Partager via


az load test

Remarque

Cette référence fait partie de l’extension de charge pour Azure CLI (version 2.41.0 ou ultérieure). L’extension installe automatiquement la première fois que vous exécutez une commande az load test . En savoir plus sur les extensions.

Ce groupe de commandes est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Groupe de commandes pour gérer les tests de charge.

Groupe de commandes pour gérer le test de charge avec créer, mettre à jour, supprimer, lister, etc.

Commandes

Nom Description Type Statut
az load test app-component

Groupe de commandes pour gérer les composants d’application.

Extension Aperçu
az load test app-component add

Ajoutez un composant d’application à un test.

Extension Aperçu
az load test app-component list

Répertoriez tous les composants d’application pour un test.

Extension Aperçu
az load test app-component remove

Supprimez le composant d’application donné d’un test.

Extension Aperçu
az load test create

Créez un test de charge.

Extension Aperçu
az load test delete

Supprimez un test de charge existant.

Extension Aperçu
az load test download-files

Téléchargez des fichiers d’un test de charge existant.

Extension Aperçu
az load test file

Groupe de commandes pour les opérations sur les fichiers de test.

Extension Aperçu
az load test file delete

Supprimez un fichier du test.

Extension Aperçu
az load test file download

Téléchargez un fichier à partir d’un test.

Extension Aperçu
az load test file list

Répertoriez tous les fichiers dans un test.

Extension Aperçu
az load test file upload

Chargez un fichier dans un test.

Extension Aperçu
az load test list

Répertoriez tous les tests dans la ressource de test de charge donnée.

Extension Aperçu
az load test server-metric

Groupe de commandes pour gérer les métriques du serveur.

Extension Aperçu
az load test server-metric add

Ajoutez une métrique de serveur à un test.

Extension Aperçu
az load test server-metric list

Répertoriez toutes les métriques de serveur pour un test.

Extension Aperçu
az load test server-metric remove

Supprimez la métrique serveur donnée du test.

Extension Aperçu
az load test show

Afficher les détails du test.

Extension Aperçu
az load test update

Mettez à jour un test de charge existant.

Extension Aperçu

az load test create

Préversion

Le groupe de commandes « test de charge » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Créez un test de charge.

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]

Exemples

Créez un test avec le fichier de configuration de test de charge.

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

Créez un test avec des arguments.

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

Créez un test avec le fichier de configuration de test de charge et remplacez l’instance du moteur et env à l’aide d’arguments et n’attendez pas le chargement du fichier.

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

Créez un test avec des secrets et des variables d’environnement.

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

Créez un test avec des secrets à l’aide de l’identité managée affectée par l’utilisateur pour accéder au coffre de clés.

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"

Créez un test pour un point de terminaison privé dans un Réseau virtuel avec l’option CSV fractionnée activée.

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

Paramètres obligatoires

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

Nom ou ID de ressource ARM de la ressource De test de charge.

--test-id -t

ID de test du test de charge.

Paramètres facultatifs

--certificate

Un seul certificat au format « key[=value] ». Le certificat doit être stocké dans Azure Key Vault au format PFX et l’identificateur de certificat doit être fourni comme valeur.

--description

Description du test de charge.

--display-name

Nom complet du test de charge.

--engine-instances

Nombre d’instances de moteur sur lesquelles le test doit s’exécuter.

--env

Variables d’environnement séparées par l’espace : key[=value] [key[=value] ...].

--keyvault-reference-id

Identité qui sera utilisée pour accéder au coffre de clés.

--load-test-config-file

Chemin d’accès au fichier de configuration de test de charge. Voir https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--secret

Secrets séparés par l’espace : key[=value] [key[=value] ...]. Les secrets doivent être stockés dans Azure Key Vault et l’identificateur de secret doit être fourni comme valeur.

--split-csv

Fractionner uniformément les fichiers CSV entre les instances du moteur.

--subnet-id

ID de ressource du sous-réseau à utiliser pour le test de charge privé.

--test-plan

Chemin d’accès au script JMeter.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az load test delete

Préversion

Le groupe de commandes « test de charge » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Supprimez un test de charge existant.

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

Exemples

Supprimez un test de charge.

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

Paramètres obligatoires

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

Nom ou ID de ressource ARM de la ressource De test de charge.

--test-id -t

ID de test du test de charge.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--yes -y

Ne pas demander de confirmation.

