az aks machine

Note

Este grupo de comandos tiene comandos definidos en CLI de Azure y al menos una extensión. Instale cada extensión para beneficiarse de sus funcionalidades extendidas. Obtenga más información sobre las extensiones.

Obtenga información sobre las máquinas de un grupo de nodos de un clúster administrado.

Comandos

Nombre Description Tipo Estado
az aks machine add

Agregue una máquina al grupo de nodos especificado.

 Extension GA
az aks machine list

Obtenga información sobre direcciones IP, nombre de host para todas las máquinas de un grupo de agentes.

 Core GA
az aks machine list (aks-preview extensión)

Enumere los detalles de todas las máquinas de un grupo de agentes.

 Extension GA
az aks machine show

Mostrar direcciones IP, nombre de host para una máquina específica en un grupo de agentes para un clúster administrado.

 Core GA
az aks machine show (aks-preview extensión)

Mostrar los detalles de una máquina específica en un grupo de agentes de un clúster administrado.

 Extension GA
az aks machine update

Actualice la máquina especificada en un grupo de agentes.

 Extension GA

az aks machine add

Agregue una máquina al grupo de nodos especificado.

az aks machine add --cluster-name
                   --nodepool-name
                   --resource-group
                   [--acquire-policy-token]
                   [--change-reference]
                   [--disable-fips-image]
                   [--enable-fips-image]
                   [--enable-node-public-ip]
                   [--enable-ultra-ssd]
                   [--eviction-policy {Deallocate, Delete}]
                   [--kubernetes-version]
                   [--machine-name]
                   [--no-wait]
                   [--node-public-ip-prefix-id]
                   [--node-public-ip-tags]
                   [--os-sku {AzureContainerLinux, AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual}]
                   [--os-type]
                   [--pod-subnet-id]
                   [--priority {Regular, Spot}]
                   [--spot-max-price]
                   [--tags]
                   [--vm-size]
                   [--vnet-subnet-id]
                   [--zones]

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--nodepool-name

Nombre del grupo de agentes de un clúster administrado.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--disable-fips-image

Cambie para usar el sistema operativo no habilitado para FIPS en la máquina.

Propiedad Valor
Valor predeterminado: False
--enable-fips-image

Cambie para usar el sistema operativo habilitado para FIPS en la máquina.

Propiedad Valor
Valor predeterminado: False
--enable-node-public-ip

Habilite la dirección IP pública de la máquina.

Propiedad Valor
Valor predeterminado: False
--enable-ultra-ssd

Si se va a habilitar UltraSSD.

Propiedad Valor
Valor predeterminado: False
--eviction-policy

La política de desahucios para máquinas. Esto no puede especificarse a menos que la prioridad sea 'Spot'. Si no se especifica, el valor predeterminado es "Delete".

Propiedad Valor
Valores aceptados: Deallocate, Delete
--kubernetes-version

Versión de Kubernetes que se usará para crear la máquina, como "1.7.12" o "1.8.7".

--machine-name

Nombre de host de la máquina.

--no-wait

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

Propiedad Valor
Valor predeterminado: False
--node-public-ip-prefix-id

Identificador de prefijo de DIRECCIÓN IP pública que se usa para asignar direcciones IP públicas a la máquina.

--node-public-ip-tags

IpTags de las direcciones IP públicas de la máquina.

--os-sku

La os-sku del grupo de nodos del agente.

Propiedad Valor
Valores aceptados: AzureContainerLinux, AzureLinux, AzureLinux3, AzureLinux3OSGuard, AzureLinuxOSGuard, CBLMariner, Flatcar, Mariner, Ubuntu, Ubuntu2204, Ubuntu2404, Windows2019, Windows2022, Windows2025, WindowsAnnual
--os-type

El tipo de sistema operativo de la máquina.

--pod-subnet-id

El identificador de una subred de una red virtual existente en la que asignar pods en la máquina (requiere azure network-plugin).

--priority

Prioridad de la máquina.

Propiedad Valor
Valores aceptados: Regular, Spot
--spot-max-price

El precio máximo (en dólares estadounidenses) que está dispuesto a pagar por las instancias de spot.

Propiedad Valor
Valor predeterminado: nan
--tags

Etiquetas de la máquina.

--vm-size

Tamaño de la máquina.

--vnet-subnet-id

Identificador de una subred de una red virtual existente en la que se va a implementar la máquina.

--zones -z

Lista separada por espacios de zonas de disponibilidad donde se colocará una máquina.

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

Formato de salida.

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

Editar

Obtenga información sobre direcciones IP, nombre de host para todas las máquinas de un grupo de agentes.

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

Ejemplos

Obtenga información sobre las direcciones IP, el nombre de host Availability Zones para todas las máquinas de un grupo de agentes.

az aks machine list  --resource-group <rg> --cluster-name <clusterName> --nodepool-name <apName>

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--nodepool-name

Nombre del grupo de agentes de un clúster administrado.

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

Formato de salida.

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 machine list (aks-preview extensión)

Enumere los detalles de todas las máquinas de un grupo de agentes.

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

Ejemplos

Enumerar los detalles de todas las máquinas de un grupo de agentes

az aks machine list --resource-group <resourceGroupName> --cluster-name <clusterName> --nodepool-name <apName>

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--nodepool-name

Nombre del grupo de agentes de un clúster administrado.

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

Formato de salida.

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

Editar

Mostrar direcciones IP, nombre de host para una máquina específica en un grupo de agentes para un clúster administrado.

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

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--machine-name

Nombre de la máquina en el grupo de agentes de un clúster administrado.

--nodepool-name

Nombre del grupo de agentes de un clúster administrado.

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

Formato de salida.

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 machine show (aks-preview extensión)

Mostrar los detalles de una máquina específica en un grupo de agentes de un clúster administrado.

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

Ejemplos

Mostrar los detalles de una máquina específica en un grupo de agentes de un clúster administrado.

az aks machine show --resource-group <resourceGroupName> --cluster-name <clusterName> --nodepool-name <apName> --machine-name <machineName>

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--machine-name

Nombre de la máquina.

--nodepool-name

Nombre del grupo de agentes de un clúster administrado.

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

Formato de salida.

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

Actualice la máquina especificada en un grupo de agentes.

az aks machine update --cluster-name
                      --nodepool-name
                      --resource-group
                      [--acquire-policy-token]
                      [--change-reference]
                      [--labels]
                      [--machine-name]
                      [--no-wait]
                      [--node-taints]
                      [--tags]

Parámetros requeridos

--cluster-name

Nombre del clúster administrado.

--nodepool-name

Nombre del grupo de agentes de un clúster administrado.

--resource-group -g

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

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--acquire-policy-token

Adquirir un token de Azure Policy automáticamente para esta operación de recursos.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--change-reference

Identificador de referencia de cambio relacionado para esta operación de recurso.

Propiedad Valor
Grupo de parámetros: Global Policy Arguments
--labels

Etiquetas de la máquina.

--machine-name

Nombre de host de la máquina.

--no-wait

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

Propiedad Valor
Valor predeterminado: False
--node-taints

Las taints de la máquina.

--tags

Etiquetas de la máquina.

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

Formato de salida.

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