功能介紹
把磁盤(pán)掛載到彈性 云服務(wù)器 上。
本接口為異步接口，當(dāng)前彈性云服務(wù)器掛載磁盤(pán)請(qǐng)求下發(fā)成功后會(huì)返回job_id，此時(shí)彈性云服務(wù)器掛載磁盤(pán)并沒(méi)有立即完成，需要通過(guò)調(diào)用查詢(xún)?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢(xún)job狀態(tài)，當(dāng)Job狀態(tài)為 SUC CES S 時(shí)代表彈性云服務(wù)器磁盤(pán)掛載成功。
調(diào)試
您可以在API Explorer中調(diào)試該接口。
URI
POST /v1/{project_id}/cloudservers/{server_id}/attachvolume
|
參數(shù) |
是否必選 |
描述 |
|---|---|---|
|
project_id |
是 |
項(xiàng)目ID。 獲取方法請(qǐng)參見(jiàn)獲取項(xiàng)目ID。 |
|
server_id |
是 |
云服務(wù)器ID。 |
請(qǐng)求消息
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
volumeAttachment |
是 |
Object |
|
|
dry_run |
否 |
Boolean |
是否只預(yù)檢此次請(qǐng)求。
默認(rèn)值：false |
|
參數(shù) |
是否必選 |
參數(shù)類(lèi)型 |
描述 |
|---|---|---|---|
|
volumeId |
是 |
String |
待掛載磁盤(pán)的磁盤(pán)ID，UUID格式。 |
|
device |
否 |
String |
磁盤(pán)掛載點(diǎn)。 說(shuō)明：
|
|
volume_type |
否 |
String |
云硬盤(pán) 類(lèi)型。 該字段于dry_run為true并且volumeId不存在時(shí)有效且為必選字段。 |
|
count |
否 |
Integer |
云硬盤(pán)的個(gè)數(shù)。 該字段于dry_run為true并且volumeId不存在時(shí)有效，如果該字段不存在，默認(rèn)為1。 |
|
hw:passthrough |
否 |
String |
該字段于dry_run為true并且volumeId不存在時(shí)有效且為必選字段。 |
響應(yīng)消息
請(qǐng)參考響應(yīng)（任務(wù)類(lèi)）。
請(qǐng)求示例
掛載SCSI類(lèi)型的云硬盤(pán)到云服務(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"
}
返回值
請(qǐng)參考通用請(qǐng)求返回值。
錯(cuò)誤碼
請(qǐng)參考錯(cuò)誤碼。
