az aks nodepool

Note

Este grupo de comandos tiene comandos definidos en la CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Learn more about extensions.

Comandos para administrar grupos de nodos en el clúster de Kubernetes de Kubernetes.

Comandos

Nombre	Description	Tipo	Estado
az aks nodepool add	Agregue un grupo de nodos al clúster de Kubernetes administrado.	Core	GA
az aks nodepool add (aks-preview extensión)	Agregue un grupo de nodos al clúster de Kubernetes administrado.	Extension	GA
az aks nodepool delete	Elimine el grupo de agentes en el clúster de Kubernetes administrado.	Core	GA
az aks nodepool delete (aks-preview extensión)	Elimine el grupo de agentes en el clúster de Kubernetes administrado.	Extension	GA
az aks nodepool delete-machines	Elimine máquinas específicas de un grupo de agentes para un clúster administrado.	Core	GA
az aks nodepool delete-machines (aks-preview extensión)	Elimine máquinas específicas de un grupo de agentes para un clúster administrado.	Extension	GA
az aks nodepool get-upgrades	Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.	Core	GA
az aks nodepool get-upgrades (aks-preview extensión)	Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.	Extension	GA
az aks nodepool list	Enumera los grupos de nodos del clúster de Kubernetes administrado. Para obtener la lista de nodos en el comando cluster run `kubectl get nodes` .	Core	GA
az aks nodepool list (aks-preview extensión)	Enumera los grupos de nodos del clúster de Kubernetes administrado.	Extension	GA
az aks nodepool manual-scale	Comandos para administrar nodepool virtualMachineProfile.scale.manual.	Extension	GA
az aks nodepool manual-scale add	Agregue un nuevo manual a un grupo de agentes de VirtualMachines en el clúster de Kubernetes administrado.	Extension	GA
az aks nodepool manual-scale delete	Elimine un manual existente en un grupo de agentes de VirtualMachines en el clúster de Kubernetes administrado.	Extension	GA
az aks nodepool manual-scale update	Actualice un manual existente de un grupo de agentes de VirtualMachines en el clúster de Kubernetes administrado.	Extension	GA
az aks nodepool operation-abort	Anule la última operación en ejecución en nodepool.	Core	GA
az aks nodepool operation-abort (aks-preview extensión)	Anule la última operación en ejecución en nodepool.	Extension	GA
az aks nodepool scale	Escala el grupo de nodos en un clúster de Kubernetes administrado.	Core	GA
az aks nodepool scale (aks-preview extensión)	Escala el grupo de nodos en un clúster de Kubernetes administrado.	Extension	GA
az aks nodepool show	Muestra los detalles de un grupo de nodos en el clúster de Kubernetes administrado.	Core	GA
az aks nodepool show (aks-preview extensión)	Muestra los detalles de un grupo de nodos en el clúster de Kubernetes administrado.	Extension	GA
az aks nodepool snapshot	Comandos para administrar instantáneas del grupo de nodos.	Núcleo y extensión	GA
az aks nodepool snapshot create	Cree una instantánea de grupo de nodos.	Core	GA
az aks nodepool snapshot create (aks-preview extensión)	Cree una instantánea de grupo de nodos.	Extension	GA
az aks nodepool snapshot delete	Elimine una instantánea de grupo de nodos.	Core	GA
az aks nodepool snapshot delete (aks-preview extensión)	Elimine una instantánea de grupo de nodos.	Extension	GA
az aks nodepool snapshot list	Enumerar instantáneas de grupo de nodos.	Core	GA
az aks nodepool snapshot list (aks-preview extensión)	Enumerar instantáneas de grupo de nodos.	Extension	GA
az aks nodepool snapshot show	Muestra los detalles de una instantánea de grupo de nodos.	Core	GA
az aks nodepool snapshot show (aks-preview extensión)	Muestra los detalles de una instantánea de grupo de nodos.	Extension	GA
az aks nodepool snapshot update	Actualizar etiquetas en una instantánea de un grupo de nodos.	Core	GA
az aks nodepool snapshot update (aks-preview extensión)	Actualizar etiquetas en una instantánea de un grupo de nodos.	Extension	GA
az aks nodepool snapshot wait	Espere a que una instantánea de grupo de nodos alcance un estado deseado.	Core	GA
az aks nodepool start	Inicie el grupo de agentes detenido en el clúster de Kubernetes administrado.	Core	GA
az aks nodepool start (aks-preview extensión)	Inicie el grupo de agentes detenido en el clúster de Kubernetes administrado.	Extension	GA
az aks nodepool stop	Detenga la ejecución del grupo de agentes en el clúster de Kubernetes administrado.	Core	GA
az aks nodepool stop (aks-preview extensión)	Detenga la ejecución del grupo de agentes en el clúster de Kubernetes administrado.	Extension	GA
az aks nodepool update	Actualice las propiedades de un grupo de nodos.	Core	GA
az aks nodepool update (aks-preview extensión)	Actualice las propiedades de un grupo de nodos.	Extension	GA
az aks nodepool upgrade	Actualiza el grupo de nodos en un clúster de Kubernetes administrado.	Core	GA
az aks nodepool upgrade (aks-preview extensión)	Actualiza el grupo de nodos en un clúster de Kubernetes administrado.	Extension	GA
az aks nodepool wait	Espere a que un grupo de nodos alcance un estado deseado.	Core	GA

