Partilhar via


az aks nodepool

Nota

Este 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. Saiba mais sobre extensões.

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

Comandos

Name Description Tipo Status
az aks nodepool add

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

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

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

Extensão GA
az aks nodepool delete

Exclua o pool de agentes no cluster Kubernetes gerenciado.

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

Exclua o pool de agentes no cluster Kubernetes gerenciado.

Extensão GA
az aks nodepool delete-machines

Exclua máquinas específicas em um pool de agentes para um cluster gerenciado.

Extensão GA
az aks nodepool get-upgrades

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

Principal 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 Kubernetes gerenciado.

Extensão GA
az aks nodepool list

Listar pools de nós no cluster Kubernetes gerenciado. Para obter a lista de nós no comando de execução kubectl get nodes do cluster.

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

Listar pools de nós no cluster Kubernetes gerenciado.

Extensão GA
az aks nodepool manual-scale

Comandos para gerenciar nodepool virtualMachineProfile.scale.manual.

Extensão GA
az aks nodepool manual-scale add

Adicione um novo manual a um agentpool de VirtualMachines no cluster Kubernetes gerenciado.

Extensão GA
az aks nodepool manual-scale delete

Exclua um manual existente para um agentpool de VirtualMachines no cluster Kubernetes gerenciado.

Extensão GA
az aks nodepool manual-scale update

Atualize um manual existente de um agentpool de VirtualMachines no cluster Kubernetes gerenciado.

Extensão GA
az aks nodepool operation-abort

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

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

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

Extensão GA
az aks nodepool scale

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

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

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

Extensão GA
az aks nodepool show

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

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

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

Extensão 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.

Principal GA
az aks nodepool snapshot create (aks-preview extensão)

Crie um instantâneo do pool de nós.

Extensão GA
az aks nodepool snapshot delete

Exclua um instantâneo do pool de nós.

Principal GA
az aks nodepool snapshot delete (aks-preview extensão)

Exclua um instantâneo do pool de nós.

Extensão GA
az aks nodepool snapshot list

Listar instantâneos do pool de nós.

Principal GA
az aks nodepool snapshot list (aks-preview extensão)

Listar instantâneos do pool de nós.

Extensão GA
az aks nodepool snapshot show

Mostrar os detalhes de um instantâneo do pool de nós.

Principal GA
az aks nodepool snapshot show (aks-preview extensão)

Mostrar os detalhes de um instantâneo do pool de nós.

Extensão GA
az aks nodepool snapshot update

Atualize as tags em um instantâneo de um pool de nós.

Principal GA
az aks nodepool snapshot update (aks-preview extensão)

Atualize as tags em um instantâneo de um pool de nós.

Extensão GA
az aks nodepool snapshot wait

Aguarde até que um instantâneo do pool de nós atinja o estado desejado.

Principal GA
az aks nodepool start

Inicie o pool de agentes interrompidos no cluster Kubernetes gerenciado.

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

Inicie o pool de agentes interrompidos no cluster Kubernetes gerenciado.

Extensão GA
az aks nodepool stop

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

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

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

Extensão GA
az aks nodepool update

Atualize as propriedades de um pool de nós.

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

Atualize as propriedades de um pool de nós.

Extensão GA
az aks nodepool upgrade

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

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

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

Extensão GA
az aks nodepool wait

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

Principal GA

az aks nodepool add

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

az aks nodepool add --cluster-name
                    --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-ultra-ssd]
                    [--eviction-policy {Deallocate, Delete}]
                    [--gpu-instance-profile {MIG1g, MIG2g, MIG3g, MIG4g, MIG7g}]
                    [--host-group-id]
                    [--kubelet-config]
                    [--kubernetes-version]
                    [--labels]
                    [--linux-os-config]
                    [--max-count]
                    [--max-pods]
                    [--max-surge]
                    [--min-count]
                    [--mode {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, Windows2019, Windows2022}]
                    [--os-type]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--tags]
                    [--vnet-subnet-id]
                    [--zones]

Exemplos

Crie um nodepool em um cluster 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 nodepool 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 uma SKU de sistema operacional específica

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

Criar um pool de nós com SO habilitado para FIPS

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

Crie um cluster Kubernetes com um ID de instantâneo.

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 nodepool em um cluster AKS existente com ID de 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 nodepool com uma ID de CRG (Grupo de Reserva de Capacidade).

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"

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

Pares chave-valor separados por vírgulas 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 de aplicativos aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por espaços.

--crg-id

