az aks nodepool

Note

Esse grupo de comandos tem comandos definidos na CLI do Azure e em pelo menos uma extensão. Instale cada extensão para se beneficiar de seus recursos estendidos. Learn more about extensions.

Comandos para gerenciar pools de nós no cluster Kubernetes kubernetes.

Comandos

Nome	Description	Tipo	Status
az aks nodepool add	Adicione um pool de nós ao cluster gerenciado do Kubernetes.	Core	GA
az aks nodepool add (aks-preview extensão)	Adicione um pool de nós ao cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool delete	Exclua o pool de agentes no cluster gerenciado do Kubernetes.	Core	GA
az aks nodepool delete (aks-preview extensão)	Exclua o pool de agentes no cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool delete-machines	Exclua computadores específicos em um pool de agentes para um cluster gerenciado.	Core	GA
az aks nodepool delete-machines (aks-preview extensão)	Exclua computadores específicos em um pool de agentes para um cluster gerenciado.	Extension	GA
az aks nodepool get-upgrades	Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.	Core	GA
az aks nodepool get-upgrades (aks-preview extensão)	Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool list	Liste pools de nós no cluster gerenciado do Kubernetes. Para obter a lista de nós no cluster, execute `kubectl get nodes` o comando.	Core	GA
az aks nodepool list (aks-preview extensão)	Liste pools de nós no cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool manual-scale	Comandos para gerenciar o pool de nós virtualMachineProfile.scale.manual.	Extension	GA
az aks nodepool manual-scale add	Adicione um novo manual a um pool de agentes do VirtualMachines no cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool manual-scale delete	Exclua um manual existente para um pool de agentes VirtualMachines no cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool manual-scale update	Atualize um manual existente de um agentpool de Máquinas Virtuais no cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool operation-abort	Anule a última operação em execução no pool de nós.	Core	GA
az aks nodepool operation-abort (aks-preview extensão)	Anule a última operação em execução no pool de nós.	Extension	GA
az aks nodepool scale	Dimensione o pool de nós em um cluster gerenciado do Kubernetes.	Core	GA
az aks nodepool scale (aks-preview extensão)	Dimensione o pool de nós em um cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool show	Mostre os detalhes de um pool de nós no cluster gerenciado do Kubernetes.	Core	GA
az aks nodepool show (aks-preview extensão)	Mostre os detalhes de um pool de nós no cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool snapshot	Comandos para gerenciar instantâneos do pool de nós.	Núcleo e extensão	GA
az aks nodepool snapshot create	Crie um instantâneo do pool de nós.	Core	GA
az aks nodepool snapshot create (aks-preview extensão)	Crie um instantâneo do pool de nós.	Extension	GA
az aks nodepool snapshot delete	Exclua um instantâneo do pool de nós.	Core	GA
az aks nodepool snapshot delete (aks-preview extensão)	Exclua um instantâneo do pool de nós.	Extension	GA
az aks nodepool snapshot list	Listar instantâneos do pool de nós.	Core	GA
az aks nodepool snapshot list (aks-preview extensão)	Listar instantâneos do pool de nós.	Extension	GA
az aks nodepool snapshot show	Mostre os detalhes de um instantâneo do pool de nós.	Core	GA
az aks nodepool snapshot show (aks-preview extensão)	Mostre os detalhes de um instantâneo do pool de nós.	Extension	GA
az aks nodepool snapshot update	Atualize as tags em um instantâneo de um pool de nós.	Core	GA
az aks nodepool snapshot update (aks-preview extensão)	Atualize as tags em um instantâneo de um pool de nós.	Extension	GA
az aks nodepool snapshot wait	Aguarde até que um instantâneo do pool de nós atinja um estado desejado.	Core	GA
az aks nodepool start	Inicie o pool de agentes parado no cluster gerenciado do Kubernetes.	Core	GA
az aks nodepool start (aks-preview extensão)	Inicie o pool de agentes parado no cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool stop	Pare de executar o pool de agentes no cluster gerenciado do Kubernetes.	Core	GA
az aks nodepool stop (aks-preview extensão)	Pare de executar o pool de agentes no cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool update	Atualize as propriedades de um pool de nós.	Core	GA
az aks nodepool update (aks-preview extensão)	Atualize as propriedades de um pool de nós.	Extension	GA
az aks nodepool upgrade	Atualize o pool de nós em um cluster gerenciado do Kubernetes.	Core	GA
az aks nodepool upgrade (aks-preview extensão)	Atualize o pool de nós em um cluster gerenciado do Kubernetes.	Extension	GA
az aks nodepool wait	Aguarde até que um pool de nós atinja um estado desejado.	Core	GA

az aks nodepool add

Editar

Adicione um pool de nós ao cluster gerenciado do Kubernetes.

az aks nodepool add --cluster-name
                    --name --nodepool-name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--enable-cluster-autoscaler]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gateway-prefix-size]
                    [--gpu-driver {Install, None}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--max-unavailable]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--vnet-subnet-id]
                    [--zones]

Exemplos

Crie um pool de nós em um cluster do AKS existente com o sistema operacional efêmero habilitado.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Crie um pool de nós com EncryptionAtHost habilitado.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Crie um pool de nós com UltraSSD ativado.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-ultra-ssd

Criar um cluster de pool de nós com um SKU de sistema operacional específico

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --os-sku Ubuntu

Criar um pool de nós com sistema operacional habilitado para FIPS

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-fips-image

Crie um cluster do Kubernetes com uma ID de snapshot.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

criar um pool de nós em um cluster do AKS existente com a ID do grupo de hosts

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

crie um pool de nós com uma ID do Grupo de Reserva de Capacidade (CRG).

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

