Condividi tramite

az hdinsight-on-aks clusterpool

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione hdinsightonaks per l'interfaccia della riga di comando di Azure (versione 2.57.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az hdinsight-on-aks clusterpool . Altre informazioni sulle estensioni.

Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Operazioni del pool di cluster.

Comandi

Nome Descrizione Tipo Status
az hdinsight-on-aks clusterpool create

Creare un pool di cluster.

 Estensione Anteprima
az hdinsight-on-aks clusterpool delete

Eliminare un pool di cluster.

 Estensione Anteprima
az hdinsight-on-aks clusterpool list

Elencare l'elenco dei pool di cluster all'interno di una sottoscrizione.

 Estensione Anteprima
az hdinsight-on-aks clusterpool show

Ottenere un pool di cluster.

 Estensione Anteprima
az hdinsight-on-aks clusterpool update

Aggiornare un pool di cluster.

 Estensione Anteprima
az hdinsight-on-aks clusterpool upgrade

Aggiornare il pool di cluster.

 Estensione Anteprima
az hdinsight-on-aks clusterpool upgrade history

Elencare un elenco della cronologia degli aggiornamenti.

 Estensione Anteprima
az hdinsight-on-aks clusterpool upgrade list

Elencare un aggiornamento disponibile per un pool di cluster.

 Estensione Anteprima
az hdinsight-on-aks clusterpool upgrade run

Aggiornare un pool di cluster.

 Estensione Anteprima
az hdinsight-on-aks clusterpool wait

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

 Estensione Anteprima

az hdinsight-on-aks clusterpool create

Anteprima

Il gruppo di comandi 'az hdinsight-on-aks clusterpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare un pool di cluster.

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]

Esempio

Creare un pool di cluster.

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

Parametri necessari

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

Nome del pool di cluster.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri facoltativi

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

Gli intervalli IP vengono specificati in formato CIDR, ad esempio 137.117.106.88/29. Questa funzionalità non è compatibile con i cluster del servizio Azure Kubernetes privati. Non è quindi possibile impostare enablePrivateApiServer su true e apiServerAuthorizedIpRanges contemporaneamente. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--availability-zones

Elenco delle zone di disponibilità da usare per i nodi del set di scalabilità di macchine virtuali del servizio Azure Kubernetes. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--cluster-pool-version --version

La versione del pool di cluster è una versione in 2 parti.

--enable-log-analytics

True se Log Analytics è abilitato per il pool di cluster; in caso contrario, false.

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

Area di lavoro Log Analytics da associare all'agente OMS.

--location -l

Posizione geografica in cui si trova la risorsa Se non specificato, verrà usata la posizione del gruppo di risorse.

--managed-rg-name

Un gruppo di risorse creato da RP per contenere le risorse create da RP per conto dei clienti. Verrà usato anche per generare aksManagedResourceGroupName in base al modello: MC_{managedResourceGroupName}{clusterPoolName}{region}. Assicurarsi che soddisfi la restrizione del nome del gruppo di risorse.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--outbound-type

Questa impostazione può essere impostata solo in fase di creazione del pool di cluster e non può essere modificata in un secondo momento.

Valori accettati: loadBalancer, userDefinedRouting
Valore predefinito: loadBalancer
--private-server-enabled

ClusterPool è basato sul cluster del servizio Azure Kubernetes. Il cluster del servizio Azure Kubernetes espone il server API a Internet pubblico per impostazione predefinita. Se si imposta questa proprietà su true, verrà creato un cluster del servizio Azure Kubernetes privato e verrà usato un server API privato, che non è esposto a Internet pubblico.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--subnet-id

ID risorsa della subnet del pool di cluster.

--tags

Tag di risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--workernode-size

SKU della macchina virtuale.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az hdinsight-on-aks clusterpool delete

Anteprima

Il gruppo di comandi 'az hdinsight-on-aks clusterpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare un pool di cluster.

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]

Esempio

Elimina un pool di cluster.

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

Parametri facoltativi

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

Nome del pool di cluster.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

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

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--yes -y

Indica che non è richiesta la conferma.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az hdinsight-on-aks clusterpool list

Anteprima

Il gruppo di comandi 'az hdinsight-on-aks clusterpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare l'elenco dei pool di cluster all'interno di una sottoscrizione.

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

Esempio

Elenca l'elenco di clusterpool in un gruppo di risorse.

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

