List Routers

Verb URI Description
GET /routers Returns a list of logical routers accessible to the tenant submitting the request.

Normal Response Code: 200

Error Response Codes: Unauthorized (401)

This operation returns a list of routers to which the tenant has access. Default policy settings return only those routers that are owned by the tenant who submits the request, unless the request is submitted by an user with administrative rights. Users can control which attributes should be returned by using the fields query parameter. Additionally, results can be filtered by using query string parameters.

This operation does not require a request body; this operation returns a response body.

 

Example 4.13. List Routers: JSON Request

GET /v2.0/routers
Accept: application/json

 

Example 4.14. List Routers: JSON Response

{
   "routers":
   [{
       "status": "ACTIVE",
       "external_gateway_info": null,
       "name": "second_routers",
       "admin_state_up": true,
       "tenant_id": "6b96ff0cb17a4b859e1e575d221683d3",
       "id": "7177abc4-5ae9-4bb7-b0d4-89e94a4abf3b"
    },
    {
       "status": "ACTIVE",
       "external_gateway_info":
       {"network_id": "3c5bcddd-6af9-4e6b-9c3e-c153e521cab8"},
       "name": "router1",
       "admin_state_up": true,
       "tenant_id": "33a40233088643acb66ff6eb0ebea679",
       "id": "a9254bdb-2613-4a13-ac4c-adc581fba50d"
     }]
}

Questions? Discuss on ask.openstack.org
Found an error? Report a bug against this page


loading table of contents...