为一个伸缩组创建生命周期挂钩(CreateLifecycleHook)。
描述
一个伸缩组最多可以创建 6 个生命周期挂钩。创建了生命周期挂钩的伸缩组,在发生伸缩活动时,生命周期挂钩会暂停伸缩活动一段时间,我们称之为伸缩活动等待状态,具体等待时长您可以通过 HeartbeatTimeout 参数指定。
伸缩活动处于等待状态时,伸缩组弹性扩张活动之前或者弹性收缩活动之前为您保留指定时长的操作时间。您可以在等待期间初始化 ECS 实例配置或者获取 ECS 实例数据等。等待状态的进程在处于加入或移除 RDS 实例 IP 白名单和加入或移除 SLB 实例 IP 白名单之间
我们推荐您利用
消息服务 MNS 主题或者队列创建消息通知,掌握伸缩组内正在启动或者即将释放的 ECS 实例的动态。
请求参数
返回参数
示例
请求示例
- http://ess.aliyuncs.com/?Action=CreateLifecycleHook
- &ScalingGroupId=AG6CQdPU8OKdwLjgZcJ2eaQ
- &LifecycleHookName=测试SCALE_OUT
- &LifecycleTransition=SCALE_OUT
- &NotificationArn=acs:ess:cn-hangzhou:1111111111:queue/queue1
- &NotificationMetadata=Test
- &<公共请求参数>
返回示例
XML 格式
- <CreateLifecycleHookResponse>
- <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
- <LifecycleHookId>ash-xxxxxxxxxxxxxxxxx</LifecycleHookId>
- </CreateLifecycleHookResponse>
JSON 格式
- {
- "requestId": "04F0F334-1335-436C-A1D7-6C044FE73368",
- "lifecycleHookId": "ash-xxxxxxxxxxxxxxxxx"
- }
错误码
以下为本接口特有的错误码。更多错误码,请访问
API 错误中心。
[tr=rgb(239, 251, 255)][td]QuotaExceeded.LifecycleHook
Lifecycle hook quota exceeded in the specified scaling group. | 400 | 一个伸缩组最多可以创建 6 个生命周期挂钩。 |