Compartilhar via

az load test

  • Versão Prévia
  • Referência

Observação

Essa referência faz parte da extensão de carga da 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 suporte: 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

Nome Description Tipo Status
az load test app-component

Grupo de comandos para gerenciar componentes do aplicativo.

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

Adicione um componente de aplicativo a um teste.

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

Liste todos os componentes do aplicativo para um teste.

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

Remova o componente do aplicativo fornecido de um teste.

 Extensão Versão Prévia
az load test create

Crie um novo teste de carga.

 Extensão Versão Prévia
az load test delete

Exclua um teste de carga existente.

 Extensão Versão Prévia
az load test download-files

Baixar arquivos de um teste de carga existente.

 Extensão Versão Prévia
az load test file

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

 Extensão Versão Prévia
az load test file delete

Exclua um arquivo do teste.

 Extensão Versão Prévia
az load test file download

Baixar um arquivo de um teste.

 Extensão Versão Prévia
az load test file list

Listar todos os arquivos em um teste.

 Extensão Versão Prévia
az load test file upload

Carregue um arquivo para um teste.

 Extensão Versão Prévia
az load test list

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

 Extensão Versão Prévia
az load test server-metric

Grupo de comandos para gerenciar métricas de servidor.

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

Adicione uma métrica de servidor a um teste.

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

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

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

Remova a métrica de servidor fornecida do teste.

 Extensão Versão Prévia
az load test show

Mostrar detalhes do teste.

 Extensão Versão Prévia
az load test update

Atualize um teste de carga existente.

 Extensão Versão Prévia

az load test create

Versão Prévia

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 o 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 de Chaves.

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 Exigidos

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

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

--test-id -t

ID de teste do teste de carga.

Parâmetros Opcionais

--certificate

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

--description

Descrição do teste de carga.

--display-name

Nome de exibição do teste de carga.

--engine-instances

Número de instâncias de mecanismo nas quais o teste 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. Veja https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--resource-group -g

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 de segredo deve ser fornecido como o valor.

--split-csv

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

--subnet-id

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

--test-plan

Caminho para o script JMeter.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az load test delete

Versão Prévia

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

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

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

--test-id -t

ID de teste do teste de carga.

Parâmetros Opcionais

--resource-group -g

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 padrão: False
Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az load test download-files

Versão Prévia

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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

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

--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 de teste do teste de carga.

Parâmetros Opcionais

--force

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

valor padrão: False
--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az load test list

Versão Prévia

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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

Listar todos os testes de carga em um recurso.

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

Parâmetros Exigidos

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

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

Parâmetros Opcionais

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az load test show

Versão Prévia

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 Exigidos

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

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

--test-id -t

ID de teste do teste de carga.

Parâmetros Opcionais

--resource-group -g

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

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.

az load test update

Versão Prévia

O grupo de comandos 'teste de carga' está em pré-visualização e em desenvolvimento. Níveis de referência e suporte: 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 aguarde o 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 os 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 de Chaves 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 Exigidos

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

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

--test-id -t

ID de teste do teste de carga.

Parâmetros Opcionais

--certificate

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

--description

Descrição do teste de carga.

--display-name

Nome de exibição do teste de carga.

--engine-instances

Número de instâncias de mecanismo nas quais o teste deve ser executado.

--env

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

--keyvault-reference-id

A identidade que será usada para acessar o cofre de chaves. Forneça null ou None use 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. Veja https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

Não aguarde a conclusão da operação de execução longa.

valor padrão: False
--resource-group -g

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 de segredo 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 de recurso da sub-rede a ser usada para teste de carga privada.

--test-plan

Caminho para o script JMeter.

Parâmetros Globais
--debug

Aumente o detalhamento 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 aceitos: json, jsonc, none, table, tsv, yaml, yamlc
valor padrão: json
--query

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

--subscription

Nome ou ID da assinatura. Você pode configurar a assinatura padrão usando az account set -s NAME_OR_ID.

--verbose

Aumentar o detalhamento do log. Use --debug para logs de depuração completos.