華為云計(jì)算 云知識 子網(wǎng)關(guān)聯(lián)路由表AssociateRouteTable
子網(wǎng)關(guān)聯(lián)路由表AssociateRouteTable

 

接口說明

路由表關(guān)聯(lián)子網(wǎng)。子網(wǎng)關(guān)聯(lián)路由表A后,再關(guān)聯(lián)B,不需要先跟路由表A解關(guān)聯(lián)再關(guān)聯(lián)路由表B

約束說明

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

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

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

project_id
 
string path

項(xiàng)目ID

routetable_id
 
string path

路由表ID

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

路由表對象

參數(shù):
routetable
名稱 類型 必選 描述
subnets
 
AssociateRouteTableAndSubnetReq object

關(guān)聯(lián)、解除關(guān)聯(lián)要操作的子網(wǎng),參見AssociateRouteTableAndSubnetReq對象

參數(shù):
routetable.subnets
名稱 類型 必選 描述
associate
 
Array of strings

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

disassociate
 
Array of strings

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

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

正常返回

名稱 類型 必選 描述
routetable
 
RouteTableResp object

路由表對象

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

功能說明:路由對象,參見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:對等連接 vpn : 虛擬專用網(wǎng)絡(luò) dc: 云專線 cc: 云連接 egw:VPC終端節(jié)點(diǎn)

destination
 
string

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

nexthop
 
string

功能說明:路由下一跳對象的ID 取值范圍: 當(dāng)type為ecs時(shí),傳入ecs實(shí)例ID 當(dāng)type為eni時(shí),取值為從網(wǎng)卡ID 當(dāng)type為vip時(shí),取值為vip對應(yīng)的IP地址 當(dāng)type為nat時(shí),取值為nat實(shí)例對應(yīng)的ID 當(dāng)type為peering時(shí),取值為peering對應(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ù)器未能處理請求。

名稱 類型 必選 描述
code
 
string

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

message
 
string

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

返回碼: 401

被請求的頁面需要用戶名和密碼。

名稱 類型 必選 描述
code
 
string

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

message
 
string

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

返回碼: 403

對被請求頁面的訪問被禁止。

名稱 類型 必選 描述
code
 
string

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

message
 
string

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

返回碼: 404

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

名稱 類型 必選 描述
code
 
string

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

message
 
string

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

返回碼: 409

由于沖突,請求無法被完成。

名稱 類型 必選 描述
code
 
string

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

message
 
string

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

返回碼: 500

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

名稱 類型 必選 描述
code
 
string

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

message
 
string

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

請求示例
示例 1
 
"POST https://{Endpoint}/v1/{project_id}/routetables/{routetable_id}/action"
 
{ "routetable": { "subnets": { "associate": [ "1a8b8c98-3976-401b-a735-8b058109268c" ] } } }
返回示例
返回碼:200

正常返回

示例 1
 
{
"routetable": {
"id": "3d42a0d4-a980-4613-ae76-a2cddecff054",
"name": "routetable_01",
"vpc_id": "ab78be2d-782f-42a5-aa72-35879f6890ff",
"tenant_id": "6fbe9263116a4b68818cf1edce16bc4f",
"default": false,
"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"
}
]
}
}
SDK
點(diǎn)擊 虛擬 私有云  (VPC) SDK, 下載SDK或查看SDK文檔。SDK的安裝、認(rèn)證方式等在SDK文檔中對應(yīng)語言類型的【使用】目錄下。
錯(cuò)誤碼
請參考 錯(cuò)誤碼說明。