Partilhar via

az load test

  • Pré-visualizar
  • Referência

Nota

Essa referência faz parte da extensão de carga para a CLI do Azure (versão 2.41.0 ou superior). A extensão será instalada automaticamente na primeira vez que você executar um comando az load test. Saiba mais sobre extensões.

Este grupo de comandos está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Grupo de comandos para gerenciar testes de carga.

Grupo de comandos para gerenciar o teste de carga com criar, atualizar, excluir, listar, etc.

Comandos

Name Description Tipo Estado
az load test app-component

Grupo de comandos para gerenciar componentes do aplicativo.

 Extensão Pré-visualizar
az load test app-component add

Adicione um componente de aplicativo a um teste.

 Extensão Pré-visualizar
az load test app-component list

Liste todos os componentes do aplicativo para um teste.

 Extensão Pré-visualizar
az load test app-component remove

Remova o componente de aplicativo específico de um teste.

 Extensão Pré-visualizar
az load test create

Crie um novo teste de carga.

 Extensão Pré-visualizar
az load test delete

Exclua um teste de carga existente.

 Extensão Pré-visualizar
az load test download-files

Baixar arquivos de um teste de carga existente.

 Extensão Pré-visualizar
az load test file

Grupo de comandos para operações em arquivos de teste.

 Extensão Pré-visualizar
az load test file delete

Exclua um arquivo do teste.

 Extensão Pré-visualizar
az load test file download

Baixe um arquivo de um teste.

 Extensão Pré-visualizar
az load test file list

Liste todos os arquivos em um teste.

 Extensão Pré-visualizar
az load test file upload

Carregue um ficheiro para um teste.

 Extensão Pré-visualizar
az load test list

Liste todos os testes no recurso de teste de carga fornecido.

 Extensão Pré-visualizar
az load test server-metric

Grupo de comandos para gerenciar métricas do servidor.

 Extensão Pré-visualizar
az load test server-metric add

Adicione uma métrica de servidor a um teste.

 Extensão Pré-visualizar
az load test server-metric list

Liste todas as métricas do servidor para um teste.

 Extensão Pré-visualizar
az load test server-metric remove

Remova a métrica de servidor fornecida do teste.

 Extensão Pré-visualizar
az load test show

Mostrar detalhes do teste.

 Extensão Pré-visualizar
az load test update

Atualize um teste de carga existente.

 Extensão Pré-visualizar

az load test create

Pré-visualizar

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Crie um novo teste 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]

Exemplos

Crie um teste com o arquivo de configuração de teste 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

Crie um teste com 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

Crie um teste com o arquivo de configuração de teste de carga e substitua a instância do mecanismo e env usando argumentos e não espere pelo upload do arquivo.

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

Crie um teste com segredos e variáveis de 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

Crie um teste com segredos usando a Identidade Gerenciada atribuída pelo usuário para acessar o Cofre da Chave.

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"

Crie um teste para um ponto de extremidade privado em uma Rede Virtual com a opção 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 Obrigatórios

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

Nome ou ID do recurso ARM do recurso Teste de Carga.

--test-id -t

ID do teste de carga.

Parâmetros Opcionais

--certificate

Um único certificado no formato 'key[=value]'. O certificado deve ser armazenado no Cofre da Chave do Azure no formato PFX e o identificador do certificado deve ser fornecido como o valor.

--description

Descrição do ensaio de carga.

--display-name

Nome de exibição do teste de carga.

--engine-instances

Número de instâncias do motor em que o ensaio deve ser executado.

--env

Variáveis de ambiente separadas por espaço: key[=value] [key[=value] ...].

--keyvault-reference-id

A identidade que será usada para acessar o cofre de chaves.

--load-test-config-file

Caminho para o arquivo de configuração de teste de carga. Consulte https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--secret

Segredos separados por espaço: key[=value] [key[=value] ...]. Os segredos devem ser armazenados no Cofre de Chaves do Azure e o identificador secreto deve ser fornecido como o valor.

--split-csv

Divida os arquivos CSV uniformemente entre as instâncias do mecanismo.

--subnet-id

ID do recurso da sub-rede a ser usada para o teste de carga privada.

--test-plan

Caminho para o script JMeter.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az load test delete

Pré-visualizar

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Exclua um teste de carga existente.

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

Exemplos

