Поделиться через

az load test

  • Предварительный просмотр

Note

Эта ссылка является частью расширения нагрузки для Azure CLI (версия 2.66.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az load test. Подробнее о расширениях.

Эта группа команд находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Группа команд для управления нагрузочных тестов.

Группа команд для управления нагрузочного теста с помощью создания, обновления, удаления, списка и т. д.

Команды

Имя Описание Тип Состояние
az load test app-component

Группа команд для управления компонентами приложения.

 Extension Preview
az load test app-component add

Добавьте компонент приложения в тест.

 Extension Preview
az load test app-component list

Список всех компонентов приложения для теста.

 Extension Preview
az load test app-component remove

Удалите заданный компонент приложения из теста.

 Extension Preview
az load test compare-to-baseline

Сравните статистику выборки из последних тестовых запусков с базовым запуском теста.

 Extension Preview
az load test convert-to-jmx

Преобразование теста типа URL-адреса в тест JMX.

 Extension Preview
az load test create

Создайте новый нагрузочный тест.

 Extension Preview
az load test delete

Удалите существующий нагрузочный тест.

 Extension Preview
az load test download-files

Скачайте файлы существующего нагрузочного теста.

 Extension Preview
az load test file

Группа команд для операций с тестовых файлами.

 Extension Preview
az load test file delete

Удаление файла из теста.

 Extension Preview
az load test file download

Скачайте файл из теста.

 Extension Preview
az load test file list

Вывод списка всех файлов в тесте.

 Extension Preview
az load test file upload

Отправьте файл в тест.

 Extension Preview
az load test list

Перечислить все тесты в заданном ресурсе нагрузочного теста.

 Extension Preview
az load test server-metric

Группа команд для управления метриками сервера.

 Extension Preview
az load test server-metric add

Добавьте серверную метрику в тест.

 Extension Preview
az load test server-metric list

Перечислить все метрики сервера для теста.

 Extension Preview
az load test server-metric remove

Удалите указанную метрику сервера из теста.

 Extension Preview
az load test set-baseline

Задайте тестовый запуск в качестве базового плана для сравнения с другими запусками в тесте.

 Extension Preview
az load test show

Отображение сведений о тесте.

 Extension Preview
az load test update

Обновите существующий нагрузочный тест.

 Extension Preview

az load test compare-to-baseline

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Сравните статистику выборки из последних тестовых запусков с базовым запуском теста.

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]

Примеры

Сравните последние тестовые запуски с базовыми показателями.

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

Сравните последние тестовые запуски с базовыми показателями с конкретным агрегированием.

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

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

--test-id -t

Идентификатор теста нагрузочного теста.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--aggregation

Укажите метод агрегирования для времени отклика.

Свойство Значение
Default value: MEAN
Допустимые значения: MAX, MEAN, MEDIAN, MIN, P75, P90, P95, P96, P98, P99, P999, P9999
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az load test convert-to-jmx

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Преобразование теста типа URL-адреса в тест JMX.

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

Примеры

Преобразование в тест JMX.

az load test convert-to-jmx --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-existing-test-id

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

--test-id -t

Идентификатор теста нагрузочного теста.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--yes -y

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az load test create

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Создайте новый нагрузочный тест.

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

Примеры

Создайте тест с файлом конфигурации нагрузочного теста.

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

Создайте тест с аргументами.

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

Создайте тест с файлом конфигурации нагрузочного теста и переопределите экземпляр ядра и env с помощью аргументов и не дождитесь отправки файла.

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

Создайте тест с помощью секретов и переменных среды.

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

Создайте тест с секретами с помощью назначаемого пользователем управляемого удостоверения для доступа к 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"

Создайте тест для частной конечной точки в виртуальной сети с включенным параметром split CSV.

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

Создайте тест с настраиваемыми критериями автостопирования или включите или отключите автостоп для теста.

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

Создайте тест с конфигурацией загрузки с несколькими регионами с помощью имен регионов в формате, принятом Azure Resource Manager (ARM). Убедитесь, что указанные регионы поддерживаются нагрузочном тестировании Azure. Нагрузочные тесты с несколькими регионами ограничены только общедоступными конечными точками.

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

Создайте расширенный тест URL-адресов с несколькими HTTP-запросами с помощью 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

Создание нагрузочного теста на основе указателя

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

Создайте тест с назначаемой пользователем ссылкой на управляемое удостоверение для подсистемы.

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"

