更新路由器
功能介绍
更新路由器。
URI
PUT /v2.0/routers/{router_id}
请求消息
|
参数名称 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
router |
是 |
Object |
router对象列表，参见表2。 更新操作时至少指定一项属性 |
|
属性 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
name |
否 |
String |
路由器的名称。 【使用说明】 仅支持数字、字母、_(下划线)、-（中划线）、.（点）。 |
|
admin_state_up |
否 |
Boolean |
管理状态。 【取值范围】 只支持true。 |
|
external_gateway_info |
否 |
Object |
扩展属性：外部网关信息，参见external_gateway_info对象 |
|
routes |
否 |
Array of route objects |
扩展属性：路由信息列表，参见routes对象 |
|
属性 |
是否必选 |
类型 |
说明 |
|---|---|---|---|
|
network_id |
否 |
String |
外部网络的UUID。 外部网络的信息请通过GET /v2.0/networks?router:external=True或neutron net-external-list方式查询。 |
响应消息
|
参数名称 |
类型 |
说明 |
|---|---|---|
|
router |
Object |
router对象列表，参见表6。 |
|
属性 |
类型 |
说明 |
|---|---|---|
|
id |
String |
路由器的id 【使用说明】在查询路由器列表时非必选 |
|
name |
String |
路由器的名称。 仅支持数字、字母、_(下划线)、-（中划线）、.（点）。 |
|
admin_state_up |
Boolean |
管理状态。 只支持true。 |
|
status |
String |
状态，可以为ACTIVE， DOWN，ERROR。 |
|
tenant_id |
String |
项目ID |
|
external_gateway_info |
Object |
扩展属性：外部网关信息，参见external_gateway_info对象 |
|
routes |
Array of route objects |
扩展属性：路由信息列表，参见routes对象 |
|
project_id |
String |
项目ID，请参见获取项目ID。 |
|
created_at |
String |
资源创建时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
|
updated_at |
String |
资源更新时间，UTC时间 格式：yyyy-MM-ddTHH:mm:ss |
|
属性 |
类型 |
说明 |
|---|---|---|
|
network_id |
String |
外部网络的UUID。 外部网络的信息请通过GET /v2.0/networks?router:external=True或neutron net-external-list方式查询。 |
|
enable_snat |
Boolean |
是否启用SNAT。 默认为false。 |
样例
请求样例
PUT https://{Endpoint}/v2.0/routers/f5dbdfe0-86f9-4b0a-9a32-6be143f0a076
{
"router": {
"name": "router-220"
}
}
响应样例
{
"router": {
"id": "f5dbdfe0-86f9-4b0a-9a32-6be143f0a076",
"name": "router-220",
"status": "ACTIVE",
"tenant_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"project_id": "bbfe8c41dd034a07bebd592bf03b4b0c",
"admin_state_up": true,
"external_gateway_info": {
"network_id": "0a2228f2-7f8a-45f1-8e09-9039e1d09975",
"enable_snat": false
},
"routes": [],
"created_at": "2018-09-20T02:06:07",
"updated_at": "2018-09-20T02:06:09"
}
}
状态码
请参见状态码。
错误码
请参见错误码。
