文档首页/云专线 DC/API参考 (联盟区域) /API/全域接入网关路由表/修改全域接入网关路由表
更新时间：2026-01-08 GMT+08:00
在线调试
CLI示例
查看PDF
分享

修改全域接入网关路由表

功能介绍

支持的修改操作：新增、删除、修改

调用方法

请参见如何调用API。

URI

PUT /v3/{project_id}/dcaas/gdgw/{gdgw_id}/routetables

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户项目ID

最小长度：0

最大长度：36

gdgw_id

是

String

全域接入网关ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

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

最小长度：0

最大长度：10240

表3 请求Body参数

参数

是否必选

参数类型

描述

dry_run

否

Boolean

是否dry run模式执行

gdgw_routetable

否

GdgwRouteTableRequest object

修改路由入参对象

表4 GdgwRouteTableRequest

参数

是否必选

参数类型

描述

add_routes

否

Array of objects

需要添加的路由

数组长度：0 - 100

del_routes

否

Array of objects

需要删除的路由

数组长度：0 - 100

update_routes

否

Array of objects

需要更新的路由

仅更新该条路由的附加信息，不执行交换机的路由更新操作。当前支持更新：路由描述-description信息

数组长度：0 - 100

表5 add_routes

参数

是否必选

参数类型

描述

type

是

String

下一跳类型:

  • vif_peer: 虚拟接口对等体

  • gdgw: 全域接入网关

destination

是

String

路由子网

nexthop

是

String

下一跳id

description

否

String

路由描述

表6 del_routes

参数

是否必选

参数类型

描述

type

是

String

下一跳类型:

  • vif_peer: 虚拟接口对等体

  • gdgw: 全域接入网关

destination

是

String

路由子网

nexthop

是

String

下一跳id

表7 update_routes

参数

是否必选

参数类型

描述

destination

是

String

路由子网

nexthop

是

String

下一跳id

description

否

String

路由描述

响应参数

状态码： 200

表8 响应Body参数

参数

参数类型

描述

request_id

String

请求id

最小长度：0

最大长度：36

gdgw_routetable

Array of CommonRoutetable objects

全域接入网关路由表

数组长度：0 - 2000

表9 CommonRoutetable

参数

参数类型

描述

id

String

路由id

最小长度：36

最大长度：36

tenant_id

String

租户id

最小长度：64

最大长度：64

gateway_id

String

网关id

最小长度：36

最大长度：36

destination

String

路由子网

最小长度：64

最大长度：64

nexthop

String

下一跳id

最小长度：36

最大长度：36

obtain_mode

String

路由类型:

  • customized: 默认路由

  • specific: 自定义路由

  • bgp: 动态路由

status

String

路由状态:

  • ACTIVE: 下发正常

  • ERROR: 下发失败

  • PENDING_CREATE: 待下发

address_family

String

地址族类型:

  • ipv4: ipv4

  • ipv6: ipv6

description

String

路由描述

最小长度：0

最大长度：1024

type

String

下一跳类型:

  • vif_peer: 虚拟接口对等体

  • gdgw: 全域接入网关

最小长度：0

最大长度：255

请求示例

更新专线网关路由表请求体

PUT https://{dc_endpoint}/v3/4bd6efdb0fb747b39aa2c0162c112226/dcaas/gdgw/0851a5e0-6623-42c2-bb02-b8956e313dd8/routetables

{
  "gdgw_routetable" : {
    "add_routes" : [ {
      "destination" : "1.1.1.0/24",
      "nexthop" : "b9060822-06bf-4c48-995d-29a3fb04a3c3",
      "type" : "vif_peer",
      "description" : ""
    } ]
  }
}

响应示例

状态码： 200

OK

  • 更新专线网关路由表响应体

    {
  "request_id" : "d365091f89df06c8737bd81a72efc8b2",
  "gdgw_routetable" : [ {
    "id" : "94912503-0a97-48ee-909b-6676129a565e",
    "description" : "",
    "tenant_id" : "4bd6efdb0fb747b39aa2c0162c112226",
    "gateway_id" : "0851a5e0-6623-42c2-bb02-b8956e313dd8",
    "destination" : "1.1.1.0/24",
    "nexthop" : "b9060822-06bf-4c48-995d-29a3fb04a3c3",
    "type" : "vif_peer",
    "obtain_mode" : "specific",
    "status" : "PENDING_CREATE",
    "address_family" : "ipv4"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。