Compartir a través de

az load test

  • Vista previa
  • Referencia

Nota:

Esta referencia forma parte de la extensión de carga para la CLI de Azure (versión 2.41.0 o posterior). La extensión instalará automáticamente la primera vez que ejecute un comando az load test . 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

Grupo de comandos para administrar pruebas de carga.

Grupo de comandos para administrar la prueba de carga con la creación, actualización, eliminación, lista, etc.

Comandos

Nombre Description Tipo Estado
az load test app-component

Grupo de comandos para administrar los componentes de la aplicación.

 Extensión Vista previa
az load test app-component add

Agregue un componente de aplicación a una prueba.

 Extensión Vista previa
az load test app-component list

Enumere todos los componentes de la aplicación para una prueba.

 Extensión Vista previa
az load test app-component remove

Quite el componente de aplicación especificado de una prueba.

 Extensión Vista previa
az load test create

Cree una nueva prueba de carga.

 Extensión Vista previa
az load test delete

Elimine una prueba de carga existente.

 Extensión Vista previa
az load test download-files

Descargue los archivos de una prueba de carga existente.

 Extensión Vista previa
az load test file

Grupo de comandos para operaciones en archivos de prueba.

 Extensión Vista previa
az load test file delete

Elimine un archivo de prueba.

 Extensión Vista previa
az load test file download

Descargue un archivo de una prueba.

 Extensión Vista previa
az load test file list

Enumera todos los archivos de una prueba.

 Extensión Vista previa
az load test file upload

Cargue un archivo en una prueba.

 Extensión Vista previa
az load test list

Enumere todas las pruebas del recurso de prueba de carga especificado.

 Extensión Vista previa
az load test server-metric

Grupo de comandos para administrar las métricas del servidor.

 Extensión Vista previa
az load test server-metric add

Agregue una métrica de servidor a una prueba.

 Extensión Vista previa
az load test server-metric list

Enumere todas las métricas de servidor para una prueba.

 Extensión Vista previa
az load test server-metric remove

Quite la métrica de servidor especificada de la prueba.

 Extensión Vista previa
az load test show

Muestra los detalles de la prueba.

 Extensión Vista previa
az load test update

Actualice una prueba de carga existente.

 Extensión Vista previa

az load test create

Vista previa

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

Cree una nueva prueba de carga.

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]

Ejemplos

Cree una prueba con el archivo de configuración de pruebas de carga.

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

Cree una prueba con argumentos.

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

Cree una prueba con el archivo de configuración de prueba de carga e invalide engine-instance y env mediante argumentos y no espere a la carga de archivos.

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

Cree una prueba con secretos y variables de entorno.

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

Cree una prueba con secretos mediante la identidad administrada asignada por el usuario para acceder a Key Vault.

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"

Cree una prueba para un punto de conexión privado en una red virtual con la opción CSV dividida habilitada.

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

Parámetros requeridos

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

Nombre o identificador de recurso de ARM del recurso Load Testing.

--test-id -t

Id. de prueba de la prueba de carga.

Parámetros opcionales

--certificate

Un solo certificado en formato 'key[=value]'. El certificado debe almacenarse en Azure Key Vault en formato PFX y el identificador de certificado debe proporcionarse como valor.

--description

Descripción de la prueba de carga.

--display-name

Nombre para mostrar de la prueba de carga.

--engine-instances

Número de instancias del motor en las que se debe ejecutar la prueba.

--env

Variables de entorno separadas por espacios: key[=value] [key[=value] ...].

--keyvault-reference-id

Identidad que se usará para acceder al almacén de claves.

--load-test-config-file

Ruta de acceso al archivo de configuración de prueba de carga. Consulte https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

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

valor predeterminado: False
--resource-group -g

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

--secret

Secretos separados por espacios: key[=value] [key[=value] ...]. Los secretos se deben almacenar en Azure Key Vault y el identificador del secreto debe proporcionarse como valor.

