Compartir a través de

az hdinsight-on-aks clusterpool

  • Vista previa
  • Referencia

Nota:

Esta referencia forma parte de la extensión hdinsightonaks para la CLI de Azure (versión 2.57.0 o posterior). La extensión se instalará automáticamente la primera vez que ejecute un comando az hdinsight-on-aks clusterpool . Obtenga más información sobre las extensiones.

Este grupo de comandos está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Operaciones de grupo de clústeres.

Comandos

Nombre Description Tipo Estado
az hdinsight-on-aks clusterpool create

Cree un grupo de clústeres.

 Extensión Vista previa
az hdinsight-on-aks clusterpool delete

Elimine un grupo de clústeres.

 Extensión Vista previa
az hdinsight-on-aks clusterpool list

Enumere la lista de grupos de clústeres dentro de una suscripción.

 Extensión Vista previa
az hdinsight-on-aks clusterpool show

Obtenga un grupo de clústeres.

 Extensión Vista previa
az hdinsight-on-aks clusterpool update

Actualice un grupo de clústeres.

 Extensión Vista previa
az hdinsight-on-aks clusterpool upgrade

Actualice clusterpool.

 Extensión Vista previa
az hdinsight-on-aks clusterpool upgrade history

Enumerar una lista del historial de actualizaciones.

 Extensión Vista previa
az hdinsight-on-aks clusterpool upgrade list

Enumeración de un grupo de clústeres disponible de actualización.

 Extensión Vista previa
az hdinsight-on-aks clusterpool upgrade run

Actualice un grupo de clústeres.

 Extensión Vista previa
az hdinsight-on-aks clusterpool wait

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

 Extensión Vista previa

az hdinsight-on-aks clusterpool create

Vista previa

El grupo de comandos "az hdinsight-on-aks clusterpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Cree un grupo de clústeres.

