文档首页 > > API参考> OpenStack Neutron API> 路由器> 查询路由器列表

查询路由器列表

分享
更新时间: 2019/11/22 GMT+08:00

功能介绍

查询提交请求的租户有权限操作的所有路由器信息,单次查询最多返回2000条数据,超过2000后会返回分页标记。分页查询请参考分页查询

URI

GET /v2.0/routers

样例:

GET https://{Endpoint}/v2.0/routers?id={id}&name={name}&admin_state_up={admin_state_up}&tenant_id={tenant_id}&status={status}

分页查询样例:

GET https://{Endpoint}/v2.0/routers?limit=2&marker=01ab4be1-4447-45fb-94be-3ee787ed4ebe&page_reverse=False

请求消息

无。

响应消息

表1 响应参数

参数名称

类型

说明

routers

Array of router objects

router对象列表,参见表2

表2 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

created_at

String

资源创建时间,UTC时间

格式:yyyy-MM-ddTHH:mm:ss

updated_at

String

资源更新时间,UTC时间

格式:yyyy-MM-ddTHH:mm:ss

表3 external_gateway_info对象

属性

类型

说明

network_id

String

外部网络的UUID。

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

enable_snat

Boolean

是否启用SNAT。

默认为false。

表4 route对象

属性

类型

说明

destination

String

IP地址段

nexthop

String

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

样例

请求样例

GET https://{Endpoint}/v2.0/routers?limit=1

响应样例

{
    "routers": [
        {
            "id": "01ab4be1-4447-45fb-94be-3ee787ed4ebe",
            "name": "xiaoleizi-tag",
            "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": [
                {
                    "destination": "0.0.0.0/0",
                    "nexthop": "172.16.0.124"
                }
            ],
            "created_at": "2018-03-23T09:26:08",
            "updated_at": "2018-08-24T08:49:53"
        }
    ]
}

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

跳转到云社区