Todos os produtos
Search
Central de documentação

:UpgradeCluster

Última atualização: Jul 08, 2026

Atualize um cluster pelo ID do cluster.

Depuração

O OpenAPI Explorer calcula automaticamente o valor da assinatura. Para sua conveniência, recomendamos chamar esta operação no OpenAPI Explorer. O OpenAPI Explorer gera dinamicamente exemplos de código da operação para diferentes SDKs.

Sintaxe da requisição

POST /api/v2/clusters/ClusterId/upgrade HTTP/1.1
Content-Type:application/json

{
  "next_version" : "String",
  "master_only" : Boolean
}

Parâmetros da requisição

Parâmetros de caminho da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

ClusterId

String

Sim

c82e6987e2961451182edacd74faf****

O ID do cluster.

Parâmetros do corpo da requisição

Parâmetro

Tipo

Obrigatório

Exemplo

Descrição

component_name String Não k8s

Este parâmetro foi descontinuado.

next_version String Não 1.24.6-aliyun.1

Versão do Kubernetes para atualizar o cluster.

version String Não 1.24.6-aliyun.1

Este parâmetro foi descontinuado. Especifique a versão do Kubernetes no parâmetro next_version.

master_only Boolean Não true

Define se apenas os nós mestres devem ser atualizados. Valores válidos:

  • true: atualiza somente os nós mestres.
  • false: atualiza os nós mestres e workers.

Sintaxe da resposta

HTTP/1.1 200 OK

Parâmetros de resposta

Exemplos

Exemplos de requisições

POST /api/v2/clusters/c82e6987e2961451182edacd74faf****/upgrade HTTP/1.1 
Content-Type:application/json
{
  "next_version" : "1.24.6-aliyun.1"
}

Exemplos de respostas de sucesso

Formato JSON

HTTP/1.1 200 OK

Códigos de erro

Para obter mais códigos de erro, consulte Códigos de erro do serviço.