--split-csv

Dividir archivos CSV uniformemente entre instancias del motor.

--subnet-id

Identificador de recurso de la subred que se va a usar para la prueba de carga privada.

--test-plan

Ruta de acceso al script JMeter.

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 load test delete

Vista previa

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

Elimine una prueba de carga existente.

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

Ejemplos

Elimine una prueba de carga.

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

Parámetros requeridos

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

Nombre o identificador de recurso de ARM del recurso Load Testing.

--test-id -t

Id. de prueba de la prueba de carga.

Parámetros opcionales

--resource-group -g

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

--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 load test download-files

Vista previa

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

Descargue los archivos de una prueba de carga existente.

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

Ejemplos

Descargue todos los archivos de una prueba. El directorio ya debe existir.

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

Descargue todos los archivos de una prueba mediante la creación del directorio si no existe.

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

Parámetros requeridos

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

Nombre o identificador de recurso de ARM del recurso Load Testing.

--path

Ruta de acceso del directorio para descargar archivos.

--test-id -t

Id. de prueba de la prueba de carga.

Parámetros opcionales

--force

Forzar la ejecución del comando. Esto creará el directorio para descargar archivos si no existe.

valor predeterminado: False
--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 load test list

Vista previa

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

Enumere todas las pruebas del recurso de prueba de carga especificado.

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

Ejemplos

Enumere todas las pruebas de carga de un recurso.

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

Parámetros requeridos

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

Nombre o identificador de recurso de ARM del recurso Load Testing.

Parámetros opcionales

--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 load test show

Vista previa

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

Muestra los detalles de la prueba.

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

Ejemplos

Obtenga los detalles de una prueba de carga.

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

Parámetros requeridos

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

Nombre o identificador de recurso de ARM del recurso Load Testing.

--test-id -t

Id. de prueba de la prueba de carga.

Parámetros opcionales

--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 load test update

Vista previa

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

Actualice una prueba de carga existente.

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]

Ejemplos

Actualice una prueba con el archivo de configuración de prueba de carga y no espere a la carga de archivos.

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

Actualice el nombre para mostrar y la descripción de una prueba.

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"

Actualice una prueba con el archivo de configuración de pruebas de carga e invalide los parámetros mediante argumentos.

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

Quite los secretos de una prueba.

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

Actualice la identidad de referencia de Key Vault a la identidad administrada asignada por el 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

Parámetros requeridos

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

Nombre o identificador de recurso de ARM del recurso Load Testing.

--test-id -t

Id. de prueba de la prueba de carga.

Parámetros opcionales

--certificate

Un solo certificado en formato 'key[=value]'. El certificado debe almacenarse en Azure Key Vault en formato PFX y el identificador de certificado debe proporcionarse como valor. Use "" para borrar el certificado existente.

--description

Descripción de la prueba de carga.

--display-name

Nombre para mostrar de la prueba de carga.

--engine-instances

Número de instancias del motor en las que se debe ejecutar la prueba.

--env

Variables de entorno separadas por espacios: key[=value] [key[=value] ...]. Use "" para borrar las variables de entorno existentes.

--keyvault-reference-id

Identidad que se usará para acceder al almacén de claves. Proporcione null o None use la identidad asignada por el sistema del recurso de prueba de carga.

--load-test-config-file

Ruta de acceso al archivo de configuración de prueba de carga. Consulte https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

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

valor predeterminado: False
--resource-group -g

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

--secret

Secretos separados por espacios: key[=value] [key[=value] ...]. Los secretos se deben almacenar en Azure Key Vault y el identificador del secreto debe proporcionarse como valor. Use "" para borrar los secretos existentes.

--split-csv

Dividir archivos CSV uniformemente entre instancias del motor.

--subnet-id

Identificador de recurso de la subred que se va a usar para la prueba de carga privada.

--test-plan

Ruta de acceso al script JMeter.

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.