批量添加云服务器网卡
功能介绍
给云服务器添加一张或多张网卡。
本接口为异步接口，当前批量添加云服务器网卡请求下发成功后会返回job_id，此时批量添加云服务器网卡并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUCCESS 时代表云服务器网卡批量添加成功。
接口约束
在网卡添加成功以前，禁止对添加中的网卡进行卸载、删除等操作。
调试
您可以在API Explorer中调试该接口。
URI
POST /v1/{project_id}/cloudservers/{server_id}/nics
请求消息
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
subnet_id |
否 |
String |
云服务器添加网卡的信息。 需要指定已创建的网络（network）的ID，UUID格式。 |
|
security_groups |
否 |
Array of objects |
添加网卡的安全组信息，详情请参见表4。 |
|
ip_address |
否 |
String |
IP地址，无该参数表示自动分配IP地址。 |
|
port_id |
否 |
String |
网卡ID，UUID格式。 当该字段不为空时，表示挂载指定的网卡。port_id和subnet_id不能同时为空。 网卡ID可以从虚拟私有云的“查询端口列表”章节查询到。 约束： 网卡状态必须为DOWN 当port_id和subnet_id同时存在的时候，优先使用port_id。 当选择port_id不为空时，代表此时使用的是弹性网卡，此时security_groups和ip_address等参数不生效。 |
|
ipv6_enable |
否 |
Boolean |
是否支持ipv6。 取值为true时，标识此网卡支持ipv6。 |
|
ipv6_bandwidth |
否 |
Object |
绑定的共享带宽信息，详情请参见ipv6_bandwidth字段数据结构说明。 |
响应消息
请参考响应（任务类）。
请求示例
添加网络ID为“d32019d3-bc6e-4319-9c1d-6722fc136a23”，安全组ID为“f0ac4394-7e4a-4409-9701-ba8be283dbc3”的网卡至云服务器。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/nics
{
"nics": [
{
"subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23",
"security_groups": [
{
"id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
}
]
}
]
}
响应示例
{
"job_id": "ff80808288d41e1b018990260955686a"
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
