-
响应示例 1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16 {
"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"
}
]
}
-
响应参数 参数 参数类型 描述 interfaceAttachments Array of objects 裸金属服务器网卡信息列表，详情请参见表2。 表2 interfaceAttachments字段数据结构说明 参数 参数类型 描述 port_state String 网卡端口状态。取值为：ACTIVE、BUILD、DOWN fixed_ips Array of objects 网卡私网IP信息列表，详情请参见表3。 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号。 表3 fixed_ips字段数据结构说明 参数 参数类型 描述 subnet_id String 网卡私网IP对应子网的子网ID（subnet_id）。 ip_address String 网卡私网IP信息。
-
请求示例 查询ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器上ID为ce531f90-199f-48c0-816c-13e38010b442的网卡信息。 1 GET https://{E
CS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-interface/ce531f90-199f-48c0-816c-13e38010b442
-
响应示例 1
2
3
4
5
6
7
8
9
10
11
12
13
14 {
"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"
}
}
-
URI GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id} 参数说明请参见表1。 表1 参数说明 参数 是否必选 描述 project_id 是 项目ID。 获取方式请参见获取项目ID。 server_id 是 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用查询裸金属服务器列表（废弃）获取。 id 是 网卡ID。 可以在裸金属服务器详情页面“网卡”页签中查看；也可以通过查询裸金属服务器网卡信息（废弃）API获取，对应的是参数“port_id”的取值。
-
响应参数 参数 参数类型 描述 interfaceAttachment Object 裸金属服务器网卡信息列表，详情请参见表2。 表2 interfaceAttachment字段数据结构说明 参数 参数类型 描述 port_state String 网卡端口状态，取值为：ACTIVE、BUILD、DOWN。 fixed_ips Array of objects 网卡IP信息列表，详情请参见表3。 net_id String 网卡端口所属子网的网络ID（network_id）。 port_id String 网卡端口ID。 mac_addr String 网卡MAC地址信息。 表3 fixed_ips字段数据结构说明 参数 参数类型 描述 subnet_id String 网卡私网IP对应子网的子网ID（subnet_id）。 ip_address String 网卡IP地址。
-
响应参数 表4 正常响应要素说明 名称 参数类型 说明 job_id String 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考查询Job状态。 表5 异常响应要素说明 名称 参数类型 说明 error 字典数据结构 提交任务异常时返回的异常信息，详情请参见表6。 表6 error数据结构 名称 参数类型 说明 message String 任务异常错误信息描述。 code String 任务异常错误信息编码。
-
请求参数 参数 是否必选 参数类型 描述 nics 是 Array of objects 需要绑定的网卡参数列表，详情请参见表2。 约束： 当前不支持10个网卡以上的并发挂载。10个以上并发挂载时，挂载可能失败。 表2 nics字段数据结构说明 参数 是否必选 参数类型 描述 subnet_id 是 String 网卡的子网ID。 网络（network）的ID可以从控制台或者参考《虚拟私有云API参考》的“查询子网列表”章节获取，UUID格式。 约束： 指定subnet_id绑定网卡时，网卡带宽下限默认值是quota:min_rate。 指定subnet_id绑定网卡时，队列个数默认值是quota:vif_multiqueue_num。 quota:min_rate和quota:vif_multiqueue_num可参见查询裸金属服务器规格extra_specs参数的详情（废弃）查询。 security_groups 否 Array of objects 网卡的安全组信息，详情请参见表3。 约束： 仅在指定subnet_id时生效，当使用subnet_id跨租户挂网卡时，此字段必填。 ip_address 否 String IP地址。无该参数表示自动分配IP地址。 约束： 仅在指定subnet_id时生效。 表3 security_groups字段数据结构说明 参数 是否必选 参数类型 描述 id 是 String 安全组ID。
-
请求示例 绑定网卡，其中网卡的子网ID为d32019d3-bc6e-4319-9c1d-6722fc136a23，安全组ID为f0ac4394-7e4a-4409-9701-ba8be283dbc3。 { "nics": [ { "subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23", "security_groups": [ { "id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3" } ] } ]}
