調用DescribeLifecycleHooks通過指定生命周期掛鉤ID或伸縮組ID來查詢生命周期掛鉤的信息,包括等待狀態結束后的下一步動作、生命周期掛鉤對應的伸縮活動類型、通知對象標識符、掛起等待時間等。
接口說明
您可以通過以下三種方式查詢生命周期掛鉤:
- 指定一個生命周期掛鉤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 | 生命周期掛鉤通知對象標識符,參數格式如下:
參數格式中的變量含義如下:
|
HeartbeatTimeout | Integer | 60 | 生命周期掛鉤為伸縮活動設置的等待時間,等待超時后會執行下一步動作。 |
ScalingGroupId | String | asg-bp1igpak5ft1flyp**** | 伸縮組ID。 |
LifecycleHookStatus | String | Active | 生命周期掛鉤的狀態,可選值:
|
示例
請求示例
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. |
指定的參數值不合法。 |
文檔內容是否對您有幫助?