Querying a Port
Function
This API is used to query a single port.
URI
GET /v1/{project_id}/ports/{port_id}
Table 1 describes the parameters.
Parameter | Mandatory | Description |
---|---|---|
project_id | Yes | Specifies the project ID. For details about how to obtain a project ID, see Obtaining a Project ID. |
port_id | Yes | Specifies the port ID that uniquely identifies the port. |
Request Parameters
None
Example Request
GET https://{Endpoint}/v1/{project_id}/ports/d00f9c13-412f-4855-8af3-de5d8c24cd60
Response Parameters
Parameter | Type | Description |
---|---|---|
id | String | Specifies the port ID that uniquely identifies the port. |
name | String |
|
network_id | String |
|
admin_state_up | Boolean |
|
mac_address | String |
|
fixed_ips | Array of fixed_ip objects |
|
device_id | String |
|
device_owner | String |
|
tenant_id | String | Specifies the project ID. |
status | String |
|
security_groups | Array of strings | Specifies the security group UUID (extended attribute). |
allowed_address_pairs | Array of allowed_address_pairs objects |
|
extra_dhcp_opts | Array of extra_dhcp_opt objects | Specifies the extended option (extended attribute) of DHCP. For details, see Table 6. |
binding:vif_details | binding:vif_details object | For details, see Table 7. |
binding:profile | Object | Specifies the user-defined settings. This is an extended attribute. Note:
|
binding:vnic_type | String |
|
instance_id | String |
|
instance_type | String |
|
port_security_enabled | Boolean |
|
ipv6_bandwidth_id | String |
|
Parameter | Type | Description |
---|---|---|
subnet_id | String |
|
ip_address | String | Specifies the port IP address. |
Parameter | Type | Description |
---|---|---|
ip_address | String |
|
mac_address | String | Specifies the MAC address. By default, the MAC address of the local port is used. |
Parameter | Type | Description |
---|---|---|
opt_name | String | Specifies the name of the DHCP option. The value of this parameter can only be 51, indicating the DHCP lease time. |
opt_value | String |
|
Parameter | Type | Description |
---|---|---|
primary_interface | Boolean | If the value is true, this is the primary NIC. |
port_filter | Boolean | Specifies the port used for filtering in security groups to protect against MAC or IP spoofing. |
ovs_hybrid_plug | Boolean | Specifies that OVS hybrid plug should be used by Nova APIs. |
Example Response
{"port": {"id": "d00f9c13-412f-4855-8af3-de5d8c24cd60","name": "test","status": "DOWN","admin_state_up": "true","fixed_ips": [{"subnet_id": "70f2e74b-e660-410a-b754-0ca46744348a","ip_address": "10.128.1.10"}],"mac_address": "fa:16:3e:d7:f2:6c","network_id": "5b808927-13c9-4e60-a4f4-ed6ffe225167","tenant_id": "43f2d1cca56a40729dcb17212482f34d","device_id": "","device_owner": "","security_groups": ["02b4e8ee-74fa-4a31-802e-5490df11245e"],"extra_dhcp_opts": [],"allowed_address_pairs": [],"binding:vnic_type": "normal","instance_type": "RDS","instance_id": "03a4e9ee-64eb-4a31-802e-5490df22146c"}}
Status Code
See Status Codes.
Error Code
See Error Codes.
- Function
- URI
- Request Parameters
- Example Request
- Response Parameters
- Example Response
- Status Code
- Error Code