Criar um pool de nós com o modo de alocação de ip definido como "StaticBlock" e usando um ID de sub-rede de pod

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu --pod-subnet-id /subscriptions/SubID/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Pares de chave-valor separados por vírgula para especificar cabeçalhos personalizados.

--allowed-host-ports

Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por espaços de intervalos com protocolo, por exemplo. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

As IDs dos grupos de segurança do aplicativo aos quais o adaptador de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separadas por espaços.

--crg-id

A id crg usada para associar o novo pool de nós ao recurso Grupo de Reserva de Capacidade existente.

--disable-windows-outbound-nat

Desative o Windows OutboundNAT no pool de nós do agente do Windows.

Propriedade	Valor
Valor padrão:	False

--drain-timeout

Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.

--enable-cluster-autoscaler -e

Habilite o dimensionador automático de cluster.

Propriedade	Valor
Valor padrão:	False

--enable-encryption-at-host

Habilite EncryptionAtHost, o valor padrão é false.

Propriedade	Valor
Valor padrão:	False

--enable-fips-image

Use o sistema operacional habilitado para FIPS em nós de agente.

Propriedade	Valor
Valor padrão:	False

--enable-node-public-ip

Habilite o IP público do nó VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-secure-boot

Habilite a Inicialização Segura no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-ultra-ssd

Ativar UltraSSD, o valor padrão é false.

Propriedade	Valor
Valor padrão:	False

--enable-vtpm

Habilite o vTPM no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--eviction-policy

A política de remoção do pool de nós spot. Ele só pode ser definido quando --priority for Spot.

Propriedade	Valor
Valor padrão:	Delete
Valores aceitos:	Deallocate, Delete

--gateway-prefix-size

O tamanho do IPPrefix público anexado ao pool de nós do modo Gateway. O pool de nós deve estar no modo Gateway.

--gpu-driver

Se o driver deve ser instalado para o pool de nós da GPU. Os valores possíveis são "Instalar" ou "Nenhum". O padrão é "Instalar".

Propriedade	Valor
Valores aceitos:	Install, None

--gpu-instance-profile

Perfil de instância de GPU para particionar GPUs Nvidia multi-GPU.

Propriedade	Valor
Valores aceitos:	MIG1g, MIG2g, MIG3g, MIG4g, MIG7g

--host-group-id

A ID do grupo de hosts dedicado totalmente qualificada usada para provisionar o pool de nós do agente.

--if-match

O valor fornecido será comparado com a ETag do agentpool, se corresponder à operação continuará. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool.

--if-none-match

Defina como '*' para permitir que um novo agentpool seja criado, mas para impedir a atualização de um agentpool existente. Outros valores serão ignorados.

--kubelet-config

Caminho para o arquivo JSON que contém as configurações do Kubelet para nós do agente. https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

Versão do Kubernetes a ser usada para criar o cluster, como "1.16.9".

Propriedade	Valor
Valor de:	`az aks get-versions`

--labels

Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.

--linux-os-config

Caminho para o arquivo JSON que contém as configurações do sistema operacional para nós do agente do Linux. https://aka.ms/aks/custom-node-config.

--max-count

Contagem máxima de nós usada para o dimensionador automático, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.

--max-pods -m

O número máximo de pods implantados em um nó.

Se não for especificado, os padrões serão baseados no plug-in de rede. 30 para "azure", 110 para "kubenet" ou 250 para "none".

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem usada, por exemplo. 5 ou 33%.

--max-unavailable

O número máximo ou percentual de nós que podem estar simultaneamente indisponíveis durante a atualização. Quando especificado, ele representa o número ou a porcentagem usada, por exemplo. 1 ou 5%.

--message-of-the-day

Caminho para um arquivo contendo a mensagem desejada do dia. Válido apenas para nós linux. Será escrito em /etc/motd.

--min-count

Contagem mínima de nós usada para o dimensionador automático, quando "--enable-cluster-autoscaler" especificado. Especifique o valor no intervalo de [0, 1000] para o pool de nós do usuário e [1,1000] para o pool de nós do sistema.

--mode

O modo de um pool de nós que define a função primária de um pool de nós. Se definido como "Sistema", o AKS prefere o agendamento de pods do sistema para pools de nós com o modo System. Saiba mais em https://aka.ms/aks/nodepool/mode.

Propriedade	Valor
Valor padrão:	User
Valores aceitos:	Gateway, System, User

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-count -c

Número de nós no pool de agentes do Kubernetes. Depois de criar um cluster, você pode alterar o tamanho do pool de nós com az aks scale.

Propriedade	Valor
Valor padrão:	3

--node-osdisk-size

Tamanho em GiB do disco do sistema operacional para cada nó no pool de agentes. Mínimo de 30 GiB.

--node-osdisk-type

Tipo de disco do sistema operacional a ser usado para computadores em um determinado pool de agentes. O padrão é 'Efêmero' quando possível em conjunto com o tamanho da VM e o tamanho do disco do sistema operacional. Não pode ser alterado para este pool após a criação. ('Efêmero' ou 'Gerenciado').

Propriedade	Valor
Valores aceitos:	Ephemeral, Managed

--node-public-ip-prefix-id

ID de prefixo de IP público usado para atribuir IPs públicos a nós VMSS.

--node-public-ip-tags

As ipTags dos IPs públicos do nó.

--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--node-taints

Os contaminadores do nó para o pool de nós.

--node-vm-size -s

Tamanho das máquinas virtuais para criar como nós do Kubernetes. Se o usuário não especificar um, o servidor selecionará um tamanho de VM padrão para ele.

--os-sku

O SKU do sistema operacional do pool de nós do agente. Ubuntu, AzureLinux ou Ubuntu2204 para Linux. Windows2019 ou Windows2022 para Windows.

Propriedade	Valor
Valores aceitos:	AzureLinux, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022

