功能介紹
給 云服務(wù)器 添加一張或多張網(wǎng)卡。
本接口為異步接口，當前批量添加云服務(wù)器網(wǎng)卡請求下發(fā)成功后會返回job_id，此時批量添加云服務(wù)器網(wǎng)卡并沒有立即完成，需要通過調(diào)用查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢job狀態(tài)，當Job狀態(tài)為 SUC CES S 時代表云服務(wù)器網(wǎng)卡批量添加成功。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
請求消息
請求參數(shù)如表2所示。
|
參數(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ù)表示自動分配IP地址。 |
|
ipv6_enable |
否 |
Boolean |
是否支持ipv6。 取值為true時，標識此網(wǎng)卡支持ipv6。 |
|
ipv6_bandwidth |
否 |
Object |
綁定的共享帶寬信息，詳情請參見ipv6_bandwidth字段數(shù)據(jù)結(jié)構(gòu)說明。 |
響應(yī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"
}
返回值
請參考通用請求返回值。
錯誤碼
請參考錯誤碼。
猜你喜歡
