功能介紹
給 云服務(wù)器 添加一張或多張網(wǎng)卡。
本接口為異步接口，當(dāng)前批量添加云服務(wù)器網(wǎng)卡請(qǐng)求下發(fā)成功后會(huì)返回job_id，此時(shí)批量添加云服務(wù)器網(wǎng)卡并沒有立即完成，需要通過調(diào)用查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢job狀態(tài)，當(dāng)Job狀態(tài)為 SUC CES S 時(shí)代表云服務(wù)器網(wǎng)卡批量添加成功。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/cloudservers/{server_id}/nics
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請(qǐng)參見獲取項(xiàng)目ID。 |
|
server_id |
是 |
云服務(wù)器ID。 |
請(qǐng)求消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
subnet_id |
是 |
String |
云服務(wù)器添加網(wǎng)卡的信息。 需要指定已創(chuàng)建的網(wǎng)絡(luò)（network）的ID，UUID格式。 |
|
security_groups |
否 |
Array of objects |
|
|
ip_address |
否 |
String |
IP地址，無該參數(shù)表示自動(dòng)分配IP地址。 |
|
ipv6_enable |
否 |
Boolean |
是否支持ipv6。 取值為true時(shí)，標(biāo)識(shí)此網(wǎng)卡支持ipv6。 |
|
ipv6_bandwidth |
否 |
Object |
綁定的共享帶寬信息，詳情請(qǐng)參見ipv6_bandwidth字段數(shù)據(jù)結(jié)構(gòu)說明。 |
響應(yīng)消息
請(qǐng)參考響應(yīng)（任務(wù)類）。
請(qǐng)求示例
添加網(wǎng)絡(luò)ID為“d32019d3-bc6e-4319-9c1d-6722fc136a23”，安全組ID為“f0ac4394-7e4a-4409-9701-ba8be283dbc3”的網(wǎng)卡至云服務(wù)器。
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"
}
]
}
]
}
響應(yīng)示例
{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
返回值
請(qǐng)參考通用請(qǐng)求返回值。
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
