すべてのプロダクト
Search

このプロダクト

    Platform For AI:GetLifecycle

    ドキュメントセンター

    Platform For AI:GetLifecycle

    最終更新日:Nov 27, 2025

    インスタンスのライフサイクルを取得します。

    操作説明

    インスタンスのライフサイクルトランジション情報を取得します。 特定の時点におけるインスタンスの状態の詳細を取得できます。

    今すぐお試しください

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

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    paidsw:GetLifecycle

    get

    *All Resource

    *

    		 なし なし

    リクエスト構文

    GET /api/v2/instances/{InstanceId}/lifecycle HTTP/1.1

    パスパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    インスタンス ID。 インスタンス ID の取得方法の詳細については、「ListInstances」をご参照ください。

    dsw-9698d842b6***

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    SessionNumber

    integer

    任意

    セッションとは、インスタンスが起動してから失敗または停止するまでの期間です。 sessionNumber は、セッションの序数オフセットを指定します。

    1
    StartTime

    string

    任意

    クエリの開始時刻。

    2020-11-08T15:00:00Z
    EndTime

    string

    任意

    クエリの終了時刻。

    2020-11-08T15:00:00Z
    Limit

    integer

    任意

    クエリで返すセッションの最大数。

    1
    Order

    string

    任意

    結果をソートする順序。 有効な値：

    • ASC：時間による昇順。

    • DESC：時間による降順。

    DESC
    Token

    string

    任意

    URL を共有するために使用されるトークン。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    ライフサイクルクエリの結果。

    RequestId

    string

    リクエスト ID。

    E7D55162-4489-1619-AAF5-3F97D5FC****
    Success

    boolean

    リクエストが成功したかどうかを示します。 有効な値：

    • true

    • false

    true
    Message

    string

    操作に対して返されたメッセージ。

    "XXX"
    Code

    string

    状態コード。 有効な値：

    • InternalError：内部エラーが発生しました。 パラメーター検証エラーを除くすべてのエラーが含まれます。

    • ValidationError：パラメーター検証エラーが発生しました。

    null
    Lifecycle

    array<object>

    セッションごとに整理されたインスタンスのライフサイクルの詳細。

    [[{"Status":"Creating","GmtCreateTime":"2022-09-19T22:38:00Z","Reason":"","ReasonCode":""}]]

    array<object>

    ライフサイクルのリスト。各サブキーはセッションのライフサイクルを表します。

    object

    単一のライフサイクルイベント。

    Status

    string

    インスタンスのステータス。 指定可能な値：

    • Creating：インスタンスを作成しています。

    • SaveFailed：インスタンスイメージの保存に失敗しました。

    • Stopped：インスタンスは停止しています。

    • Failed：インスタンスの作成に失敗しました。

    • ResourceAllocating：リソースを割り当てています。

    • Stopping：インスタンスを停止しています。

    • Updating：インスタンスを更新しています。

    • Saving：インスタンスを保存しています。

    • Starting：インスタンスを起動しています。

    • Running：インスタンスは実行中です。

    • Saved：インスタンスは保存されました。

    • EnvPreparing：環境を準備しています。

    • ArrearStopping：支払い遅延のため停止中です。

    • Arrearge：支払い遅延のため停止しました。

    • Queuing：インスタンスはキューで待機中です。

    • Recovering：インスタンスを回復しています。

    列挙値:

    • ArrearStopping :

      ArrearStopping

    • Creating :

      Creating

    • SaveFailed :

      SaveFailed

    • Stopped :

      Stopped

    • Failed :

      Failed

    • ResourceAllocating :

      ResourceAllocating

    • Stopping :

      Stopping

    • Updating :

      Updating

    • Saving :

      Saving

    • Arrearge :

      Arrearage

    • Queuing :

      Queuing

    • Recovering :

      Recovering

    • Starting :

      Starting

    • Running :

      Running

    • Saved :

      Saved

    • EnvPreparing :

      EnvPreparing

    Starting
    ReasonCode

    string

    イベントが発生した理由のコード。

    “”
    ReasonMessage

    string

    イベントが発生した理由の説明。

    “”
    GmtCreateTime

    string

    インスタンスがこの状態に移行した時刻。 時刻は GMT です。

    2022-10-21T07:27:44Z
    GmtEndTime

    string

    LifecycleId

    string

    TotalCount

    integer

    返されたセッションの総数。

    35

    例

    成功レスポンス

    JSONJSON

    {
  "RequestId": "E7D55162-4489-1619-AAF5-3F97D5FC****",
  "Success": true,
  "Message": "\"XXX\"",
  "Code": "null",
  "Lifecycle": [
    [
      {
        "Status": "Starting",
        "ReasonCode": "“”",
        "ReasonMessage": "“”",
        "GmtCreateTime": "2022-10-21T07:27:44Z",
        "GmtEndTime": "",
        "LifecycleId": ""
      }
    ]
  ],
  "TotalCount": 35
}

    エラーコード

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

    変更履歴

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