Exclua um teste de carga.

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

Parâmetros Obrigatórios

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

Nome ou ID do recurso ARM do recurso Teste de Carga.

--test-id -t

ID do teste de carga.

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--yes -y

Não solicite confirmação.

valor predefinido: False
Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az load test download-files

Pré-visualizar

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Baixar arquivos de um teste de carga existente.

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

Exemplos

Faça o download de todos os arquivos de um teste. O diretório já deve existir.

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

Baixe todos os arquivos de um teste criando o diretório, se ele não existir.

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 Obrigatórios

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

Nome ou ID do recurso ARM do recurso Teste de Carga.

--path

Caminho do diretório para baixar arquivos.

--test-id -t

ID do teste de carga.

Parâmetros Opcionais

--force

Força executar o comando. Isso criará o diretório para baixar arquivos, se ele não existir.

valor predefinido: False
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az load test list

Pré-visualizar

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Liste todos os testes no recurso de teste de carga fornecido.

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

Exemplos

Liste todos os testes de carga em um recurso.

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

Parâmetros Obrigatórios

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

Nome ou ID do recurso ARM do recurso Teste de Carga.

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az load test show

Pré-visualizar

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Mostrar detalhes do teste.

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

Exemplos

Obtenha os detalhes de um teste de carga.

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

Parâmetros Obrigatórios

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

Nome ou ID do recurso ARM do recurso Teste de Carga.

--test-id -t

ID do teste de carga.

Parâmetros Opcionais

--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.

az load test update

Pré-visualizar

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e de apoio: https://aka.ms/CLI_refstatus

Atualize um teste 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]

Exemplos

Atualize um teste com o arquivo de configuração de teste de carga e não espere pelo upload do arquivo.

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

Atualize o nome para exibição e a descrição de um teste.

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"

Atualize um teste com o arquivo de configuração de teste de carga e substitua parâmetros usando 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

Remova os segredos de um teste.

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

Atualize a identidade de referência do Cofre da Chave para a Identidade Gerenciada atribuída ao 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 Obrigatórios

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

Nome ou ID do recurso ARM do recurso Teste de Carga.

--test-id -t

ID do teste de carga.

Parâmetros Opcionais

--certificate

Um único certificado no formato 'key[=value]'. O certificado deve ser armazenado no Cofre da Chave do Azure no formato PFX e o identificador do certificado deve ser fornecido como o valor. Use "" para limpar o certificado existente.

--description

Descrição do ensaio de carga.

--display-name

Nome de exibição do teste de carga.

--engine-instances

Número de instâncias do motor em que o ensaio deve ser executado.

--env

Variáveis de ambiente separadas por espaço: key[=value] [key[=value] ...]. Use "" para limpar as variáveis de ambiente existentes.

--keyvault-reference-id

A identidade que será usada para acessar o cofre de chaves. Fornecer null ou None usar a identidade atribuída ao sistema do recurso de teste de carga.

--load-test-config-file

Caminho para o arquivo de configuração de teste de carga. Consulte https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

Não espere que a operação de longa duração termine.

valor predefinido: False
--resource-group -g

o nome do grupo de recursos. Você pode configurar o grupo padrão usando az configure --defaults group=<name>.

--secret

Segredos separados por espaço: key[=value] [key[=value] ...]. Os segredos devem ser armazenados no Cofre de Chaves do Azure e o identificador secreto deve ser fornecido como o valor. Use "" para limpar segredos existentes.

--split-csv

Divida os arquivos CSV uniformemente entre as instâncias do mecanismo.

--subnet-id

ID do recurso da sub-rede a ser usada para o teste de carga privada.

--test-plan

Caminho para o script JMeter.

Parâmetros de Globais
--debug

Aumente a verbosidade do log para mostrar todos os logs de depuração.

--help -h

Mostrar esta mensagem de ajuda e sair.

--only-show-errors

Mostrar apenas erros, suprimindo avisos.

--output -o

Formato de saída.

valores aceites: json, jsonc, none, table, tsv, yaml, yamlc
valor predefinido: json
--query

Cadeia de caracteres de consulta JMESPath. Consulte http://jmespath.org/ para obter mais informações e exemplos.

--subscription

o nome ou o ID da subscrição. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_IDo .

--verbose

Aumente a verbosidade do registro. Use --debug para logs de depuração completos.