查询云服务器网卡信息ListServerInterfaces
功能介绍
查询 云服务器 网卡信息。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/cloudservers/{server_id}/os-interface
请求消息
无
响应消息
响应参数如表2所示。
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
port_state |
String |
网卡端口状态。 |
|
fixed_ips |
Array of objects |
|
|
net_id |
String |
网卡端口所属网络ID（network_id）。 |
|
port_id |
String |
网卡端口ID。 |
|
mac_addr |
String |
网卡Mac地址信息。 |
|
delete_on_termination |
Boolean |
卸载网卡时，是否删除网卡。 true: 删除； false: 不删除 |
|
driver_mode |
String |
从guest os中，网卡的驱动类型。可选值为virtio和hinic，默认为virtio。 |
|
min_rate |
Integer |
网卡带宽下限。 |
|
multiqueue_num |
Integer |
队列个数。 取值范围为 1, 2, 4, 8, 16，28。 |
|
pci_address |
String |
弹性网卡在Linux GuestOS里的BDF号。 说明：
网卡不支持时，返回为空。 |
请求示例
查询云服务器网卡信息。
GET https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/os-interface
响应示例
{
"interfaceAttachments": [
{
"port_state": "ACTIVE",
"fixed_ips": [
{
"subnet_id": "ba31e1f5-fa76-4530-862c-5176fad033cf",
"ip_address": "192.168.0.33"
}
],
"net_id": "610a4af2-1d90-4d2b-8057-dc238b26febf",
"port_id": "04819c0a-6a07-44b6-945e-fb932071888e",
"mac_addr": "fa:16:3e:45:65:c4"
}
]
}
返回值
请参考通用请求返回值。