az aks nodepool add

Editar

Agregue un grupo de nodos al clúster de Kubernetes administrado.

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]

Ejemplos

Cree un grupo de nodos en un clúster de AKS existente con sistemas operativos efímeros habilitados.

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

Cree un grupo de nodos con EncryptionAtHost habilitado.

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

Cree un grupo de nodos con UltraSSD habilitado.

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

Creación de un clúster de grupos de nodos con una SKU específica del sistema operativo

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

Creación de un grupo de nodos con sistema operativo habilitado para FIPS

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

cree un clúster de Kubernetes con un identificador de instantánea.

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"

creación de un grupo de nodos en un clúster de AKS existente con el identificador de grupo host

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

cree un grupo de nodos con un identificador de grupo de reserva de capacidad (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"

Cree un grupo de nodos con el modo de asignación ip establecido en "StaticBlock" y use un identificador de subred 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 requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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 clave-valor separados por comas para especificar encabezados personalizados.

--allowed-host-ports

Exponga los puertos de host en el grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por espacios de intervalos con protocolo, por ejemplo. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

Identificadores de los grupos de seguridad de aplicaciones a los que debe pertenecer la interfaz de red del grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por espacios de identificadores.

--crg-id

Identificador crg usado para asociar el nuevo grupo de nodos con el recurso grupo de reserva de capacidad existente.

--disable-windows-outbound-nat

Deshabilite Windows OutboundNAT en el grupo de nodos del agente de Windows.

Propiedad	Valor
Valor predeterminado:	False

--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster.

Propiedad	Valor
Valor predeterminado:	False

--enable-encryption-at-host

Enable EncryptionAtHost, el valor predeterminado es false.

Propiedad	Valor
Valor predeterminado:	False

--enable-fips-image

Use el sistema operativo habilitado para FIPS en los nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--enable-node-public-ip

Habilite la dirección IP pública del nodo VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-secure-boot

Habilite el arranque seguro en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-ultra-ssd

Habilitar UltraSSD, el valor predeterminado es false.

Propiedad	Valor
Valor predeterminado:	False

--enable-vtpm

Habilite vTPM en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--eviction-policy

Directiva de expulsión del grupo de nodos de spot. Solo se puede establecer cuando --priority es Spot.

Propiedad	Valor
Valor predeterminado:	Delete
Valores aceptados:	Deallocate, Delete

--gateway-prefix-size

Tamaño de IPPrefix público asociado al grupo de nodos en modo de puerta de enlace. El grupo de nodos debe estar en modo de puerta de enlace.

--gpu-driver

Si se va a instalar el controlador para el grupo de nodos de GPU. Los valores posibles son "Instalar" o "Ninguno". El valor predeterminado es "Instalar".

Propiedad	Valor
Valores aceptados:	Install, None

--gpu-instance-profile

Perfil de instancia de GPU para particionar gpu múltiples GPU nvidia.

Propiedad	Valor
Valores aceptados:	MIG1g, MIG2g, MIG3g, MIG4g, MIG7g

--host-group-id

Identificador de grupo host dedicado completo que se usa para aprovisionar el grupo de nodos del agente.

--if-match

El valor proporcionado se comparará con la ETag del grupo de agentes, si coincide con la operación. Si no coincide, la solicitud se rechazará para evitar sobrescrituras accidentales. No se debe especificar al crear un grupo de agentes.

--if-none-match

Establézcalo en "*" para permitir que se cree un nuevo grupo de agentes, pero para evitar la actualización de un grupo de agentes existente. Se omitirán otros valores.

--kubelet-config

Ruta de acceso al archivo JSON que contiene configuraciones de Kubelet para los nodos del agente. https://aka.ms/aks/custom-node-config.

--kubernetes-version -k

Versión de Kubernetes que se usará para crear el clúster, como "1.16.9".

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

--labels

Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.

--linux-os-config

Ruta de acceso al archivo JSON que contiene configuraciones del sistema operativo para los nodos del agente de Linux. https://aka.ms/aks/custom-node-config.

--max-count

Número máximo de nodos usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--max-pods -m

Número máximo de pods que se pueden implementar en un nodo.

Si no se especifica, el valor predeterminado se basa en el complemento de red. 30 para "azure", 110 para "kubenet" o 250 para "none".

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--max-unavailable

Número máximo o porcentaje de nodos que pueden no estar disponibles simultáneamente durante la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 1 o 5%.

--message-of-the-day

Ruta de acceso a un archivo que contiene el mensaje deseado del día. Solo es válido para los nodos de Linux. Se escribirá en /etc/motd.

--min-count

Número mínimo de nodos usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--mode

Modo para un grupo de nodos que define la función principal de un grupo de nodos. Si se establece como "Sistema", AKS prefiere programar pods del sistema en grupos de nodos con el modo System. Obtenga más información en https://aka.ms/aks/nodepool/mode.

Propiedad	Valor
Valor predeterminado:	User
Valores aceptados:	Gateway, System, User

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--node-count -c

Número de nodos del grupo de agentes de Kubernetes. Después de crear un clúster, puede cambiar el tamaño de su grupo de nodos con az aks scale.

Propiedad	Valor
Valor predeterminado:	3

--node-osdisk-size

Tamaño en GiB del disco del sistema operativo para cada nodo del grupo de agentes. Mínimo 30 GiB.

--node-osdisk-type

Tipo de disco del sistema operativo que se va a usar para las máquinas de un grupo de agentes determinado. El valor predeterminado es "Efímero" cuando sea posible junto con el tamaño de máquina virtual y el tamaño del disco del sistema operativo. Es posible que no se cambie para este grupo después de la creación. ('Efímero' o 'Administrado').

Propiedad	Valor
Valores aceptados:	Ephemeral, Managed

--node-public-ip-prefix-id

Identificador de prefijo de IP pública que se usa para asignar direcciones IP públicas a los nodos de VMSS.

--node-public-ip-tags

IpTags del nodo direcciones IP públicas.

--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--node-taints

Las intolerancias de nodo del grupo de nodos.

--node-vm-size -s

Tamaño de las máquinas virtuales que se van a crear como nodos de Kubernetes. Si el usuario no especifica uno, el servidor seleccionará un tamaño de máquina virtual predeterminado para ella o él.

--os-sku

SKU del sistema operativo del grupo de nodos del agente. Ubuntu, AzureLinux o Ubuntu2204 para Linux. Windows2019 o Windows2022 para Windows.

Propiedad	Valor
Valores aceptados:	AzureLinux, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Windows2019, Windows2022

--os-type

Tipo de sistema operativo. Linux o Windows.

--pod-ip-allocation-mode

Establezca el modo de asignación ip para saber cómo se asignan las direcciones IP de pod de la subred de pod de Azure a los nodos del clúster de AKS. La elección es entre lotes dinámicos de direcciones IP individuales o la asignación estática de un conjunto de bloques CIDR. Los valores aceptados son "DynamicIndividual" o "StaticBlock".

Se usa junto con el complemento de red "azure". Requires --pod-subnet-id.

Propiedad	Valor
Valores aceptados:	DynamicIndividual, StaticBlock

--pod-subnet-id

El identificador de recurso de una subred de una red virtual existente en la que asignar pods en el clúster (requiere azure network-plugin).

--ppg

Identificador de un PPG.

--priority

Prioridad del grupo de nodos.

Propiedad	Valor
Valor predeterminado:	Regular
Valores aceptados:	Regular, Spot

--scale-down-mode

Describir cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.

Propiedad	Valor
Valor predeterminado:	Delete
Valores aceptados:	Deallocate, Delete

--snapshot-id

Identificador de instantánea de origen que se usa para crear este grupo de nodos.

--spot-max-price

Solo se puede establecer cuando --priority es Spot. Especifique el precio máximo que está dispuesto a pagar en dólares estadounidenses. Los valores posibles son cualquier valor decimal mayor que cero o -1 que indica que el precio predeterminado debe ser up-to a petición. Solo puede incluir hasta 5 posiciones decimales.

Propiedad	Valor
Valor predeterminado:	nan

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--undrainable-node-behavior

Defina el comportamiento de los nodos que no se pueden detectar durante la actualización. El valor debe ser "Cordon" o "Schedule". El valor predeterminado es "Schedule".

Propiedad	Valor
Valor predeterminado:	Schedule

--vnet-subnet-id

Identificador de recurso de una subred en una red virtual existente en la que se va a implementar el clúster.

--zones -z

Zonas de disponibilidad en las que se colocarán los nodos del agente. Además, para instalar nodos de agente en más de una zona, debe pasar números de zona separados por espacios en blanco. Por ejemplo: para tener todas las tres zonas, se espera que escriba --zones 1 2 3.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool add (aks-preview extensión)

Agregue un grupo de nodos al clúster de Kubernetes administrado.

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]

