Compartir a través de


az load test

Note

Esta referencia forma parte de la extensión de carga para la CLI de Azure (versión 2.66.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.

Extension Preview
az load test app-component add

Agregue un componente de aplicación a una prueba.

Extension Preview
az load test app-component list

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

Extension Preview
az load test app-component remove

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

Extension Preview
az load test compare-to-baseline

Compare las estadísticas del sampler de las ejecuciones de pruebas recientes con las de la ejecución de pruebas de línea base.

Extension Preview
az load test convert-to-jmx

Convierta una prueba de tipo de dirección URL en prueba de JMX.

Extension Preview
az load test create

Cree una nueva prueba de carga.

Extension Preview
az load test delete

Elimine una prueba de carga existente.

Extension Preview
az load test download-files

Descargue los archivos de una prueba de carga existente.

Extension Preview
az load test file

Grupo de comandos para operaciones en archivos de prueba.

Extension Preview
az load test file delete

Elimine un archivo de prueba.

Extension Preview
az load test file download

Descargue un archivo de una prueba.

Extension Preview
az load test file list

Enumera todos los archivos de una prueba.

Extension Preview
az load test file upload

Cargue un archivo en una prueba.

Extension Preview
az load test list

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

Extension Preview
az load test server-metric

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

Extension Preview
az load test server-metric add

Agregue una métrica de servidor a una prueba.

Extension Preview
az load test server-metric list

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

Extension Preview
az load test server-metric remove

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

Extension Preview
az load test set-baseline

Establezca una ejecución de prueba como línea base para la comparación con otras ejecuciones de la prueba.

Extension Preview
az load test show

Muestra los detalles de la prueba.

Extension Preview
az load test update

Actualice una prueba de carga existente.

Extension Preview

az load test compare-to-baseline

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

Compare las estadísticas del sampler de las ejecuciones de pruebas recientes con las de la ejecución de pruebas de línea base.

az load test compare-to-baseline --load-test-resource --name
                                 --test-id
                                 [--aggregation {MAX, MEAN, MEDIAN, MIN, P75, P90, P95, P96, P98, P99, P999, P9999}]
                                 [--resource-group]

Ejemplos

Compare las ejecuciones de pruebas recientes con la línea base.

az load test compare-to-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id -o table

Compare las ejecuciones de pruebas recientes con la línea base con una agregación específica.

az load test compare-to-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --aggregation P95 -o table

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--aggregation

Especifique el método de agregación para el tiempo de respuesta.

Propiedad Valor
Valor predeterminado: MEAN
Valores aceptados: MAX, MEAN, MEDIAN, MIN, P75, P90, P95, P96, P98, P99, P999, P9999
--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az load test convert-to-jmx

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

Convierta una prueba de tipo de dirección URL en prueba de JMX.

az load test convert-to-jmx --load-test-resource --name
                            --test-id
                            [--resource-group]
                            [--yes]

Ejemplos

Convierta en prueba de JMX.

az load test convert-to-jmx --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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --name
                    --test-id
                    [--autostop]
                    [--autostop-engine-users]
                    [--autostop-error-rate]
                    [--autostop-time-window]
                    [--certificate]
                    [--description]
                    [--disable-public-ip]
                    [--display-name]
                    [--engine-instances]
                    [--engine-ref-id-type {None, SystemAssigned, UserAssigned}]
                    [--engine-ref-ids]
                    [--env]
                    [--keyvault-reference-id]
                    [--load-test-config-file]
                    [--metrics-reference-id]
                    [--no-wait]
                    [--regionwise-engines]
                    [--resource-group]
                    [--secret]
                    [--split-csv]
                    [--subnet-id]
                    [--test-plan]
                    [--test-type {JMX, Locust, URL}]

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 --engine-ref-id-type SystemAssigned

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

Cree una prueba con criterios de autotop definidos personalizados o habilite o deshabilite la conmutación automática para una prueba.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop-error-rate 80.5 --autostop-time-window 120 --autostop-engine-users 1000
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop disable
az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --autostop enable

Cree una prueba con una configuración de carga de varias regiones mediante nombres de región en el formato aceptado por Azure Resource Manager (ARM). Asegúrese de que Azure Load Testing admite las regiones especificadas. Las pruebas de carga de varias regiones solo están restringidas a puntos de conexión públicos.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --engine-instances 3 --regionwise-engines eastus=1 westus2=1 germanywestcentral=1 --test-plan sample-jmx.jmx

Cree una prueba avanzada de direcciones URL con varias solicitudes HTTP mediante un archivo JSON.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --test-plan ~/resources/sample-url-requests.json --test-type URL

Creación de una prueba de carga basada en locust

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --test-plan ~/resources/sample-locust-file.py --test-type Locust --env LOCUST_HOST="https://azure.microsoft.com" LOCUST_SPAWN_RATE=0.3 LOCUST_RUN_TIME=120 LOCUST_USERS=4

Cree una prueba con la referencia de identidad administrada asignada por el usuario para el motor.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --engine-ref-id-type UserAssigned --engine-ref-ids "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/microsoft.managedidentity/userassignedidentities/sample-mi"

Cree una prueba con la referencia de identidad administrada asignada por el usuario para acceder a las métricas de las aplicaciones configuradas.

az load test create --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --engine-ref-id-type UserAssigned --metrics-reference-id "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/microsoft.managedidentity/userassignedidentities/sample-mi"

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--autostop

Indica si la detención automática debe estar habilitada o deshabilitada. Los valores permitidos son enable/disable.

--autostop-engine-users

Número máximo de usuarios por motor en el que se detendrá el ensayo.

--autostop-error-rate

Porcentaje de umbral de errores en los que se debe detener automáticamente la ejecución de pruebas. Los valores permitidos están en el intervalo de [0,0,100.0].

--autostop-time-window

Período de tiempo durante el cual se debe evaluar el porcentaje de error en segundos.

--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.

--disable-public-ip

Deshabilite la implementación de una dirección IP pública, un equilibrador de carga y un grupo de seguridad de red al probar un punto de conexión privado.

--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.

--engine-ref-id-type

Tipo de identidad que se va a configurar para el motor.

Propiedad Valor
Valores aceptados: None, SystemAssigned, UserAssigned
--engine-ref-ids

Lista separada por espacios de identificadores de recursos completos de las identidades administradas que se van a configurar en el motor. Solo se requiere para identidades asignadas por el usuario.

--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.

--metrics-reference-id

Identidad que se usará para acceder a las métricas. De forma predeterminada, se usará SystemAssigned si no se le asigna.

--no-wait

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

Propiedad Valor
Valor predeterminado: False
--regionwise-engines

Especifique el número de motores para cada región con el formato: region1=engineCount1 region2=engineCount2 .... Use los nombres de región en el formato aceptado por Azure Resource Manager (ARM). Asegúrese de que las regiones son compatibles con Azure Load Testing. Las pruebas de carga de varias regiones solo pueden tener como destino puntos de conexión públicos.

--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

Referencia al archivo del plan de prueba. Si testType: JMX: ruta de acceso al script JMeter. Si testType: URL: ruta de acceso al archivo JSON de solicitudes. Si testType: Locust: ruta de acceso al script de prueba de Locust.

--test-type

Tipo de la prueba de carga.

Propiedad Valor
Valores aceptados: JMX, Locust, URL
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --name
                    --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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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.

Propiedad Valor
Valor predeterminado: False
Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --name
                            --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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--force

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

Propiedad Valor
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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --name
                  [--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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

az load test set-baseline

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

Establezca una ejecución de prueba como línea base para la comparación con otras ejecuciones de la prueba.

az load test set-baseline --load-test-resource --name
                          --test-id
                          --test-run-id
                          [--resource-group]

Ejemplos

Establezca la ejecución de pruebas de línea base.

az load test set-baseline --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --test-run-id sample-associated-test-run-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.

--test-run-id -r

Identificador de ejecución de prueba de la ejecución de pruebas de carga.

Parámetros opcionales

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --name
                  --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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--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 del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False

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 --name
                    --test-id
                    [--autostop]
                    [--autostop-engine-users]
                    [--autostop-error-rate]
                    [--autostop-time-window]
                    [--certificate]
                    [--description]
                    [--disable-public-ip]
                    [--display-name]
                    [--engine-instances]
                    [--engine-ref-id-type {None, SystemAssigned, UserAssigned}]
                    [--engine-ref-ids]
                    [--env]
                    [--keyvault-reference-id]
                    [--load-test-config-file]
                    [--metrics-reference-id]
                    [--no-wait]
                    [--regionwise-engines]
                    [--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

Actualice los criterios de autotop.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --autostop-error-rate 90 --autostop-time-window 180

Actualice la configuración de carga de varias regiones.

az load test update --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id --engine-instances 5 --regionwise-engines eastus=2 westus2=1 eastasia=2

Actualice una prueba con la referencia de identidad administrada asignada por el usuario para el motor a SystemAssigned.

az load test update --test-id sample-test-id --load-test-resource sample-alt-resource --resource-group sample-rg --display-name "Sample Name" --engine-ref-id-type SystemAssigned

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

Los parámetros siguientes son opcionales, pero dependiendo del contexto, es posible que se requiera uno o varios para que el comando se ejecute correctamente.

--autostop

Indica si la detención automática debe estar habilitada o deshabilitada. Los valores permitidos son enable/disable.

--autostop-engine-users

Número máximo de usuarios por motor en el que se detendrá el ensayo.

--autostop-error-rate

Porcentaje de umbral de errores en los que se debe detener automáticamente la ejecución de pruebas. Los valores permitidos están en el intervalo de [0,0,100.0].

--autostop-time-window

Período de tiempo durante el cual se debe evaluar el porcentaje de error en segundos.

--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.

--disable-public-ip

Deshabilite la implementación de una dirección IP pública, un equilibrador de carga y un grupo de seguridad de red al probar un punto de conexión privado.

--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.

--engine-ref-id-type

Tipo de identidad que se va a configurar para el motor.

Propiedad Valor
Valores aceptados: None, SystemAssigned, UserAssigned
--engine-ref-ids

Lista separada por espacios de identificadores de recursos completos de las identidades administradas que se van a configurar en el motor. Solo se requiere para identidades asignadas por el usuario.

--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 para usar 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.

--metrics-reference-id

Identidad que se usará para acceder a las métricas. Proporcione null o None para usar la identidad asignada por el sistema del recurso de prueba de carga.

--no-wait

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

Propiedad Valor
Valor predeterminado: False
--regionwise-engines

Especifique el número de motores para cada región con el formato: region1=engineCount1 region2=engineCount2 .... Use los nombres de región en el formato aceptado por Azure Resource Manager (ARM). Asegúrese de que las regiones son compatibles con Azure Load Testing. Las pruebas de carga de varias regiones solo pueden tener como destino puntos de conexión públicos.

--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

Referencia al archivo del plan de prueba. Si testType: JMX: ruta de acceso al script JMeter. Si testType: URL: ruta de acceso al archivo JSON de solicitudes. Si testType: Locust: ruta de acceso al script de prueba de Locust.

Parámetros globales
--debug

Aumente el nivel de detalle del registro para mostrar todos los registros de depuración.

Propiedad Valor
Valor predeterminado: False
--help -h

Mostrar este mensaje de ayuda y salir.

--only-show-errors

Solo se muestran errores, suprimiendo advertencias.

Propiedad Valor
Valor predeterminado: False
--output -o

Formato de salida.

Propiedad Valor
Valor predeterminado: json
Valores aceptados: json, jsonc, none, table, tsv, yaml, yamlc
--query

Cadena de consulta JMESPath. Consulte http://jmespath.org/ para obtener más información y ejemplos.

--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 del registro. Usa --debug para ver registros de depuración completos.

Propiedad Valor
Valor predeterminado: False