功能介紹
為 裸金屬服務(wù)器 綁定一張或多張彈性網(wǎng)卡。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/baremetalservers/{server_id}/nics
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項目ID。 獲取方式請參見獲取項目ID。 |
|
server_id |
是 |
裸金屬服務(wù)器ID。 可以從裸金屬服務(wù)器控制臺查詢，或者通過調(diào)用查詢裸金屬服務(wù)器列表（OpenStack原生）API獲取。 |
請求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
nics |
是 |
Array of objects |
需要綁定的網(wǎng)卡參數(shù)列表，詳情請參見表2。 約束： 當(dāng)前不支持10個網(wǎng)卡以上的并發(fā)掛載。10個以上并發(fā)掛載時，掛載可能失敗。 |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
subnet_id |
是 |
String |
網(wǎng)卡的子網(wǎng)ID。 網(wǎng)絡(luò)（network）的ID可以從控制臺或者參考《 虛擬私有云 API參考》的“查詢子網(wǎng)列表”章節(jié)獲取，UUID格式。 約束：
|
|
security_groups |
否 |
Array of objects |
約束： 僅在指定subnet_id時生效，當(dāng)使用subnet_id跨租戶掛網(wǎng)卡時，此字段必填。 |
|
ip_address |
否 |
String |
IP地址。無該參數(shù)表示自動分配IP地址。 約束： 僅在指定subnet_id時生效。 |
請求示例
{
"nics": [
{
"subnet_id": "d32019d3-bc6e-4319-9c1d-6722fc136a23",
"security_groups": [
{
"id": "f0ac4394-7e4a-4409-9701-ba8be283dbc3"
}
]
}
]
}
響應(yīng)參數(shù)
響應(yīng)參數(shù)如下：
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
job_id |
String |
提交任務(wù)成功后返回的任務(wù)ID，用戶可以使用該ID對任務(wù)執(zhí)行情況進行查詢。 如何根據(jù)job_id來查詢Job的執(zhí)行狀態(tài)，請參考查詢Job狀態(tài)。 |
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
error |
字典數(shù)據(jù)結(jié)構(gòu) |
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
message |
String |
任務(wù)異常錯誤信息描述。 |
|
code |
String |
任務(wù)異常錯誤信息編碼。 |
響應(yīng)示例
- 正常響應(yīng)
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
錯誤碼
請參考錯誤碼。
