升级集群控制面。

注意事项

Kubernetes 次要版本升级可能涉及到 Kubernetes 资源版本变更。升级前请确认您的应用是否使用了已废弃资源。如果您在应用的 Chart 中使用了已废弃资源，则需要更新应用 Chart 中的资源到新版本，再将新的 Chart 更新到集群中。详细的资源变更与弃用说明，请参见 Kubernetes 版本发布记录。

不支持跨 VKE 适配的 Kubernetes 版本升级，例如集群当前版本为 v1.32，则该集群只能升级到 v1.32 的最新补丁版本，或者 v1.34 的最新补丁版本，不支持从 v1.32 直接升级到 v1.36。VKE 适配的 Kubernetes 版本，请参见 Kubernetes 版本发布记录。

同一集群连续升级 Kubernetes 版本时，建议版本升级间隔时间大于 24 小时，确保集群的稳定运行。例如集群从 v1.32 升级至 v1.34，并稳定运行 24 小时后，再将该集群升级至 v1.36 版本。

升级控制面 Kubernetes 版本后可能存在参数不兼容的情况，因此升级操作不会保留您集群维度自定义 Kubelet 等参数，需要升级后重新设置以保证新增节点使用期望的自定义配置。相关操作说明，请参见自定义集群 Kubelet 参数。

请求说明

VKE 已在全球多个地域部署服务，旨在为您提供更稳定、低延迟的访问体验。您可以通过查阅服务地址文档，根据业务所在地域，选择最合适的接入点。

请求地址：https://vke.cn-beijing.volcengineapi.com?Action=UpdateClusterVersion&Version=2022-05-12

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

请求参数

调用该 API 时的请求参数如下，除此之外还需传入公共请求参数。公共请求参数说明，请参见公共参数。

参数	类型	是否必选	示例值	描述
Action	String	是	UpdateClusterVersion	接口名称。当前 API 的名称为 UpdateClusterVersion。
Version	String	是	2022-05-12	接口版本。当前 API 的版本为 2022-05-12。
Id	String	是	cc8o******	目标集群的 ID。可以调用 ListClusters 接口，获取集群 ID。注意集群必须处于{Running,[Ok]}状态。可调用 ListClusters接口获取集群当前的状态。
KubernetesVersion	String	是	1.36	要升级的目标 Kubernetes 版本，格式为x.xx。系统会自动升级到该 Kubernetes 版本对应的最新 VKE 补丁版本。容器服务已发布的 Kubernetes 版本，请参见 Kubernetes 版本发布记录。
Operation	String	否	Precheck	执行的具体操作，取值： Precheck：（默认值）仅执行升级检查操作。 Upgrade：直接执行升级任务，升级任务会包含一次升级检查，检查通过后继续执行升级操作。
IgnorePrecheckWarning	Boolean	否	true	升级检查出现 Warning 时，是否停止升级过程，取值： true：升级检查结果为 Warning 时，忽略检查结果，继续升级集群控制面。 false：（默认值）升级检查结果为 Warning 时，停止升级集群控制面。
ClientToken	String	否	BC028527-33B9-4990-A633-******	用于保证请求幂等性的字符串。该字符串由调用方传入，需保证不同请求之间唯一。ClientToken 对大小写敏感，且最大值不超过 64 个 ASCII 字符。

请求示例

返回参数

本接口返回参数如下表所示，公共返回参数请参见返回结果。

参数	类型	示例值	描述
TaskId	String	ud8ojr****	任务 ID。

返回示例

错误码

本接口错误码如下表所示，公共错误码请参见公共错误码。

HTTP 状态码	错误码	错误信息	说明
400	OperationDenied.ClusterStatus	The action is forbidden due to cluster status {{statusPhase}} and {{statusConditions}}.	指定集群的当前状态不支持该操作。请确认该接口依赖的集群状态后重试。
400	OperationDenied.KubernetesVersion	The action has been denied due to the kubernetes version upgrade constraints.	不满足 Kubernetes 版本升级约束，无法执行此操作。请仔细阅读控制面升级注意事项，确认参数配置后重试。