valeur par défaut: False
Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az load test download-files

Préversion

Le groupe de commandes « test de charge » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Téléchargez des fichiers d’un test de charge existant.

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

Exemples

Téléchargez tous les fichiers d’un test. Le répertoire doit déjà exister.

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

Téléchargez tous les fichiers d’un test en créant le répertoire s’il n’existe pas.

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

Paramètres obligatoires

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

Nom ou ID de ressource ARM de la ressource De test de charge.

--path

Chemin d’accès du répertoire pour télécharger des fichiers.

--test-id -t

ID de test du test de charge.

Paramètres facultatifs

--force

Forcez l’exécution de la commande. Cela crée le répertoire pour télécharger les fichiers s’il n’existe pas.

valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az load test list

Préversion

Le groupe de commandes « test de charge » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Répertoriez tous les tests dans la ressource de test de charge donnée.

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

Exemples

Répertorier tous les tests de charge dans une ressource.

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

Paramètres obligatoires

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

Nom ou ID de ressource ARM de la ressource De test de charge.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az load test show

Préversion

Le groupe de commandes « test de charge » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Afficher les détails du test.

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

Exemples

Obtenez les détails d’un test de charge.

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

Paramètres obligatoires

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

Nom ou ID de ressource ARM de la ressource De test de charge.

--test-id -t

ID de test du test de charge.

Paramètres facultatifs

--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.

az load test update

Préversion

Le groupe de commandes « test de charge » est en préversion et en cours de développement. Référence et niveaux de support : https://aka.ms/CLI_refstatus

Mettez à jour un test de charge existant.

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]

Exemples

Mettez à jour un test avec le fichier de configuration de test de charge et n’attendez pas le chargement du fichier.

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

Mettez à jour le nom complet et la description d’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"

Mettez à jour un test avec le fichier de configuration de test de charge et remplacez les paramètres à l’aide d’arguments.

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

Supprimez les secrets d’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=""

Mettez à jour l’identité de référence Key Vault sur l’identité managée affectée par le système.

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

Paramètres obligatoires

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

Nom ou ID de ressource ARM de la ressource De test de charge.

--test-id -t

ID de test du test de charge.

Paramètres facultatifs

--certificate

Un seul certificat au format « key[=value] ». Le certificat doit être stocké dans Azure Key Vault au format PFX et l’identificateur de certificat doit être fourni comme valeur. Utilisez « » pour effacer le certificat existant.

--description

Description du test de charge.

--display-name

Nom complet du test de charge.

--engine-instances

Nombre d’instances de moteur sur lesquelles le test doit s’exécuter.

--env

Variables d’environnement séparées par l’espace : key[=value] [key[=value] ...]. Utilisez « » pour effacer les variables d’environnement existantes.

--keyvault-reference-id

Identité qui sera utilisée pour accéder au coffre de clés. Fournissez null ou None utilisez l’identité affectée par le système de la ressource de test de charge.

--load-test-config-file

Chemin d’accès au fichier de configuration de test de charge. Voir https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

Ne pas attendre la fin de l’opération de longue durée.

valeur par défaut: False
--resource-group -g

Nom du groupe de ressources. Vous pouvez configurer le groupe par défaut en utilisant az configure --defaults group=<name>.

--secret

Secrets séparés par l’espace : key[=value] [key[=value] ...]. Les secrets doivent être stockés dans Azure Key Vault et l’identificateur de secret doit être fourni comme valeur. Utilisez « » pour effacer les secrets existants.

--split-csv

Fractionner uniformément les fichiers CSV entre les instances du moteur.

--subnet-id

ID de ressource du sous-réseau à utiliser pour le test de charge privé.

--test-plan

Chemin d’accès au script JMeter.

Paramètres globaux
--debug

Augmentez le niveau de détail de la journalisation pour afficher tous les journaux de débogage.

--help -h

Affichez ce message d’aide et quittez.

--only-show-errors

Afficher uniquement les erreurs, en supprimant les avertissements.

--output -o

Format de sortie.

valeurs acceptées: json, jsonc, none, table, tsv, yaml, yamlc
valeur par défaut: json
--query

Chaîne de requêtes JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.

--subscription

Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut en utilisant az account set -s NAME_OR_ID.

--verbose

Augmentez le niveau de détail de la journalisation. Utilisez --debug pour des journaux de débogage complets.