--os-type

O tipo de sistema operacional. Linux ou Windows.

--pod-ip-allocation-mode

Defina o modo de alocação de ip para como os IPs de pod da sub-rede do Azure Pod são alocados para os nós no cluster do AKS. A escolha é entre lotes dinâmicos de IPs individuais ou alocação estática de um conjunto de blocos CIDR. Os valores aceitos são "DynamicIndividual" ou "StaticBlock".

Usado em conjunto com o plug-in de rede "azure". Requires --pod-subnet-id.

Propriedade	Valor
Valores aceitos:	DynamicIndividual, StaticBlock

--pod-subnet-id

A ID do recurso de uma sub-rede em uma VNet existente na qual atribuir pods no cluster (requer azure network-plugin).

--ppg

O ID de um PPG.

--priority

A prioridade do pool de nós.

Propriedade	Valor
Valor padrão:	Regular
Valores aceitos:	Regular, Spot

--scale-down-mode

Descreva como as VMs são adicionadas ou removidas dos pools de nós.

Propriedade	Valor
Valor padrão:	Delete
Valores aceitos:	Deallocate, Delete

--snapshot-id

O ID do instantâneo de origem usado para criar esse pool de nós.

--spot-max-price

Ele só pode ser definido quando --priority for Spot. Especifique o preço máximo que você está disposto a pagar em dólares americanos. Os valores possíveis são qualquer valor decimal maior que zero ou -1 que indica que o preço padrão é up-to sob demanda. Ele só pode incluir até 5 casas decimais.

Propriedade	Valor
Valor padrão:	nan

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--undrainable-node-behavior

Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Agendar".

Propriedade	Valor
Valor padrão:	Schedule

--vnet-subnet-id

A ID do recurso de uma sub-rede em uma VNet existente na qual implantar o cluster.

--zones -z

Zonas de disponibilidade em que os nós do agente serão colocados. Além disso, para instalar nós de agente em mais de uma zona, você precisa passar números de zona separados por espaços em branco. Por exemplo - Para ter todas as 3 zonas, espera-se que você insira --zones 1 2 3.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool add (aks-preview extensão)

Adicione um pool de nós ao cluster gerenciado do Kubernetes.

az aks nodepool add --cluster-name
                    --name --nodepool-name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--driver-type {CUDA, GRID}]
                    [--enable-artifact-streaming]
                    [--enable-cluster-autoscaler]
                    [--enable-custom-ca-trust]
                    [--enable-encryption-at-host]
                    [--enable-fips-image]
                    [--enable-node-public-ip]
                    [--enable-secure-boot]
                    [--enable-ultra-ssd]
                    [--enable-vtpm]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gateway-prefix-size]
                    [--gpu-driver {Install, None}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--if-match]
                    [--if-none-match]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-blocked-nodes]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--max-unavailable]
                    [--message-of-the-day]
                    [--min-count]
                    [--mode {Gateway, System, User}]
                    [--no-wait]
                    [--node-count]
                    [--node-osdisk-size]
                    [--node-osdisk-type {Ephemeral, Managed}]
                    [--node-public-ip-prefix-id]
                    [--node-public-ip-tags]
                    [--node-soak-duration]
                    [--node-taints]
                    [--node-vm-size]
                    [--os-sku {AzureLinux, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, WindowsAnnual}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, localuser}]
                    [--tags]
                    [--undrainable-node-behavior]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi}]
                    [--zones]

Exemplos

Crie um pool de nós em um cluster do AKS existente com o sistema operacional efêmero habilitado.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --node-osdisk-type Ephemeral --node-osdisk-size 48

Crie um pool de nós com EncryptionAtHost habilitado.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --enable-encryption-at-host

Criar um pool de nós com um os-sku específico

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu

Crie um pool de nós que possa executar cargas de trabalho wasm.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --workload-runtime WasmWasi

Crie um cluster do Kubernetes com uma ID de snapshot.

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --kubernetes-version 1.20.9 --snapshot-id "/subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/snapshots/mysnapshot1"

crie um pool de nós com uma ID do Grupo de Reserva de Capacidade (CRG).

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --node-vm-size VMSize --crg-id "/subscriptions/SubID/resourceGroups/ResourceGroupName/providers/Microsoft.ContainerService/CapacityReservationGroups/MyCRGID"

criar um pool de nós em um cluster do AKS existente com a ID do grupo de hosts

az aks nodepool add -g MyResourceGroup -n MyNodePool --cluster-name MyMC --host-group-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.ContainerService/hostGroups/myHostGroup --node-vm-size VMSize

Criar um pool de nós com o modo de alocação de ip definido como "StaticBlock" e usando um ID de sub-rede de pod

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster  --os-sku Ubuntu --pod-subnet-id /subscriptions/00000/resourceGroups/AnotherResourceGroup/providers/Microsoft.Network/virtualNetworks/MyVnet/subnets/MySubnet --pod-ip-allocation-mode StaticBlock

Criar um pool de nós do tipo VirtualMachines

az aks nodepool add -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster --vm-set-type VirtualMachines --vm-sizes "Standard_D4s_v3,Standard_D8s_v3" --node-count 3

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--allowed-host-ports

Versão Prévia

Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por vírgulas de intervalos com protocolo, por exemplo. 80 / TCP, 443 / TCP, 4000-5000 / TCP. Deve usar o tipo de pool de agentes VMSS.

--asg-ids

Versão Prévia

As IDs dos grupos de segurança do aplicativo aos quais o adaptador de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por vírgulas. Deve usar o tipo de pool de agentes VMSS.

--crg-id

Versão Prévia

O crg-id usado para associar o novo pool de nós ao recurso de Grupo de Reserva de Capacidade existente. Deve usar o tipo de pool de agentes VMSS.

