華為云計(jì)算 云知識(shí) 批量啟動(dòng)云服務(wù)器BatchStartServers
批量啟動(dòng)云服務(wù)器BatchStartServers

 

功能介紹

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

本接口為異步接口,當(dāng)前批量啟動(dòng)云服務(wù)器請(qǐng)求下發(fā)成功后會(huì)返回job_id,此時(shí)批量啟動(dòng)云服務(wù)器并沒(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ù)器批量啟動(dòng)成功。

調(diào)試

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

URI

POST /v1/{project_id}/cloudservers/action

參數(shù)說(shuō)明請(qǐng)參見(jiàn)表1。
表1 參數(shù)說(shuō)明

參數(shù)

是否必選

描述

project_id

項(xiàng)目ID。

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

請(qǐng)求消息

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

參數(shù)

是否必選

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

描述

os-start

Object

標(biāo)記為啟動(dòng)云服務(wù)器操作,詳情請(qǐng)參見(jiàn)表3。

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

參數(shù)

是否必選

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

描述

servers

Array of objects

云服務(wù)器ID列表,詳情請(qǐng)參見(jiàn)表4。

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

參數(shù)

是否必選

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

描述

id

String

云服務(wù)器ID。

響應(yīng)消息

請(qǐng)參考響應(yīng)(任務(wù)類(lèi))

請(qǐng)求示例

批量啟動(dòng)ID為“616fb98f-46ca-475e-917e-2563e5a8cd19”和“726fb98f-46ca-475e-917e-2563e5a8cd20”的云服務(wù)器,請(qǐng)求參數(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"
}

返回值

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

錯(cuò)誤碼

請(qǐng)參考錯(cuò)誤碼。