更新时间:2024-01-02 GMT+08:00
分享

更新路由

功能介绍

更新路由信息

接口约束

1、自定义路由表的目的网段,不能被包含在系统路由的网段内 2、同一个路由表,路由的目的网段不能相同

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/routetables/{routetable_id}/update-routes

表1 路径参数

参数

是否必选

参数类型

描述

routetable_id

String

路由表ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。

通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

routes

Array of RouteOption objects

待更新的路由信息

表4 RouteOption

参数

是否必选

参数类型

描述

type

String

路由的类型

取值范围: 1)ecs:弹性云服务器 2)vip:虚拟IP

destination

String

路由的目的网段

约束:合法的CIDR格式, 目的地址不可更新

nexthop

String

路由下一跳对象的ID

取值范围: 1)当type为ecs时,传入ecs实例ID; 2)当type为vip时,取值为vip的ip地址;

description

String

路由的描述信息

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

最小长度:0

最大长度:255

响应参数

状态码: 200

表5 响应Body参数

参数

参数类型

描述

routes

Array of Route objects

路由列表

表6 Route

参数

参数类型

描述

type

String

路由的类型

取值范围: 1)ecs:弹性云服务器 2)vip:虚拟IP 3)local:系统路由,不可修改和删除

destination

String

路由的目的网段

约束:合法的CIDR格式

nexthop

String

路由下一跳对象的ID

取值范围: 1)当type为ecs时,传入ecs实例ID; 2)当type为vip时,取值为vip对应的IP地址;

description

String

路由的描述信息

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

请求示例

更新路由

POST https://{{endpoint}}/v1/routetables/97d08984-d346-410e-bc0e-f466dfbd1f24/update-routes

{
  "routes" : [ {
    "type" : "vip",
    "destination" : "10.10.10.0/24",
    "nexthop" : "172.16.0.6",
    "description" : "abc"
  } ]
}

响应示例

状态码: 200

OK

{
  "routes" : [ {
    "type" : "vip",
    "destination" : "10.10.10.0/24",
    "nexthop" : "172.16.0.6",
    "description" : "abc"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码

相关文档