A id crg usada para associar o novo nodepool ao recurso existente do Grupo de Reserva de Capacidade.

--disable-windows-outbound-nat

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

Default value: False
--drain-timeout

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

--enable-cluster-autoscaler -e

Habilite o autoscaler de cluster.

Default value: False
--enable-encryption-at-host

Habilite EncryptionAtHost, o valor padrão é false.

Default value: False
--enable-fips-image

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

Default value: False
--enable-node-public-ip

Habilite o IP público do nó VMSS.

Default value: False
--enable-ultra-ssd

Ative UltraSSD, o valor padrão é false.

Default value: False
--eviction-policy

A política de despejo do pool de nós Spot. Ele só pode ser definido quando --prioridade é Spot.

Valores aceites: Deallocate, Delete
Default value: Delete
--gpu-instance-profile

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

Valores aceites: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

O ID do grupo de host dedicado totalmente qualificado usado para provisionar o pool de nós do agente.

--kubelet-config

Caminho para o arquivo JSON contendo configurações de Kubelet para nós de 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".

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

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

--linux-os-config

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

--max-count

Contagem máxima de nós usada para autoscaler, 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 implantáveis 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 percentagem utilizada, por exemplo. 5 ou 33%.

--min-count

Contagem mínima de nós usada para autoscaler, 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 para 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 a pools de nós com o modo System. Saiba mais em https://aka.ms/aks/nodepool/mode.

Valores aceites: System, User
Default value: User
--no-wait

Não espere que a operação de longa duração termine.

Default value: 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 de seu pool de nós com az aks scale.

Default value: 3
--node-osdisk-size

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

--node-osdisk-type

Tipo de disco do SO a ser usado para máquinas 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 'gerido').

Valores aceites: Ephemeral, Managed
--node-public-ip-prefix-id

ID de prefixo 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 recriar a imagem e passar para o próximo nó.

--node-taints

As manchas do nó para o pool de nós.

--node-vm-size -s

Tamanho das máquinas virtuais a serem criadas como nós do Kubernetes.

--os-sku

A SKU do sistema operacional do pool de nós do agente. Ubuntu ou CBLMariner para Linux. Windows2019 ou Windows2022 para Windows.

Valores aceites: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022
--os-type

O tipo de SO. Linux ou Windows.

--pod-subnet-id

O Resource Id de uma sub-rede em uma VNet existente na qual atribuir pods no cluster (requer plug-in de rede azure).

--ppg

O ID de um PPG.

--priority

A prioridade do pool de nós.

Valores aceites: Regular, Spot
Default value: Regular
--scale-down-mode

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

Valores aceites: Deallocate, Delete
Default value: Delete
--snapshot-id

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

--spot-max-price

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

Default value: nan
--tags

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

--vnet-subnet-id

A Id de Recurso de uma sub-rede em uma VNet existente na qual implantar o cluster.

--zones -z

Zonas de disponibilidade onde 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ê entre em --zones 1 2 3.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

az aks nodepool add --cluster-name
                    --name
                    --resource-group
                    [--aks-custom-headers]
                    [--allowed-host-ports]
                    [--asg-ids]
                    [--crg-id]
                    [--disable-windows-outbound-nat]
                    [--drain-timeout]
                    [--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-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]
                    [--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, Windows2019, Windows2022, WindowsAnnual}]
                    [--os-type]
                    [--pod-ip-allocation-mode {DynamicIndividual, StaticBlock}]
                    [--pod-subnet-id]
                    [--ppg]
                    [--priority {Regular, Spot}]
                    [--scale-down-mode {Deallocate, Delete}]
                    [--skip-gpu-driver-install]
                    [--snapshot-id]
                    [--spot-max-price]
                    [--ssh-access {disabled, localuser}]
                    [--tags]
                    [--vm-set-type]
                    [--vm-sizes]
                    [--vnet-subnet-id]
                    [--workload-runtime {KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi}]
                    [--zones]

Exemplos

Crie um nodepool em um cluster 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 nodepool com EncryptionAtHost habilitado.

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

Criar um nodepool com um os-sku específico

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

Crie um nodepool que possa executar cargas de trabalho wasm.

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

Crie um cluster Kubernetes com um ID de instantâneo.

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 nodepool com uma ID de CRG (Grupo de Reserva de Capacidade).

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 nodepool em um cluster AKS existente com ID de 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 nodepool com o modo de alocação ip definido como "StaticBlock" e usando um ID de sub-rede 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 Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--allowed-host-ports
Pré-visualizar

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
Pré-visualizar

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