Создайте тест с ссылкой на управляемое удостоверение, назначаемое пользователем, для доступа к метрикам настроенных приложений.

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"

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

--test-id -t

Идентификатор теста нагрузочного теста.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--autostop

Следует ли включить или отключить автоматическую остановку. Допустимые значения : включить или отключить.

--autostop-engine-users

Максимальное количество пользователей на двигатель, на котором будет остановлен тест.

--autostop-error-rate

Пороговое значение ошибок, при которых тестовый запуск должен быть остановлен автоматически. Допустимые значения находятся в диапазоне [0,0,100,0].

--autostop-time-window

Временное окно, в течение которого процент ошибок должен оцениваться в секундах.

--certificate

Один сертификат в формате key[=value]. Сертификат должен храниться в Azure Key Vault в формате PFX, а идентификатор сертификата должен быть указан в качестве значения.

--description

Описание нагрузочного теста.

--disable-public-ip

Отключите развертывание общедоступного IP-адреса, подсистемы балансировки нагрузки и группы безопасности сети при тестировании частной конечной точки.

--display-name

Отображаемое имя нагрузочного теста.

--engine-instances

Количество экземпляров подсистемы, в которых должен выполняться тест.

--engine-ref-id-type

Тип удостоверения, который необходимо настроить для подсистемы.

Свойство Значение
Допустимые значения: None, SystemAssigned, UserAssigned
--engine-ref-ids

Разделенный пробелами список полных идентификаторов ресурсов управляемых удостоверений для настройки на подсистеме. Требуется только для назначенных пользователем удостоверений.

--env

Переменные среды, разделенные пробелами: key[=value] [key[=value] ...].

--keyvault-reference-id

Удостоверение, которое будет использоваться для доступа к хранилищу ключей.

--load-test-config-file

Путь к файлу конфигурации нагрузочного теста. См. https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--metrics-reference-id

Удостоверение, которое будет использоваться для доступа к метрикам. Значение по умолчанию будет задано в SystemAssigned, если оно не задано.

--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Default value: False
--regionwise-engines

Укажите число обработчиков для каждого региона в формате: region1=engineCount1 region2=engineCount2 .... Используйте имена регионов в формате, принятом Azure Resource Manager (ARM). Убедитесь, что регионы поддерживаются нагрузочном тестировании Azure. Нагрузочные тесты с несколькими регионами могут использовать только общедоступные конечные точки.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--secret

Секреты, разделенные пробелами: key[=value] [key[=value] ...]. Секреты должны храниться в Azure Key Vault, а идентификатор секрета должен быть указан в качестве значения.

--split-csv

Разделение CSV-файлов равномерно между экземплярами ядра.

--subnet-id

Идентификатор ресурса подсети, используемой для частного нагрузочного теста.

--test-plan

Ссылка на файл плана тестирования. Если testType: JMX: путь к скрипту JMeter. Если testType: URL: путь к JSON-файлу запросов. Если testType: Locust: путь к скрипту тестирования Locust.

--test-type

Тип нагрузочного теста.

Свойство Значение
Допустимые значения: JMX, Locust, URL
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az load test delete

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Удалите существующий нагрузочный тест.

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

Примеры

Удаление нагрузочного теста.

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

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

--test-id -t

Идентификатор теста нагрузочного теста.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--yes -y

Не запрашивать подтверждение.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az load test download-files

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Скачайте файлы существующего нагрузочного теста.

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

Примеры

Скачайте все файлы теста. Каталог уже должен существовать.

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

Скачайте все файлы теста, создав каталог, если он не существует.

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

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

--path

Путь к каталогу для скачивания файлов.

--test-id -t

Идентификатор теста нагрузочного теста.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--force

Принудительно выполните команду. При этом каталог будет создан для скачивания файлов, если он не существует.

Свойство Значение
Default value: False
--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az load test list

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Перечислить все тесты в заданном ресурсе нагрузочного теста.

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

Примеры

Перечислить все нагрузочные тесты в ресурсе.

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

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az load test set-baseline

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Задайте тестовый запуск в качестве базового плана для сравнения с другими запусками в тесте.

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

Примеры

Задайте базовый тестовый запуск.

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

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

--test-id -t

Идентификатор теста нагрузочного теста.

--test-run-id -r

Идентификатор тестового запуска нагрузочного теста.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az load test show

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Отображение сведений о тесте.

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

Примеры