--disable-windows-outbound-nat

Desative o Windows OutboundNAT no pool de nós do agente do Windows. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--drain-timeout

Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.

--driver-type

Versão Prévia

Especifique o tipo de driver de GPU a ser instalado ao criar pools de agentes do Windows. Os valores válidos são "GRID" e "CUDA". Se não for fornecido, o AKS selecionará o driver com base na compatibilidade do sistema. Essa opção não pode ser alterada depois que o AgentPool for criado. O padrão é sistema selecionado.

Propriedade	Valor
Valores aceitos:	CUDA, GRID

--enable-artifact-streaming

Versão Prévia

Habilite o streaming de artefato para VirtualMachineScaleSets gerenciado por um pool de nós, para acelerar a inicialização a frio de contêineres em um nó por meio do carregamento de imagem sob demanda. Para usar esse recurso, as imagens de contêiner também devem habilitar o streaming de artefatos no ACR. Se não for especificado, o padrão será false.

Propriedade	Valor
Valor padrão:	False

--enable-cluster-autoscaler -e

Habilite o dimensionador automático de cluster. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-custom-ca-trust

Habilite a confiança de CA personalizada no pool de nós do agente.

Propriedade	Valor
Valor padrão:	False

--enable-encryption-at-host

Habilite EncryptionAtHost no pool de nós do agente.

Propriedade	Valor
Valor padrão:	False

--enable-fips-image

Use o sistema operacional habilitado para FIPS em nós de agente.

Propriedade	Valor
Valor padrão:	False

--enable-node-public-ip

Habilite o IP público do nó VMSS. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-secure-boot

Versão Prévia

Habilite a Inicialização Segura no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-ultra-ssd

Habilite o UltraSSD no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-vtpm

Versão Prévia

Habilite o vTPM no pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--eviction-policy

A política de remoção do pool de nós spot. Ele só pode ser definido quando --priority for Spot.

Propriedade	Valor
Valor padrão:	Delete
Valores aceitos:	Deallocate, Delete

--gateway-prefix-size

Versão Prévia

O tamanho do IPPrefix público anexado ao pool de nós do modo Gateway. O pool de nós deve estar no modo Gateway.

--gpu-driver

Se o driver deve ser instalado para o pool de nós da GPU. Os valores possíveis são "Instalar" ou "Nenhum". O padrão é "Instalar".

Propriedade	Valor
Valores aceitos:	Install, None

--gpu-instance-profile

Perfil de instância de GPU para particionar GPUs Nvidia multi-GPU.

Propriedade	Valor
Valores aceitos:	MIG1g, MIG2g, MIG3g, MIG4g, MIG7g

--host-group-id

(VISUALIZAÇÃO) A ID do grupo de hosts dedicado totalmente qualificada usada para provisionar o pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.

--if-match

--if-none-match

Defina como '*' para permitir que um novo agentpool seja criado, mas para impedir a atualização de um agentpool existente. Outros valores serão ignorados.

--kubelet-config

Configurações do Kubelet para nós de agente.

--kubernetes-version -k

Versão do Kubernetes a ser usada para criar o cluster, como "1.7.12" ou "1.8.7".

Propriedade	Valor
Valor de:	`az aks get-versions`

--labels

Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.

--linux-os-config

Configurações do sistema operacional para nós do agente do Linux.

--max-blocked-nodes

O número máximo ou porcentagem de nós extras que têm permissão para serem bloqueados no pool de agentes durante uma atualização quando o comportamento do nó não indesenível é Cordon. Quando especificado, ele representa o número ou a porcentagem usada, por exemplo. 1 ou 5%.

--max-count

--max-pods -m

O número máximo de pods implantados em um nó.

Se não for especificado, os padrões serão baseados no plug-in de rede. 30 para "azure", 110 para "kubenet" ou 250 para "none".

Propriedade	Valor
Valor padrão:	0

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem usada, por exemplo. 5 ou 33%.

--max-unavailable

--message-of-the-day

Caminho para um arquivo contendo a mensagem desejada do dia. Válido apenas para nós linux. Será escrito em /etc/motd.

--min-count

--mode

Propriedade	Valor
Valor padrão:	User
Valores aceitos:	Gateway, System, User

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-count -c

Número de nós no pool de agentes do Kubernetes. Depois de criar um cluster, você pode alterar o tamanho do pool de nós com az aks scale.

Propriedade	Valor
Valor padrão:	3

--node-osdisk-size

Tamanho em GiB do disco do sistema operacional para cada nó no pool de agentes. Mínimo de 30 GiB.

Propriedade	Valor
Valor padrão:	0

--node-osdisk-type

Propriedade	Valor
Valores aceitos:	Ephemeral, Managed

--node-public-ip-prefix-id

ID de prefixo de IP público usado para atribuir IPs públicos a nós VMSS. Deve usar o tipo de pool de agentes VMSS.

--node-public-ip-tags

As ipTags dos IPs públicos do nó. Deve usar o tipo de pool de agentes VMSS.

--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--node-taints

Os contaminadores do nó para o pool de nós.

--node-vm-size -s

Tamanho das máquinas virtuais para criar como nós do Kubernetes. Se o usuário não especificar um, o servidor selecionará um tamanho de VM padrão para ele.

--os-sku

O os-sku do pool de nós do agente. Ubuntu, CBLMariner, Ubuntu2204 ou Ubuntu2404 quando o tipo de sistema operacional é Linux, o padrão é Ubuntu se não estiver definido; Windows2019, Windows2022 ou WindowsAnnual quando o tipo de sistema operacional é Windows, o padrão atual é Windows2022 se não estiver definido.

Propriedade	Valor
Valores aceitos:	AzureLinux, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, WindowsAnnual

--os-type

