List Networks

Verb URI Description
GET /networks Lists networks that the tenant who submits the request can access.

Normal Response Code: 200

Error Response Codes: Unauthorized (401)

Lists networks that the tenant who submits the request can access. The list shows the ID for each network.

This operation does not require a request body, unless the OpenStack Networking server is running without Keystone integration.

This operation returns a response body.

 

Example 4.1. List Networks: JSON Request

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

 

Example 4.2. List Networks: JSON Response

{
   "networks":[
      {
         "status":"ACTIVE",
         "subnets":[
            "a318fcb4-9ff0-4485-b78c-9e6738c21b26"
         ],
         "name":"private",
         "admin_state_up":true,
         "tenant_id":"625887121e364204873d362b553ab171",
         "id":"9d83c053-b0a4-4682-ae80-c00df269ce0a",
         "shared":false
      },
      {
         "status":"ACTIVE",
         "subnets":[
            "aca4d43c-c48c-4a2c-9bb6-ba374ef7e135"
         ],
         "name":"nova",
         "admin_state_up":true,
         "tenant_id":"63878e4c5dd649d2a980e37aefddfa87",
         "id":"ebda9658-093b-41ba-80ce-0cf8cb8365d4",
         "shared":false
      },
      {
         "status":"ACTIVE",
         "subnets":[
            "e12f0c45-46e3-446a-b207-9474b27687a6"
         ],
         "name":"network_3",
         "admin_state_up":true,
         "tenant_id":"ed680f49ff714162ab3612d7876ffce5",
         "id":"afc75773-640e-403c-9fff-62ba98db1f19",
         "shared":true
      }
   ]
}

 

Example 4.3. List Networks: XML Request

GET /v2.0/networks
Accept: application/xml

 

Example 4.4. List Networks: XML Response

<?xml version="1.0" encoding="UTF-8"?>
<networks xmlns="http://openstack.org/quantum/api/v2.0"
    xmlns:quantum="http://openstack.org/quantum/api/v2.0"
    xmlns:router="http://docs.openstack.org/ext/quantum/router/api/v1.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <network>
        <status>ACTIVE</status>
        <subnets>
            <subnet>a318fcb4-9ff0-4485-b78c-9e6738c21b26</subnet>
        </subnets>
        <name>private</name>
        <admin_state_up quantum:type="bool">True</admin_state_up>
        <tenant_id>625887121e364204873d362b553ab171</tenant_id>
        <router:external quantum:type="bool">False</router:external>
        <shared quantum:type="bool">False</shared>
        <id>9d83c053-b0a4-4682-ae80-c00df269ce0a</id>
    </network>
    <network>
        <status>ACTIVE</status>
        <subnets>
            <subnet>aca4d43c-c48c-4a2c-9bb6-ba374ef7e135</subnet>
        </subnets>
        <name>nova</name>
        <admin_state_up quantum:type="bool">True</admin_state_up>
        <tenant_id>63878e4c5dd649d2a980e37aefddfa87</tenant_id>
        <router:external quantum:type="bool">True</router:external>
        <shared quantum:type="bool">False</shared>
        <id>ebda9658-093b-41ba-80ce-0cf8cb8365d4</id>
    </network>
</networks>

Log a bug against this page


loading table of contents...