更新时间：2023-08-03 GMT+08:00
批量添加云服务器网卡
功能介绍
给云服务器添加一张或多张网卡。
本接口为异步接口，当前批量添加云服务器网卡请求下发成功后会返回job_id，此时批量添加云服务器网卡并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为 SUCCESS 时代表云服务器网卡批量添加成功。
URI
POST /v1/{project_id}/cloudservers/{server_id}/nics
请求消息
请求参数如表2所示。
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
subnet_id |
是 |
String |
云服务器添加网卡的信息。 需要指定已创建的网络（network）的ID，UUID格式。 |
|
security_groups |
否 |
Array of objects |
添加网卡的安全组信息，详情请参见表4。 |
|
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": "ff80808288d41e1b018990260955686a"
}
返回值
请参考通用请求返回值。
错误码
请参考错误码。
父主题： 网卡管理
