# 添加云服务器网卡（废弃） - NovaAttachInterface
#### 功能介绍
给云服务器添加一张网卡。
添加云服务器网卡应用示例请参考[弹性云服务器挂载网卡](https://support.huaweicloud.com/api-ecs/ecs_04_0005.html)。
当前API已废弃，请使用[批量添加云服务器网卡 - BatchAddServerNics](https://support.huaweicloud.com/api-ecs/ecs_02_0501.html)。
#### 调试
您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=ECS&api=NovaAttachInterface)中调试该接口。
#### URI
POST /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请求参数 
| 参数                  | 是否必选 | 参数类型   | 描述                                                                |
|:---|:---|:---|:---|
| interfaceAttachment | 是    | Object | 需要添加的网卡参数列表，详情请参见[表3]。 |
   
 表3interfaceAttachment字段数据结构说明 
| 参数        | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| port_id   | 否    | String           | Port ID。 port_id和net_id不能同时传入。                                                                                                                                                                                      |
| net_id    | 否    | String           | Network ID。 port_id和net_id不能同时传入。                                                                                                                                                                                   |
| fixed_ips | 否    | Array of objects | 私有IP。 使用port_id时，不能指定该参数。 该参数必须与net_id配合使用。 只有列表中第一个元素有效。传入两个及以上元素会报错。详情请参见[表4]。 |
   
 表4fixed_ips字段数据结构说明 
| 参数         | 是否必选 | 参数类型   | 描述    |
|:---|:---|:---|:---|
| ip_address | 否    | String | IP地址。 |
   
#### 响应消息
响应参数如[表5]所示。
 表5响应参数 
| 参数                  | 参数类型   | 描述                                                               |
|:---|:---|:---|
| interfaceAttachment | Object | 云服务器网卡信息列表，详情请参见[表6]。 |
   
 表6interfaceAttachment字段数据结构说明 
| 参数         | 参数类型             | 描述                                                                 |
|:---|:---|:---|
| port_state | String           | 端口状态。                                                              |
| fixed_ips  | Array of objects | 网卡IP信息列表，请参见[表7]。 |
| port_id    | String           | Port ID。                                                           |
| net_id     | String           | Network ID。                                                        |
| mac_addr   | String           | Mac地址。                                                             |
   
 表7fixed_ips字段数据结构说明 
| 参数         | 参数类型   | 描述        |
|:---|:---|:---|
| subnet_id  | String | 网卡所属子网ID。 |
| ip_address | String | 网卡IP地址。   |
   
#### 请求示例
- 为指定云服务器添加一张网卡，Network ID为"3cb9bc59-5699-4588-a4b1-b87f96708bc6"。
  ```
  POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface
  {
      "interfaceAttachment" : {
          "fixed_ips" : [ 
              {
                  "ip_address" : "192.168.1.3"
              } 
           ],
      "net_id" : "3cb9bc59-5699-4588-a4b1-b87f96708bc6"
      }
  }
  ```
  
- 为指定云服务器添加一张网卡，Port ID为"ce531f90-199f-48c0-816c-13e38010b442"。
  ```
  POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-interface
  {
      "interfaceAttachment" : {
          "fixed_ips" : [ 
              {
                  "ip_address" : "192.168.1.3"
              } 
           ],
      "port_id" : "ce531f90-199f-48c0-816c-13e38010b442"
      }
  }
  ```
  
 
#### 响应示例
```
{
    "interfaceAttachment": {
        "port_state": "DOWN",
        "fixed_ips": [
            {
                "subnet_id": "d9cfef77-0151-4c2a-9ed5-d951ada8adf3",
                "ip_address": "10.0.1.11"
            }
        ],
        "port_id": " ce531f90-199f-48c0-816c-13e38010b442",
        "net_id": "0dc714fa-9022-4a03-bb22-9821a396bb9d",
        "mac_addr": "fa:16:3e:63:75:b2"
    }
}
```
#### 返回值
请参考[通用请求返回值](https://support.huaweicloud.com/api-ecs/ecs_07_0001.html)。