華為云計(jì)算 云知識 批量掛載指定共享盤BatchAttachSharableVolumes
批量掛載指定共享盤BatchAttachSharableVolumes

 

功能介紹

將指定的共享磁盤一次性掛載到多個(gè)彈性 云服務(wù)器 ,實(shí)現(xiàn)批量掛載。

本接口為異步接口,當(dāng)前批量掛載指定共享盤請求下發(fā)成功后會(huì)返回job_id,此時(shí)批量掛載指定共享盤并沒有立即完成,需要通過調(diào)用查詢?nèi)蝿?wù)的執(zhí)行狀態(tài)查詢job狀態(tài),當(dāng)Job狀態(tài)為 SUC CES S 時(shí)代表指定共享盤批量掛載成功。

接口約束

每臺(tái)彈性云服務(wù)器上已掛載的磁盤總量不超過23張。

調(diào)試

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

URI

POST /v1/{project_id}/batchaction/attachvolumes/{volume_id}

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

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

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

volume_id

共享磁盤ID。

請求消息

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

參數(shù)

是否必選

參數(shù)類型

描述

serverinfo

Array of objects

共享磁盤需要掛載的彈性云服務(wù)器列表。詳細(xì)請參見表3。

表3 serverinfo 列表數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

是否必選

參數(shù)類型

描述

server_id

String

共享磁盤需要掛載的彈性云服務(wù)器ID。

device

String

磁盤掛載點(diǎn)。

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

響應(yīng)消息

請參考響應(yīng)(任務(wù)類)。

請求示例

批量掛載共享數(shù)據(jù)盤到ID為“a26887c6-c47b-4654-abb5-dfadf7d3f803”和“a26887c6-c47b-4654-abb5-dfadf7d3fa05”的云服務(wù)器。

POST https://{endpoint}/v1/{project_id}/batchaction/attachvolumes/{volume_id}

{
    "serverinfo": [
        {
            "server_id": "a26887c6-c47b-4654-abb5-dfadf7d3f803",
            "device": "/dev/sdb"
        },
        {
            "server_id": "a26887c6-c47b-4654-abb5-dfadf7d3fa05",
            "device": "/dev/sdb"
        }
    ]
}

響應(yīng)示例

{      
    "job_id": "70a599e0-31e7-49b7-b260-868f441e862b" 
}

返回值

請參考通用請求返回值。

錯(cuò)誤碼

請參考錯(cuò)誤碼