华为云计算 云知识 创建路由表CreateRouteTable
创建路由表CreateRouteTable

 

接口说明

创建路由表

约束说明

1、自定义路由表的目的网段,不能被包含在 local 类型路由的网段内 2、同一个路由表,路由的目的网段不能相同 3、一次下发的路由条目数,不能超过5条

URL
POST  https://vpc.cn-north-4.myhuaweicloud.com/v1/{project_id}/routetables 
请求参数
名称 类型 IN 必选 描述
X-Auth-Token
 
string header

用户Token 获取Token ,请参考《 统一身份认证 服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

project_id
 
string path

项目ID

Body参数
名称 类型 必选 描述
routetable
 
CreateRouteTableReq object

路由表对象

参数:
routetable
名称 类型 必选 描述
name
 
string

功能说明:路由表名称

取值范围:0-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)

routes
 
Array of RouteTableRoute objects

功能说明:路由对象,参见route字段说明

约束:每个路由表最大关联200条路由

vpc_id
 
string

路由表所在的 虚拟私有云 ID

description
 
string

功能说明:路由表描述信息

取值范围:0-255个字符,不能包含“<”和“>”

参数:
routetable.routes
名称 类型 必选 描述
type
 
string

功能说明:路由的类型 取值范围: ecs:弹性 云服务器 eni:网卡 vip:虚拟IP nat: NAT网关 peering:对等连接 vpn : 虚拟专用网络 dc: 云专线 cc: 云连接 egw: VPC终端节点

destination
 
string

功能说明:路由目的网段 约束:合法的CIDR格式

nexthop
 
string

功能说明:路由下一跳对象的ID 取值范围: 当type为ecs时,传入ecs实例ID 当type为eni时,取值为从网卡ID 当type为vip时,取值为vip对应的IP地址 当type为nat时,取值为nat实例对应的ID 当type为peering时,取值为peering对应实例ID 当type为vpn时,取值为vpn实例ID 当type为dc时,取值为dc实例ID 当type为cc时,取值为cc的实例ID

description
 
string

功能说明:路由的描述信息 取值范围:0-255个字符,不能包含“<”和“>”

返回参数
返回码: 200

正常返回

名称 类型 必选 描述
routetable
 
RouteTableResp object

路由表对象

200 routetable
名称 类型 必选 描述
id
 
string

功能说明:路由表ID

取值范围:标准UUID

name
 
string

功能说明:路由表名称

取值范围:0-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)

default
 
boolean

功能说明:是否为默认路由表

取值范围:true表示默认路由表;false表示自定义路由表

routes
 
Array of RouteTableRoute objects

功能说明:路由对象,参见route字段说明。

约束:每个路由表最大关联200条路由

subnets
 
Array of SubnetList objects

功能说明:路由表所关联的子网

约束:只能关联路由表所属VPC下的子网

tenant_id
 
string

项目ID

vpc_id
 
string

路由表所在的虚拟 私有云 ID

description
 
string

功能说明:路由表描述信息

取值范围:0-255个字符,不能包含“<”和“>”

created_at
 
string

功能说明:资源创建UTC时间 格式:yyyy-MM-ddTHH:mm:ss

updated_at
 
string

功能说明:资源更新UTC时间 格式:yyyy-MM-ddTHH:mm:ss

200 routetable.routes
名称 类型 必选 描述
type
 
string

功能说明:路由的类型 取值范围: ecs:弹性 云服务 器 eni:网卡 vip:虚拟IP nat:NAT网关 peering:对等连接 vpn:虚拟专用网络 dc:云专线 cc:云连接 egw:VPC 终端节点

destination
 
string

功能说明:路由目的网段 约束:合法的CIDR格式

nexthop
 
string

功能说明:路由下一跳对象的ID 取值范围: 当type为ecs时,传入ecs实例ID 当type为eni时,取值为从网卡ID 当type为vip时,取值为vip对应的IP地址 当type为nat时,取值为nat实例对应的ID 当type为peering时,取值为peering对应实例ID 当type为vpn时,取值为vpn实例ID 当type为dc时,取值为dc实例ID 当type为cc时,取值为cc的实例ID

description
 
string

功能说明:路由的描述信息 取值范围:0-255个字符,不能包含“<”和“>”

200 routetable.subnets
名称 类型 必选 描述
id
 
string

路由表关联的子网ID

返回码: 400

服务器未能处理请求。

名称 类型 必选 描述
code
 
string

请求返回的错误码

message
 
string

请求返回的错误信息

返回码: 401

被请求的页面需要用户名和密码。

名称 类型 必选 描述
code
 
string

请求返回的错误码

message
 
string

请求返回的错误信息

返回码: 403

对被请求页面的访问被禁止。

名称 类型 必选 描述
code
 
string

请求返回的错误码

message
 
string

请求返回的错误信息

返回码: 404

服务器无法找到被请求的页面。

名称 类型 必选 描述
code
 
string

请求返回的错误码

message
 
string

请求返回的错误信息

返回码: 409

由于冲突,请求无法被完成。

名称 类型 必选 描述
code
 
string

请求返回的错误码

message
 
string

请求返回的错误信息

返回码: 500

请求未完成。服务异常。

名称 类型 必选 描述
code
 
string

请求返回的错误码

message
 
string

请求返回的错误信息

请求示例
示例 1
 
"POST https://{Endpoint}/v1/{project_id}/routetables"
 
{ "routetable": { "name": "routetable-1234", "vpc_id": "60c809cb-6731-45d0-ace8-3bf5626421a9", "routes": [ { "type": "ecs", "destination": "10.10.10.0/24", "nexthop": "7c50463d-d36c-4417-aa85-cc11fa10f341" } ], "description": "abc" } }
返回示例
返回码:200

正常返回

示例 1
 
{
"routetable": {
"id": "3d42a0d4-a980-4613-ae76-a2cddecff054",
"name": "routetable-1234",
"default": false,
"vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff",
"description": "abc",
"routes": [
{
"type": "ecs",
"destination": "10.10.10.0/24",
"nexthop": "7c50463d-d36c-4417-aa85-cc11fa10f341",
"description": "abc"
}
],
"subnets": [
{
"id": "8d4ce32f-d68a-4c4c-9f18-c68d8a5c7f2f"
}
],
"tenant_id": "6fbe9263116a4b68818cf1edce16bc4f"
}
}
SDK
点击 虚拟私有云 (VPC) SDK, 下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。
错误码
请参考 错误码说明
文档反馈

 

上一篇:创建全球加速器CreateAccelerator 下一篇:Hadoop