UpgradeCluster - Container Service for Kubernetes: Central de Documentação do Alibaba Cloud

Versões desatualizadas do Kubernetes podem apresentar problemas de segurança e estabilidade. Recomendamos que você atualize a versão do Kubernetes do seu cluster o mais rápido possível para aproveitar os novos recursos da nova versão do Kubernetes. Você pode chamar a operação UpgradeCluster para atualizar manualmente um cluster.

Descrição da operação

Após chamar a operação UpgradeCluster com sucesso, esta API retorna o task_id da tarefa de atualização. Você pode gerenciar esta tarefa de operação chamando as seguintes APIs de tarefa:\n- Chame DescribeTaskInfo para consultar os detalhes da tarefa\n- Chame PauseTask para pausar uma tarefa em execução \n- Chame ResumeTask para retomar uma tarefa que foi pausada \n- Chame CancelTask para cancelar uma tarefa em execução

Experimente agora

Experimente esta API no OpenAPI Explorer, sem necessidade de assinatura manual. Chamadas bem-sucedidas geram automaticamente código SDK correspondente aos seus parâmetros. Faça o download com segurança de credenciais integrada para uso local.

Testar

Autorização RAM

A tabela abaixo descreve a autorização necessária para chamar esta API. Você pode defini-la em uma política do Resource Access Management (RAM). As colunas da tabela estão detalhadas abaixo:

Ação: As ações que podem ser usadas no elemento Action das instruções de política de permissão do RAM para conceder permissões para executar a operação.
API: A API que você pode chamar para executar a ação.
Nível de acesso: O nível de acesso predefinido concedido para cada API. Valores válidos: create, list, get, update e delete.
Tipo de recurso: O tipo de recurso que suporta autorização para executar a ação. Indica se a ação suporta permissão em nível de recurso. O recurso especificado deve ser compatível com a ação. Caso contrário, a política será ineficaz.
- Para APIs com permissões em nível de recurso, os tipos de recursos obrigatórios são marcados com um asterisco (*). Especifique o Nome de Recurso Alibaba Cloud (ARN) correspondente no elemento Resource da política.
- Para APIs sem permissões em nível de recurso, é exibido como Todos os Recursos. Use um asterisco (*) no elemento Resource da política.
Chave de condição: As chaves de condição definidas pelo serviço. A chave permite controle granular, aplicando-se somente a ações ou a ações associadas a recursos específicos. Além das chaves de condição específicas do serviço, o Alibaba Cloud fornece um conjunto de chaves de condição comuns aplicáveis a todos os serviços compatíveis com RAM.
Ação dependente: As ações dependentes necessárias para executar a ação. Para concluir a ação, o usuário RAM ou a função RAM deve ter permissões para executar todas as ações dependentes.

Ação

Nível de acesso

Tipo de recurso

Chave de condição

Ação dependente

cs:UpgradeCluster

update

*Cluster.

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

Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster que você deseja atualizar.	c82e6987e2961451182edacd74faf****

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	Os parâmetros do corpo da solicitação.	k8s
component_name `deprecated`	string	Não	Este parâmetro foi descontinuado. Não é necessário passar valores.	null
next_version	string	Não	A versão de destino do Kubernetes para a atualização do cluster.	1.32.1-aliyun.1
version `deprecated`	string	Não	Este parâmetro foi descontinuado. Use next_version para especificar a versão de destino do Kubernetes para a atualização.	null
master_only	boolean	Não	Especifica se apenas os nós mestres devem ser atualizados. Valores válidos:\n\n* true: atualiza apenas os nós mestres.\n* false: atualiza os nós mestres e os nós de trabalho.	true
rolling_policy `deprecated`	object	Não	A configuração de atualização em rolagem.
max_parallelism `deprecated`	integer	Não	O número máximo de nós atualizados simultaneamente por lote.	3

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
cluster_id	string	O ID do cluster.	c82e6987e2961451182edacd74faf****
task_id	string	O ID da tarefa.	T-5faa48fb31b6b8078d00****
request_id	string	O ID da solicitação.	0527ac9a-c899-4341-a21a-****

Exemplos

Resposta de sucesso

JSON formato

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

Códigos de erro

Consulte Códigos de Erro para uma lista completa.

Notas de versão

Consulte Notas de Versão para uma lista completa.