功能介紹
把磁盤掛載到彈性 云服務(wù)器 上。
本接口為異步接口，當(dāng)前彈性云服務(wù)器掛載磁盤請求下發(fā)成功后會返回job_id，此時(shí)彈性云服務(wù)器掛載磁盤并沒有立即完成，需要通過調(diào)用查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢job狀態(tài)，當(dāng)Job狀態(tài)為 SUC CES S 時(shí)代表彈性云服務(wù)器磁盤掛載成功。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/cloudservers/{server_id}/attachvolume
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請參見獲取項(xiàng)目ID。 |
|
server_id |
是 |
云服務(wù)器ID。 |
請求消息
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
volumeAttachment |
是 |
Object |
|
|
dry_run |
否 |
Boolean |
是否只預(yù)檢此次請求。
默認(rèn)值：false |
|
參數(shù) |
是否必選 |
參數(shù)類型 |
描述 |
|---|---|---|---|
|
volumeId |
是 |
String |
待掛載磁盤的磁盤ID，UUID格式。 |
|
device |
否 |
String |
磁盤掛載點(diǎn)。 說明：
|
|
volume_type |
否 |
String |
云硬盤 類型。 該字段于dry_run為true并且volumeId不存在時(shí)有效且為必選字段。 |
|
count |
否 |
Integer |
云硬盤的個(gè)數(shù)。 該字段于dry_run為true并且volumeId不存在時(shí)有效，如果該字段不存在，默認(rèn)為1。 |
|
hw:passthrough |
否 |
String |
該字段于dry_run為true并且volumeId不存在時(shí)有效且為必選字段。 |
響應(yīng)消息
請求示例
掛載SCSI類型的云硬盤到云服務(wù)器，掛載點(diǎn)為“/dev/sda”。
POST https://{endpoint}/v1/{project_id}/cloudservers/{server_id}/attachvolume
{
"volumeAttachment": {
"volumeId": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
"device": "/dev/sda",
"volume_type": "SSD",
"count": 5,
"hw:passthrough": "true"
},
"dry_run": false
}
響應(yīng)示例
{
"job_id": "70a599e0-31e7-49b7-b260-868f441e862b"
}
返回值
請參考通用請求返回值。
錯(cuò)誤碼
請參考錯(cuò)誤碼。
