az load test

  • Anteprima
  • Riferimento

Nota

Questo riferimento fa parte dell'estensione di caricamento per l'interfaccia della riga di comando di Azure (versione 2.41.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az load test . 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

Gruppo di comandi per gestire i test di carico.

Gruppo di comandi per gestire il test di carico con creazione, aggiornamento, eliminazione, elenco e così via.

Comandi

Nome Descrizione Tipo Stato
az load test app-component

Gruppo di comandi per gestire i componenti dell'app.

 Estensione Anteprima
az load test app-component add

Aggiungere un componente dell'app a un test.

 Estensione Anteprima
az load test app-component list

Elencare tutti i componenti dell'app per un test.

 Estensione Anteprima
az load test app-component remove

Rimuovere il componente dell'app specificato da un test.

 Estensione Anteprima
az load test create

Creare un nuovo test di carico.

 Estensione Anteprima
az load test delete

Eliminare un test di carico esistente.

 Estensione Anteprima
az load test download-files

Scaricare i file di un test di carico esistente.

 Estensione Anteprima
az load test file

Gruppo di comandi per le operazioni sui file di test.

 Estensione Anteprima
az load test file delete

Eliminare un file dal test.

 Estensione Anteprima
az load test file download

Scaricare un file da un test.

 Estensione Anteprima
az load test file list

Elencare tutti i file in un test.

 Estensione Anteprima
az load test file upload

Caricare un file in un test.

 Estensione Anteprima
az load test list

Elencare tutti i test nella risorsa test di carico specificata.

 Estensione Anteprima
az load test server-metric

Gruppo di comandi per gestire le metriche del server.

 Estensione Anteprima
az load test server-metric add

Aggiungere una metrica server a un test.

 Estensione Anteprima
az load test server-metric list

Elencare tutte le metriche del server per un test.

 Estensione Anteprima
az load test server-metric remove

Rimuovere la metrica server specificata dal test.

 Estensione Anteprima
az load test show

Mostra i dettagli del test.

 Estensione Anteprima
az load test update

Aggiornare un test di carico esistente.

 Estensione Anteprima

az load test create

Anteprima

Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Creare un nuovo test di carico.

az load test create --load-test-resource
                    --test-id
                    [--certificate]
                    [--description]
                    [--display-name]
                    [--engine-instances]
                    [--env]
                    [--keyvault-reference-id]
                    [--load-test-config-file]
                    [--no-wait]
                    [--resource-group]
                    [--secret]
                    [--split-csv]
                    [--subnet-id]
                    [--test-plan]

Esempio

Creare un test con il file di configurazione del test di carico.

az load test create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --load-test-config-file ~/resources/sample-config.yaml

Creare un test con argomenti.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --description "Test description" --test-plan sample-jmx.jmx --engine-instances 1 --env rps=2 count=1

Creare un test con il file di configurazione del test di carico ed eseguire l'override dell'istanza del motore e di env usando argomenti e non attendere il caricamento dei file.

az load test create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --load-test-config-file ~/resources/sample-config.yaml --engine-instances 1 --env rps=2 count=1 --no-wait

Creare un test con segreti e variabili di ambiente.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --description "Test description" --test-plan sample-jmx.jmx --secret secret_name1=secret_uri1 secret_name2=secret_uri2 --env rps=2 count=1

Creare un test con segreti usando l'identità gestita assegnata dall'utente per accedere all'insieme di credenziali delle chiavi.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --secret secret_name1=secret_uri1 secret_name2=secret_uri2 --keyvault-reference-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/microsoft.managedidentity/userassignedidentities/sample-mi"

Creare un test per un endpoint privato in un Rete virtuale con l'opzione split CSV abilitata.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --subnet-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.Network/virtualNetworks/SampleVMVNET/subnets/SampleVMSubnet" --split-csv true

Parametri necessari

--load-test-resource --name -n

Nome o ID risorsa ARM della risorsa test di carico.

--test-id -t

ID test del test di carico.

Parametri facoltativi

--certificate

Un singolo certificato in formato 'key[=value]'. Il certificato deve essere archiviato in Azure Key Vault in formato PFX e l'identificatore del certificato deve essere fornito come valore.

--description

Descrizione del test di carico.

--display-name

Nome visualizzato del test di carico.

--engine-instances

Numero di istanze del motore in cui deve essere eseguito il test.

--env

Variabili di ambiente separate da spazi: key[=value] [key[=value] ...].

--keyvault-reference-id

Identità che verrà usata per accedere all'insieme di credenziali delle chiavi.

--load-test-config-file

Percorso del file di configurazione del test di carico. Vedere https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

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

valore predefinito: False
--resource-group -g

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

--secret

Segreti separati da spazi: key[=value] [key[=value] ...]. I segreti devono essere archiviati in Azure Key Vault e l'identificatore del segreto deve essere specificato come valore.

--split-csv

Suddividere i file CSV in modo uniforme tra le istanze del motore.

--subnet-id

ID risorsa della subnet da usare per il test di carico privato.

--test-plan

Percorso dello script JMeter.

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 sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

az load test delete

Anteprima

Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Eliminare un test di carico esistente.

az load test delete --load-test-resource
                    --test-id
                    [--resource-group]
                    [--yes]

Esempio

Eliminare un test di carico.

az load test delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id

Parametri necessari

--load-test-resource --name -n

Nome o ID risorsa ARM della risorsa test di carico.

--test-id -t

ID test del test di carico.

Parametri facoltativi

--resource-group -g

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

--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 sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

az load test download-files

Anteprima

Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Scaricare i file di un test di carico esistente.

az load test download-files --load-test-resource
                            --path
                            --test-id
                            [--force]
                            [--resource-group]

Esempio

Scaricare tutti i file di un test. La directory dovrebbe già esistere.

az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path ~/downloads

Scaricare tutti i file di un test creando la directory se non esiste.

az load test download-files --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --path "~/downloads/new folder" --force

Parametri necessari

--load-test-resource --name -n

Nome o ID risorsa ARM della risorsa test di carico.

--path

Percorso della directory per scaricare i file.

--test-id -t

ID test del test di carico.

Parametri facoltativi

--force

Forzare l'esecuzione del comando. Verrà creata la directory per scaricare i file, se non esiste.

valore predefinito: False
--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 sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

az load test list

Anteprima

Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Elencare tutti i test nella risorsa test di carico specificata.

az load test list --load-test-resource
                  [--resource-group]

Esempio

Elencare tutti i test di carico in una risorsa.

az load test list --load-test-resource sample-alt-resource --resource-group sample-rg

Parametri necessari

--load-test-resource --name -n

Nome o ID risorsa ARM della risorsa test di carico.

Parametri facoltativi

--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 sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

az load test show

Anteprima

Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Mostra i dettagli del test.

az load test show --load-test-resource
                  --test-id
                  [--resource-group]

Esempio

Ottenere i dettagli di un test di carico.

az load test show --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg

Parametri necessari

--load-test-resource --name -n

Nome o ID risorsa ARM della risorsa test di carico.

--test-id -t

ID test del test di carico.

Parametri facoltativi

--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 sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

az load test update

Anteprima

Il gruppo di comandi 'test di carico' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus

Aggiornare un test di carico esistente.

az load test update --load-test-resource
                    --test-id
                    [--certificate]
                    [--description]
                    [--display-name]
                    [--engine-instances]
                    [--env]
                    [--keyvault-reference-id]
                    [--load-test-config-file]
                    [--no-wait]
                    [--resource-group]
                    [--secret]
                    [--split-csv]
                    [--subnet-id]
                    [--test-plan]

Esempio

Aggiornare un test con il file di configurazione del test di carico e non attendere il caricamento del file.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --load-test-config-file ~/resources/sample-config.yaml --no-wait

Aggiornare il nome visualizzato e la descrizione per un test.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --description "Test description" --display-name "Sample Name"

Aggiornare un test con il file di configurazione del test di carico ed eseguire l'override dei parametri usando gli argomenti.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --load-test-config-file ~/resources/sample-config.yaml --engine-instances 1 --env name=value name=value

Rimuovere i segreti da un test.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --secret secret_name1=""

Aggiornare l'identità di riferimento di Key Vault all'identità gestita assegnata dal sistema.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --keyvault-reference-id null

Parametri necessari

--load-test-resource --name -n

Nome o ID risorsa ARM della risorsa test di carico.

--test-id -t

ID test del test di carico.

Parametri facoltativi

--certificate

Un singolo certificato in formato 'key[=value]'. Il certificato deve essere archiviato in Azure Key Vault in formato PFX e l'identificatore del certificato deve essere fornito come valore. Usare "" per cancellare il certificato esistente.

--description

Descrizione del test di carico.

--display-name

Nome visualizzato del test di carico.

--engine-instances

Numero di istanze del motore in cui deve essere eseguito il test.

--env

Variabili di ambiente separate da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare le variabili di ambiente esistenti.

--keyvault-reference-id

Identità che verrà usata per accedere all'insieme di credenziali delle chiavi. Specificare null o None usare l'identità assegnata dal sistema della risorsa di test di carico.

--load-test-config-file

Percorso del file di configurazione del test di carico. Vedere https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

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

valore predefinito: False
--resource-group -g

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

--secret

Segreti separati da spazi: key[=value] [key[=value] ...]. I segreti devono essere archiviati in Azure Key Vault e l'identificatore del segreto deve essere specificato come valore. Usare "" per cancellare i segreti esistenti.

--split-csv

Suddividere i file CSV in modo uniforme tra le istanze del motore.

--subnet-id

ID risorsa della subnet da usare per il test di carico privato.

--test-plan

Percorso dello script JMeter.

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 sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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