Ejemplos

Cree un grupo de nodos en un clúster de AKS existente con sistemas operativos efímeros habilitados.

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

Cree un grupo de nodos con EncryptionAtHost habilitado.

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

Creación de un grupo de nodos con una SKU específica de os

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

Cree un grupo de nodos que pueda ejecutar cargas de trabajo wasm.

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

cree un clúster de Kubernetes con un identificador de instantánea.

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"

cree un grupo de nodos con un identificador de grupo de reserva de capacidad (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"

creación de un grupo de nodos en un clúster de AKS existente con el identificador de grupo host

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

Cree un grupo de nodos con el modo de asignación ip establecido en "StaticBlock" y use un identificador de subred 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

Creación de un grupo de nodos de 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 requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--allowed-host-ports

Vista previa

Exponga los puertos de host en el grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por comas de intervalos con protocolo, por ejemplo. 80/TCP,443/TCP,4000-5000/TCP. Debe usar el tipo de grupo de agentes de VMSS.

--asg-ids

Vista previa

--crg-id

Vista previa

El crg-id usado para asociar el nuevo grupo de nodos con el recurso grupo de reserva de capacidad existente. Debe usar el tipo de grupo de agentes de VMSS.

--disable-windows-outbound-nat

Deshabilite Windows OutboundNAT en el grupo de nodos del agente de Windows. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--driver-type

Vista previa

Especifique el tipo de controlador de GPU que se va a instalar al crear grupos de agentes de Windows. Los valores válidos son "GRID" y "CUDA". Si no se proporciona, AKS selecciona el controlador en función de la compatibilidad del sistema. Esta opción no se puede cambiar una vez que se haya creado AgentPool. El valor predeterminado es el sistema seleccionado.

Propiedad	Valor
Valores aceptados:	CUDA, GRID

--enable-artifact-streaming

Vista previa

Habilite el streaming de artefactos para VirtualMachineScaleSets administrado por un grupo de nodos para acelerar el arranque en frío de los contenedores en un nodo a través de la carga de imágenes a petición. Para usar esta característica, las imágenes de contenedor también deben habilitar el streaming de artefactos en ACR. Si no se especifica, el valor predeterminado es false.

Propiedad	Valor
Valor predeterminado:	False

--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-custom-ca-trust

Habilite Confianza de CA personalizada en el grupo de nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--enable-encryption-at-host

Habilite EncryptionAtHost en el grupo de nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--enable-fips-image

Use el sistema operativo habilitado para FIPS en los nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--enable-node-public-ip

Habilite la dirección IP pública del nodo VMSS. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-secure-boot

Vista previa

Habilite el arranque seguro en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-ultra-ssd

Habilite UltraSSD en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-vtpm

Vista previa

Habilite vTPM en el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--eviction-policy

Directiva de expulsión del grupo de nodos de spot. Solo se puede establecer cuando --priority es Spot.

Propiedad	Valor
Valor predeterminado:	Delete
Valores aceptados:	Deallocate, Delete

--gateway-prefix-size

Vista previa

Tamaño de IPPrefix público asociado al grupo de nodos en modo de puerta de enlace. El grupo de nodos debe estar en modo de puerta de enlace.

--gpu-driver

Si se va a instalar el controlador para el grupo de nodos de GPU. Los valores posibles son "Instalar" o "Ninguno". El valor predeterminado es "Instalar".

Propiedad	Valor
Valores aceptados:	Install, None

--gpu-instance-profile

Perfil de instancia de GPU para particionar gpu múltiples GPU nvidia.

Propiedad	Valor
Valores aceptados:	MIG1g, MIG2g, MIG3g, MIG4g, MIG7g

--host-group-id

(VERSIÓN PRELIMINAR) Identificador de grupo host dedicado completo que se usa para aprovisionar el grupo de nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

--if-match

--if-none-match

Establézcalo en "*" para permitir que se cree un nuevo grupo de agentes, pero para evitar la actualización de un grupo de agentes existente. Se omitirán otros valores.

--kubelet-config

Configuraciones de Kubelet para nodos de agente.

--kubernetes-version -k

Versión de Kubernetes que se usará para crear el clúster, como "1.7.12" o "1.8.7".

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

--labels

Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.

--linux-os-config

Configuraciones del sistema operativo para nodos del agente de Linux.

--max-blocked-nodes

Número máximo o porcentaje de nodos adicionales que se pueden bloquear en el grupo de agentes durante una actualización cuando el comportamiento del nodo no se puede detectar es Cordon. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 1 o 5%.

--max-count

--max-pods -m

Número máximo de pods que se pueden implementar en un nodo.

Si no se especifica, el valor predeterminado se basa en el complemento de red. 30 para "azure", 110 para "kubenet" o 250 para "none".

Propiedad	Valor
Valor predeterminado:	0

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--max-unavailable

--message-of-the-day

Ruta de acceso a un archivo que contiene el mensaje deseado del día. Solo es válido para los nodos de Linux. Se escribirá en /etc/motd.

--min-count

Número de nodos de minicomunión usados para el escalador automático, cuando se especifica "--enable-cluster-autoscaler". Especifique el valor en el intervalo de [0, 1000] para el grupo de nodos de usuario y [1000] para el grupo de nodos del sistema.

--mode

Propiedad	Valor
Valor predeterminado:	User
Valores aceptados:	Gateway, System, User

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--node-count -c

Número de nodos del grupo de agentes de Kubernetes. Después de crear un clúster, puede cambiar el tamaño de su grupo de nodos con az aks scale.

Propiedad	Valor
Valor predeterminado:	3

--node-osdisk-size

Tamaño en GiB del disco del sistema operativo para cada nodo del grupo de agentes. Mínimo 30 GiB.

Propiedad	Valor
Valor predeterminado:	0

--node-osdisk-type

Propiedad	Valor
Valores aceptados:	Ephemeral, Managed

--node-public-ip-prefix-id

Identificador de prefijo de IP pública que se usa para asignar direcciones IP públicas a los nodos de VMSS. Debe usar el tipo de grupo de agentes de VMSS.

--node-public-ip-tags

IpTags del nodo direcciones IP públicas. Debe usar el tipo de grupo de agentes de VMSS.

--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--node-taints

Las intolerancias de nodo del grupo de nodos.

--node-vm-size -s

--os-sku

La os-sku del grupo de nodos del agente. Ubuntu, CBLMariner, Ubuntu2204 o Ubuntu2404 cuando el tipo de sistema operativo es Linux, el valor predeterminado es Ubuntu si no se establece; Windows2019, Windows2022 o Windows Annual cuando el tipo de sistema operativo es Windows, el valor predeterminado actual es Windows2022 si no se establece.

Propiedad	Valor
Valores aceptados:	AzureLinux, CBLMariner, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, WindowsAnnual

--os-type

Tipo de sistema operativo. Linux o Windows. Windows aún no se admite para el tipo de conjunto de máquinas virtuales "VirtualMachines".

--pod-ip-allocation-mode

Se usa junto con el complemento de red "azure". Requires --pod-subnet-id.

Propiedad	Valor
Valores aceptados:	DynamicIndividual, StaticBlock

--pod-subnet-id

El identificador de una subred de una red virtual existente en la que asignar pods en el clúster (requiere azure network-plugin).

--ppg

Identificador de un PPG. Debe usar el tipo de grupo de agentes de VMSS.

--priority

Prioridad del grupo de nodos.

Propiedad	Valor
Valor predeterminado:	Regular
Valores aceptados:	Regular, Spot

--scale-down-mode

Describe cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.

Propiedad	Valor
Valor predeterminado:	Delete
Valores aceptados:	Deallocate, Delete

--snapshot-id

Identificador de instantánea de origen que se usa para crear este grupo de nodos. Debe usar el tipo de grupo de agentes de VMSS.

--spot-max-price

Propiedad	Valor
Valor predeterminado:	nan

--ssh-access

Vista previa

Configure la configuración de SSH para el grupo de nodos. Use "disabled" para deshabilitar el acceso SSH, "localuser" para habilitar el acceso SSH mediante la clave privada.

Propiedad	Valor
Valor predeterminado:	localuser
Valores aceptados:	disabled, localuser

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--undrainable-node-behavior

Defina el comportamiento de los nodos que no se pueden detectar durante la actualización. El valor debe ser "Cordon" o "Schedule". El valor predeterminado es "Schedule".

--vm-set-type

Tipo de conjunto de máquinas virtuales del grupo de agentes. VirtualMachineScaleSets, AvailabilitySet o VirtualMachines(Preview).

--vm-sizes

Vista previa

Lista separada por comas de tamaños. Debe usar el tipo de grupo de agentes VirtualMachines.

--vnet-subnet-id

Identificador de la subred de una red virtual existente en la que se va a implementar el clúster.

--workload-runtime

Determina el tipo de carga de trabajo que puede ejecutar un nodo. El valor predeterminado es OCIContainer.

Propiedad	Valor
Valor predeterminado:	OCIContainer
Valores aceptados:	KataCcIsolation, KataMshvVmIsolation, OCIContainer, WasmWasi

--zones -z

Lista separada por espacios de zonas de disponibilidad donde se colocarán los nodos del agente. Debe usar el tipo de grupo de agentes de VMSS.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool delete

Editar

Elimine el grupo de agentes en el clúster de Kubernetes administrado.

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

Ejemplos

Eliminación de un grupo de agentes con ignore-pdb

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

--if-match

El valor proporcionado se comparará con la ETag del grupo de nodos, si coincide con la operación. Si no coincide, la solicitud se rechazará para evitar sobrescrituras accidentales. No se debe especificar al crear un grupo de agentes.

--ignore-pdb -i

Elimine un grupo de nodos existente sin tener en cuenta el presupuesto de interrupciones del pod.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool delete (aks-preview extensión)

Elimine el grupo de agentes en el clúster de Kubernetes administrado.

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

Ejemplos

Eliminación de un grupo de agentes con ignore-pod-disruption-budget

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Vista previa

(VERSIÓN PRELIMINAR) ignore-pod-disruption-budget elimina un grupo de nodos existente sin tener en cuenta el presupuesto de interrupciones del pod.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool delete-machines

Editar

Elimine máquinas específicas de un grupo de agentes para un clúster administrado.

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

Ejemplos

Eliminación de máquinas específicas en un grupo de agentes

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--machine-names

Lista separada por espacios de nombres de máquina del grupo de agentes que se va a eliminar.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool delete-machines (aks-preview extensión)

Elimine máquinas específicas de un grupo de agentes para un clúster administrado.

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

Ejemplos

Eliminación de máquinas específicas en un grupo de agentes

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--machine-names

Lista separada por espacios de nombres de máquina del grupo de agentes que se va a eliminar.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool get-upgrades

Editar

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

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

Ejemplos

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool get-upgrades (aks-preview extensión)

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

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

Ejemplos

Obtiene las versiones de actualización disponibles para un grupo de agentes del clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool list

Editar

Enumera los grupos de nodos del clúster de Kubernetes administrado. Para obtener la lista de nodos en el comando cluster run kubectl get nodes .

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool list (aks-preview extensión)

Enumera los grupos de nodos del clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool operation-abort

Editar

Anule la última operación en ejecución en nodepool.

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

Ejemplos

Anulación de la operación en el grupo de agentes

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool operation-abort (aks-preview extensión)

Anule la última operación en ejecución en nodepool.

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

Ejemplos

Anulación de la operación en el grupo de agentes

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool scale

Editar

Escala el grupo de nodos en un clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--node-count -c

Número de nodos del grupo de nodos de Kubernetes.

Propiedad	Valor
Valor predeterminado:	3

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool scale (aks-preview extensión)

Escala el grupo de nodos en un clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--node-count -c

Número de nodos del grupo de nodos de Kubernetes.

Propiedad	Valor
Valor predeterminado:	3

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool show

Editar

Muestra los detalles de un grupo de nodos en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool show (aks-preview extensión)

Muestra los detalles de un grupo de nodos en el clúster de Kubernetes administrado.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool start

Editar

Inicie el grupo de agentes detenido en el clúster de Kubernetes administrado.

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

Ejemplos

Inicio del grupo de agentes en el clúster administrado

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool start (aks-preview extensión)

Inicie el grupo de agentes detenido en el clúster de Kubernetes administrado.

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

Ejemplos

Inicio del grupo de agentes en el clúster administrado

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool stop

Editar

Detenga la ejecución del grupo de agentes en el clúster de Kubernetes administrado.

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

Ejemplos

Detener el grupo de agentes en el clúster administrado

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool stop (aks-preview extensión)

Detenga la ejecución del grupo de agentes en el clúster de Kubernetes administrado.

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

Ejemplos

Detener el grupo de agentes en el clúster administrado

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool update

Editar

Actualice las propiedades de un grupo de nodos.

Actualice un grupo de nodos para habilitar o deshabilitar el escalador automático de clústeres o cambie min-count o max-count. Cuando se llama sin argumentos opcionales, intenta mover el grupo de nodos a su estado objetivo sin cambiar la configuración actual del grupo de nodos. Esto se puede usar para salir de un estado no correcto.

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]

