全部產品
Search

搜尋本產品

    Container Service for Kubernetes：ListOperationPlansForRegion - 查詢指定地區自動營運任務執行計畫列表

    文件中心

    Container Service for Kubernetes：ListOperationPlansForRegion - 查詢指定地區自動營運任務執行計畫列表

    更新時間：Apr 04, 2026

    查詢指定地區內最近100條自動營運執行計畫列表。開啟叢集智能託管模式Auto Mode、叢集自動升級、節點池自動化營運等功能時，您可以通過該介面查詢由系統自動產生的營運計劃及其執行情況，例如叢集升級、節點池CVE修複等。

    調試

    您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

    調試

    授權資訊

    下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    cs:ListOperationPlansForRegion

    none

    *全部資源

    *

    		 無 無

    請求文法

    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

    Schema of Response

    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****

    樣本

    正常返回樣本

    JSON格式

    {
  "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****"
    }
  ]
}

    錯誤碼

    訪問錯誤中心查看更多錯誤碼。

    變更歷史

    更多資訊，參考變更詳情。