--crg-id
Pré-visualizar

O crg-id usado para associar o novo nodepool 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.

Default value: False
--drain-timeout

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

--enable-artifact-streaming
Pré-visualizar

Habilite o streaming de artefatos para VirtualMachineScaleSets gerenciados por um pool de nós, para acelerar o início a frio de contêineres em um nó por meio do carregamento de imagens 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.

Default value: False
--enable-cluster-autoscaler -e

Habilite o autoscaler de cluster. Deve usar o tipo de pool de agentes VMSS.

Default value: False
--enable-custom-ca-trust

Habilite a confiança da autoridade de certificação personalizada no pool de nós do agente.

Default value: False
--enable-encryption-at-host

Habilite EncryptionAtHost no pool de nós do agente.

Default value: False
--enable-fips-image

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

Default value: False
--enable-node-public-ip

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

Default value: False
--enable-secure-boot
Pré-visualizar

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

Default value: False
--enable-ultra-ssd

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

Default value: False
--enable-vtpm
Pré-visualizar

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

Default value: False
--eviction-policy

A política de despejo do pool de nós Spot. Ele só pode ser definido quando --prioridade é Spot.

Valores aceites: Deallocate, Delete
Default value: Delete
--gateway-prefix-size
Pré-visualizar

O tamanho da correção IPPrefix Pública anexada ao pool de nós do modo Gateway. O pool de nós deve estar no modo Gateway.

--gpu-instance-profile

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

Valores aceites: MIG1g, MIG2g, MIG3g, MIG4g, MIG7g
--host-group-id

(PRÉ-VISUALIZAÇÃO) O ID do grupo de host dedicado totalmente qualificado usado para provisionar o pool de nós do agente. Deve usar o tipo de pool de agentes VMSS.

--if-match

O valor fornecido será comparado com o ETag do agentpool, se corresponder à operação prosseguirá. 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

Configurações de 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".

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

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

--linux-os-config

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

--max-count

Contagem máxima de nós usada para autoscaler, 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 implantáveis 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".

Default value: 0
--max-surge

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

--message-of-the-day

Caminho para um arquivo que contém a mensagem desejada do dia. Válido apenas para nós linux. Será escrito para /etc/motd.

--min-count

Contagem mínima de nós usada para autoscaler, 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 para 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 a pools de nós com o modo System. Saiba mais em https://aka.ms/aks/nodepool/mode.

Valores aceites: Gateway, System, User
Default value: User
--no-wait

Não espere que a operação de longa duração termine.

Default value: 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 de seu pool de nós com az aks scale.

Default value: 3
--node-osdisk-size

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

Default value: 0
--node-osdisk-type

Tipo de disco do SO a ser usado para máquinas 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 'gerido').

Valores aceites: Ephemeral, Managed
--node-public-ip-prefix-id

ID de prefixo 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 recriar a imagem e passar para o próximo nó.

--node-taints

As manchas do nó para o pool de nós.

--node-vm-size -s

Tamanho das máquinas virtuais a serem criadas como nós do Kubernetes.

--os-sku

O os-sku do pool de nós do agente. Ubuntu ou CBLMariner 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.

Valores aceites: AzureLinux, CBLMariner, Mariner, Ubuntu, Windows2019, Windows2022, WindowsAnnual
--os-type

O tipo de SO. Linux ou Windows. Windows ainda não suportado para o tipo de conjunto de VM "VirtualMachines".

--pod-ip-allocation-mode

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

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

Valores aceites: DynamicIndividual, StaticBlock
--pod-subnet-id

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

--ppg

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

--priority

A prioridade do pool de nós.

Valores aceites: Regular, Spot
Default value: Regular
--scale-down-mode

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

Valores aceites: Deallocate, Delete
Default value: Delete
--skip-gpu-driver-install
Pré-visualizar

Para ignorar a instalação automática do driver de GPU pelo AKS em um pool de nós usando o tamanho vm da GPU se os clientes quiserem gerenciar a instalação do driver de GPU por conta própria. Se não for especificado, o padrão será false.

Default value: False
--snapshot-id

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

--spot-max-price

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

Default value: nan
--ssh-access
Pré-visualizar

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

Valores aceites: disabled, localuser
Default value: localuser
--tags

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

--vm-set-type

Tipo de conjunto vm do pool de agentes. VirtualMachineScaleSets, AvailabilitySet ou VirtualMachines(Preview).

