華為云計(jì)算 云知識(shí) 創(chuàng)建路由表CreateRouteTable
創(chuàng)建路由表CreateRouteTable

 

接口說明

創(chuàng)建路由表

約束說明

1、自定義路由表的目的網(wǎng)段,不能被包含在 local 類型路由的網(wǎng)段內(nèi) 2、同一個(gè)路由表,路由的目的網(wǎng)段不能相同 3、一次下發(fā)的路由條目數(shù),不能超過5條

URL
POST  https://vpc.cn-north-4.myhuaweicloud.com/v1/{project_id}/routetables 
請(qǐng)求參數(shù)
名稱 類型 IN 必選 描述
X-Auth-Token
 
string header

用戶Token 獲取Token ,請(qǐng)參考《 統(tǒng)一身份認(rèn)證 服務(wù)API參考》的“獲取用戶Token”章節(jié)。請(qǐng)求響應(yīng)成功后在響應(yīng)消息頭中包含的“X-Subject-Token”的值即為Token值。

project_id
 
string path

項(xiàng)目ID

Body參數(shù)
名稱 類型 必選 描述
routetable
 
CreateRouteTableReq object

路由表對(duì)象

參數(shù):
routetable
名稱 類型 必選 描述
name
 
string

功能說明:路由表名稱

取值范圍:0-64個(gè)字符,支持?jǐn)?shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點(diǎn))

routes
 
Array of RouteTableRoute objects

功能說明:路由對(duì)象,參見route字段說明

約束:每個(gè)路由表最大關(guān)聯(lián)200條路由

vpc_id
 
string

路由表所在的 虛擬私有云 ID

description
 
string

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

取值范圍:0-255個(gè)字符,不能包含“<”和“>”

參數(shù):
routetable.routes
名稱 類型 必選 描述
type
 
string

功能說明:路由的類型 取值范圍: ecs:彈性 云服務(wù)器 eni:網(wǎng)卡 vip:虛擬IP nat: NAT網(wǎng)關(guān) peering:對(duì)等連接 vpn : 虛擬專用網(wǎng)絡(luò) dc: 云專線 cc: 云連接 egw:VPC終端節(jié)點(diǎn)

destination
 
string

功能說明:路由目的網(wǎng)段 約束:合法的CIDR格式

nexthop
 
string

功能說明:路由下一跳對(duì)象的ID 取值范圍: 當(dāng)type為ecs時(shí),傳入ecs實(shí)例ID 當(dāng)type為eni時(shí),取值為從網(wǎng)卡ID 當(dāng)type為vip時(shí),取值為vip對(duì)應(yīng)的IP地址 當(dāng)type為nat時(shí),取值為nat實(shí)例對(duì)應(yīng)的ID 當(dāng)type為peering時(shí),取值為peering對(duì)應(yīng)實(shí)例ID 當(dāng)type為vpn時(shí),取值為vpn實(shí)例ID 當(dāng)type為dc時(shí),取值為dc實(shí)例ID 當(dāng)type為cc時(shí),取值為cc的實(shí)例ID

description
 
string

功能說明:路由的描述信息 取值范圍:0-255個(gè)字符,不能包含“<”和“>”

返回參數(shù)
返回碼: 200

正常返回

名稱 類型 必選 描述
routetable
 
RouteTableResp object

路由表對(duì)象

200 routetable
名稱 類型 必選 描述
id
 
string

功能說明:路由表ID

取值范圍:標(biāo)準(zhǔn)UUID

name
 
string

功能說明:路由表名稱

取值范圍:0-64個(gè)字符,支持?jǐn)?shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點(diǎn))

default
 
boolean

功能說明:是否為默認(rèn)路由表

取值范圍:true表示默認(rèn)路由表;false表示自定義路由表

routes
 
Array of RouteTableRoute objects

功能說明:路由對(duì)象,參見route字段說明。

約束:每個(gè)路由表最大關(guān)聯(lián)200條路由

subnets
 
Array of SubnetList objects

