華為云計(jì)算 云知識(shí) 彈性云服務(wù)器掛載磁盤(pán)AttachServerVolume
彈性云服務(wù)器掛載磁盤(pán)AttachServerVolume
時(shí)間: 2023-07-25 15:09:21
猜你想看：
實(shí)時(shí)語(yǔ)音識(shí)別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

功能介紹

把磁盤(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ù)說(shuō)明請(qǐng)參見(jiàn)表1。
表1 參數(shù)說(shuō)明

參數(shù)

是否必選

描述

project_id

是

項(xiàng)目ID。

獲取方法請(qǐng)參見(jiàn)獲取項(xiàng)目ID。

server_id

是

云服務(wù)器ID。

請(qǐng)求消息

表2 請(qǐng)求參數(shù)

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

volumeAttachment

是

Object

云服務(wù)器掛載信息，參考表3。

dry_run

否

Boolean

是否只預(yù)檢此次請(qǐng)求。

  • true：發(fā)送檢查請(qǐng)求，不會(huì)掛載磁盤(pán)。檢查項(xiàng)包括是否填寫(xiě)了必需參數(shù)、請(qǐng)求格式、業(yè)務(wù)限制。如果檢查不通過(guò)，則返回對(duì)應(yīng)錯(cuò)誤。如果檢查通過(guò)，則返回響應(yīng)結(jié)果。
  • false：發(fā)送正常請(qǐng)求，通過(guò)檢查后并且進(jìn)行掛載磁盤(pán)請(qǐng)求。

默認(rèn)值：false
表3 volumeAttachment數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

是否必選

參數(shù)類(lèi)型

描述

volumeId

是

String

待掛載磁盤(pán)的磁盤(pán)ID，UUID格式。

device

否

String

磁盤(pán)掛載點(diǎn)。

說(shuō)明：
  • 新增加的磁盤(pán)掛載點(diǎn)不能和已有的磁盤(pán)掛載點(diǎn)相同。
  • 對(duì)于采用XEN虛擬化類(lèi)型的彈性云服務(wù)器，device為必選參數(shù)；系統(tǒng)盤(pán)掛載點(diǎn)請(qǐng)指定/dev/sda；數(shù)據(jù)盤(pán)掛載點(diǎn)請(qǐng)按英文字母順序依次指定，如/dev/sdb，/dev/sdc，如果指定了以“/dev/vd”開(kāi)頭的掛載點(diǎn)，系統(tǒng)默認(rèn)改為“/dev/sd”。
  • 對(duì)于采用KVM虛擬化類(lèi)型的彈性云服務(wù)器，系統(tǒng)盤(pán)掛載點(diǎn)請(qǐng)指定/dev/vda；數(shù)據(jù)盤(pán)掛載點(diǎn)可不用指定，也可按英文字母順序依次指定，如/dev/vdb，/dev/vdc，如果指定了以“/dev/sd”開(kāi)頭的掛載點(diǎn)，系統(tǒng)默認(rèn)改為“/dev/vd”。

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
  • true表示云硬盤(pán)的設(shè)備類(lèi)型為SCSI類(lèi)型，即允許ECS操作系統(tǒng)直接訪(fǎng)問(wèn)底層存儲(chǔ)介質(zhì)。支持SCSI鎖命令
  • false表示云硬盤(pán)的設(shè)備類(lèi)型為VBD (虛擬塊存儲(chǔ)設(shè)備 , Virtual Block Device)類(lèi)型，VBD只能支持簡(jiǎn)單的SCSI讀寫(xiě)命令。

該字段于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ò)誤碼。

彈性云服務(wù)器掛載磁盤(pán)AttachServerVolume

意見(jiàn)反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會(huì)繼續(xù)努力做到更好 反饋提交失??！請(qǐng)稍后重試！