調用DescribeLifecycleActions,通過指定伸縮活動的ID、查詢憑證、MaxResults等配置參數,查看伸縮活動發生時,生命周期掛鉤執行操作的狀態、標識符、掛起的ECS實例的ID等信息。
接口說明
如果伸縮組發生了和生命周期掛鉤適用類型一致的伸縮活動,每個生命周期掛鉤都會觸發一次生命周期操作,生命周期操作有三種狀態:
- Pending:掛起中。表示ECS實例仍處于掛起中狀態。
- Timeout:已超時。表示已超過生命周期掛鉤的超時時間,自動結束了ECS實例的掛起中狀態。
- Completed:已處理。表示您手動提前結束了ECS實例的掛起中狀態。
如果在創建生命周期掛鉤時沒有設置后續動作,例如在結束掛起后觸發執行指定的OOS模板。您可以調用本接口獲取當前伸縮活動對應生命周期操作的標識符,以便自行定制后續動作。
調試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
Action | String | 是 | DescribeLifecycleActions | 系統規定參數。取值:DescribeLifecycleActions。 |
ScalingActivityId | String | 是 | asa-bp17mug9t0pegagw**** | 伸縮活動的ID。 |
LifecycleActionStatus | String | 否 | Pending | 生命周期操作的狀態。取值范圍:
|
NextToken | String | 否 | AAAAAcSz4VTb1Nq**** | 查詢憑證,用于指定開始查詢的位置。 例如上次查詢10條生命周期操作后,本次從第11條生命周期操作開始查詢。取值為上次調用本接口返回的NextToken參數值,如果不填寫取值則表示從頭開始查詢。 |
MaxResults | Integer | 否 | 10 | 設置單頁查詢的最大條目數。取值范圍:1~50。 默認值:10。 |
RegionId | String | 否 | cn-qingdao | 伸縮組所屬的地域ID。 |
返回數據
名稱 |
類型 |
示例值 |
描述 |
NextToken | String | AAAAAcSz4VTb1Nq**** | 本次調用返回的查詢憑證。 |
RequestId | String | 42A742EB-FCF3-459E-9C62-E107048C17E3 | 請求ID。 |
TotalCount | Integer | 3 | 本次查詢到的生命周期操作的總數。 |
MaxResults | Integer | 3 | 單頁查詢的最大條目數。 |
LifecycleActions | Array of LifecycleAction | 各個生命周期掛鉤對應的生命周期操作列表。 |
|
LifecycleAction | |||
LifecycleHookId | String | ash-bp18uoft0deax0f7**** | 生命周期掛鉤的ID。 |
LifecycleActionToken | String | 9C2E9DA7-F794-449A-ACF6-CEE24444**** | 生命周期操作的標識符。 |
LifecycleActionStatus | String | Pending | 生命周期操作的狀態。 |
LifecycleActionResult | String | CONTINUE | 該生命周期掛鉤觸發的生命周期操作結束后的下一步動作。取值范圍:
|
InstanceIds | Array of String | ["i-bp11m3fzlqrgk5vh****","i-bp11m3fzlqrgk5vh****"] | 該生命周期掛鉤掛起的ECS實例的ID。 |
示例
請求示例
http(s)://ess.aliyuncs.com/?Action=DescribeLifecycleActions
&ScalingActivityId=asa-bp17mug9t0pegagw****
&LifecycleActionStatus=Pending
&NextToken=AAAAAcSz4VTb1Nq****
&MaxResults=10
&RegionId=cn-qingdao
&公共請求參數
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<DescribeLifecycleActionsResponse>
<NextToken>AAAAAcSz4VTb1Nq****</NextToken>
<RequestId>42A742EB-FCF3-459E-9C62-E107048C17E3</RequestId>
<TotalCount>3</TotalCount>
<MaxResults>3</MaxResults>
<LifecycleActions>
<LifecycleHookId>ash-bp18uoft0deax0f7****</LifecycleHookId>
<LifecycleActionToken>9C2E9DA7-F794-449A-ACF6-CEE24444F7BB</LifecycleActionToken>
<LifecycleActionStatus>Pending</LifecycleActionStatus>
<LifecycleActionResult>CONTINUE</LifecycleActionResult>
<InstanceIds>["i-bp11m3fzlqrgk5vh****","i-bp11m3fzlqrgk5vh****"]</InstanceIds>
</LifecycleActions>
</DescribeLifecycleActionsResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NextToken" : "AAAAAcSz4VTb1Nq****",
"RequestId" : "42A742EB-FCF3-459E-9C62-E107048C17E3",
"TotalCount" : 3,
"MaxResults" : 3,
"LifecycleActions" : [ {
"LifecycleHookId" : "ash-bp18uoft0deax0f7****",
"LifecycleActionToken" : "9C2E9DA7-F794-449A-ACF6-CEE24444F7BB",
"LifecycleActionStatus" : "Pending",
"LifecycleActionResult" : "CONTINUE",
"InstanceIds" : [ "[\"i-bp11m3fzlqrgk5vh****\",\"i-bp11m3fzlqrgk5vh****\"]" ]
} ]
}
錯誤碼
訪問錯誤中心查看更多錯誤碼。
HttpCode |
錯誤碼 |
錯誤信息 |
描述 |
400 |
InvalidParameter |
The specified value of parameter "ScalingActivityId" is not valid. |
指定的參數(ScalingActivityId)無效。 |
400 |
InvalidParameter |
The specified value of parameter "MaxResults" is not valid. |
指定的參數(MaxResults)無效。 |
400 |
InvalidParameter |
The specified value of parameter "LifecycleActionStatus" is not valid. |
指定的參數(LifecycleActionStatus)無效。 |