调用DescribeLifecycleHooks查询生命周期挂钩_弹性伸缩(ESS)-阿里云帮助中心

接口说明

您可以通过以下三种方式查询生命周期挂钩：

指定一个生命周期挂钩ID列表（LifecycleHookId.N），此时将忽略伸缩组ID（ScalingGroupId）和生命周期挂钩名称（LifecycleHookName）参数。
指定伸缩组ID（ScalingGroupId）。
同时指定伸缩组ID（ScalingGroupId）和生命周期挂钩名称（LifecycleHookName）。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称	类型	是否必选	示例值	描述
Action	String	是	DescribeLifecycleHooks	系统规定参数。取值：DescribeLifecycleHooks。
ScalingGroupId	String	否	asg-bp1igpak5ft1flyp****	伸缩组的ID。
LifecycleHookName	String	否	lifecyclehook****	生命周期挂钩的名称。
PageNumber	Integer	否	1	实例状态列表的页码，起始值：1。默认值：1。
PageSize	Integer	否	50	分页查询时设置的每页行数，最大值：50。默认值：50。
LifecycleHookId.N	String	否	ash-bp1at9ufhmcf9cmy****	生命周期挂钩的ID。
RegionId	String	否	cn-beijing	伸缩组所属地域的ID。

返回数据

名称	类型	示例值	描述
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E	请求ID。
PageNumber	Integer	1	查询起始页数。
PageSize	Integer	50	查询每页返回行数。
TotalCount	Integer	1	生命周期挂钩总个数。
LifecycleHooks	Array of LifecycleHook		生命周期挂钩信息列表。
LifecycleHook
DefaultResult	String	CONTINUE	实例挂起等待状态结束后的下一步动作。
LifecycleHookId	String	ash-bp19d1032y9kij96****	生命周期挂钩ID。
LifecycleHookName	String	lifecyclehook****	生命周期挂钩名称。
LifecycleTransition	String	SCALE_OUT	生命周期挂钩对应的伸缩活动类型。
NotificationMetadata	String	Test Lifecycle Hook.	伸缩活动的等待状态的固定字符串信息。
NotificationArn	String	acs:ess:cn-beijing:161456884340****:null/null	生命周期挂钩通知对象标识符，参数格式如下：未设置通知：`acs:ess:{region-id}:{account-id}:null/null`。消息服务MNS队列：`acs:mns:{region-id}:{account-id}:queue/{queuename}`。消息服务MNS主题：`acs:mns:{region-id}:{account-id}:topic/{topicname}`。运维编排OOS模板：`acs:oos:{region-id}:{account-id}:template/{templatename}`。事件总线，参数取值格式：`acs:eventbridge:{region-id}:{account-id}:eventbus/default`。参数格式中的变量含义如下： region-id：伸缩组所在的地域的ID。 account-id：阿里云账号ID。 queuename：MNS队列的名称。 topicname：MNS主题的名称。 templatename：OOS模板的名称。
HeartbeatTimeout	Integer	60	生命周期挂钩为伸缩活动设置的等待时间，等待超时后会执行下一步动作。
ScalingGroupId	String	asg-bp1igpak5ft1flyp****	伸缩组ID。
LifecycleHookStatus	String	Active	生命周期挂钩的状态，可选值： Active：启动状态。 InActive：暂停状态。

示例

请求示例

http(s)://ess.aliyuncs.com/?Action=DescribeLifecycleHooks
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&LifecycleHookName=lifecyclehook****
&PageNumber=1
&PageSize=50
&LifecycleHookId=["ash-bp1at9ufhmcf9cmy****"]
&RegionId=cn-beijing
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeLifecycleHooksResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
    <PageNumber>1</PageNumber>
    <PageSize>50</PageSize>
    <TotalCount>1</TotalCount>
    <LifecycleHooks>
        <DefaultResult>CONTINUE</DefaultResult>
        <LifecycleHookId>ash-bp19d1032y9kij96****</LifecycleHookId>
        <LifecycleHookName>lifecyclehook****</LifecycleHookName>
        <LifecycleTransition>SCALE_OUT</LifecycleTransition>
        <NotificationMetadata>Test Lifecycle Hook.</NotificationMetadata>
        <NotificationArn>acs:ess:cn-beijing:161456884340****:null/null</NotificationArn>
        <HeartbeatTimeout>60</HeartbeatTimeout>
        <ScalingGroupId>asg-bp1igpak5ft1flyp****</ScalingGroupId>
        <LifecycleHookStatus>Active</LifecycleHookStatus>
    </LifecycleHooks>
</DescribeLifecycleHooksResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber" : 1,
  "PageSize" : 50,
  "TotalCount" : 1,
  "LifecycleHooks" : [ {
    "DefaultResult" : "CONTINUE",
    "LifecycleHookId" : "ash-bp19d1032y9kij96****",
    "LifecycleHookName" : "lifecyclehook****",
    "LifecycleTransition" : "SCALE_OUT",
    "NotificationMetadata" : "Test Lifecycle Hook.",
    "NotificationArn" : "acs:ess:cn-beijing:161456884340****:null/null",
    "HeartbeatTimeout" : 60,
    "ScalingGroupId" : "asg-bp1igpak5ft1flyp****",
    "LifecycleHookStatus" : "Active"
  } ]
}

错误码

访问错误中心查看更多错误码。

HttpCode	错误码	错误信息	描述
400	InvalidParamter	The specified value of parameter is not valid.	指定的参数值不合法。