すべてのプロダクト
Search

このプロダクト

    Container Service for Kubernetes:ListOperationPlansForRegion

    ドキュメントセンター

    Container Service for Kubernetes:ListOperationPlansForRegion

    最終更新日:Apr 04, 2026

    指定されたリージョン内の最新 100 件の自動 O&M 実行計画リストをクエリします。インテリジェントクラスター管理の自動モード、自動クラスターアップグレード、ノードプールの自動 O&M などの機能が有効な場合、この API を使用して、システムが自動生成した O&M 計画 (クラスターのアップグレードやノードプールの CVE 修正など) とその実行ステータスをクエリできます。

    今すぐお試しください

    この 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 ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    cs:ListOperationPlansForRegion

    none

    *All Resource

    *

    		 なし なし

    リクエスト構文

    GET /regions/{region_id}/operation/plans HTTP/1.1

    パスパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    region_id

    string

    必須

    リージョン ID。

    cn-beijing

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    cluster_id

    string

    任意

    クラスター ID でフィルターします。

    c02b3e03be10643e8a644a843ffcb****
    type

    string

    任意

    実行計画タイプでフィルターします。

    列挙値:

    • CVE_FIX :

      CVE_FIX

    • CONTAINERD_UPGRADE :

      CONTAINERD_UPGRADE

    • CLUSTER_UPGRADE_MASTER :

      CLUSTER_UPGRADE_MASTER

    • CLUSTER_UPGRADE_ADDON :

      CLUSTER_UPGRADE_ADDON

    • NODEPOOL_CONFIG :

      NODEPOOL_CONFIG

    • KUBELET_UPGRADE :

      KUBELET_UPGRADE

    • NODEPOOL_UPDATE_OS :

      NODEPOOL_UPDATE_OS

    • IMAGE_UPGRADE :

      IMAGE_UPGRADE

    CLUSTER_UPGRADE_MASTER
    state

    string

    任意

    実行計画ステータスでフィルターします。

    列挙値:

    • Scheduled :
    • Failed :
    • ValidatingFailed :
    • Executing :
    • Canceled :
    • Executed :

    Scheduled

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    応答のスキーマ

    plans

    array<object>

    実行計画のリスト。

    array<object>

    実行計画。

    plan_id

    string

    実行計画 ID。

    P-655c9c127e0e6603ef00****
    cluster_id

    string

    クラスター ID。

    c29ced64b3dfe4f33b57ca0aa9f68****
    created

    string

    実行計画の作成時刻。

    2023-11-21T20:01:22+08:00
    start_time

    string

    予想開始時刻。

    2023-11-22T15:18:00+08:00
    end_time

    string

    予想実行終了時刻。

    2023-11-22T18:00:00+08:00
    state

    string

    ステータス。

    列挙値:

    • Scheduled :
    • Failed :
    • ValidatingFailed :
    • Executing :
    • Canceled :
    • Executed :

    Scheduled
    state_reason

    object

    ステータス理由。

    code

    string

    コード。

    CanceledByUser
    message

    string

    メッセージ。

    plan has been canceled by user
    type

    string

    タイプ。

    列挙値:

    • CVE_FIX :

      CVE_FIX

    • CONTAINERD_UPGRADE :

      CONTAINERD_UPGRADE

    • CLUSTER_UPGRADE_MASTER :

      CLUSTER_UPGRADE_MASTER

    • CLUSTER_UPGRADE_ADDON :

      CLUSTER_UPGRADE_ADDON

    • NODEPOOL_CONFIG :

      NODEPOOL_CONFIG

    • KUBELET_UPGRADE :

      KUBELET_UPGRADE

    • NODEPOOL_UPDATE_OS :

      NODEPOOL_UPDATE_OS

    • IMAGE_UPGRADE :

      IMAGE_UPGRADE

    CLUSTER_UPGRADE_MASTER
    target_type

    string

    実行ターゲットのタイプ。

    列挙値:

    • cluster :

      cluster

    • nodepool :

      nodepool

    • addon :

      addon

    cluster
    target_id

    string

    実行ターゲットの ID。

    c29ced64b3dfe4f33b57ca0aa9f68****
    task_id

    string

    実行計画によって生成されたジョブ ID。

    T-681ac448b23ced010600****

    例

    成功レスポンス

    JSONJSON

    {
  "plans": [
    {
      "plan_id": "P-655c9c127e0e6603ef00****",
      "cluster_id": "c29ced64b3dfe4f33b57ca0aa9f68****",
      "created": "2023-11-21T20:01:22+08:00",
      "start_time": "2023-11-22T15:18:00+08:00",
      "end_time": "2023-11-22T18:00:00+08:00",
      "state": "Scheduled",
      "state_reason": {
        "code": "CanceledByUser",
        "message": "plan has been canceled by user"
      },
      "type": "CLUSTER_UPGRADE_MASTER",
      "target_type": "cluster",
      "target_id": "c29ced64b3dfe4f33b57ca0aa9f68****",
      "task_id": "T-681ac448b23ced010600****"
    }
  ]
}

    エラーコード

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

    変更履歴

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