批量添加云服务器网卡BatchAddServerNics
.jpg)
.jpg)
.jpg)
.jpg)
功能介绍
给 云服务器 添加一张或多张网卡。
本接口为异步接口，当前批量添加 云服务 器网卡请求下发成功后会返回job_id，此时批量添加云服务器网卡并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUC CES S 时代表云服务器网卡批量添加成功。
调试
您可以在API Explorer中调试该接口。
请求消息
请求参数如表2所示。
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
subnet_id |
是 |
String |
云服务器添加网卡的信息。 需要指定已创建的网络（network）的ID，UUID格式。 |
|
security_groups |
否 |
Array of objects |
|
|
ip_address |
否 |
String |
IP地址，无该参数表示自动分配IP地址。 |
|
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": "70a599e0-31e7-49b7-b260-868f441e862b"
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
