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

Atualiza a versão do kubelet (recomenda-se corresponder à versão do plano de controle), a versão do sistema operacional ou a versão do runtime de contêiner de um pool de nós de cluster especificado.

Descrição da operação

Atualiza a versão do Kubernetes, a versão do sistema operacional ou a versão do runtime de contêiner dos nós em um pool de nós de cluster especificado. Após chamar com sucesso a operação UpgradeClusterNodepool, a API retorna um task_id para a tarefa de atualização. Você pode gerenciar a tarefa chamando as seguintes operações de API relacionadas a tarefas:

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:UpgradeClusterNodepool

update

*Cluster

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

Nenhuma

Sintaxe da solicitação

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

Parâmetros de caminho

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
ClusterId	string	Sim	O ID do cluster.	c106f377e16f34eb1808d6b9362c9****
NodepoolId	string	Sim	O ID do pool de nós.	np31da1b38983f4511b490fc62108a****

Parâmetros da solicitação

Parâmetro	Tipo	Obrigatório	Descrição	Exemplo
body	object	Não	Os parâmetros da solicitação.
image_id	string	Não	O ID da imagem do sistema do nó.	aliyun_3_x64_20G_container_optimized_20241226.vhd.
runtime_version	string	Não	A versão do runtime do nó. Você pode chamar DescribeKubernetesVersionMetadata para obter as informações da versão do runtime no campo runtime.	1.6.36
kubernetes_version	string	Não	A versão do Kubernetes do nó. Você pode chamar DescribeKubernetesVersionMetadata para obter as informações da versão atual do cluster em `KubernetesVersion`.	1.32.1-aliyun.1
runtime_type	string	Não	O tipo de runtime. Você pode chamar DescribeKubernetesVersionMetadata para obter as informações do runtime no campo runtime.	containerd.
use_replace	boolean	Não	Especifica se deve ser usada a substituição de disco para a atualização. Valores válidos: true: Usa a substituição de disco para atualizar o pool de nós. O ACK reinicializa os nós com base nas configurações atuais do pool de nós, como método de login, labels, taints, imagem do sistema operacional e versão do runtime. false: Não usa a substituição de disco. Valor padrão: false.	false.
rolling_policy	object	Não	A configuração de atualização contínua.
pause_policy	string	Não	A política de pausa automática durante as atualizações de nós. Valores válidos: FirstBatch: Pausa após a conclusão do primeiro lote. EveryBatch: Pausa após a conclusão de cada lote. NotPause: Não pausa.	NotPause.
batch_interval	integer	Não	O intervalo de atualização entre lotes. Este parâmetro entra em vigor apenas quando a política de pausa está definida como `NotPause`. Valores válidos: [5,120]. Unidade: minutos. Este parâmetro pode ser definido como 0, o que indica nenhum intervalo entre lotes.	5
max_parallelism	integer	Não	O número máximo de nós que podem ser atualizados em paralelo por lote. As atualizações do pool de nós são realizadas em lotes. Valores válidos: [1,10]. Valor padrão: 10.	2
max_failed_nodes	integer	Não	O número máximo de nós com falha permitida durante a atualização contínua. Valor padrão: 0, o que indica que a tarefa falha se qualquer nó falhar. Se o valor for maior que 0, a tarefa falha e é interrompida quando o número acumulado de nós com falha exceder este valor.	0
node_names	array	Não	A lista de nós a serem atualizados. Se não for especificado, todos os nós no pool de nós serão atualizados por padrão.
	string	Não	O nome do nó, que serve como identificador do nó dentro do cluster.	cn-beijing.10.180.xx.xx.
ignore_warning_check	boolean	Não	Especifica se as pré-verificações de nível de aviso devem ser ignoradas.

Elementos de resposta

Elemento	Tipo	Descrição	Exemplo
	object
RequestId	string	O ID da solicitação.	2D69A58F-345C-4FDE-88E4-BF518944****
task_id	string	O ID da tarefa.	T-5fd211e924e1d0078700****

Exemplos

Resposta de sucesso

JSON formato

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

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.