全部產品
Search

搜尋本產品

    Container Service for Kubernetes：UpgradeClusterNodepool

    文件中心

    Container Service for Kubernetes：UpgradeClusterNodepool

    更新時間：Jul 24, 2026

    您可以呼叫 UpgradeClusterNodepool 介面升級指定叢集節點池的 kubelet 版本（建議與控制面版本一致）、作業系統版本或容器執行時版本。

    介面說明

    透過 UpgradeClusterNodepool 可升級指定叢集節點池內節點的 Kubernetes 版本、作業系統版本或容器執行時版本。成功呼叫 UpgradeClusterNodepool 介面後，該 API 將返回此次升級任務的 task_id，您可以透過呼叫任務 API 管理該操作任務：

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    cs:UpgradeClusterNodepool

    update

    *Cluster

    acs:cs:{#regionId}:{#accountId}:cluster/{#ClusterId}

    		 無 無

    請求文法

    POST /clusters/{ClusterId}/nodepools/{NodepoolId}/upgrade HTTP/1.1

    路徑參數

    名稱

    類型

    必填

    描述

    樣本值
    ClusterId

    string

    是

    叢集 ID。

    c106f377e16f34eb1808d6b9362c9****
    NodepoolId

    string

    是

    節點池 ID。

    np31da1b38983f4511b490fc62108a****

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    body

    object

    否

    請求參數。

    image_id

    string

    否

    節點系統映像 ID。

    aliyun_3_x64_20G_container_optimized_20241226.vhd
    runtime_version

    string

    否

    節點執行時版本。您可以呼叫 DescribeKubernetesVersionMetadata 在 runtime 中取得執行時版本資訊。

    1.6.36
    kubernetes_version

    string

    否

    節點 Kubernetes 版本。您可以呼叫 DescribeKubernetesVersionMetadata 在 KubernetesVersion 中取得目前叢集版本資訊。

    1.32.1-aliyun.1
    runtime_type

    string

    否

    執行時類型。您可以呼叫 DescribeKubernetesVersionMetadata 在 runtime 中取得執行時資訊。

    containerd
    use_replace

    boolean

    否

    是否使用替換磁碟升級。取值：

    • true：使用，即透過替換節點系統磁碟的方式升級節點池，ACK 將按照節點池目前的設定（例如節點登入方式、標籤、污點、作業系統映像、執行時版本）重新初始化節點。

    • false：不使用。

    預設值：false。

    false
    rolling_policy

    object

    否

    輪轉設定。

    pause_policy

    string

    否

    節點升級過程中的自動暫停策略。取值：

    • FirstBatch：第一批完成後暫停。

    • EveryBatch：每批完成後暫停。

    • NotPause：不暫停。

    NotPause
    batch_interval

    integer

    否

    批次之間的升級間隔時間。該參數僅在暫停策略為 NotPause 時生效。

    取值範圍：[5,120]，單位：分鐘。

    該參數支援設定為 0，表示不設定間隔時間。

    5
    max_parallelism

    integer

    否

    節點池內的節點更新分批次執行，該參數定義每批次最大並行更新的節點數。

    取值範圍：[1,10]。

    預設值：10。

    2
    max_failed_nodes

    integer

    否

    允許滾動過程中失敗的最大節點數。預設為 0，即任一節點失敗即判定任務失敗；大於 0 時，累計失敗節點數超過該值則整體判定失敗並停止。

    0
    node_names

    array

    否

    指定升級的節點清單。未指定時預設升級節點池內所有節點。

    string

    否

    節點名稱，叢集內節點識別碼。

    cn-beijing.10.180.xx.xx
    ignore_warning_check

    boolean

    否

    忽略 warning 層級前置檢查。

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    2D69A58F-345C-4FDE-88E4-BF518944****
    task_id

    string

    任務 ID。

    T-5fd211e924e1d0078700****

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "2D69A58F-345C-4FDE-88E4-BF518944****",
  "task_id": "T-5fd211e924e1d0078700****"
}

    錯誤碼

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

    變更歷史

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