全部产品
Search

搜索本产品

    容器服务 Kubernetes 版 ACK：UpgradeCluster - 升级集群

    文档中心

    容器服务 Kubernetes 版 ACK：UpgradeCluster - 升级集群

    更新时间：Aug 27, 2026

    为避免过期版本集群潜在的安全和稳定性风险，同时享用新集群版本的新功能，请随ACK集群的版本发布节奏升级集群。您可以调用UpgradeCluster接口手动升级集群。

    接口说明

    成功调用 UpgradeCluster 接口后，该 API 将返回此次升级任务的task_id，您可以通过调用任务 API 管理该操作任务：

    重要 自 2026 年 07 月 04 日起，请求入参 rolling_policy、rolling_policy.max_parallelism 不再生效，推荐使用 UpgradeClusterNodepool 升级 Worker 节点。变更详情请参见关于 ACK 集群管理相关的 OpenAPI 出入参变化及 OpenAPI 下线的公告。

    调试

    您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    cs:UpgradeCluster

    update

    *Cluster

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

    		 无 无

    请求语法

    POST /api/v2/clusters/{ClusterId}/upgrade HTTP/1.1

    路径参数

    名称

    类型

    必填

    描述

    示例值
    ClusterId

    string

    是

    集群 ID。

    c82e6987e2961451182edacd74faf****

    请求参数

    名称

    类型

    必填

    描述

    示例值
    body

    object

    否

    请求体参数。

    k8s
    component_name deprecated

    string

    否

    【该参数已废弃】无需传递。

    null
    next_version

    string

    否

    集群升级的目标版本。

    1.32.1-aliyun.1
    version deprecated

    string

    否

    【该参数已废弃】请使用next_version参数替代。

    null
    master_only

    boolean

    否

    是否仅升级控制面。

    • true：仅升级控制面。

    • false：升级控制面和工作节点。

    true
    rolling_policy deprecated

    object

    否

    轮转配置。

    max_parallelism deprecated

    integer

    否

    每批次工作节点升级的最大并行数。

    工作节点升级过程会根据设置的最大并行数，依次对节点进行升级。每个批次的升级节点数依次为 1、2、4、8……直至达到最大并行数。达到最大并行数后，每个批次都按最大并行数的节点进行升级。

    3

    返回参数

    名称

    类型

    描述

    示例值

    object

    cluster_id

    string

    集群 ID。

    c82e6987e2961451182edacd74faf****
    task_id

    string

    任务 ID。

    T-5faa48fb31b6b8078d00****
    request_id

    string

    请求 ID。

    0527ac9a-c899-4341-a21a-****

    示例

    正常返回示例

    JSON格式

    {
  "cluster_id": "c82e6987e2961451182edacd74faf****",
  "task_id": "T-5faa48fb31b6b8078d00****",
  "request_id": "0527ac9a-c899-4341-a21a-****"
}

    错误码

    访问错误中心查看更多错误码。

    变更历史

    更多信息，参考变更详情。