O tipo de sistema operacional. Linux ou Windows. O Windows ainda não é compatível com o tipo de conjunto de VM "VirtualMachines".

--pod-ip-allocation-mode

Usado em conjunto com o plug-in de rede "azure". Requires --pod-subnet-id.

Propriedade	Valor
Valores aceitos:	DynamicIndividual, StaticBlock

--pod-subnet-id

A ID de uma sub-rede em uma VNet existente na qual atribuir pods no cluster (requer azure network-plugin).

--ppg

O ID de um PPG. Deve usar o tipo de pool de agentes VMSS.

--priority

A prioridade do pool de nós.

Propriedade	Valor
Valor padrão:	Regular
Valores aceitos:	Regular, Spot

--scale-down-mode

Descreve como as VMs são adicionadas ou removidas de pools de nós.

Propriedade	Valor
Valor padrão:	Delete
Valores aceitos:	Deallocate, Delete

--snapshot-id

O ID do instantâneo de origem usado para criar esse pool de nós. Deve usar o tipo de pool de agentes VMSS.

--spot-max-price

Propriedade	Valor
Valor padrão:	nan

--ssh-access

Versão Prévia

Defina a configuração de SSH para o pool de nós. Use "disabled" para desabilitar o acesso SSH, "localuser" para habilitar o acesso SSH usando a chave privada.

Propriedade	Valor
Valor padrão:	localuser
Valores aceitos:	disabled, localuser

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--undrainable-node-behavior

Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Agendar".

--vm-set-type

Tipo de conjunto de vm do pool de agentes. VirtualMachineScaleSets, AvailabilitySet ou VirtualMachines (versão prévia).

--vm-sizes

Versão Prévia

Lista de tamanhos separados por vírgulas. Deve usar o tipo de pool de agentes de Máquinas Virtuais.

--vnet-subnet-id

O ID de uma sub-rede em uma VNet existente na qual implantar o cluster.

--workload-runtime

Determina o tipo de carga de trabalho que um nó pode executar. O padrão é OCIContainer.

Propriedade	Valor
Valor padrão:	OCIContainer
Valores aceitos:	KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi

--zones -z

Lista separada por espaço de zonas de disponibilidade em que os nós do agente serão colocados. Deve usar o tipo de pool de agentes VMSS.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool delete

Editar

Exclua o pool de agentes no cluster gerenciado do Kubernetes.

az aks nodepool delete --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--if-match]
                       [--ignore-pdb]
                       [--no-wait]

Exemplos

Excluir um pool de agentes com ignore-pdb

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --if-match etag --ignore-pdb

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--if-match

O valor fornecido será comparado com a ETag do pool de nós, se corresponder a operação continuará. Se não corresponder, a solicitação será rejeitada para evitar substituições acidentais. Isso não deve ser especificado ao criar um novo agentpool.

--ignore-pdb -i

Exclua um nodepool existente sem considerar o orçamento de interrupção do pod.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool delete (aks-preview extensão)

Exclua o pool de agentes no cluster gerenciado do Kubernetes.

az aks nodepool delete --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--if-match]
                       [--ignore-pod-disruption-budget]
                       [--no-wait]

Exemplos

Excluir um pool de agentes com ignore-pod-disruption-budget

az aks nodepool delete --resource-group MyResourceGroup --cluster-name MyManagedCluster --name nodepool1 --ignore-pod-disruption-budget=true

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--if-match

--ignore-pod-disruption-budget -i

Versão Prévia

(PREVIEW) ignore-pod-disruption-budget exclui um pool de nós existente sem considerar o Orçamento de Interrupção do Pod.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool delete-machines

Editar

Exclua computadores específicos em um pool de agentes para um cluster gerenciado.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Exemplos

Excluir computadores específicos em um pool de agentes

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--machine-names

Lista separada por espaço de nomes de máquinas do pool de agentes a serem excluídos.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool delete-machines (aks-preview extensão)

Exclua computadores específicos em um pool de agentes para um cluster gerenciado.

az aks nodepool delete-machines --cluster-name
                                --machine-names
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Exemplos

Excluir computadores específicos em um pool de agentes

az aks nodepool delete-machines -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster --machine-names machine1

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--machine-names

Lista separada por espaço de nomes de máquinas do pool de agentes a serem excluídos.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool get-upgrades

Editar

Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.

az aks nodepool get-upgrades --cluster-name
                             --name --nodepool-name
                             --resource-group

Exemplos

Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool get-upgrades (aks-preview extensão)

Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.

az aks nodepool get-upgrades --cluster-name
                             --name --nodepool-name
                             --resource-group

Exemplos

Obtenha as versões de atualização disponíveis para um pool de agentes do cluster gerenciado do Kubernetes.

az aks nodepool get-upgrades --resource-group MyResourceGroup --cluster-name MyManagedCluster --nodepool-name MyNodePool

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool list

Editar

Liste pools de nós no cluster gerenciado do Kubernetes. Para obter a lista de nós no cluster, execute kubectl get nodes o comando.

az aks nodepool list --cluster-name
                     --resource-group

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool list (aks-preview extensão)

Liste pools de nós no cluster gerenciado do Kubernetes.

az aks nodepool list --cluster-name
                     --resource-group

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool operation-abort

Editar

Anule a última operação em execução no pool de nós.

az aks nodepool operation-abort --cluster-name
                                --name --nodepool-name
                                --resource-group
                                [--no-wait]

Exemplos

Anular operação no pool de agentes

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool operation-abort (aks-preview extensão)

Anule a última operação em execução no pool de nós.

az aks nodepool operation-abort --cluster-name
                                --name --nodepool-name
                                --resource-group
                                [--aks-custom-headers]
                                [--no-wait]

Exemplos

