全部產品
Search
文件中心

Auto Scaling:DescribeLifecycleActions

更新時間:Jan 14, 2025

調用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

生命週期操作的狀態。取值範圍:

  • Pending:掛起中。表示ECS執行個體仍處於掛起中狀態。
  • Timeout:已逾時。表示已到達生命週期掛鈎的逾時時間,自動結束ECS執行個體的掛起中狀態。
  • Completed:已處理。表示您手動提前結束了ECS執行個體的掛起中狀態。
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

該生命週期掛鈎觸發的生命週期操作結束後的下一步動作。取值範圍:

  • CONTINUE:繼續響應彈性擴張活動,將ECS執行個體添加至伸縮組;繼續響應彈性收縮活動,將ECS執行個體從伸縮組移除。
  • ABANDON:終止彈性擴張活動,直接釋放建立出來的ECS執行個體;繼續響應彈性收縮活動,將ECS執行個體從伸縮組移除。
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)無效。