Ejemplos

Concilie el grupo de nodos a su estado actual.

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

Habilitación del escalador automático de clústeres dentro del intervalo de recuento de nodos [1,5]

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

Deshabilitación del escalador automático de clústeres para un clúster existente

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

Actualice min-count o max-count para el escalador automático del clúster.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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 clave-valor separados por comas para especificar encabezados personalizados.

--allowed-host-ports

Exponga los puertos de host en el grupo de nodos. Cuando se especifica, el formato debe ser una lista separada por espacios de intervalos con protocolo, por ejemplo. 80/TCP 443/TCP 4000-5000/TCP.

--asg-ids

--disable-cluster-autoscaler -d

Deshabilite el escalador automático del clúster.

Propiedad	Valor
Valor predeterminado:	False

--disable-fips-image

Cambie para usar el sistema operativo no habilitado para FIPS en los nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--disable-secure-boot

Deshabilite el arranque seguro en un grupo de nodos de agente habilitado para inicio seguro existente.

Propiedad	Valor
Valor predeterminado:	False

--disable-vtpm

Deshabilite vTPM en un grupo de nodos de agente habilitado para inicio seguro existente.

Propiedad	Valor
Valor predeterminado:	False

--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster.

Propiedad	Valor
Valor predeterminado:	False