--vm-sizes
Pré-visualizar

Lista de tamanhos separados por vírgula. Deve usar o tipo de pool de agentes VirtualMachines.

--vnet-subnet-id

A 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.

Valores aceites: KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi
Default value: OCIContainer
--zones -z

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool delete

Exclua o pool de agentes no cluster Kubernetes gerenciado.

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Exclua o pool de agentes no cluster Kubernetes gerenciado.

az aks nodepool delete --cluster-name
                       --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 Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--if-match

O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. 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-pod-disruption-budget -i
Pré-visualizar

(PREVIEW) ignore-pod-disruption-budget exclui um nodepool existente sem considerar o Pod Disruption Budget.

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool delete-machines

Exclua máquinas específicas em um pool de agentes para um cluster gerenciado.

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

Exemplos

Excluir máquinas específicas em um pool de agentes

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

Parâmetros Obrigatórios

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

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

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool get-upgrades

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

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

Exemplos

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

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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 Kubernetes gerenciado.

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

Exemplos

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

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool list

Listar pools de nós no cluster Kubernetes gerenciado. Para obter a lista de nós no comando de execução kubectl get nodes do cluster.

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Listar pools de nós no cluster Kubernetes gerenciado.

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool operation-abort

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

az aks nodepool operation-abort --cluster-name
                                --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 Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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
                                --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 Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool scale

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

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--node-count -c

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

Default value: 3
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--node-count -c

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

Default value: 3
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool show

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

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool start

Inicie o pool de agentes interrompidos no cluster Kubernetes gerenciado.

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

Exemplos

Iniciar pool de agentes no cluster gerenciado

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Inicie o pool de agentes interrompidos no cluster Kubernetes gerenciado.

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

Exemplos

Iniciar pool de agentes no cluster gerenciado

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool stop

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

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

Exemplos

Parar pool de agentes no cluster gerenciado

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

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

Exemplos

Parar pool de agentes no cluster gerenciado

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool update

Atualize as propriedades de um pool de nós.

Atualize um pool de nós para habilitar/desabilitar o escalonamento automático de cluster ou alterar a contagem mínima ou a contagem máxima. Quando chamado sem argumentos opcionais, ele tenta mover o pool de nós para seu estado de destino sem alterar a configuração atual do pool de nós. Isso pode ser usado para sair de um estado sem êxito.

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--disable-cluster-autoscaler]
                       [--drain-timeout]
                       [--enable-cluster-autoscaler]
                       [--labels]
                       [--max-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, CBLMariner, Mariner}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--tags]
                       [--update-cluster-autoscaler]

Exemplos

Reconcilie o nodepool de volta ao seu estado atual.

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

Habilitar o escalonador 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 autodimensionador de cluster para um cluster existente

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

Atualize a contagem mínima ou a contagem máxima para o autoscaler de cluster.

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

Pares chave-valor separados por vírgulas 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 de aplicativos aos quais a interface de rede do pool de nós deve pertencer. Quando especificado, o formato deve ser uma lista de IDs separada por espaços.

--disable-cluster-autoscaler -d

Desative o autoscaler do cluster.

Default value: False
--drain-timeout

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

--enable-cluster-autoscaler -e

Habilite o autoscaler de cluster.

Default value: False
--labels

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

--max-count

Contagem máxima de nós usada para autoscaler, 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-surge

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

--min-count

Contagem mínima de nós usada para autoscaler, 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 para 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 a pools de nós com o modo System. Saiba mais em https://aka.ms/aks/nodepool/mode.

Valores aceites: System, User
--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.

--node-taints

As manchas do nó para o pool de nós. Você pode atualizar a coloração de nó existente de um pool de nós ou criar uma nova coloração de nó para um pool de nós. Passe a corda "" vazia para remover todas as manchas.

--os-sku

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

Valores aceites: AzureLinux, CBLMariner, Mariner
--scale-down-mode

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

Valores aceites: Deallocate, Delete
--tags

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

--update-cluster-autoscaler -u

Atualize a contagem mínima ou a contagem máxima para o autoscaler de cluster.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

Atualize as propriedades de um pool de nós.

Atualize um pool de nós para habilitar/desabilitar o escalonamento automático de cluster ou alterar a contagem mínima ou a contagem máxima. Quando chamado sem argumentos opcionais, ele tenta mover o pool de nós para seu estado de destino sem alterar a configuração atual do pool de nós. Isso pode ser usado para sair de um estado sem êxito.

