实例移出备用状态
描述
运行伸缩组内的处于备用状态的ECS实例（ExitStandby）。如果伸缩组设置了负载均衡服务，则会将权重设置伸缩配置定义的权重值。
请求参数
| 名称 | 类型 | 是否必需 | 描述 |
| Action | String | 是 | 系统规定参数。取值：ExitStandby |
| ScalingGroupId | String | 是 | 伸缩组 ID。 |
| InstanceId.N | String | 是 | ECS实例ID。取值可以由多个实例ID组成一个JSON数组，格式为[“i-xxxxxxxxx”, “i-yyyyyyyyy”, … “i-zzzzzzzzz”]，最多支持20个ID，ID之间用半角逗号（,）隔开。 |
返回参数
| 名称 | 类型 | 描述 |
| RequestId | String | 唯一请求 ID |
示例
请求示例
- http://ess.aliyuncs.com/?Action=ExitStandby
- &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ2eaQ
- &InstanceId.1=i-28wt48iaa
- &<公共请求参数>
返回示例
XML 格式
- <ExitStandbyResponse>
- <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
- </ExitStandbyResponse>
JSON 格式
- {
- "RequestId": "04F0F334-1335-436C-A1D7-6C044FE73368"
- }
错误码
| 错误代码 | 错误信息 | HTTP 状态码 | 说明 |
| Forbidden.Unauthorized | A required authorization for the specified action is not supplied. | 403 | RAM用户无权限调用该接口。请联系主账号授权后重试。 |
| InvalidInstanceId.NotFound | Instance “XXX” does not exist. | 404 | 指定的ECS实例不存在。 |
| InvalidScalingGroupId.NotFound | The specified scaling group does not exist. | 404 | 指定的伸缩组在该用户账号下不存在 |
展开
收起
版权声明：本文内容由阿里云实名注册用户自发贡献，版权归原作者所有，阿里云开发者社区不拥有其著作权，亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容，填写侵权投诉表单进行举报，一经查实，本社区将立刻删除涉嫌侵权内容。
阿里云 AI 助理回答
要运行伸缩组内处于备用状态的ECS实例并将其移出备用，您需要调用ExitStandby API。以下是执行此操作的详细说明和请求示例：
请求步骤
-
构建API请求：
- Action: 必填参数，设置为
ExitStandby。 - ScalingGroupId: 必填，指定要操作的伸缩组ID。
- InstanceId.N: 必填，提供一个或多个ECS实例ID的列表，这些实例将被移出备用状态。实例ID需组成JSON数组格式，例如：
["i-xxxxxxxxx", "i-yyyyyyyyy"]，最多支持20个ID。
- Action: 必填参数，设置为
-
可选参数：
- ClientToken: 可选，用于保证请求幂等性，自定义字符串。
- Async: 可选，默认为
false表示同步执行，设为true则异步执行。 - RegionId: 可选，指定伸缩组所属的地域ID。
-
负载均衡权重调整：如果您的伸缩组关联了负载均衡服务，当ECS实例从备用状态转换为运行状态时，其在负载均衡中的权重会自动恢复为伸缩配置中定义的默认值（如未特别设定，默认为50）。
请求示例
http://ess.aliyuncs.com/
?Action=ExitStandby
&ScalingGroupId=asg-bp1fo0dbtsbmqa9h****
&InstanceId.N=["i-28wt4****","i-anotherinstanceid"]
&Async=false
返回参数说明
- RequestId: 该次请求的唯一标识符。
注意事项
- 确保提供的ECS实例ID有效且属于指定的伸缩组。
- 实例状态转换后，会重新参与伸缩活动及健康检查。
- 如果有与实例相关的生命周期挂钩，确保它们不会阻止实例状态的转换。
通过上述步骤，您可以成功地将伸缩组内的备用ECS实例移出备用状态并使其恢复正常服务。
参考文献： ExitStandby API 文档
有帮助
无帮助
AI 助理回答生成答案可能存在不准确，仅供参考
相关问答