--enable-fips-image

Cambie para usar el sistema operativo habilitado para FIPS en los nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--enable-secure-boot

Habilite el arranque seguro en un grupo de nodos de agente habilitado para inicio seguro existente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-vtpm

Habilite vTPM en un grupo de nodos de agente habilitado para inicio seguro existente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--if-match

--if-none-match

Establézcalo en "*" para permitir la creación de un nuevo grupo de nodos, pero para evitar la actualización de un grupo de nodos existente. Se omitirán otros valores.

--labels

Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.

--max-count

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--max-unavailable

--min-count

--mode

Propiedad	Valor
Valores aceptados:	Gateway, System, User

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--node-taints

Las intolerancias de nodo del grupo de nodos. Puede actualizar el taint de nodo existente de un grupo de nodos o crear un nuevo valor taint de nodo para un grupo de nodos. Pase la cadena "" vacía para quitar todos los taints.

--os-sku

La os-sku del grupo de nodos del agente.

Propiedad	Valor
Valores aceptados:	AzureLinux, Ubuntu, Ubuntu2204

--scale-down-mode

Describir cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.

Propiedad	Valor
Valores aceptados:	Deallocate, Delete

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--undrainable-node-behavior

Defina el comportamiento de los nodos que no se pueden detectar durante la actualización. El valor debe ser "Cordon" o "Schedule". El valor predeterminado es "Schedule".

