批量操作实例

功能介绍

• 批量移出伸缩组中的实例或批量添加伸缩组外的实例。
  

  批量移出伸缩组时，如果是手动添加到伸缩组的实例，只能从伸缩组中移出，不支持移出并删除。

• 批量对伸缩组中的实例设置或取消其实例保护属性。
• 批量将伸缩组中的实例转入或移出备用状态。

• 单次最多批量移出实例个数为50，其他批量操作单次最多操作实例个数为10。批量添加后实例数不能大于伸缩组的最大实例数，批量移出后实例数不能小于伸缩组的最小实例数。
• 当伸缩组处于INSERVICE状态且没有伸缩活动时，才能添加实例。
• 当伸缩组没有伸缩活动时，才能移出实例。
• 向伸缩组中添加实例时，必须保证实例所在的可用区包含于伸缩组的可用区内。
• 实例处于INSERVICE状态时才可以进行移出、设置或取消实例保护属性等操作。
• 当伸缩组发生自动缩容活动时，设置了实例保护的实例不会被移出伸缩组。
• 批量移出弹性伸缩组中的实例时，若该实例加入伸缩组时绑定的监听器和伸缩组本身的监听器相同，会解绑定实例和监听器。若该实例加入伸缩组时绑定的监听器和伸缩组本身的监听器不同，会保留实例和监听器的绑定关系。

调试

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

URI

POST /autoscaling-api/v1/{project_id}/scaling_group_instance/{scaling_group_id}/action

请求参数

请求示例

• 批量添加实例ID为instance_id_1和instance_id_2的两个实例到ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组中。

  POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action
  
  {
      "action": "ADD",
      "instances_id": [
          "instance_id_1",
          "instance_id_2"
      ]
  }

• 批量移出并删除ID为e5d27f5c-dd76-4a61-b4bc-a67c5686719a的伸缩组中，实例ID为instance_id_1和instance_id_2的两个实例。

  POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action
  
  {
      "action": "REMOVE",
      "instances_id": [
          "instance_id_1",
          "instance_id_2"
      ],
      "instance_delete": "yes"
  }

• 批量对ID为instance_id_1和instance_id_2的两个实例设置实例保护属性。

  POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action
  
  {
      "action": "PROTECT",
      "instances_id": [
          "instance_id_1",
          "instance_id_2"
      ]
  }

• 批量对ID为instance_id_1和instance_id_2的两个实例取消实例保护属性。

  POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action
  
  {
      "action": "UNPROTECT",
      "instances_id": [
          "instance_id_1",
          "instance_id_2"
      ]
  }

• 批量将ID为instance_id_1和instance_id_2的两个实例转入实例备用状态。

  POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action
  
  {
      "action": "ENTER_STANDBY",
      "instances_id": [
          "instance_id_1",
          "instance_id_2"
      ],
      "instance_append": "yes"
  }

• 批量将ID为instance_id_1和instance_id_2的两个实例移出实例备用状态。

  POST https://{Endpoint}/autoscaling-api/v1/{project_id}/scaling_group_instance/e5d27f5c-dd76-4a61-b4bc-a67c5686719a/action
  
  {
      "action": "EXIT_STANDBY",
      "instances_id": [
          "instance_id_1",
          "instance_id_2"
      ]
  }

响应参数

无

响应示例

无

返回值

• 正常

  204

• 异常

  返回值	说明
  400 Bad Request	服务器未能处理请求。
  401 Unauthorized	被请求的页面需要用户名和密码。
  403 Forbidden	对被请求的页面访问禁止。
  404 Not Found	服务器无法找到被请求的页面。
  405 Method Not Allowed	请求中指定的方法不被允许。
  406 Not Acceptable	服务器生成的响应无法被客户端所接受。
  407 Proxy Authentication Required	用户必须首先使用代理服务器进行验证，这样请求才会被处理。
  408 Request Timeout	请求超出了服务器的等待时间。
  409 Conflict	由于冲突，请求无法被完成。
  500 Internal Server Error	请求未完成。服务异常。
  501 Not Implemented	请求未完成。服务器不支持所请求的功能。
  502 Bad Gateway	请求未完成。服务器从上游服务器收到一个无效的响应。
  503 Service Unavailable	请求未完成。系统暂时异常。
  504 Gateway Timeout	网关超时。

错误码

请参考错误码。