# 查询指定裸金属服务器网卡信息（废弃）
#### 功能介绍
根据网卡ID，查询裸金属服务器网卡信息。
当前API已废弃，请使用"[查询裸金属服务器网卡信息 - ShowBaremetalServerInterfaceAttachments](https://support.huaweicloud.com/api-bms/bms_api_0621.html)"。
#### URI
GET /v2.1/{project_id}/servers/{server_id}/os-interface/{id}
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                                                                 |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-bms/bms_api_appendix_03.html)。                                                 |
| server_id  | 是    | 裸金属服务器ID。 可以从裸金属服务器控制台查询，或者通过调用[查询裸金属服务器列表（废弃）](https://support.huaweicloud.com/api-bms/bms_api_0709.html)获取。                       |
| id         | 是    | 网卡ID。 可以在裸金属服务器详情页面"网卡"页签中查看；也可以通过[查询裸金属服务器网卡信息（废弃）](https://support.huaweicloud.com/api-bms/bms_api_0730.html)API获取，对应的是参数"port_id"的取值。 |
   
#### 请求参数
无
#### 请求示例
查询ID为95bf2490-5428-432c-ad9b-5e3406f869dd的裸金属服务器上ID为ce531f90-199f-48c0-816c-13e38010b442的网卡信息。
```
GET https://{ECS Endpoint}/v2.1/c685484a8cc2416b97260938705deb65/servers/95bf2490-5428-432c-ad9b-5e3406f869dd/os-interface/ce531f90-199f-48c0-816c-13e38010b442
```
#### 响应参数
| 参数                  | 参数类型   | 描述                                                    |
|:---|:---|:---|
| interfaceAttachment | Object | 裸金属服务器网卡信息列表，详情请参见[表2]。 |
   
 表2interfaceAttachment字段数据结构说明 
| 参数         | 参数类型             | 描述                                                |
|:---|:---|:---|
| 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地址信息。                                        |
   
 表3fixed_ips字段数据结构说明 
| 参数         | 参数类型   | 描述                          |
|:---|:---|:---|
| subnet_id  | String | 网卡私网IP对应子网的子网ID（subnet_id）。 |
| ip_address | String | 网卡IP地址。                     |
   
#### 响应示例
```
{
    "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"
    }
}
```
#### 返回值
正常返回值：
| 返回值 | 说明           |
|:---|:---|
| 200 | 服务器已成功处理了请求。 |
   
其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。
#### 错误码
请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。