--update-cluster-autoscaler -u

Actualice min-count o max-count para el escalador automático del clúster.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool update (aks-preview extensión)

Actualice las propiedades de un grupo de nodos.

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]

Ejemplos

Concilie el grupo de nodos a su estado actual.

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

Habilitación del escalador automático de clústeres dentro del intervalo de recuento de nodos [1,5]

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

Deshabilitación del escalador automático de clústeres para un clúster existente

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

Actualice min-count o max-count para el escalador automático del clúster.

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

Cambiar un grupo de nodos al modo del sistema

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--allowed-host-ports

Vista previa

--asg-ids

Vista previa

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

Deshabilite Confianza de CA personalizada en el grupo de nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--disable-cluster-autoscaler -d

Deshabilite el escalador automático del clúster.

Propiedad	Valor
Valor predeterminado:	False

--disable-fips-image

Cambie para usar el sistema operativo no habilitado para FIPS en los nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--disable-secure-boot

Vista previa

Deshabilite el arranque seguro en un grupo de nodos de agente habilitado para inicio seguro existente.

Propiedad	Valor
Valor predeterminado:	False

--disable-vtpm

Vista previa

Deshabilite vTPM en un grupo de nodos de agente habilitado para inicio seguro existente.

Propiedad	Valor
Valor predeterminado:	False

