查询指定云服务器网卡信息NovaShowServerInterface
.jpg)
.jpg)
.jpg)
.jpg)
接口说明
根据网卡ID,查询 云服务器 网卡信息。
约束说明
无
URL
GET https://ecs.cn-north-1.myhuaweicloud.com/v2.1/{project_id}/servers/{server_id}/os-interface/{port_id}
请求参数
| 名称 | 类型 | IN | 必选 | 描述 |
|---|---|---|---|---|
|
X-Auth-Token
|
string | header | 是 |
用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 |
|
port_id
|
string | path | 是 |
网卡port id |
|
project_id
|
string | path | 是 |
项目ID。 |
|
server_id
|
string | path | 是 |
云服务器ID。 |
返回参数
返回码: 200
OK
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
interfaceAttachment
|
NovaServerInterfaceDetail object | 是 |
云服务器网卡信息。 |
200 interfaceAttachment
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
fixed_ips
|
Array of NovaServerInterfaceFixedIp objects | 是 |
网卡私网IP信息列表。 |
|
mac_addr
|
string | 是 |
网卡Mac地址信息。 |
|
net_id
|
string | 是 |
网卡端口所属网络ID。 |
|
port_id
|
string | 是 |
网卡端口ID。 |
|
port_state
|
string | 是 |
网卡端口状态。 |
200 interfaceAttachment.fixed_ips
| 名称 | 类型 | 必选 | 描述 |
|---|---|---|---|
|
ip_address
|
string | 是 |
网卡私网IP信息。 |
|
subnet_id
|
string | 是 |
网卡私网IP对应子网信息。 |
请求示例
示例 1
"GET https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface/{id}"
返回示例
返回码：200
OK
示例 1
{
"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"
}
}
"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"
}
}
错误码
请参考 错误码说明。
