華為云計(jì)算 云知識(shí) 更新路由表UpdateRouteTable
更新路由表UpdateRouteTable

 

功能介紹

更新路由表。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

PUT /v1/{project_id}/routetables/{routetable_id}

參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。

表1 參數(shù)說(shuō)明

名稱

是否必選

參數(shù)類(lèi)型

說(shuō)明

project_id

String

項(xiàng)目ID,請(qǐng)參見(jiàn)獲取項(xiàng)目ID。

routetable_id

String

路由表ID,路由表唯一標(biāo)識(shí)

請(qǐng)求參數(shù)

表2 請(qǐng)求參數(shù)

名稱

是否必選

參數(shù)類(lèi)型

說(shuō)明

routetable

routetable object

路由表對(duì)象,參見(jiàn)表3。

表3 routetable字段說(shuō)明

名稱

是否必選

參數(shù)類(lèi)型

說(shuō)明

name

String

  • 功能說(shuō)明:路由表名稱
  • 取值范圍:1-64個(gè)字符,支持?jǐn)?shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點(diǎn))

description

String

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

routes

RouteTableRouteAction object

  • 功能說(shuō)明:路由對(duì)象,參見(jiàn)表4。
  • 約束:
    • 每個(gè)路由表最大關(guān)聯(lián)200條路由
    • 不支持直接修改destination,如需修改,只能使用del先刪除對(duì)應(yīng)路由,然后使用add新增路由
  • 動(dòng)作:
    • add:新增路由條目,type,destination,nexthop必選
    • mod:修改路由信息,type,destination,nexthop必選
    • del:刪除路由條目,destination必選
表4 route字段操作說(shuō)明

參數(shù)

是否必選

參數(shù)類(lèi)型

說(shuō)明

add

Array of AddRouteTableRoute objects

新增路由條目,參見(jiàn)表5 新增route字段說(shuō)明

type,destination,nexthop必選

mod

Array of ModRouteTableRoute objects

修改路由條目,參見(jiàn)表6 修改route字段說(shuō)明

type,destination,nexthop必選

del

Array of DelRouteTableRoute objects

刪除路由條目,參見(jiàn)表7 刪除route字段說(shuō)明

destination必選

表5 新增route字段說(shuō)明

名稱

是否必選

參數(shù)類(lèi)型

說(shuō)明

type

String

destination

String

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

nexthop

String

  • 功能說(shuō)明:路由下一跳對(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
    • 當(dāng)type為egw時(shí),取值為vpc終端節(jié)點(diǎn)的實(shí)例ID

description

String

  • 功能說(shuō)明:路由的描述信息
  • 取值范圍:0-255個(gè)字符,不能包含“<”和“>”
表6 修改route字段說(shuō)明

參數(shù)

是否必選

參數(shù)類(lèi)型

說(shuō)明

type

String

  • 功能說(shuō)明:路由的類(lèi)型
  • 取值范圍:
    • 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

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

nexthop

String

  • 功能說(shuō)明:路由下一跳對(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
    • 當(dāng)type為egw時(shí),取值為vpc終端節(jié)點(diǎn)的實(shí)例ID

description

String

  • 功能說(shuō)明:路由的描述信息
  • 取值范圍:0-255個(gè)字符,不能包含“<”和“>”
表7 刪除route字段說(shuō)明

參數(shù)

是否必選

參數(shù)類(lèi)型

說(shuō)明

type

String

  • 功能說(shuō)明:路由的類(lèi)型
  • 取值范圍:
    • 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

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

nexthop

String

  • 功能說(shuō)明:路由下一跳對(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
    • 當(dāng)type為egw時(shí),取值為vpc終端節(jié)點(diǎn)的實(shí)例ID

description

String

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

請(qǐng)求示例

  • 更新id為3d42a0d4-a980-4613-ae76-a2cddecff054的路由表,新增一條ecs類(lèi)型的路由,修改一條ecs類(lèi)型的路由,刪除一條目的網(wǎng)段為20.20.10.0/24的路由。
    PUT https://{Endpoint}/v1/6fbe9263116a4b68818cf1edce16bc4f/routetables/3d42a0d4-a980-4613-ae76-a2cddecff054
    
    {
        "routetable": {
            "name": "routertable-789",
            "description": "abc",
            "routes": {
                "add": [
                    {
                        "type": "ecs",
                        "destination": "10.10.10.0/24",
                        "nexthop": "7c50463d-d36c-4417-aa85-cc11fa10f341",
                        "description": "abc"
                    }
                ],
                "mod": [
                    {
                        "type": "ecs",
                        "destination": "20.10.10.0/24",
                        "nexthop": "7c50463d-d36c-4417-aa85-cc11fa10f341",
                        "description": "abc"
                    }
                ],
                "del": [
                    {
                        "destination": "20.20.10.0/24"
                    }
                ]
            }
        }
    }

響應(yīng)參數(shù)

表8 響應(yīng)參數(shù)

名稱

參數(shù)類(lèi)型

說(shuō)明

routetable

routetable object

路由表對(duì)象,參見(jiàn)表9。

表9 routetable字段說(shuō)明

名稱

參數(shù)類(lèi)型

說(shuō)明

id

String

  • 功能說(shuō)明:路由表唯一標(biāo)識(shí)
  • 取值范圍:標(biāo)準(zhǔn)UUID

name

String

  • 功能說(shuō)明:路由表名稱
  • 取值范圍:0-64個(gè)字符,支持?jǐn)?shù)字、字母、中文、_(下劃線)、-(中劃線)、.(點(diǎn))

default

Boolean

  • 功能說(shuō)明:是否為默認(rèn)路由表
  • 取值范圍:true表示默認(rèn)路由表;false表示自定義路由表

routes

Array of route objects

  • 功能說(shuō)明:路由對(duì)象列表,參見(jiàn)表4
  • 約束:每個(gè)路由表最大關(guān)聯(lián)200條路由

subnets

Array of subnet objects

  • 功能說(shuō)明:路由表所關(guān)聯(lián)的子網(wǎng),參見(jiàn)表5
  • 約束:只能關(guān)聯(lián)路由表所屬VPC下的子網(wǎng)

tenant_id

String

  • 功能說(shuō)明:項(xiàng)目ID

vpc_id

String

  • 功能說(shuō)明:路由表所屬VPC的ID

description

String

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

created_at

String

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

updated_at

String

  • 功能說(shuō)明:資源更新時(shí)間,UTC時(shí)間
  • 格式:yyyy-MM-ddTHH:mm:ss
表10 route字段說(shuō)明

名稱

參數(shù)類(lèi)型

說(shuō)明

type

String

  • 功能說(shuō)明:路由的類(lèi)型
  • 取值范圍:
    • 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

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

nexthop

String

  • 功能說(shuō)明:路由下一跳對(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
    • 當(dāng)type為egw時(shí),取值為vpc終端節(jié)點(diǎn)的實(shí)例ID

description

String

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

名稱

參數(shù)類(lèi)型

說(shuō)明

id

String

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

響應(yīng)示例

{
    "routetable": {
        "id": "3d42a0d4-a980-4613-ae76-a2cddecff054",
        "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",
        "created_at": "2022-12-15T02:56:40",
        "updated_at": "2022-12-15T03:03:42"
    }
}

狀態(tài)碼

請(qǐng)參見(jiàn)狀態(tài)碼。

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。