すべてのプロダクト
Search
ドキュメントセンター

Auto Scaling:DescribeLifecycleActions

最終更新日:Sep 10, 2026

スケーリングアクティビティ ID とステータスによってライフサイクルトークンを照会します。

操作説明

操作の説明

スケーリンググループ内でライフサイクルフックに適用されるタイプに一致するスケーリングアクティビティが発生すると、各ライフサイクルフックがライフサイクルアクションをトリガーします。ライフサイクルアクションは、次のいずれかの状態になります:

  • Pending: ECS インスタンスはまだ待機状態です。

  • Timeout: ライフサイクルフックのタイムアウト期間が経過し、ECS インスタンスの待機状態が自動的に終了しました。

  • Completed: ECS インスタンスの待機状態を手動でスケジュールより早く終了しました。

ライフサイクルフックの作成時に、待機状態の終了後に特定の OOS テンプレートをトリガーするなどの後続の操作を設定しなかった場合、この操作を呼び出して、現在のスケーリングアクティビティに対応するライフサイクルアクションの識別子を取得できます。これにより、後続の操作をカスタマイズできます。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

ScalingActivityId

string

必須

スケーリングアクティビティの ID。

asa-bp17mug9t0pegagw****

LifecycleActionStatus

string

任意

ライフサイクルアクションのステータス。有効な値:

  • Pending: ECS インスタンスはまだ待機状態です。

  • Timeout: ライフサイクルフックのタイムアウト期間に達し、ECS インスタンスの待機状態が自動的に終了しました。

  • Completed: ECS インスタンスの待機状態を手動でスケジュールより早く終了しました。

Pending

NextToken

string

任意

クエリの開始位置を指定するために使用されるページネーショントークン。

たとえば、前回のリクエストで 10 個のライフサイクルアクションを照会した場合、このパラメーターを前回の応答で返された NextToken の値にセットして、11 番目のライフサイクルアクションから照会を開始できます。このパラメーターを指定しない場合、クエリは最初から開始されます。

AAAAAcSz4VTb1Nq****

MaxResults

integer

任意

1 ページあたりのエントリの最大値。有効な値: 1~50。

デフォルト値: 10。

10

RegionId

string

任意

スケーリンググループのリージョン ID。

cn-qingdao

レスポンスフィールド

フィールド

説明

object

NextToken

string

この応答で返されたページネーショントークン。

AAAAAcSz4VTb1Nq****

RequestId

string

リクエスト ID。

42A742EB-FCF3-459E-9C62-E107048C17E3

TotalCount

integer

このクエリで返されたライフサイクルアクションの総数。

3

MaxResults

integer

1 ページあたりのエントリの最大値。

3

LifecycleActions

object

LifecycleAction

array<object>

ライフサイクルフックに対応するライフサイクルアクションのリスト。

array<object>

ライフサイクルフックに対応するライフサイクルアクション。

LifecycleHookId

string

ライフサイクルフックの ID。

ash-bp18uoft0deax0f7****

LifecycleActionToken

string

ライフサイクルアクションのトークン。

9C2E9DA7-F794-449A-ACF6-CEE24444****

LifecycleActionStatus

string

ライフサイクルアクションのステータス。

Pending

LifecycleActionResult

string

ライフサイクルフックによってトリガーされたライフサイクルアクションが完了した後に実行される操作。有効な値は次のとおりです。

  • CONTINUE: Auto Scaling はスケールアウトリクエストへの応答を継続し、ECS インスタンスをスケーリンググループに追加します。または、スケールインリクエストへの応答を継続し、ECS インスタンスをスケーリンググループから削除します。

  • ABANDON: Auto Scaling はスケールアウトアクティビティを停止し、作成された ECS インスタンスをリリースします。または、スケールインリクエストへの応答を継続し、ECS インスタンスをスケーリンググループから削除します。

CONTINUE

InstanceIds

object

InstanceId

array

ライフサイクルフックが適用される ECS インスタンスの ID。

string

ECS インスタンスの ID。

["i-bp11m3fzlqrgk5vh****","i-bp11m3fzlqrgk5vh****"]

成功レスポンス

JSONJSON

{
  "NextToken": "AAAAAcSz4VTb1Nq****",
  "RequestId": "42A742EB-FCF3-459E-9C62-E107048C17E3",
  "TotalCount": 3,
  "MaxResults": 3,
  "LifecycleActions": {
    "LifecycleAction": [
      {
        "LifecycleHookId": "ash-bp18uoft0deax0f7****",
        "LifecycleActionToken": "9C2E9DA7-F794-449A-ACF6-CEE24444****",
        "LifecycleActionStatus": "Pending",
        "LifecycleActionResult": "CONTINUE",
        "InstanceIds": {
          "InstanceId": [
            "[\"i-bp11m3fzlqrgk5vh****\",\"i-bp11m3fzlqrgk5vh****\"]"
          ]
        }
      }
    ]
  }
}

エラーコード

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。