# 裸金属服务器绑定弹性网卡 - AddServerNics #### 功能介绍 为裸金属服务器绑定一张或多张弹性网卡。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/BMS/doc?api=AddServerNics)中调试该接口。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-bms/bms_api_0900.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | bms:servers:addNics | write | instance\* | - g:EnterpriseProjectId - g:ResourceTag/\ - bms:SubnetId - eip:AssociatePublicIp | - | - | #### URI POST /v1/{project_id}/baremetalservers/{server_id}/nics 参数说明请参见[表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)获取。 | #### 请求参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | nics | 是 | Array of objects | 需要绑定的网卡参数列表，详情请参见[表2]。 约束： 当前不支持10个网卡以上的并发挂载。10个以上并发挂载时，挂载可能失败。 | 表2nics字段数据结构说明 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | subnet_id | 是 | String | 网卡的子网ID。 网络（network）的ID可以从控制台或者参考《虚拟私有云API参考》的"[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)"章节获取，UUID格式。 约束： - 指定subnet_id绑定网卡时，网卡带宽下限默认值是quota:min_rate。 - 指定subnet_id绑定网卡时，队列个数默认值是quota:vif_multiqueue_num。 - quota:min_rate和quota:vif_multiqueue_num可参见[查询裸金属服务器规格extra_specs参数的详情（废弃）](https://support.huaweicloud.com/api-bms/bms_api_0728.html)查询。 | | security_groups | 否 | Array of objects | 网卡的安全组信息，详情请参见[表3]。 约束： 仅在指定subnet_id时生效，当使用subnet_id跨租户挂网卡时，此字段必填。 | | ip_address | 否 | String | IP地址。无该参数表示自动分配IP地址。 约束： 仅在指定subnet_id时生效。 | 表3security_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" } ] } ] } ``` #### 响应参数 表4正常响应要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | job_id | String | 提交任务成功后返回的任务ID，用户可以使用该ID对任务执行情况进行查询。 如何根据job_id来查询Job的执行状态，请参考[查询Job状态 - ShowJobInfos](https://support.huaweicloud.com/api-bms/bms_api_0640.html)。 | 表5异常响应要素说明 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | error | 字典数据结构 | 提交任务异常时返回的异常信息，详情请参见[表6]。 | 表6error数据结构 | 名称 | 参数类型 | 说明 | |:---|:---|:---| | message | String | 任务异常错误信息描述。 | | code | String | 任务异常错误信息编码。 | #### 响应示例 - 正常响应 ``` { "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" } ``` #### 返回值 正常返回值： | 返回值 | 说明 | |:---|:---| | 200 | 服务器已成功处理了请求。 | 其他返回值请参考[状态码](https://support.huaweicloud.com/api-bms/bms_api_0801.html)。 #### 错误码 请参考[错误码](https://support.huaweicloud.com/api-bms/bms_api_0802.html)。