az aks nodepool update --cluster-name
                       --name
                       --resource-group
                       [--aks-custom-headers]
                       [--allowed-host-ports]
                       [--asg-ids]
                       [--dcat]
                       [--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-count]
                       [--max-surge]
                       [--min-count]
                       [--mode {Gateway, System, User}]
                       [--no-wait]
                       [--node-soak-duration]
                       [--node-taints]
                       [--os-sku {AzureLinux, Ubuntu}]
                       [--scale-down-mode {Deallocate, Delete}]
                       [--ssh-access {disabled, localuser}]
                       [--tags]
                       [--update-cluster-autoscaler]
                       [--yes]

Exemplos

Reconcilie o nodepool de volta ao seu estado atual.

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

Habilitar o escalonador 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 autodimensionador de cluster para um cluster existente

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

Atualize a contagem mínima ou a contagem máxima para o autoscaler 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 de sistema

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--allowed-host-ports
Pré-visualizar

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
Pré-visualizar

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

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

Desative a confiança da autoridade de certificação personalizada no pool de nós do agente.

Default value: False
--disable-cluster-autoscaler -d

Desative o autoscaler do cluster.

Default value: False
--disable-fips-image

Mude para usar SO não habilitado para FIPS em nós de agente.

Default value: False
--disable-secure-boot
Pré-visualizar

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

Default value: False
--disable-vtpm
Pré-visualizar

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

Default value: False
--drain-timeout

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

--enable-artifact-streaming
Pré-visualizar

Habilite o streaming de artefatos para VirtualMachineScaleSets gerenciados por um pool de nós, para acelerar o início a frio de contêineres em um nó por meio do carregamento de imagens 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.

Default value: False
--enable-cluster-autoscaler -e

Habilite o autoscaler de cluster. Deve usar o tipo de pool de agentes VMSS.

Default value: False
--enable-custom-ca-trust

Habilite a confiança da autoridade de certificação personalizada no pool de nós do agente.

Default value: False
--enable-fips-image

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

Default value: False
--enable-secure-boot
Pré-visualizar

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.

Default value: False
--enable-vtpm
Pré-visualizar

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.

Default value: False
--if-match

O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. 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 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 para sintaxe de rótulos.

--max-count

Contagem máxima de nós usada para autoscaler, 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-surge

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

--min-count

Contagem mínima de nós usada para autoscaler, 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 para 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 a pools de nós com o modo System. Saiba mais em https://aka.ms/aks/nodepool/mode.

Valores aceites: Gateway, System, User
--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.

--node-taints

As manchas do nó para o pool de nós.

--os-sku

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

Valores aceites: AzureLinux, Ubuntu
--scale-down-mode

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

Valores aceites: Deallocate, Delete
--ssh-access
Pré-visualizar

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

Valores aceites: disabled, localuser
--tags

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

--update-cluster-autoscaler -u

Atualize a contagem mínima ou a contagem máxima para o autoscaler de cluster.

Default value: False
--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool upgrade

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

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--aks-custom-headers

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

--drain-timeout

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

--kubernetes-version -k

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

--max-surge

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

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--node-image-only

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

Default value: False
--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.

--snapshot-id

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

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

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

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

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

Parâmetros Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--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 para esperar que todos os pods sejam removidos.

--if-match

O valor fornecido será comparado com o ETag do pool de nós, se corresponder à operação prosseguirá. 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. Para solicitações de versão de imagem de nó de atualização, isso será ignorado.

--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-surge

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

--no-wait

Não espere que a operação de longa duração termine.

Default value: False
--node-image-only

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

Default value: False
--node-soak-duration

A quantidade de tempo (em minutos) para esperar depois de drenar um nó e antes de recriar a imagem e passar para o próximo nó.

--snapshot-id

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

--yes -y

Não solicite confirmação.

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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

az aks nodepool wait

Aguarde até que um pool de nós atinja o 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
                     --resource-group
                     [--created]
                     [--custom]
                     [--deleted]
                     [--exists]
                     [--interval]
                     [--timeout]
                     [--updated]

Exemplos

Aguarde até que um pool de nós atinja o 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 Obrigatórios

--cluster-name

O nome do cluster.

--name --nodepool-name -n

O nome do pool de nós.

--resource-group -g

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

Parâmetros Opcionais

--created

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

Default value: False
--custom

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

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--interval

Intervalo de sondagem em segundos.

Default value: 30
--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

Default value: False
Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

Valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

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

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

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