華為云計(jì)算 云知識(shí) 彈性云服務(wù)器掛載磁盤NovaAttachVolume
彈性云服務(wù)器掛載磁盤NovaAttachVolume

 

功能介紹

云服務(wù)器 掛載磁盤。

彈性云服務(wù)器掛載磁盤應(yīng)用示例請(qǐng)參考彈性云服務(wù)器掛載磁盤。

接口約束

  1. 掛載bootable卷必須指定掛載盤符。
  2. 由備份創(chuàng)建的磁盤不能掛載為系統(tǒng)盤。
  3. 彈性云服務(wù)器狀態(tài)(彈性云服務(wù)器的OS-EXT-STS:vm_state屬性)處于SUSPENDED和PAUSED狀態(tài)下不支持掛卷。
  4. 待掛載的 云硬盤 必須是available狀態(tài)。
  5. 待掛載的云硬盤與云服務(wù)器屬于同一可用區(qū)。
  6. VBD類型的云硬盤不支持掛載到 裸金屬服務(wù)器 上。

調(diào)試

您可以在API Explorer中調(diào)試該接口。

URI

POST /v2.1/{project_id}/servers/{server_id}/os-volume_attachments

參數(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)求消息

請(qǐng)求參數(shù)如表2所示。
表2 請(qǐng)求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

volumeAttachment

Object

要掛載的卷相關(guān)信息,詳情請(qǐng)參見(jiàn)表3。

表3 volumeAttachment數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

是否必選

參數(shù)類型

描述

volumeId

String

待掛載磁盤的磁盤ID,UUID格式。

device

String

磁盤掛載點(diǎn),如/dev/sda,/dev/sdb。

新增加的磁盤掛載點(diǎn)不能和已有的磁盤掛載點(diǎn)相同。

需要根據(jù)已有設(shè)備名稱順序指定,否則由系統(tǒng)自動(dòng)生成。

說(shuō)明:

VBD磁盤掛載點(diǎn)只支持從/dev/vdb到/dev/vdx,建議按英文字母順序進(jìn)行掛載,否則可能出現(xiàn)云服務(wù)器中磁盤盤符錯(cuò)亂的情況。

響應(yīng)消息

響應(yīng)參數(shù)如表 響應(yīng)參數(shù)所示。
表4 響應(yīng)參數(shù)

參數(shù)

參數(shù)類型

描述

volumeAttachment

object

云服務(wù)器掛載信息,詳情請(qǐng)參見(jiàn)表5。

表5 volumeAttachment字段數(shù)據(jù)結(jié)構(gòu)說(shuō)明

參數(shù)

參數(shù)類型

描述

device

String

設(shè)備名稱。

serverId

String

掛載的云服務(wù)器ID,UUID格式。

id

String

卷的ID,UUID格式。

volumeId

String

掛載ID,目前實(shí)現(xiàn)與卷UUID相同。

請(qǐng)求示例

掛載ID為“54667652-3029-4af8-9222-2d53066fd61c”的磁盤到指定云服務(wù)器,掛載點(diǎn)為“/dev/sdb”。

POST https://{endpoint}/v2.1/{project_id}/servers/{server_id}/os-volume_attachments

{
    "volumeAttachment": {
        "volumeId": "54667652-3029-4af8-9222-2d53066fd61c",
        "device": "/dev/sdb"
    }
}

響應(yīng)示例

{
    "volumeAttachment": {
        "device": "/dev/vdb",
        "serverId": "ab258e25-e351-47c7-b6e3-0749c5d9ed6a",
        "id": "54667652-3029-4af8-9222-2d53066fd61c",
        "volumeId": "54667652-3029-4af8-9222-2d53066fd61c"
    }
}

返回值

請(qǐng)參考通用請(qǐng)求返回值。