華為云計算 云知識 彈性云服務器掛載磁盤NovaAttachVolume
彈性云服務器掛載磁盤NovaAttachVolume

 

功能介紹

云服務器 掛載磁盤。

彈性云服務器掛載磁盤應用示例請參考彈性云服務器掛載磁盤。

接口約束

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

調(diào)試

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

URI

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

參數(shù)說明請參見表1。
表1 參數(shù)說明

參數(shù)

是否必選

描述

project_id

項目ID。

獲取方法請參見獲取項目ID。

server_id

云服務器ID。

請求消息

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

參數(shù)

是否必選

參數(shù)類型

描述

volumeAttachment

Object

要掛載的卷相關信息,詳情請參見表3。

表3 volumeAttachment數(shù)據(jù)結(jié)構說明

參數(shù)

是否必選

參數(shù)類型

描述

volumeId

String

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

device

String

磁盤掛載點,如/dev/sda,/dev/sdb。

新增加的磁盤掛載點不能和已有的磁盤掛載點相同。

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

說明:

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

響應消息

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

參數(shù)

參數(shù)類型

描述

volumeAttachment

object

云服務器掛載信息,詳情請參見表5。

表5 volumeAttachment字段數(shù)據(jù)結(jié)構說明

參數(shù)

參數(shù)類型

描述

device

String

設備名稱。

serverId

String

掛載的云服務器ID,UUID格式。

id

String

卷的ID,UUID格式。

volumeId

String

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

請求示例

掛載ID為“54667652-3029-4af8-9222-2d53066fd61c”的磁盤到指定云服務器,掛載點為“/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"
    }
}

響應示例

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

返回值

請參考通用請求返回值。