--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--enable-artifact-streaming

Vista previa

Propiedad	Valor
Valor predeterminado:	False

--enable-cluster-autoscaler -e

Habilite el escalador automático del clúster. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-custom-ca-trust

Habilite Confianza de CA personalizada en el grupo de nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--enable-fips-image

Cambie para usar el sistema operativo habilitado para FIPS en los nodos del agente.

Propiedad	Valor
Valor predeterminado:	False

--enable-secure-boot

Vista previa

Habilite el arranque seguro en un grupo de nodos de agente habilitado para inicio seguro existente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--enable-vtpm

Vista previa

Habilite vTPM en un grupo de nodos de agente habilitado para inicio seguro existente. Debe usar el tipo de grupo de agentes de VMSS.

Propiedad	Valor
Valor predeterminado:	False

--if-match

--if-none-match

Establézcalo en "*" para permitir la creación de un nuevo grupo de nodos, pero para evitar la actualización de un grupo de nodos existente. Se omitirán otros valores.

--labels

Etiquetas de nodo para el grupo de nodos. Consulte https://aka.ms/node-labels para obtener información sobre la sintaxis de las etiquetas.

--max-blocked-nodes

--max-count

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--max-unavailable

--min-count

--mode

Propiedad	Valor
Valores aceptados:	Gateway, System, User

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--node-taints

Las intolerancias de nodo del grupo de nodos.

--os-sku

La os-sku del grupo de nodos del agente.

Propiedad	Valor
Valores aceptados:	AzureLinux, Ubuntu, Ubuntu2204, Ubuntu2404

--scale-down-mode

Describe cómo se agregan o quitan las máquinas virtuales de los grupos de nodos.

Propiedad	Valor
Valores aceptados:	Deallocate, Delete

--ssh-access

Vista previa

Actualice la configuración de SSH para el grupo de nodos. Use "disabled" para deshabilitar el acceso SSH, "localuser" para habilitar el acceso SSH mediante la clave privada.

Propiedad	Valor
Valores aceptados:	disabled, localuser

--tags

Etiquetas separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las etiquetas existentes.

--undrainable-node-behavior

Defina el comportamiento de los nodos que no se pueden detectar durante la actualización. El valor debe ser "Cordon" o "Schedule". El valor predeterminado es "Schedule".

--update-cluster-autoscaler -u

Actualice min-count o max-count para el escalador automático del clúster.

Propiedad	Valor
Valor predeterminado:	False

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool upgrade

Editar

Actualiza el grupo de nodos en un clúster de Kubernetes administrado.

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 requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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 clave-valor separados por comas para especificar encabezados personalizados.

--drain-timeout

Cuando los nodos se purgan cuánto tiempo se espera a que se desaloten todos los pods.

--if-match

--if-none-match

Establézcalo en "*" para permitir la creación de un nuevo grupo de nodos, pero para evitar la actualización de un grupo de nodos existente. Se omitirán otros valores.

--kubernetes-version -k

Versión de Kubernetes a la que actualizar el grupo de nodos, como "1.16.9".

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33 % (mutuamente excluyente con "--node-image-only". Consulte "az aks nodepool update --max-surge" para actualizar el aumento máximo antes de actualizar con "--node-image-only").

--max-unavailable

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--node-image-only

Actualice solo la imagen de nodo del grupo de agentes.

Propiedad	Valor
Valor predeterminado:	False

