更新时间:2022-01-25 GMT+08:00

更新路由器

功能介绍

更新路由器。

URI

PUT /v2.0/routers/{router_id}

请求消息

表1 请求参数

参数名称

是否必选

类型

说明

router

Object

router对象列表,参见表2

更新操作时至少指定一项属性

表2 router对象

属性

是否必选

类型

说明

name

String

路由器的名称。

【使用说明】

仅支持数字、字母、_(下划线)、-(中划线)、.(点)。

admin_state_up

Boolean

管理状态。

【取值范围】

只支持true。

external_gateway_info

Object

扩展属性:外部网关信息,参见external_gateway_info对象

routes

Array of route objects

扩展属性:路由信息列表,参见routes对象

表3 external_gateway_info对象

属性

是否必选

类型

说明

network_id

String

外部网络的UUID。

外部网络的信息请通过GET /v2.0/networks?router:external=True或neutron net-external-list方式查询。

表4 route对象

属性

是否必选

类型

说明

destination

String

IP地址段

【使用说明】

前缀不能和直连路由重复

nexthop

String

下一跳IP地址,nexthop仅支持是router所关联的子网范围内IP地址

响应消息

表5 响应参数

参数名称

类型

说明

router

Object

router对象列表,参见表6

表6 router对象

属性

类型

说明

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

表7 external_gateway_info对象

属性

类型

说明

network_id

String

外部网络的UUID。

外部网络的信息请通过GET /v2.0/networks?router:external=True或neutron net-external-list方式查询。

enable_snat

Boolean

是否启用SNAT。

默认为false。

表8 route对象

属性

类型

说明

destination

String

IP地址段

nexthop

String

下一跳IP地址,nexthop仅支持是router所关联的子网范围内IP地址

样例

请求样例

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"
    }
}

状态码

请参见状态码

错误码

请参见错误码