Querying NICs of an ECS
Function
This API is used to query NICs of an ECS based on the NIC ID.
URI
GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id}
Table 1 describes the parameters in the URI.
Parameter | Mandatory | Description |
---|---|---|
project_id | Yes | Specifies the project ID. For details about how to obtain the ID, see Obtaining a Project ID. |
server_id | Yes | Specifies the ECS ID. |
id | Yes | Specifies the port ID of the NIC. |
Request
None
Response
Table 2 describes the response parameters.
Parameter | Type | Description |
---|---|---|
interfaceAttachment | Object | Specifies ECS NICs. For details, see Table 3. |
Parameter | Type | Description |
---|---|---|
port_state | String | Specifies the NIC port status. |
fixed_ips | Array of objects | Specifies IP addresses for NICs. For details, see Table 4. |
net_id | String | Specifies the network ID to which the NIC port belongs. |
port_id | String | Specifies the ID of the NIC port. |
mac_addr | String | Specifies the MAC address of the NIC. |
Parameter | Type | Description |
---|---|---|
subnet_id | String | Specifies the ID of the subnet used by the NIC. |
ip_address | String | Specifies the NIC IP address. |
Example Request
GET https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface/{id}
Example Response
{"interfaceAttachment":{"port_state": "ACTIVE","fixed_ips": [{"subnet_id": "f8a6e8f8-c2ec-497c-9f23-da9616de54ef","ip_address": "192.168.1.3"}],"net_id": "3cb9bc59-5699-4588-a4b1-b87f96708bc6","port_id": "ce531f90-199f-48c0-816c-13e38010b442","mac_addr": "fa:16:3e:4c:2c:30"}}
Returned Values
- Function
- URI
- Request
- Response
- Example Request
- Example Response
- Returned Values