
# 查询云服务器网卡信息（废弃） - NovaListServerInterfaces
#### 功能介绍
查询云服务器网卡信息。
当前API已废弃，请使用[查询云服务器网卡信息 - ListServerInterfaces](https://support.huaweicloud.com/api-ecs/ecs_02_0505.html)。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=NovaListServerInterfaces)中调试该接口。
#### URI
GET /v2.1/{project_id}/servers/{server_id}/os-interface
参数说明请参见[表1]。
 表1参数说明 
| 参数         | 是否必选 | 描述                                                                                                                      |
|:---|:---|:---|
| project_id | 是    | 项目ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-ecs/ecs_01_0016.html)。 |
| server_id  | 是    | 云服务器ID                                                                                                                  |
   
#### 请求消息
无
#### 响应消息
响应参数如[表2]所示。
 表2响应参数 
| 参数                   | 参数类型             | 描述                                                               |
|:---|:---|:---|
| interfaceAttachments | Array of objects | 云服务器网卡信息列表，详情请参见[表3]。 |
   
 表3interfaceAttachments字段数据结构说明 
| 参数         | 参数类型             | 描述                                                               |
|:---|:---|:---|
| port_state | String           | 网卡端口状态。                                                          |
| fixed_ips  | Array of objects | 网卡私网IP信息列表，详情请参见[表4]。 |
| net_id     | String           | 网卡端口所属网络ID（network_id）。                                          |
| port_id    | String           | 网卡端口ID。                                                          |
| mac_addr   | String           | 网卡Mac地址信息。                                                       |
   
 表4fixed_ips字段数据结构说明 
| 参数         | 参数类型   | 描述            |
|:---|:---|:---|
| subnet_id  | String | 网卡私网IP对应子网信息。 |
| ip_address | String | 网卡私网IP信息。     |
   
#### 请求示例
查询指定云服务器网卡信息。
```
GET https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface
```
#### 响应示例
```
{
    "interfaceAttachments": [
        {
            "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"
        }
    ]
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。