Anular operação no pool de agentes

az aks nodepool operation-abort -g myResourceGroup --nodepool-name nodepool1 --cluster-name myAKSCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool scale

Editar

Dimensione o pool de nós em um cluster gerenciado do Kubernetes.

az aks nodepool scale --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--no-wait]
                      [--node-count]

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-count -c

Número de nós no pool de nós do Kubernetes.

Propriedade	Valor
Valor padrão:	3

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool scale (aks-preview extensão)

Dimensione o pool de nós em um cluster gerenciado do Kubernetes.

az aks nodepool scale --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]
                      [--node-count]

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-count -c

Número de nós no pool de nós do Kubernetes.

Propriedade	Valor
Valor padrão:	3

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool show

Editar

Mostre os detalhes de um pool de nós no cluster gerenciado do Kubernetes.

az aks nodepool show --cluster-name
                     --name --nodepool-name
                     --resource-group

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool show (aks-preview extensão)

Mostre os detalhes de um pool de nós no cluster gerenciado do Kubernetes.

az aks nodepool show --cluster-name
                     --name --nodepool-name
                     --resource-group

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool start

Editar

Inicie o pool de agentes parado no cluster gerenciado do Kubernetes.

az aks nodepool start --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

Exemplos

Iniciar o pool de agentes no cluster gerenciado

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool start (aks-preview extensão)

Inicie o pool de agentes parado no cluster gerenciado do Kubernetes.

az aks nodepool start --cluster-name
                      --name --nodepool-name
                      --resource-group
                      [--aks-custom-headers]
                      [--no-wait]

Exemplos

Iniciar o pool de agentes no cluster gerenciado

az aks nodepool start --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool stop

Editar

Pare de executar o pool de agentes no cluster gerenciado do Kubernetes.

az aks nodepool stop --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

Exemplos

Parar o pool de agentes no cluster gerenciado

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool stop (aks-preview extensão)

Pare de executar o pool de agentes no cluster gerenciado do Kubernetes.

az aks nodepool stop --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--aks-custom-headers]
                     [--no-wait]

Exemplos

Parar o pool de agentes no cluster gerenciado

az aks nodepool stop --nodepool-name nodepool1 -g MyResourceGroup --cluster-name MyManagedCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool update

Editar

Atualize as propriedades de um pool de nós.

Atualize um pool de nós para habilitar/desabilitar o dimensionador automático de cluster ou alterar min-count ou max-count. Quando chamado sem argumentos opcionais, ele tenta mover o pool de nós para seu estado de meta sem alterar a configuração atual do pool de nós. Isso pode ser usado para sair de um estado não bem-sucedido.

az aks nodepool update --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-cluster-autoscaler]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--max-unavailable]
                       [--min-count]
                       [--mode {Gateway, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, Ubuntu, Ubuntu2204}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]

Exemplos

Reconcilie o pool de nós de volta ao seu estado atual.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Habilitar o dimensionador automático de cluster dentro do intervalo de contagem de nós [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Desabilitar o dimensionador automático de cluster para um cluster existente

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Atualize min-count ou max-count para dimensionador automático de cluster.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Pares de chave-valor separados por vírgula para especificar cabeçalhos personalizados.

--allowed-host-ports

Exponha as portas do host no pool de nós. Quando especificado, o formato deve ser uma lista separada por espaços de intervalos com protocolo, por exemplo. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

As IDs dos grupos de segurança do aplicativo aos quais o adaptador de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separadas por espaços.

--disable-cluster-autoscaler -d

Desative o dimensionador automático de cluster.

Propriedade	Valor
Valor padrão:	False

--disable-fips-image

Alterne para usar o sistema operacional não habilitado para FIPS nos nós do agente.

Propriedade	Valor
Valor padrão:	False

--disable-secure-boot

Desabilite a Inicialização Segura ativada em um pool de nós de agente habilitado para Inicialização Confiável.

Propriedade	Valor
Valor padrão:	False

--disable-vtpm

Desabilite o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente.

Propriedade	Valor
Valor padrão:	False

--drain-timeout

Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.

--enable-cluster-autoscaler -e

Habilite o dimensionador automático de cluster.

Propriedade	Valor
Valor padrão:	False

--enable-fips-image

Alterne para usar o sistema operacional habilitado para FIPS nos nós do agente.

Propriedade	Valor
Valor padrão:	False

--enable-secure-boot

Habilite a Inicialização Segura em um pool de nós de agente habilitado para Inicialização Confiável existente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-vtpm

Habilite o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--if-match

--if-none-match

Defina como '*' para permitir que um novo pool de nós seja criado, mas para impedir a atualização de um pool de nós existente. Outros valores serão ignorados.

--labels

Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.

--max-count

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem usada, por exemplo. 5 ou 33%.

--max-unavailable

--min-count

--mode

Propriedade	Valor
Valores aceitos:	Gateway, System, User

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--node-taints

Os contaminadores do nó para o pool de nós. Você pode atualizar o taint de nó existente de um pool de nós ou criar um novo taint de nó para um pool de nós. Passe a string "" vazia para remover todas as manchas.

--os-sku

O os-sku do pool de nós do agente.

Propriedade	Valor
Valores aceitos:	AzureLinux, Ubuntu, Ubuntu2204

--scale-down-mode

Descreva como as VMs são adicionadas ou removidas dos pools de nós.

Propriedade	Valor
Valores aceitos:	Deallocate, Delete

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--undrainable-node-behavior

Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Agendar".

--update-cluster-autoscaler -u

Atualize min-count ou max-count para dimensionador automático de cluster.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool update (aks-preview extensão)

Atualize as propriedades de um pool de nós.

az aks nodepool update --cluster-name
                       --name --nodepool-name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--dcat --disable-custom-ca-trust]
                       [--disable-cluster-autoscaler]
                       [--disable-fips-image]
                       [--disable-secure-boot]
                       [--disable-vtpm]
                       [--drain-timeout]
                       [--enable-artifact-streaming]
                       [--enable-cluster-autoscaler]
                       [--enable-custom-ca-trust]
                       [--enable-fips-image]
                       [--enable-secure-boot]
                       [--enable-vtpm]
                       [--if-match]
                       [--if-none-match]
                       [--labels]
                       [--max-blocked-nodes]
                       [--max-count]
                       [--max-surge]
                       [--max-unavailable]
                       [--min-count]
                       [--mode {Gateway, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, Ubuntu, Ubuntu2204, Ubuntu2404}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, localuser}]
                       [--tags]
                       [--undrainable-node-behavior]
                       [--update-cluster-autoscaler]
                       [--yes]

