功能介绍
查询 裸金属服务器 的网卡信息,比如网卡的IP地址、MAC地址。
调试
您可以在API Explorer中调试该接口。
URI
GET /v1/{project_id}/baremetalservers/{server_id}/os-interface
参数 |
是否必选 |
描述 |
---|---|---|
project_id |
是 |
项目ID。 获取方式请参见获取项目ID。 |
server_id |
是 |
裸金属服务器ID。 可以从裸金属服务器控制台查询,或者通过调用查询裸金属服务器列表(OpenStack原生)API获取。 |
请求参数
无
请求示例
GET https://{BMS Endpoint}/v1/c685484a8cc2416b97260938705deb65/baremetalservers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-interface
|
响应参数
参数 |
参数类型 |
描述 |
---|---|---|
port_state |
String |
网卡端口状态。取值为:ACTIVE、BUILD、DOWN |
fixed_ips |
Array of objects |
|
net_id |
String |
网卡端口所属子网的网络ID(network_id)。 |
port_id |
String |
网卡端口ID。 |
mac_addr |
String |
网卡MAC地址信息。 |
driver_mode |
String |
从guest os中,网卡的驱动类型。可选值为virtio和hinic,默认为virtio。 |
pci_address |
String |
弹性网卡在Linux GuestOS里的BDF号。 |
响应示例
{ "interfaceAttachments": [ { "port_state": "ACTIVE", "fixed_ips": [ { "subnet_id": "a5052101-11e1-4f3d-a5fa-f6ba6791219c", "ip_address": "192.168.1.147" } ], "net_id": "ad0fadbf-4bc1-472c-a030-5310e53b3818", "port_id": "bb585b04-f2a2-4528-9064-fd0aeb4e15a9", "mac_addr": "fa:16:3e:3b:58:fc" } ] } |
错误码
请参考错误码。