az hdinsight-on-aks clusterpool create --cluster-pool-name
                                       --resource-group
                                       [--api-server-authorized-ip-ranges]
                                       [--availability-zones]
                                       [--cluster-pool-version]
                                       [--enable-log-analytics {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--la-workspace-id]
                                       [--location]
                                       [--managed-rg-name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--outbound-type {loadBalancer, userDefinedRouting}]
                                       [--private-server-enabled {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--subnet-id]
                                       [--tags]
                                       [--workernode-size]

Ejemplos

Cree un grupo de clústeres.

az hdinsight-on-aks clusterpool create -g {RG} -n {poolName} -l {westus3} --workernode-size {Standard_E4s_v3} --version {1.1}

Parámetros requeridos

--cluster-pool-name --name -n

Nombre del grupo de clústeres.

--resource-group -g

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

Parámetros opcionales

--api-server-authorized-ip-ranges --api-server-ip-ranges

Los intervalos IP se especifican en formato CIDR, por ejemplo, 137.117.106.88/29. Esta característica no es compatible con clústeres de AKS privados. Por lo tanto, no puede establecer enablePrivateApiServer en true y apiServerAuthorizedIpRanges al mismo tiempo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--availability-zones

Lista de zonas de disponibilidad que se van a usar para los nodos de VMSS de AKS. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--cluster-pool-version --version

La versión del grupo de clústeres es una versión de 2 partes.

--enable-log-analytics

True si Log Analytics está habilitado para el grupo de clústeres; de lo contrario, false.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--la-workspace-id --log-analytic-workspace-id

Área de trabajo de Log Analytics que se va a asociar al agente de OMS.

--location -l

Ubicación geográfica donde reside el recurso Cuando no se especifica, se usará la ubicación del grupo de recursos.

--managed-rg-name

Un grupo de recursos creado por RP para almacenar los recursos creados por RP en nombre de los clientes. También se usará para generar aksManagedResourceGroupName por patrón: MC_{managedResourceGroupName}{clusterPoolName}{region}. Asegúrese de que cumple la restricción de nombres del grupo de recursos.

--no-wait

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

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--outbound-type

Esto solo se puede establecer en el momento de creación del grupo de clústeres y no se puede cambiar más adelante.

Valores aceptados: loadBalancer, userDefinedRouting
Valor predeterminado: loadBalancer
--private-server-enabled

ClusterPool se basa en el clúster de AKS. El clúster de AKS expone el servidor de API a la red pública de Internet de forma predeterminada. Si establece esta propiedad en true, se creará un clúster de AKS privado y usará apiserver privado, que no se expone a la red pública de Internet.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--subnet-id

Identificador de recurso de subred del grupo de clústeres.

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--workernode-size

SKU de máquina virtual.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az hdinsight-on-aks clusterpool delete

Vista previa

El grupo de comandos "az hdinsight-on-aks clusterpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Elimine un grupo de clústeres.

az hdinsight-on-aks clusterpool delete [--cluster-pool-name]
                                       [--ids]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--resource-group]
                                       [--subscription]
                                       [--yes]

Ejemplos

Elimina un grupo de clústeres.

az hdinsight-on-aks clusterpool delete -g {RG} -n {poolName}

Parámetros opcionales

--cluster-pool-name --name -n

Nombre del grupo de clústeres.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--no-wait

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

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--yes -y

No solicita confirmación.

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az hdinsight-on-aks clusterpool list

Vista previa

El grupo de comandos "az hdinsight-on-aks clusterpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Enumere la lista de grupos de clústeres dentro de una suscripción.

az hdinsight-on-aks clusterpool list [--max-items]
                                     [--next-token]
                                     [--resource-group]

Ejemplos

Enumera la lista de grupos de clústeres en un grupo de recursos.

az hdinsight-on-aks clusterpool list -g {RG}

Enumere la lista de grupos de clústeres dentro de una suscripción.

az hdinsightonaks clusterpool list

Parámetros opcionales

--max-items

Número total de elementos que se van a devolver en la salida del comando. Si el número total de elementos disponibles es mayor que el valor especificado, se proporciona un token en la salida del comando. Para reanudar la paginación, proporcione el valor del token en --next-token el argumento de un comando posterior.

--next-token

Token para especificar dónde iniciar la paginación. Este es el valor del token de una respuesta truncada anteriormente.

--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 de registro para mostrar todos los registros de depuración.

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az hdinsight-on-aks clusterpool show

Vista previa

El grupo de comandos "az hdinsight-on-aks clusterpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Obtenga un grupo de clústeres.

az hdinsight-on-aks clusterpool show [--cluster-pool-name]
                                     [--ids]
                                     [--resource-group]
                                     [--subscription]

Ejemplos

Obtenga el grupo de clústeres.

az hdinsight-on-aks clusterpool show -g {RG} -n {poolName}

Parámetros opcionales

--cluster-pool-name --name -n

Nombre del grupo de clústeres.

--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--resource-group -g

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

--subscription

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

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az hdinsight-on-aks clusterpool update

Vista previa

El grupo de comandos "az hdinsight-on-aks clusterpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Actualice un grupo de clústeres.

az hdinsight-on-aks clusterpool update [--add]
                                       [--api-server-authorized-ip-ranges]
                                       [--cluster-pool-name]
                                       [--cluster-pool-version]
                                       [--compute-profile]
                                       [--enable-log-analytics {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--ids]
                                       [--la-workspace-id]
                                       [--managed-rg-name]
                                       [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                       [--outbound-type {loadBalancer, userDefinedRouting}]
                                       [--remove]
                                       [--resource-group]
                                       [--set]
                                       [--subnet-id]
                                       [--subscription]
                                       [--tags]

Ejemplos

Actualiza un clúster existente que habilita el análisis de registros.

az hdinsight-on-aksclusterpool update -g {RG} -n {poolName} --enable-log-analytics --log-analytic-workspace-id {"/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/RG/providers/microsoft.operationalinsights/workspaces/yourworkspace"}

Parámetros opcionales

--add

Agregue un objeto a una lista de objetos especificando una ruta de acceso y pares clave-valor. Ejemplo: --add property.listProperty <key=value, string o JSON string>.

--api-server-authorized-ip-ranges --api-server-ip-ranges

Los intervalos IP se especifican en formato CIDR, por ejemplo, 137.117.106.88/29. Esta característica no es compatible con clústeres de AKS privados. Por lo tanto, no puede establecer enablePrivateApiServer en true y apiServerAuthorizedIpRanges al mismo tiempo. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--cluster-pool-name --name -n

Nombre del grupo de clústeres.

--cluster-pool-version --version

La versión del grupo de clústeres es una versión de 2 partes.

--compute-profile

Perfil de proceso del grupo de CLuster. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

--enable-log-analytics

True si Log Analytics está habilitado para el grupo de clústeres; de lo contrario, false.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--force-string

Al usar 'set' o 'add', conserve los literales de cadena en lugar de intentar convertir en JSON.

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--la-workspace-id --log-analytic-workspace-id

Área de trabajo de Log Analytics que se va a asociar al agente de OMS.

--managed-rg-name

Un grupo de recursos creado por RP para almacenar los recursos creados por RP en nombre de los clientes. También se usará para generar aksManagedResourceGroupName por patrón: MC_{managedResourceGroupName}{clusterPoolName}{region}. Asegúrese de que cumple la restricción de nombres del grupo de recursos.

--no-wait

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

Valores aceptados: 0, 1, f, false, n, no, t, true, y, yes
--outbound-type

Esto solo se puede establecer en el momento de creación del grupo de clústeres y no se puede cambiar más adelante.

Valores aceptados: loadBalancer, userDefinedRouting
--remove

Quite una propiedad o un elemento de una lista. Ejemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Actualice un objeto especificando una ruta de acceso de propiedad y un valor que se va a establecer. Ejemplo: --set property1.property2=.

--subnet-id

Identificador de recurso de subred del grupo de clústeres.

--subscription

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

--tags

Etiquetas del recurso. Admite la sintaxis abreviada, json-file y yaml-file. Intenta "??" para mostrar más.

Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.

az hdinsight-on-aks clusterpool wait

Vista previa

El grupo de comandos "az hdinsight-on-aks clusterpool" está en versión preliminar y en desarrollo. Niveles de referencia y soporte técnico: https://aka.ms/CLI_refstatus

Coloque la CLI en un estado de espera hasta que se cumpla una condición.

az hdinsight-on-aks clusterpool wait [--cluster-pool-name]
                                     [--created]
                                     [--custom]
                                     [--deleted]
                                     [--exists]
                                     [--ids]
                                     [--interval]
                                     [--resource-group]
                                     [--subscription]
                                     [--timeout]
                                     [--updated]

Parámetros opcionales

--cluster-pool-name --name -n

Nombre del grupo de clústeres.

--created

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

Valor predeterminado: False
--custom

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

--deleted

Espere hasta que se elimine.

Valor predeterminado: False
--exists

Espere hasta que exista el recurso.

Valor predeterminado: False
--ids

Uno o varios identificadores de recursos (delimitados por espacios). Debe ser un identificador de recurso completo que contenga toda la información de los argumentos "Resource Id". Debe proporcionar argumentos --ids u otros argumentos "Resource Id".

--interval

Intervalo de sondeo en segundos.

Valor predeterminado: 30
--resource-group -g

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

--subscription

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

--timeout

Espera máxima en segundos.

Valor predeterminado: 3600
--updated

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

Valor predeterminado: False
Parámetros globales
--debug

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

--help -h

Muestre este mensaje de ayuda y salga.

--only-show-errors

Mostrar solo los errores y suprimir las advertencias.

--output -o

Formato de salida.

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

Cadena de consulta de JMESPath. Para más información y ejemplos, consulte http://jmespath.org/.

--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 de registro. Use --debug para obtener registros de depuración completos.