Exemplos

Reconcilie o pool de nós de volta ao seu estado atual.

az aks nodepool update -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Habilitar o dimensionador automático de cluster dentro do intervalo de contagem de nós [1,5]

az aks nodepool update --enable-cluster-autoscaler --min-count 1 --max-count 5 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Desabilitar o dimensionador automático de cluster para um cluster existente

az aks nodepool update --disable-cluster-autoscaler -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Atualize min-count ou max-count para dimensionador automático de cluster.

az aks nodepool update --update-cluster-autoscaler --min-count 1 --max-count 10 -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Alterar um pool de nós para o modo do sistema

az aks nodepool update --mode System -g MyResourceGroup -n nodepool1 --cluster-name MyManagedCluster

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--allowed-host-ports

Versão Prévia

--asg-ids

Versão Prévia

--dcat --disable-custom-ca-trust

Desative a confiança de CA personalizada no pool de nós do agente.

Propriedade	Valor
Valor padrão:	False

--disable-cluster-autoscaler -d

Desative o dimensionador automático de cluster.

Propriedade	Valor
Valor padrão:	False

--disable-fips-image

Alterne para usar o sistema operacional não habilitado para FIPS nos nós do agente.

Propriedade	Valor
Valor padrão:	False

--disable-secure-boot

Versão Prévia

Desabilite a Inicialização Segura ativada em um pool de nós de agente habilitado para Inicialização Confiável.

Propriedade	Valor
Valor padrão:	False

--disable-vtpm

Versão Prévia

Desabilite o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente.

Propriedade	Valor
Valor padrão:	False

--drain-timeout

Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.

--enable-artifact-streaming

Versão Prévia

Propriedade	Valor
Valor padrão:	False

--enable-cluster-autoscaler -e

Habilite o dimensionador automático de cluster. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-custom-ca-trust

Habilite a confiança de CA personalizada no pool de nós do agente.

Propriedade	Valor
Valor padrão:	False

--enable-fips-image

Alterne para usar o sistema operacional habilitado para FIPS nos nós do agente.

Propriedade	Valor
Valor padrão:	False

--enable-secure-boot

Versão Prévia

Habilite a Inicialização Segura em um pool de nós de agente habilitado para Inicialização Confiável existente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--enable-vtpm

Versão Prévia

Habilite o vTPM em um pool de nós de agente habilitado para Inicialização Confiável existente. Deve usar o tipo de pool de agentes VMSS.

Propriedade	Valor
Valor padrão:	False

--if-match

--if-none-match

Defina como '*' para permitir que um novo pool de nós seja criado, mas para impedir a atualização de um pool de nós existente. Outros valores serão ignorados.

--labels

Os rótulos de nó para o pool de nós. Consulte https://aka.ms/node-labels a sintaxe dos rótulos.

--max-blocked-nodes

--max-count

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem usada, por exemplo. 5 ou 33%.

--max-unavailable

--min-count

--mode

Propriedade	Valor
Valores aceitos:	Gateway, System, User

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--node-taints

Os contaminadores do nó para o pool de nós.

--os-sku

O os-sku do pool de nós do agente.

Propriedade	Valor
Valores aceitos:	AzureLinux, Ubuntu, Ubuntu2204, Ubuntu2404

--scale-down-mode

Descreve como as VMs são adicionadas ou removidas de pools de nós.

Propriedade	Valor
Valores aceitos:	Deallocate, Delete

--ssh-access

Versão Prévia

Atualize a configuração de SSH para o pool de nós. Use "disabled" para desabilitar o acesso SSH, "localuser" para habilitar o acesso SSH usando a chave privada.

Propriedade	Valor
Valores aceitos:	disabled, localuser

--tags

Marcas separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar marcas existentes.

--undrainable-node-behavior

Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Agendar".

--update-cluster-autoscaler -u

Atualize min-count ou max-count para dimensionador automático de cluster.

Propriedade	Valor
Valor padrão:	False

--yes -y

Não solicite confirmação.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool upgrade

Editar

Atualize o pool de nós em um cluster gerenciado do Kubernetes.

az aks nodepool upgrade --cluster-name
                        --name --nodepool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-surge]
                        [--max-unavailable]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--yes]

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Pares de chave-valor separados por vírgula para especificar cabeçalhos personalizados.

--drain-timeout

Quando os nós são drenados, quanto tempo esperar para que todos os pods sejam removidos.

--if-match

--if-none-match

Defina como '*' para permitir que um novo pool de nós seja criado, mas para impedir a atualização de um pool de nós existente. Outros valores serão ignorados.

--kubernetes-version -k

Versão do Kubernetes para atualizar o pool de nós, como "1.16.9".

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem usada, por exemplo. 5 ou 33% (mutuamente exclusivo com "--node-image-only". Consulte "az aks nodepool update --max-surge" para atualizar o pico máximo antes de atualizar com "--node-image-only").

