華為云計算 云知識 批量重啟云服務器BatchRebootServers
批量重啟云服務器BatchRebootServers

 

功能介紹

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

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

調(diào)試

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

URI

POST /v1/{project_id}/cloudservers/action

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

參數(shù)

是否必選

描述

project_id

項目ID。

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

請求消息

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

參數(shù)

是否必選

參數(shù)類型

描述

reboot

Object

標記為重啟云服務器操作,詳情請參見表3。

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

參數(shù)

是否必選

參數(shù)類型

描述

type

String

重啟類型:

  • SOFT:普通重啟。
  • HARD:強制重啟。

servers

Array of objects

云服務器ID列表,詳情請參見表4。

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

參數(shù)

是否必選

參數(shù)類型

描述

id

String

云服務器ID。

響應消息

請參考響應(任務類)。

請求示例

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

響應示例

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

返回值

請參考通用請求返回值。

錯誤碼

請參考錯誤碼。