批量关闭云主机

功能介绍

根据指定的云主机ID列表，批量关机云主机，1分钟内最多可以处理1000台。所用接口为ECS的“批量关闭云服务器”接口。本节列举了接口使用过程中的关键信息，接口更多信息详见批量关闭云服务器。

本接口为异步接口，当前批量关机云主机请求下发成功后会返回job_id，此时批量关机云主机并没有立即完成，需要通过调用查询任务的执行状态查询job状态，当Job状态为SUCCESS时代表云主机批量关机成功。

Flexus L实例中云主机所使用的该API接口与ECS相同，响应参数说明、接口使用示例、返回值等信息同样适用于Flexus L实例云主机。

调试

您可以在API Explorer中调试该接口。

URI

POST /v1/{project_id}/cloudservers/action

请求消息

请求消息中，servers字段中的id为云主机ID，请根据查询已创建的Flexus L实例获取云主机ID。

请求示例

批量关闭云主机ID为72a270de-665a-4f46-8d64-24ad6edccdd1、72a270de-665a-4f46-8d64-24ad6edccdd2的Flexus L实例。

POST https://{endpoint}/v1/{project_id}/cloudservers/action
{
 "os-stop": {
  "servers": [
   {
    "id": "72a270de-665a-4f46-8d64-24ad6edccdd1"  
   },
   {
    "id": "72a270de-665a-4f46-8d64-24ad6edccdd2"
   }
  ]
 }
}

响应示例

{
 "job_id": "ff80808290c6b8210191ef4a80e116d3"
}