功能說明:路由表所關(guān)聯(lián)的子網(wǎng)

約束:只能關(guān)聯(lián)路由表所屬VPC下的子網(wǎng)

tenant_id
 
string

項(xiàng)目ID

vpc_id
 
string

路由表所在的虛擬 私有云 ID

description
 
string

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

取值范圍:0-255個(gè)字符,不能包含“<”和“>”

created_at
 
string

功能說明:資源創(chuàng)建UTC時(shí)間 格式:yyyy-MM-ddTHH:mm:ss

updated_at
 
string

功能說明:資源更新UTC時(shí)間 格式:yyyy-MM-ddTHH:mm:ss

200 routetable.routes
名稱 類型 必選 描述
type
 
string

功能說明:路由的類型 取值范圍: ecs:彈性云服務(wù)器 eni:網(wǎng)卡 vip:虛擬IP nat:NAT網(wǎng)關(guān) peering:對(duì)等連接 vpn:虛擬專用網(wǎng)絡(luò) dc:云專線 cc:云連接 egw:VPC終端節(jié)點(diǎn)

destination
 
string

功能說明:路由目的網(wǎng)段 約束:合法的CIDR格式

nexthop
 
string

功能說明:路由下一跳對(duì)象的ID 取值范圍: 當(dāng)type為ecs時(shí),傳入ecs實(shí)例ID 當(dāng)type為eni時(shí),取值為從網(wǎng)卡ID 當(dāng)type為vip時(shí),取值為vip對(duì)應(yīng)的IP地址 當(dāng)type為nat時(shí),取值為nat實(shí)例對(duì)應(yīng)的ID 當(dāng)type為peering時(shí),取值為peering對(duì)應(yīng)實(shí)例ID 當(dāng)type為vpn時(shí),取值為vpn實(shí)例ID 當(dāng)type為dc時(shí),取值為dc實(shí)例ID 當(dāng)type為cc時(shí),取值為cc的實(shí)例ID

description
 
string

功能說明:路由的描述信息 取值范圍:0-255個(gè)字符,不能包含“<”和“>”

200 routetable.subnets
名稱 類型 必選 描述
id
 
string

路由表關(guān)聯(lián)的子網(wǎng)ID

返回碼: 400

服務(wù)器未能處理請(qǐng)求。

名稱 類型 必選 描述
code
 
string

請(qǐng)求返回的錯(cuò)誤碼

message
 
string

請(qǐng)求返回的錯(cuò)誤信息

返回碼: 401

被請(qǐng)求的頁面需要用戶名和密碼。

名稱 類型 必選 描述
code
 
string

請(qǐng)求返回的錯(cuò)誤碼

message
 
string

請(qǐng)求返回的錯(cuò)誤信息

返回碼: 403

對(duì)被請(qǐng)求頁面的訪問被禁止。

名稱 類型 必選 描述
code
 
string

請(qǐng)求返回的錯(cuò)誤碼

message
 
string

請(qǐng)求返回的錯(cuò)誤信息

返回碼: 404

服務(wù)器無法找到被請(qǐng)求的頁面。

名稱 類型 必選 描述
code
 
string

請(qǐng)求返回的錯(cuò)誤碼

message
 
string

請(qǐng)求返回的錯(cuò)誤信息

返回碼: 409

由于沖突,請(qǐng)求無法被完成。

名稱 類型 必選 描述
code
 
string

請(qǐng)求返回的錯(cuò)誤碼

message
 
string

請(qǐng)求返回的錯(cuò)誤信息

返回碼: 500

請(qǐng)求未完成。服務(wù)異常。

名稱 類型 必選 描述
code
 
string

請(qǐng)求返回的錯(cuò)誤碼

message
 
string

請(qǐng)求返回的錯(cuò)誤信息

請(qǐng)求示例
示例 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
點(diǎn)擊 虛擬私有云 (VPC) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對(duì)應(yīng)語言類型的【使用】目錄下。
錯(cuò)誤碼
請(qǐng)參考 錯(cuò)誤碼說明。
文檔反饋