Elencare l'elenco dei pool di cluster all'interno di una sottoscrizione.

az hdinsightonaks clusterpool list

Parametri facoltativi

--max-items

Numero totale di elementi da restituire nell'output del comando. Se il numero totale di elementi disponibili è maggiore del valore specificato, nell'output del comando viene fornito un token. Per riprendere la paginazione, specificare il valore del token nell'argomento --next-token di un comando successivo.

--next-token

Token per specificare dove iniziare la paginazione. Si tratta del valore del token di una risposta troncata in precedenza.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az hdinsight-on-aks clusterpool show

Anteprima

Il gruppo di comandi 'az hdinsight-on-aks clusterpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Ottenere un pool di cluster.

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

Esempio

Ottenere il pool di cluster.

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

Parametri facoltativi

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

Nome del pool di cluster.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az hdinsight-on-aks clusterpool update

Anteprima

Il gruppo di comandi 'az hdinsight-on-aks clusterpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare un pool di cluster.

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]

Esempio

Aggiorna un cluster esistente abilita l'analisi dei 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"}

Parametri facoltativi

--add

Aggiungere un oggetto a un elenco di oggetti specificando un percorso e coppie chiave-valore. Esempio: --add property.listProperty <key=value, stringa o stringa> JSON.

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

Gli intervalli IP vengono specificati in formato CIDR, ad esempio 137.117.106.88/29. Questa funzionalità non è compatibile con i cluster del servizio Azure Kubernetes privati. Non è quindi possibile impostare enablePrivateApiServer su true e apiServerAuthorizedIpRanges contemporaneamente. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

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

Nome del pool di cluster.

--cluster-pool-version --version

La versione del pool di cluster è una versione in 2 parti.

--compute-profile

Profilo di calcolo del pool CLuster. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

--enable-log-analytics

True se Log Analytics è abilitato per il pool di cluster; in caso contrario, false.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--force-string

Quando si usa 'set' o 'add', mantenere i valori letterali stringa anziché tentare di eseguire la conversione in JSON.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

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

Area di lavoro Log Analytics da associare all'agente OMS.

--managed-rg-name

Un gruppo di risorse creato da RP per contenere le risorse create da RP per conto dei clienti. Verrà usato anche per generare aksManagedResourceGroupName in base al modello: MC_{managedResourceGroupName}{clusterPoolName}{region}. Assicurarsi che soddisfi la restrizione del nome del gruppo di risorse.

--no-wait

Indica che non è necessario attendere il termine dell'operazione a esecuzione prolungata.

Valori accettati: 0, 1, f, false, n, no, t, true, y, yes
--outbound-type

Questa impostazione può essere impostata solo in fase di creazione del pool di cluster e non può essere modificata in un secondo momento.

Valori accettati: loadBalancer, userDefinedRouting
--remove

Rimuovere una proprietà o un elemento da un elenco. Esempio: --remove property.list OR --remove propertyToRemove.

--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--set

Aggiornare un oggetto specificando un percorso di proprietà e un valore da impostare. Esempio: --set property1.property2=.

--subnet-id

ID risorsa della subnet del pool di cluster.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--tags

Tag di risorsa. Supportare la sintassi abbreviata, json-file e yaml-file. Prova "??" per mostrare di più.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

az hdinsight-on-aks clusterpool wait

Anteprima

Il gruppo di comandi 'az hdinsight-on-aks clusterpool' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Posizionare l'interfaccia della riga di comando in uno stato di attesa fino a quando non viene soddisfatta una condizione.

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

Parametri facoltativi

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

Nome del pool di cluster.

--created

Attendere fino a quando non viene creato con 'provisioningState' in 'Succeeded'.

Valore predefinito: False
--custom

Attendere che la condizione soddisfi una query JMESPath personalizzata. Ad esempio provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Attendere l'eliminazione.

Valore predefinito: False
--exists

Attendere che la risorsa esista.

Valore predefinito: False
--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti 'ID risorsa'. È necessario specificare --ids o altri argomenti 'ID risorsa'.

--interval

Intervallo di polling in secondi.

Valore predefinito: 30
--resource-group -g

Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--timeout

Attesa massima in secondi.

Valore predefinito: 3600
--updated

Attendere fino a quando non viene aggiornato con provisioningState in 'Succeeded'.

Valore predefinito: False
Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID.

--verbose

Aumenta il livello di dettaglio della registrazione. Usare --debug per log di debug completi.