--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--snapshot-id

Identificador de instantánea de origen que se usa para actualizar este grupo de nodos.

--undrainable-node-behavior

Defina el comportamiento de los nodos que no se pueden detectar durante la actualización. El valor debe ser "Cordon" o "Schedule". El valor predeterminado es "Schedule".

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool upgrade (aks-preview extensión)

Actualiza el grupo de nodos en un clúster de Kubernetes administrado.

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 requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

Enviar encabezados personalizados. Cuando se especifica, el formato debe ser Key1=Value1,Key2=Value2.

--drain-timeout

Cuando los nodos purgan cuántos minutos se deben esperar a que se desaloten todos los pods.

--if-match

--if-none-match

Establézcalo en "*" para permitir la creación de un nuevo grupo de nodos, pero para evitar la actualización de un grupo de nodos existente. Se omitirán otros valores.

--kubernetes-version -k

Versión de Kubernetes a la que actualizar el grupo de nodos, como "1.11.12".

--max-blocked-nodes

--max-surge

Nodos adicionales usados para acelerar la actualización. Cuando se especifica, representa el número o porcentaje utilizado, por ejemplo, 5 o 33%.

--max-unavailable

--no-wait

No espere a que finalice la operación de ejecución prolongada.

Propiedad	Valor
Valor predeterminado:	False

--node-image-only

Actualice solo la imagen de nodo del grupo de agentes.

Propiedad	Valor
Valor predeterminado:	False

--node-soak-duration

Cantidad de tiempo (en minutos) que se debe esperar después de purgar un nodo y antes de volver a importarlo y pasar al siguiente nodo.

--snapshot-id

Identificador de instantánea de origen que se usa para actualizar este grupo de nodos. Debe usar el tipo de grupo de agentes de VMSS.

--undrainable-node-behavior

Defina el comportamiento de los nodos que no se pueden detectar durante la actualización. El valor debe ser "Cordon" o "Schedule". El valor predeterminado es "Schedule".

--yes -y

No solicita confirmación.

Propiedad	Valor
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

az aks nodepool wait

Editar

Espere a que un grupo de nodos alcance un estado deseado.

Si se interrumpió una operación en un grupo de nodos o se inició con --no-wait, use este comando para esperar a que se complete.

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

Ejemplos

Espere a que un grupo de nodos alcance un estado deseado, sondeando cada minuto hasta treinta minutos.

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

Parámetros requeridos

--cluster-name

Nombre del clúster.

--name --nodepool-name -n

Nombre del grupo de nodos.

--resource-group -g

Nombre del grupo de recursos. Puede configurar el grupo predeterminado mediante az configure --defaults group=<name>.

Parámetros opcionales

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

--created

Espere hasta que se cree con "provisioningState" en "Succeeded".

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	False

--custom

Espere hasta que la condición cumpla una consulta JMESPath personalizada. Por ejemplo, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Propiedad	Valor
Parameter group:	Wait Condition Arguments

--deleted

Espere hasta que se elimine.

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	False

--exists

Espere hasta que exista el recurso.

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	False

--interval

Intervalo de sondeo en segundos.

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	30

--timeout

Espera máxima en segundos.

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	3600

--updated

Espere hasta que se actualice con provisioningState en "Succeeded".

Propiedad	Valor
Parameter group:	Wait Condition Arguments
Valor predeterminado:	False

Parámetros globales

--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad	Valor
Valor predeterminado:	False

--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad	Valor
Valor predeterminado:	False

--output -o

Output format.

Propiedad	Valor
Valor predeterminado:	json
Valores aceptados:	json, jsonc, none, table, tsv, yaml, yamlc

--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--subscription

Nombre o identificador de la suscripción. Puede configurar la suscripción predeterminada mediante az account set -s NAME_OR_ID.

--verbose

Aumente el nivel de detalle del registro. Usa --debug para ver registros de depuración completos.

Propiedad	Valor
Valor predeterminado:	False

Compartir a través de

az aks nodepool

Comandos

az aks nodepool add

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool add (aks-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool delete

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool delete (aks-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool delete-machines

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool delete-machines (aks-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool get-upgrades

Ejemplos

Parámetros requeridos

az aks nodepool get-upgrades (aks-preview extensión)

Ejemplos

Parámetros requeridos

az aks nodepool list

Parámetros requeridos

az aks nodepool list (aks-preview extensión)

Parámetros requeridos

az aks nodepool operation-abort

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool operation-abort (aks-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool scale

Parámetros requeridos

Parámetros opcionales

az aks nodepool scale (aks-preview extensión)

Parámetros requeridos

Parámetros opcionales

az aks nodepool show

Parámetros requeridos

az aks nodepool show (aks-preview extensión)

Parámetros requeridos

az aks nodepool start

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool start (aks-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool stop

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool stop (aks-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool update

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool update (aks-preview extensión)

Ejemplos

Parámetros requeridos

Parámetros opcionales

az aks nodepool upgrade