華為云計算 云知識 批量啟動云服務(wù)器BatchStartServers
批量啟動云服務(wù)器BatchStartServers

 

功能介紹

根據(jù)給定的 云服務(wù)器 ID列表,批量啟動云服務(wù)器,1分鐘內(nèi)最多可以處理1000臺。

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

調(diào)試

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

URI

POST /v1/{project_id}/cloudservers/action

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

參數(shù)

是否必選

描述

project_id

項目ID。

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

請求消息

表2 請求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

os-start

Object

標(biāo)記為啟動云服務(wù)器操作,詳情請參見表3。

表3 os-start字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

是否必選

參數(shù)類型

描述

servers

Array of objects

云服務(wù)器ID列表,詳情請參見表4。

表4 servers字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

是否必選

參數(shù)類型

描述

id

String

云服務(wù)器ID。

響應(yīng)消息

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

請求示例

批量啟動ID為“616fb98f-46ca-475e-917e-2563e5a8cd19”和“726fb98f-46ca-475e-917e-2563e5a8cd20”的云服務(wù)器,請求參數(shù)必須以“os-start”字段下發(fā)。
POST https://{endpoint}/v1/{project_id}/cloudservers/action

{
    "os-start": {
        "servers": [
            {
                "id": "616fb98f-46ca-475e-917e-2563e5a8cd19"
            },
            {
                "id": "726fb98f-46ca-475e-917e-2563e5a8cd20"
            }
        ]
    }
}

響應(yīng)示例

{
    "job_id": "ff808082889bd9690189061140c235fe"
}

返回值

請參考通用請求返回值。

錯誤碼

請參考錯誤碼