華為云計(jì)算 云知識 批量關(guān)閉云服務(wù)器BatchStopServers
批量關(guān)閉云服務(wù)器BatchStopServers
時(shí)間: 2023-07-25 14:38:45
猜你想看：
實(shí)時(shí)語音識別 云服務(wù)器配置 CDN是什么意思 視頻點(diǎn)播加速 什么是云桌面

 

功能介紹

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

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

調(diào)試

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

URI

POST /v1/{project_id}/cloudservers/action

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

參數(shù)

是否必選

描述

project_id

是

項(xiàng)目ID。

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

請求消息

表2 請求參數(shù)

參數(shù)

是否必選

參數(shù)類型

描述

os-stop

是

Object

標(biāo)記為關(guān)閉云服務(wù)器操作，詳情請參見表3。
表3 os-stop字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

是否必選

參數(shù)類型

描述

servers

是

Array of objects

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

type

否

String

關(guān)機(jī)類型，默認(rèn)為SOFT：

SOFT：普通關(guān)機(jī)（默認(rèn)）。

HARD：強(qiáng)制關(guān)機(jī)。
表4 servers字段數(shù)據(jù)結(jié)構(gòu)說明

參數(shù)

是否必選

參數(shù)類型

描述

id

是

String

云服務(wù)器ID。

響應(yīng)消息

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

請求示例

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

響應(yīng)示例

{
    "job_id": "ff808082889bd9690189061140c235fe"
}

返回值

請參考通用請求返回值。

錯誤碼

請參考錯誤碼。

批量關(guān)閉云服務(wù)器BatchStopServers

意見反饋

0/200

提交 取消

提交成功！非常感謝您的反饋，我們會繼續(xù)努力做到更好 反饋提交失??！請稍后重試！