调用ExitStandby使伸缩组内处于备用状态的ECS实例进入运行状态。
接口说明
如果伸缩组关联了负载均衡实例,会将ECS实例权重设置为伸缩配置中定义的权重值。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | ExitStandby |
系统规定参数。取值:ExitStandby。 |
ScalingGroupId | String | 是 | asg-bp1fo0dbtsbmqa9h**** |
伸缩组的ID。 |
ClientToken | String | 否 | 123e4567-e89b-12d3-a456-42665544**** |
保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。 只支持ASCII字符,且不能超过64个字符。更多详情,请参见如何保证幂等性。 |
Async | Boolean | 否 | false |
是否采用异步任务方式执行。取值范围:
默认值: false。 |
RegionId | String | 否 | cn-hangzhou |
伸缩组所属的地域ID。 |
InstanceId.N | String | 是 | i-28wt4**** |
ECS实例的ID。取值可以由多个实例ID组成一个JSON数组,最多支持20个ID,ID之间用半角逗号(,)隔开。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3**** |
请求ID。 |
ScalingActivityId | String | asa-2zeb04oym05qaceq**** |
调用伸缩活动ID。 |
示例
请求示例
http(s)://ess.aliyuncs.com/?Action=ExitStandby
&ScalingGroupId=asg-bp1fo0dbtsbmqa9h****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&InstanceId=["i-28wt4****"]
&Async=false
&RegionId=cn-hangzhou
&公共请求参数
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<ExitStandbyResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
<ScalingActivityId>asa-2zeb04oym05qaceq****</ScalingActivityId>
</ExitStandbyResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
"ScalingActivityId" : "asa-2zeb04oym05qaceq****"
}
错误码
访问错误中心查看更多错误码。
HttpCode |
错误码 |
错误信息 |
描述 |
---|---|---|---|
403 |
Forbidden.Unauthorized |
A required authorization for the specified action is not supplied. |
RAM用户无权限调用该接口,请联系主账号授权后重试。 |
404 |
InvalidInstanceId.NotFound |
A required authorization for the specified action is not supplied. |
指定的ECS实例不存在。 |
404 |
InvalidScalingGroupId.NotFound |
The specified scaling group does not exist. |
指定的伸缩组在该用户账号下不存在。 |