List Ports

Verb URI Description
GET /ports Returns a list of ports with their attributes.

Normal Response Code: 200 OK

Error Response Codes: 401 Unauthorized

This operation returns, all the ports defined in Neutron that this user has access to.

 

Example 4.214. List Ports with extra_dhcp_opts: JSON Response

{
  "ports": [
  {
    "status": "DOWN",
    "binding:host_id": null,
    "name": "",
    "allowed_address_pairs": [],
    "admin_state_up": true,
    "network_id": "87733bcc-8144-41b1-bb6b-d011d7a5168e",
    "tenant_id": "7ea98790cd854fb5a82ef3d41e5c156b",
    "extra_dhcp_opts": [{"opt_value": "testfile.1", "opt_name": "bootfile-name"}, {"opt_value": "123.123.123.45", "opt_name": "server-ip-address"}, {"opt_value": "123.123.123.123", "opt_name": "tftp-server"}],
    "binding:vif_type": "ovs",
    "device_owner": "",
    "binding:capabilities": {"port_filter": true},
    "mac_address": "fa:16:3e:52:92:3a",
    "fixed_ips": [{"subnet_id": "99a8aea3-b9da-409d-a5e5-f45338ceb4d3", "ip_address": "172.24.4.228"}],
    "id": "3c0c7a37-690a-43a8-8088-5d4c2c7f8484",
    "security_groups": ["9bf6f19a-ba4a-470f-b8ce-28c9ad66556c"],
    "device_id": ""
  },
  {
    "status": "ACTIVE",
    "binding:host_id": null,
    "name": "",
    "allowed_address_pairs": [],
    "admin_state_up": true,
    "network_id": "87733bcc-8144-41b1-bb6b-d011d7a5168e",
    "tenant_id": "7ea98790cd854fb5a82ef3d41e5c156b",
    "extra_dhcp_opts": [],
    "binding:vif_type": "ovs",
    "device_owner": "compute:probe",
    "binding:capabilities": {"port_filter": true},
    "mac_address": "fa:16:3e:49:56:07",
    "fixed_ips": [{"subnet_id": "99a8aea3-b9da-409d-a5e5-f45338ceb4d3", "ip_address": "172.24.4.227"}],
    "id": "5212d40a-c2f5-4a5d-ad18-694658047654",
    "security_groups": ["9bf6f19a-ba4a-470f-b8ce-28c9ad66556c"],
    "device_id": "zvm2"
  }
  ]
}

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


loading table of contents...