Partilhar via

az hdinsight-on-aks clusterpool

  • Pré-visualizar
  • Referência

Nota

Essa referência faz parte da extensão hdinsightonaks para a CLI do Azure (versão 2.57.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az hdinsight-on-aks clusterpool. Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Operações de clusterpool.

Comandos

Name Description Tipo Status
az hdinsight-on-aks clusterpool create

Crie um pool de clusters.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool delete

Exclua um pool de clusters.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool list

Liste a lista de Pools de Cluster em uma Assinatura.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool show

Obtenha um pool de clusters.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool update

Atualize um pool de clusters.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool upgrade

Atualizar clusterpool.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool upgrade history

Liste uma lista do histórico de atualizações.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool upgrade list

Liste uma atualização disponível do pool de clusters.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool upgrade run

Atualize um pool de clusters.

 Extensão Pré-visualizar
az hdinsight-on-aks clusterpool wait

Coloque a CLI em um estado de espera até que uma condição seja atendida.

 Extensão Pré-visualizar

az hdinsight-on-aks clusterpool create

Pré-visualizar

O grupo de comandos 'az hdinsight-on-aks clusterpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie um pool de clusters.

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]

Exemplos

Crie um pool de clusters.

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

Parâmetros Obrigatórios

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

O nome do pool de clusters.

--resource-group -g

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

Parâmetros Opcionais

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

Os intervalos de IP são especificados no formato CIDR, por exemplo, 137.117.106.88/29. Este recurso não é compatível com clusters AKS privados. Portanto, você não pode definir enablePrivateApiServer como true e apiServerAuthorizedIpRanges ao mesmo tempo. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--availability-zones

A lista de zonas de disponibilidade a serem usadas para nós AKS VMSS. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--cluster-pool-version --version

A versão do pool de clusters é uma versão de 2 partes.

--enable-log-analytics

True se a análise de log estiver habilitada para pool de clusters, caso contrário, false.

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

Espaço de trabalho de análise de log para associar ao agente do OMS.

--location -l

A localização geográfica onde o recurso reside Quando não especificada, a localização do grupo de recursos será usada.

--managed-rg-name

Um grupo de recursos criado por RP, para manter os recursos criados por RP em nome de clientes. Ele também será usado para gerar aksManagedResourceGroupName por padrão: MC_{managedResourceGroupName}{clusterPoolName}{region}. Certifique-se de que cumpre a restrição de nome do grupo de recursos.

--no-wait

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

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

Isso só pode ser definido no momento da criação do pool de clusters e não pode ser alterado posteriormente.

Valores aceites: loadBalancer, userDefinedRouting
Default value: loadBalancer
--private-server-enabled

ClusterPool é baseado no cluster AKS. O cluster AKS expõe o servidor de API à Internet pública por padrão. Se você definir essa propriedade como true, um cluster AKS privado será criado e ele usará apiserver privado, que não está exposto à Internet pública.

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

ID do recurso de sub-rede do pool de clusters.

--tags

Tags de recursos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--workernode-size

A máquina virtual SKU.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az hdinsight-on-aks clusterpool delete

Pré-visualizar

O grupo de comandos 'az hdinsight-on-aks clusterpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua um pool de clusters.

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]

Exemplos

Exclui um pool de clusters.

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

Parâmetros Opcionais

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

O nome do pool de clusters.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--no-wait

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

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

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

--subscription

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

--yes -y

Não solicite confirmação.

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az hdinsight-on-aks clusterpool list

Pré-visualizar

O grupo de comandos 'az hdinsight-on-aks clusterpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Liste a lista de Pools de Cluster em uma Assinatura.

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

Exemplos

Lista a lista de clusterpool em um grupo de recursos.

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

Liste a lista de Pools de Cluster em uma Assinatura.

az hdinsightonaks clusterpool list

Parâmetros Opcionais

--max-items

Número total de itens a serem retornados na saída do comando. Se o número total de itens disponíveis for maior do que o valor especificado, um token será fornecido na saída do comando. Para retomar a paginação, forneça o valor do token no --next-token argumento de um comando subsequente.

--next-token

Token para especificar por onde começar a paginar. Este é o valor de token de uma resposta truncada anteriormente.

--resource-group -g

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az hdinsight-on-aks clusterpool show

Pré-visualizar

O grupo de comandos 'az hdinsight-on-aks clusterpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Obtenha um pool de clusters.

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

Exemplos

Obtenha o clusterpool.

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

Parâmetros Opcionais

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

O nome do pool de clusters.

--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--resource-group -g

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

--subscription

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

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az hdinsight-on-aks clusterpool update

Pré-visualizar

O grupo de comandos 'az hdinsight-on-aks clusterpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualize um pool de clusters.

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]

Exemplos

Atualiza um Cluster existente habilitando a análise de log.

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 Opcionais

--add

Adicione um objeto a uma lista de objetos especificando um caminho e pares de valor de chave. Exemplo: --add property.listProperty <key=value, string ou JSON string>.

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

Os intervalos de IP são especificados no formato CIDR, por exemplo, 137.117.106.88/29. Este recurso não é compatível com clusters AKS privados. Portanto, você não pode definir enablePrivateApiServer como true e apiServerAuthorizedIpRanges ao mesmo tempo. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

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

O nome do pool de clusters.

--cluster-pool-version --version

A versão do pool de clusters é uma versão de 2 partes.

--compute-profile

Perfil de computação do pool CLuster. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

--enable-log-analytics

True se a análise de log estiver habilitada para pool de clusters, caso contrário, false.

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

Ao usar 'set' ou 'add', preserve literais de string em vez de tentar converter para JSON.

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

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

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

Espaço de trabalho de análise de log para associar ao agente do OMS.

--managed-rg-name

Um grupo de recursos criado por RP, para manter os recursos criados por RP em nome de clientes. Ele também será usado para gerar aksManagedResourceGroupName por padrão: MC_{managedResourceGroupName}{clusterPoolName}{region}. Certifique-se de que cumpre a restrição de nome do grupo de recursos.

--no-wait

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

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

Isso só pode ser definido no momento da criação do pool de clusters e não pode ser alterado posteriormente.

Valores aceites: loadBalancer, userDefinedRouting
--remove

Remova uma propriedade ou um elemento de uma lista. Exemplo: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Atualize um objeto especificando um caminho de propriedade e um valor a ser definido. Exemplo: --set property1.property2=.

--subnet-id

ID do recurso de sub-rede do pool de clusters.

--subscription

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

--tags

Tags de recursos. Suporta sintaxe taquigráfica, json-file e yaml-file. Tente "??" para mostrar mais.

Parâmetros de Globais
--debug

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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

az hdinsight-on-aks clusterpool wait

Pré-visualizar

O grupo de comandos 'az hdinsight-on-aks clusterpool' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Coloque a CLI em um estado de espera até que uma condição seja atendida.

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

Parâmetros Opcionais

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

O nome do pool de clusters.

--created

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

Default value: False
--custom

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

--deleted

Aguarde até ser excluído.

Default value: False
--exists

Aguarde até que o recurso exista.

Default value: False
--ids

Um ou mais IDs de recurso (delimitados por espaço). Deve ser um ID de recurso completo contendo todas as informações dos argumentos 'ID do recurso'. Você deve fornecer --ids ou outros argumentos 'Resource Id'.

--interval

Intervalo de sondagem em segundos.

Default value: 30
--resource-group -g

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

--subscription

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

--timeout

Espera máxima em segundos.

Default value: 3600
--updated

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

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

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

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

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

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

--subscription

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

--verbose

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