功能介紹
裸金屬服務(wù)器 創(chuàng)建成功后，如果發(fā)現(xiàn)磁盤不夠用或者當(dāng)前磁盤不滿足要求，可以將已有 云硬盤 掛載給裸金屬服務(wù)器，作為數(shù)據(jù)盤使用。
約束
- 不支持批量掛載。
- 單個(gè)裸金屬服務(wù)器最多掛載60塊云硬盤。
- 不支持掛載bootable的卷。
- 裸金屬服務(wù)器狀態(tài)（OS-EXT-STS:vm_state屬性）處于PAUSED狀態(tài)下不支持掛卷。
- 要掛載的卷必須是available狀態(tài)的卷或者共享卷。
- 僅支持掛載SCSI類型的卷。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/baremetalservers/{server_id}/attachvolume
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方式請(qǐng)參見獲取項(xiàng)目ID。 |
|
server_id |
是 |
裸金屬服務(wù)器ID。 可以從裸金屬服務(wù)器控制臺(tái)查詢，或者通過調(diào)用查詢裸金屬服務(wù)器列表（OpenStack原生）API獲取。 |
請(qǐng)求參數(shù)
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
volumeId |
是 |
String |
要掛卷的卷ID。 可以從云硬盤控制臺(tái)查詢，或者通過調(diào)用“查詢?cè)朴脖P列表”API獲取。 |
|
device |
否 |
String |
磁盤掛載點(diǎn)，如/dev/sda、/dev/sdb。 新增加的磁盤掛載點(diǎn)不能和已有的磁盤掛載點(diǎn)相同。 需要根據(jù)已有設(shè)備名稱順序指定，否則不寫device或device的值為""時(shí)，由系統(tǒng)自動(dòng)生成。 |
請(qǐng)求示例
POST https://{BMS Endpoint}/v1/bbf1946d374b44a0a2a95533562ba954/baremetalservers/cf2a8b97-b5c6-47ef-9714-eb27adf26e5b/attachvolume |
{ "volumeAttachment": { "volumeId": "b53f23bd-ee8f-49ec-9420-d1acfeaf91d6", "device": "" } } |
響應(yīng)參數(shù)
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
job_id |
String |
提交任務(wù)成功后返回的任務(wù)ID，用戶可以使用該ID對(duì)任務(wù)執(zhí)行情況進(jìn)行查詢。 如何根據(jù)job_id來查詢Job的執(zhí)行狀態(tài)，請(qǐng)參考查詢Job狀態(tài)。 |
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
error |
字典數(shù)據(jù)結(jié)構(gòu) |
提交任務(wù)異常時(shí)返回的異常信息，詳情請(qǐng)參見表1 error數(shù)據(jù)結(jié)構(gòu)。 |
|
名稱 |
參數(shù)類型 |
說明 |
|---|---|---|
|
message |
String |
任務(wù)異常錯(cuò)誤信息描述。 |
|
code |
String |
任務(wù)異常錯(cuò)誤信息編碼。 |
響應(yīng)示例
- 正常響應(yīng)
{ "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" }
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
