创建静态路由
功能介绍
创建静态路由。静态路由为手动创建的路由，有效路由为优选后的路由。
接口约束
当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
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID |
route_table_id |
是 |
String |
路由表ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Client-Token |
否 |
String |
幂等性标识 最小长度：1 最大长度：64 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
route |
是 |
CreateRoute object |
创建路由请求体 |
响应参数
状态码： 202
参数 |
参数类型 |
描述 |
|---|---|---|
X-Client-Token |
- |
幂等性标识 |
参数 |
参数类型 |
描述 |
|---|---|---|
route |
Route object |
路由表项 |
request_id |
String |
请求ID |
参数 |
参数类型 |
描述 |
|---|---|---|
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 |
请求示例
在企业路由器的路由表中创建静态路由，该路由不是黑洞路由，目的地址为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",
"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 |
错误码
请参见错误码。
