DescribeLifecycleHooks
查询一个或多个满足指定条件的生命周期挂钩列表（`DescribeLifecycleHooks`）。
描述
您可以通过以下三种方式查询生命周期挂钩：
- 指定一个生命周期挂钩 ID 列表（
LifecycleHookId.N），此时将忽略ScalingGroupId和LifecycleHookName参数。 - 指定伸缩组 ID（
ScalingGroupId）。 - 同时指定伸缩组 ID（
ScalingGroupId）和生命周期挂钩名称（LifecycleHookName）。
调试
前往【】在线调试，API Explorer 提供在线调用 API、动态生成 SDK Example 代码和快速检索接口等能力，能显著降低使用云 API 的难度，强烈推荐使用。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 否 | DescribeLifecycleHooks |
系统规定参数，取值：DescribeLifecycleHooks |
| LifecycleHookId.N | RepeatList | 否 | ash-**** |
生命周期挂钩 ID。 |
| LifecycleHookName | String | 否 | Test |
生命周期挂钩名称。 |
| PageNumber | Integer | 否 | 1 |
实例状态列表的页码。起始值：1，默认值：1。 |
| PageSize | Integer | 否 | 50 |
分页查询时设置的每页行数。最大值：50，默认值：50。 |
| ScalingGroupId | String | 否 | asg-**** |
伸缩组 ID。 |
返回参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| LifecycleHooks |
生命周期挂钩信息列表。 |
||
| └DefaultResult | String | CONTINUE |
等待状态结束后的下一步动作。 |
| └HeartbeatTimeout | Integer | 60 |
生命周期挂钩为伸缩组活动设置的等待时间，等待状态超时后会执行下一步动作。 |
| └LifecycleHookId | String | ash-**** |
生命周期挂钩 ID。 |
| └LifecycleHookName | String | Test |
生命周期挂钩名称。 |
| └LifecycleTransition | String | SCALE_OUT |
生命周期挂钩对应伸缩活动类型。 |
| └NotificationArn | String | acs:ess:cn-hangzhou:1111111111:queue/queue1 |
生命周期挂钩通知对象标识符。 |
| └NotificationMetadata | String | Test |
伸缩活动的等待状态的固定字符串信息。 |
| └ScalingGroupId | String | asg-**** |
伸缩组 ID。 |
| PageNumber | Integer | 1 |
查询起始页数。 |
| PageSize | Integer | 50 |
查询每页返回行数。 |
| RequestId | String | 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E |
请求 ID。无论调用接口成功与否，我们都会返回请求 ID。 |
| TotalCount | Integer | 1 |
生命周期挂钩总个数。 |
示例
请求示例
http://ess.aliyuncs.com/?Action=DescribeLifecycleHooks
&ScalingGroupId=asg-****
&<公共请求参数>
正常返回示例
XML 格式
<DescribeLifecycleHooksResponse>
<RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
<PageNumber>1</PageNumber>
<PageSize>50</PageSize>
<TotalCount>1</TotalCount>
<LifecycleHooks>
<LifecycleHook>
<ScalingGroupId>asg-xxx</ScalingGroupId>
<LifecycleHookId>ash-xxx</LifecycleHookId>
<LifecycleHookName>Test</LifecycleHookName>
<DefaultResult>CONTINUE</DefaultResult>
<HeartbeatTimeout>60</HeartbeatTimeout>
<LifecycleTransition>SCALE_OUT</LifecycleTransition>
<NotificationMetadata>Test</NotificationMetadata>
<NotificationArn>acs:ess:cn-hangzhou:1111111111:queue/queue1</NotificationArn>
</LifecycleHook>
</LifecycleHooks>
</DescribeLifecycleHooksResponse>
JSON 格式
{
"lifecycleHooks":[
{
"notificationArn":"acs:ess:cn-hangzhou:1111111111:queue/queue1",
"lifecycleHookId":"ash-****",
"notificationMetadata":"Test",
"lifecycleTransition":"SCALE_OUT",
"defaultResult":"CONTINUE",
"lifecycleHookName":"Test",
"scalingGroupId":"asg-****",
"heartbeatTimeout":600
}
],
"totalCount":1,
"requestId":"473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
"pageSize":50,
"pageNumber":1
}错误码
HttpCode |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
|
400 |
InvalidParamter |
The specified value of parameter is not valid. |
指定的参数值不合法。 |
发布者：lidazhuang，转转请注明出处：https://www.cms2.cn/aliyun/4549.html
微信扫一扫
相关推荐
-
阿里云弹性伸缩请求结构解析
本文介绍请求结构。 服务地址 为降低网络延时，建议您根据业务部署位置配置接入地址，ESS API的服务接入地址如下表所示。 地域（部署位置） 接入地址 中心 ess.aliyuncs.com 华北1（青岛） ess.aliyuncs.com 华北2（北京） ess.aliyunc…
-
阿里云弹性伸缩流程介绍
本文介绍如何通过 API 创建和配置包含定时、动态、自定义、固定模式的整体伸缩方案。 创建完整的弹性伸缩方案，您需要通过以下图中所示步骤来完成（其中前三步为简易的伸缩方案）： 创建伸缩组（CreateScalingGroup），配置伸缩资源的最小值（MinSize）、最大值（Ma…
-
删除伸缩配置
您可以删除不再需要的伸缩配置，空出伸缩配置的配额。 前提条件 在删除一个伸缩配置前，请确保满足以下条件，否则删除操作会失败： 该伸缩配置必须处于失效状态。 伸缩组中不存在根据该伸缩配置自动创建的ECS实例。 操作步骤 登录。 单击伸缩组操作列下的管理。 前往组内实例配置信息来源页…
-
伸缩活动的状态
本文主要介绍弹性伸缩的伸缩活动状态。 伸缩活动在请求阶段被拒绝，为 Rejected 状态。 伸缩活动执行过程中，为 InProgress 状态。 伸缩活动执行完成后，有 3 种状态： 成功（Successful）：根据 Minsize、MaxSize 调整后的伸缩规则，伸缩活动…
-
删除伸缩规则
本文主要介绍删除伸缩规则的步骤。 背景信息 如果不再需要一条伸缩规则，您可以将其删除，空出伸缩规则配额。 操作步骤 登录弹性伸缩控制台。 在 伸缩组管理 页面中，单击指定伸缩组 操作 列下的 管理。 前往 伸缩规则 页面，单击要删除的伸缩规则 操作 列下的 删除。 在 删除伸缩规…
-
移出不健康ECS实例
本文主要介绍移出不健康实例的操作。 当 ECS 实例成功加入伸缩组后，弹性伸缩服务会定期扫描该 ECS 实例的运行状态，如果发现该 ECS 实例为非 运行中（Running）状态，则会将该 ECS 实例移出伸缩组。 对于弹性服务自动创建的 ECS 实例：将立即启动移出和释放该 E…