--max-unavailable

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-image-only

Atualizar apenas a imagem do nó do pool de agentes.

Propriedade	Valor
Valor padrão:	False

--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--snapshot-id

A ID do instantâneo de origem usada para atualizar esse pool de nós.

--undrainable-node-behavior

Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Agendar".

--yes -y

Não solicite confirmação.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool upgrade (aks-preview extensão)

Atualize o pool de nós em um cluster gerenciado do Kubernetes.

az aks nodepool upgrade --cluster-name
                        --name --nodepool-name
                        --resource-group
                        [--aks-custom-headers]
                        [--drain-timeout]
                        [--if-match]
                        [--if-none-match]
                        [--kubernetes-version]
                        [--max-blocked-nodes]
                        [--max-surge]
                        [--max-unavailable]
                        [--no-wait]
                        [--node-image-only]
                        [--node-soak-duration]
                        [--snapshot-id]
                        [--undrainable-node-behavior]
                        [--yes]

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--aks-custom-headers

Envie cabeçalhos personalizados. Quando especificado, o formato deve ser Key1=Value1,Key2=Value2.

--drain-timeout

Quando os nós são drenados, quantos minutos esperar para que todos os pods sejam removidos.

--if-match

--if-none-match

Defina como '*' para permitir que um novo pool de nós seja criado, mas para impedir a atualização de um pool de nós existente. Outros valores serão ignorados.

--kubernetes-version -k

Versão do Kubernetes para atualizar o pool de nós, como "1.11.12".

--max-blocked-nodes

--max-surge

Nós extras usados para acelerar a atualização. Quando especificado, representa o número ou porcentagem usada, por exemplo. 5 ou 33%.

--max-unavailable

--no-wait

Não aguarde a conclusão da operação de execução prolongada.

Propriedade	Valor
Valor padrão:	False

--node-image-only

Atualizar apenas a imagem do nó do pool de agentes.

Propriedade	Valor
Valor padrão:	False

--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de reimaginá-lo e passar para o próximo nó.

--snapshot-id

A ID do instantâneo de origem usada para atualizar esse pool de nós. Deve usar o tipo de pool de agentes VMSS.

--undrainable-node-behavior

Defina o comportamento para nós não drenáveis durante a atualização. O valor deve ser "Cordon" ou "Schedule". O valor padrão é "Agendar".

--yes -y

Não solicite confirmação.

Propriedade	Valor
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

az aks nodepool wait

Editar

Aguarde até que um pool de nós atinja um estado desejado.

Se uma operação em um pool de nós foi interrompida ou iniciada com --no-wait, use este comando para aguardar a conclusão.

az aks nodepool wait --cluster-name
                     --name --nodepool-name
                     --resource-group
                     [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--interval]
                     [--timeout]
                     [--updated]

Exemplos

Aguarde até que um pool de nós atinja um estado desejado, sondando a cada minuto por até trinta minutos.

az aks nodepool wait --created --interval 60 --cluster-name MyManagedCluster --resource-group MyResourceGroup --nodepool-name MyNodePool --timeout 1800

Parâmetros Exigidos

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

Nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros Opcionais

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Aguarde até ser criado com 'provisioningState' em 'Succeeded'.

Propriedade	Valor
Parameter group:	Wait Condition Arguments
Valor padrão:	False

--custom

Aguarde até que a condição atenda a uma consulta JMESPath personalizada. Por exemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propriedade	Valor
Parameter group:	Wait Condition Arguments

--deleted

Aguarde até ser excluído.

Propriedade	Valor
Parameter group:	Wait Condition Arguments
Valor padrão:	False

--exists

Aguarde até que o recurso exista.

Propriedade	Valor
Parameter group:	Wait Condition Arguments
Valor padrão:	False

--interval

Intervalo de sondagem em segundos.

Propriedade	Valor
Parameter group:	Wait Condition Arguments
Valor padrão:	30

--timeout

Espera máxima em segundos.

Propriedade	Valor
Parameter group:	Wait Condition Arguments
Valor padrão:	3600

--updated

Aguarde até que seja atualizado com provisioningState em 'Succeeded'.

Propriedade	Valor
Parameter group:	Wait Condition Arguments
Valor padrão:	False

Parâmetros Globais

--debug

Aumente a verbosidade de log para mostrar todos os logs de depuração.

Propriedade	Valor
Valor padrão:	False

--help -h

Mostre esta mensagem de ajuda e saia.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

Propriedade	Valor
Valor padrão:	False

--output -o

Output format.

Propriedade	Valor
Valor padrão:	json
Valores aceitos:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar a verbosidade do registro em log. Use --debug para logs de depuração completos.

Propriedade	Valor
Valor padrão:	False

Compartilhar via

az aks nodepool

Comandos

az aks nodepool add

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool add (aks-preview extensão)

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool delete

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool delete (aks-preview extensão)

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool delete-machines

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool delete-machines (aks-preview extensão)

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool get-upgrades

Exemplos

Parâmetros Exigidos

az aks nodepool get-upgrades (aks-preview extensão)

Exemplos

Parâmetros Exigidos

az aks nodepool list

Parâmetros Exigidos

az aks nodepool list (aks-preview extensão)

Parâmetros Exigidos

az aks nodepool operation-abort

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool operation-abort (aks-preview extensão)

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool scale

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool scale (aks-preview extensão)

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool show

Parâmetros Exigidos

az aks nodepool show (aks-preview extensão)

Parâmetros Exigidos

az aks nodepool start

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool start (aks-preview extensão)

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool stop

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool stop (aks-preview extensão)

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool update

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool update (aks-preview extensão)

Exemplos

Parâmetros Exigidos

Parâmetros Opcionais

az aks nodepool upgrade