文档首页/ 企业路由器 ER/ API参考（安卡拉区域）/ API/ 路由/ 创建静态路由
更新时间：2024-12-27 GMT+08:00
在线调试
CLI示例
查看PDF
分享

创建静态路由

功能介绍

创建静态路由。静态路由为手动创建的路由，有效路由为优选后的路由。

接口约束

当is_blackhole设置为false时，必须传入attachment_id参数;当is_blackhole设置为true时，禁止传入attachment_id参数。

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/enterprise-router/route-tables/{route_table_id}/static-routes

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

route_table_id

是

String

路由表ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Client-Token

否

String

幂等性标识

最小长度：1

最大长度：64
表3 请求Body参数

参数

是否必选

参数类型

描述

route

是

CreateRoute object

创建路由请求体
表4 CreateRoute

参数

是否必选

参数类型

描述

destination

是

String

路由目的地址

最小长度：0

最大长度：256

attachment_id

否

String

路由下一跳指向的连接ID

is_blackhole

否

Boolean

是否为黑洞路由，默认为false

响应参数

状态码： 202

表5 响应Header参数

参数

参数类型

描述

X-Client-Token

String

幂等性标识
表6 响应Body参数

参数

参数类型

描述

route

Route object

路由表项

request_id

String

请求ID
表7 Route

参数

参数类型

描述

id

String

路由id

type

String

路由类型:static

state

String

路由状态:pending|available|modifying|deleting|deleted|failed

is_blackhole

Boolean

是否为黑洞路由

destination

String

路由目的地址

attachments

Array of RouteAttachment objects

下一跳列表

route_table_id

String

路由表id

created_at

String

创建时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ

updated_at

String

更新时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ
表8 RouteAttachment

参数

参数类型

描述

resource_id

String

连接关联的资源ID

resource_type

String

连接关联的资源类型:

  • vpc：虚拟私有云

  • vpn：vpn网关

  • vgw：云专线的虚拟网关

  • gdgw：下一代专线网关

attachment_id

String

连接ID

请求示例

在企业路由器的路由表中创建静态路由，该路由不是黑洞路由，目的地址为192.168.0.0/16，下一跳为指定连接

POST https://{erouter_endpoint}/v3/08d5a9564a704afda6039ae2babbef3c/enterprise-router/route-tables/0d1748a0-5188-11e5-b86f-a51b5f125b84/static-routes

{
  "route" : {
    "destination" : "192.168.0.0/16",
    "is_blackhole" : false,
    "attachment_id" : "b70aee08-c671-4cad-9fd5-7381d163bcc8"
  }
}

响应示例

状态码： 202

Accepted

{
  "route" : {
    "id" : "9b3b38a9-1c9d-4f01-9429-81af6b545289",
    "type" : "static",
    "destination" : "192.168.0.0/16",
    "description" : "static route",
    "attachments" : [ {
      "resource_id" : "9c4ab06a-0ab4-4fad-93a8-f733f3a4433d",
      "resource_type" : "vpc",
      "attachment_id" : "b70aee08-c671-4cad-9fd5-7381d163bcc8"
    } ],
    "route_table_id" : "0d1748a0-5188-11e5-b86f-a51b5f125b84",
    "is_blackhole" : false,
    "state" : "pending",
    "created_at" : "2020-03-11T15:13:31Z",
    "updated_at" : "2020-03-11T15:13:31Z"
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

状态码

状态码

描述

202

Accepted

错误码

请参见错误码。

父主题： 路由