创建路由器

功能介绍

创建路由器。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2.0/routers

请求参数

表1 请求参数
参数名称	类型	是否必选	说明
router	router object	是	router对象，参见表2。

表2 router对象
参数名称	是否必选	类型	说明
name	否	String	路由器的名称。【使用说明】 1-64个字符，仅支持数字、字母、_(下划线)、-（中划线）、.（点）。
admin_state_up	否	Boolean	管理状态。【取值范围】只支持true。
external_gateway_info	否	external_gateway_info object	扩展属性：外部网关信息，参见external_gateway_info对象

表3 external_gateway_info对象
参数名称	是否必选	类型	说明
network_id	否	String	外部网络的UUID。外部网络的信息请通过GET /v2.0/networks?router:external=True或neutron net-external-list方式查询。

请求示例

创建路由器，命名为router-test2。

POST https://{Endpoint}/v2.0/routers 

{
    "router": {
           "name": "router-test2",
           "admin_state_up": true
    }
}

响应参数

表4 响应参数
参数名称	类型	说明
router	router object	router对象，参见表5

表5 router对象
参数名称	类型	说明
id	String	路由器的id 【使用说明】在查询路由器列表时非必选
name	String	路由器的名称。仅支持数字、字母、_(下划线)、-（中划线）、.（点）。
admin_state_up	Boolean	管理状态。只支持true。
status	String	状态，可以为ACTIVE， DOWN，ERROR。
tenant_id	String	项目ID
external_gateway_info	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

表6 external_gateway_info对象
参数名称	类型	说明
network_id	String	外部网络的UUID。外部网络的信息请通过GET /v2.0/networks?router:external=True或neutron net-external-list方式查询。
enable_snat	Boolean	是否启用SNAT。默认为false。

表7 route对象
参数名称	类型	说明
destination	String	IP地址段
nexthop	String	下一跳IP地址，nexthop仅支持是router所关联的子网范围内IP地址

响应示例

{
    "router": {
        "id": "f5dbdfe0-86f9-4b0a-9a32-6be143f0a076",
        "name": "router-test2",
        "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"
    }
}