Получение сведений о нагрузочном тесте.

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

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

--test-id -t

Идентификатор теста нагрузочного теста.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False

az load test update

Предварительный просмотр

Группа команд "нагрузочный тест" находится в предварительной версии и в процессе разработки. Уровни справки и поддержки: https://aka.ms/CLI_refstatus

Обновите существующий нагрузочный тест.

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]

Примеры

Обновите тест с помощью файла конфигурации нагрузочного теста и не дождитесь отправки файлов.

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

Обновите отображаемое имя и описание теста.

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"

Обновите тест с помощью файла конфигурации нагрузочного теста и переопределите параметры с помощью аргументов.

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

Удалите секреты из теста.

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

Обновите удостоверение ссылки key Vault на назначенное системой управляемое удостоверение.

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

Обновление условий автостопирования.

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

Обновление конфигурации загрузки с несколькими регионами.

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

Обновите тест с помощью ссылки на управляемое удостоверение, назначаемое пользователем, для подсистемы 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

Обязательные параметры

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

Имя или идентификатор ресурса ARM ресурса нагрузочного тестирования.

--test-id -t

Идентификатор теста нагрузочного теста.

Необязательные параметры

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--autostop

Следует ли включить или отключить автоматическую остановку. Допустимые значения : включить или отключить.

--autostop-engine-users

Максимальное количество пользователей на двигатель, на котором будет остановлен тест.

--autostop-error-rate

Пороговое значение ошибок, при которых тестовый запуск должен быть остановлен автоматически. Допустимые значения находятся в диапазоне [0,0,100,0].

--autostop-time-window

Временное окно, в течение которого процент ошибок должен оцениваться в секундах.

--certificate

Один сертификат в формате key[=value]. Сертификат должен храниться в Azure Key Vault в формате PFX, а идентификатор сертификата должен быть указан в качестве значения. Используйте "" для очистки существующего сертификата.

--description

Описание нагрузочного теста.

--disable-public-ip

Отключите развертывание общедоступного IP-адреса, подсистемы балансировки нагрузки и группы безопасности сети при тестировании частной конечной точки.

--display-name

Отображаемое имя нагрузочного теста.

--engine-instances

Количество экземпляров подсистемы, в которых должен выполняться тест.

--engine-ref-id-type

Тип удостоверения, который необходимо настроить для подсистемы.

Свойство Значение
Допустимые значения: None, SystemAssigned, UserAssigned
--engine-ref-ids

Разделенный пробелами список полных идентификаторов ресурсов управляемых удостоверений для настройки на подсистеме. Требуется только для назначенных пользователем удостоверений.

--env

Переменные среды, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих переменных среды.

--keyvault-reference-id

Удостоверение, которое будет использоваться для доступа к хранилищу ключей. Предоставьте null или None использовать удостоверение, назначенное системой ресурса нагрузочного теста.

--load-test-config-file

Путь к файлу конфигурации нагрузочного теста. См. https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--metrics-reference-id

Удостоверение, которое будет использоваться для доступа к метрикам. Предоставьте null или None использовать удостоверение, назначенное системой ресурса нагрузочного теста.

--no-wait

Не ожидать завершения длительной операции.

Свойство Значение
Default value: False
--regionwise-engines

Укажите число обработчиков для каждого региона в формате: region1=engineCount1 region2=engineCount2 .... Используйте имена регионов в формате, принятом Azure Resource Manager (ARM). Убедитесь, что регионы поддерживаются нагрузочном тестировании Azure. Нагрузочные тесты с несколькими регионами могут использовать только общедоступные конечные точки.

--resource-group -g

Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>.

--secret

Секреты, разделенные пробелами: key[=value] [key[=value] ...]. Секреты должны храниться в Azure Key Vault, а идентификатор секрета должен быть указан в качестве значения. Используйте "" для очистки существующих секретов.

--split-csv

Разделение CSV-файлов равномерно между экземплярами ядра.

--subnet-id

Идентификатор ресурса подсети, используемой для частного нагрузочного теста.

--test-plan

Ссылка на файл плана тестирования. Если testType: JMX: путь к скрипту JMeter. Если testType: URL: путь к JSON-файлу запросов. Если testType: Locust: путь к скрипту тестирования Locust.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

Отображать только ошибки, не показывая предупреждения.

Свойство Значение
Default value: False
--output -o

Формат вывода.

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Увеличьте уровень детализации ведения журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

Свойство Значение
Default value: False