| Method | URI | Description |
|---|---|---|
| GET | /v2.0/ports/{port_id} | Shows information for a specified port. |
Normal response codes: 200
Error response codes: unauthorized (401), itemNotFound (404)
This table shows the URI parameters for the show port request:
| Name | Type | Description |
|---|---|---|
| UUID | The UUID for the port of interest to you. |
This operation does not require a request body.
Example 3.42. Show port: JSON response
{
"ports":[
{
"status":"ACTIVE",
"binding:host_id":"devstack-havana",
"name":"vip-a54bc6e7-2e28-4c55-a676-6146a4c0f8b9",
"allowed_address_pairs":[
],
"admin_state_up":true,
"network_id":"d32019d3-bc6e-4319-9c1d-6722fc136a22",
"tenant_id":"4fd44f30292945e481c7b8a0c8908869",
"extra_dhcp_opts":[
],
"binding:vif_type":"ovs",
"device_owner":"neutron:LOADBALANCER",
"binding:capabilities":{
"port_filter":true
},
"mac_address":"fa:16:3e:47:57:a0",
"fixed_ips":[
{
"subnet_id":"54d6f61d-db07-451c-9ab3-b9609b6b6f0b",
"ip_address":"192.0.0.3"
}
],
"id":"36242e87-0bae-49d7-bc59-a0867476c69a",
"security_groups":[
"d30c3c54-5dba-49cf-a323-48a86f078d2d"
],
"device_id":"56016959-08ad-566c-8533-6240aff17dd5"
},
{
"status":"DOWN",
"binding:host_id":"",
"name":"my_port",
"allowed_address_pairs":[
],
"admin_state_up":true,
"network_id":"d32019d3-bc6e-4319-9c1d-6722fc136a22",
"tenant_id":"4fd44f30292945e481c7b8a0c8908869",
"extra_dhcp_opts":[
],
"binding:vif_type":"unbound",
"device_owner":"",
"binding:capabilities":{
"port_filter":false
},
"mac_address":"fa:16:3e:6c:e8:35",
"fixed_ips":[
],
"id":"41064069-24d6-46e8-9b5a-6da327e357b3",
"security_groups":[
"d30c3c54-5dba-49cf-a323-48a86f078d2d"
],
"device_id":""
},
{
"status":"DOWN",
"binding:host_id":"",
"name":"",
"allowed_address_pairs":[
],
"admin_state_up":true,
"network_id":"ee2d3158-3e80-4fb3-ba87-c99f515d85e7",
"tenant_id":"4fd44f30292945e481c7b8a0c8908869",
"extra_dhcp_opts":[
],
"binding:vif_type":"unbound",
"device_owner":"",
"binding:capabilities":{
"port_filter":false
},
"mac_address":"fa:16:3e:80:14:5b",
"fixed_ips":[
],
"id":"6f9f6319-ce4b-4267-a5f8-558d6795632d",
"security_groups":[
"d30c3c54-5dba-49cf-a323-48a86f078d2d"
],
"device_id":""
},
{
"status":"ACTIVE",
"binding:host_id":"devstack-havana",
"name":"",
"allowed_address_pairs":[
],
"admin_state_up":true,
"network_id":"d32019d3-bc6e-4319-9c1d-6722fc136a22",
"tenant_id":"4fd44f30292945e481c7b8a0c8908869",
"extra_dhcp_opts":[
],
"binding:vif_type":"ovs",
"device_owner":"network:dhcp",
"binding:capabilities":{
"port_filter":true
},
"mac_address":"fa:16:3e:3b:63:e8",
"fixed_ips":[
{
"subnet_id":"54d6f61d-db07-451c-9ab3-b9609b6b6f0b",
"ip_address":"192.0.0.2"
}
],
"id":"9842e9ab-7849-4bb5-8441-9fa223bfce45",
"security_groups":[
],
"device_id":"dhcp56016959-08ad-566c-8533-6240aff17dd5-d32019d3-bc6e-4319-9c1d-6722fc136a22"
},
{
"status":"ACTIVE",
"binding:host_id":"devstack-havana",
"name":"",
"allowed_address_pairs":[
],
"admin_state_up":true,
"network_id":"db193ab3-96e3-4cb3-8fc5-05f4296d0324",
"tenant_id":"26a7980765d0414dbc1fc1f88cdb7e6e",
"extra_dhcp_opts":[
],
"binding:vif_type":"ovs",
"device_owner":"network:dhcp",
"binding:capabilities":{
"port_filter":true
},
"mac_address":"fa:16:3e:f7:80:62",
"fixed_ips":[
{
"subnet_id":"08eae331-0402-425a-923c-34f7cfe39c1b",
"ip_address":"10.0.0.3"
}
],
"id":"d2159251-552f-47ae-9960-f80d2aa6864f",
"security_groups":[
],
"device_id":"dhcp56016959-08ad-566c-8533-6240aff17dd5-db193ab3-96e3-4cb3-8fc5-05f4296d0324"
}
]
}Example 3.43. Show port: XML response
<?xml version='1.0' encoding='UTF-8'?>
<ports xmlns="http://openstack.org/quantum/api/v2.0" xmlns:binding="http://docs.openstack.org/ext/binding/api/v1.0" xmlns:quantum="http://openstack.org/quantum/api/v2.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<port>
<status>ACTIVE</status>
<name />
<admin_state_up quantum:type="bool">True</admin_state_up>
<network_id>ebda9658-093b-41ba-80ce-0cf8cb8365d4</network_id>
<tenant_id>63878e4c5dd649d2a980e37aefddfa87</tenant_id>
<binding:vif_type>ovs</binding:vif_type>
<device_owner>compute:None</device_owner>
<binding:capabilities>
<port_filter quantum:type="bool">False</port_filter>
</binding:capabilities>
<mac_address>fa:16:3e:b9:ef:05</mac_address>
<fixed_ips>
<fixed_ip>
<subnet_id>aca4d43c-c48c-4a2c-9bb6-ba374ef7e135</subnet_id>
<ip_address>172.24.4.227</ip_address>
</fixed_ip>
</fixed_ips>
<id>664ebd1a-facd-4c20-948c-07a784475ab0</id>
<device_id>f288bb5f-920d-4276-8345-2c0319c16f58</device_id>
</port>
<port>
<status>DOWN</status>
<name />
<admin_state_up quantum:type="bool">True</admin_state_up>
<network_id>ebda9658-093b-41ba-80ce-0cf8cb8365d4</network_id>
<tenant_id />
<binding:vif_type>ovs</binding:vif_type>
<device_owner>network:router_gateway</device_owner>
<binding:capabilities>
<port_filter quantum:type="bool">False</port_filter>
</binding:capabilities>
<mac_address>fa:16:3e:4a:3a:a2</mac_address>
<fixed_ips>
<fixed_ip>
<subnet_id>aca4d43c-c48c-4a2c-9bb6-ba374ef7e135</subnet_id>
<ip_address>172.24.4.226</ip_address>
</fixed_ip>
</fixed_ips>
<id>c5ca7017-c390-4ccc-8cd7-333747e57fef</id>
<device_id>0dc517bf-9169-4aa6-88b7-569219962881</device_id>
</port>
<port>
<status>ACTIVE</status>
<name />
<admin_state_up quantum:type="bool">True</admin_state_up>
<network_id>9d83c053-b0a4-4682-ae80-c00df269ce0a</network_id>
<tenant_id>625887121e364204873d362b553ab171</tenant_id>
<binding:vif_type>ovs</binding:vif_type>
<device_owner>network:router_interface</device_owner>
<binding:capabilities>
<port_filter quantum:type="bool">False</port_filter>
</binding:capabilities>
<mac_address>fa:16:3e:2d:dc:7e</mac_address>
<fixed_ips>
<fixed_ip>
<subnet_id>a318fcb4-9ff0-4485-b78c-9e6738c21b26</subnet_id>
<ip_address>10.0.0.1</ip_address>
</fixed_ip>
</fixed_ips>
<id>d7815f5b-a228-47bb-a5e5-f139c4e476f6</id>
<device_id>0dc517bf-9169-4aa6-88b7-569219962881</device_id>
</port>
<port>
<status>ACTIVE</status>
<name />
<admin_state_up quantum:type="bool">True</admin_state_up>
<network_id>9d83c053-b0a4-4682-ae80-c00df269ce0a</network_id>
<tenant_id>625887121e364204873d362b553ab171</tenant_id>
<binding:vif_type>ovs</binding:vif_type>
<device_owner>network:dhcp</device_owner>
<binding:capabilities>
<port_filter quantum:type="bool">False</port_filter>
</binding:capabilities>
<mac_address>fa:16:3e:73:6d:1c</mac_address>
<fixed_ips>
<fixed_ip>
<subnet_id>a318fcb4-9ff0-4485-b78c-9e6738c21b26</subnet_id>
<ip_address>10.0.0.2</ip_address>
</fixed_ip>
</fixed_ips>
<id>f8639521-fab2-4879-94b2-83a47bee8a26</id>
<device_id>dhcpe1b8334f-9be9-5e49-aeee-b31e6df6c847-9d83c053-b0a4-4682-ae80-c00df269ce0a</device_id>
</port>
</ports>
This operation does not return a response body.
