az load test

참고 항목

이 참조는 Azure CLI(버전 2.41.0 이상)에 대한 부하 확장의 일부입니다. az load test 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장 프로그램에 대해 자세히 알아보세요.

이 명령 그룹은 미리 보기 상태이며 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

부하 테스트를 관리하는 명령 그룹입니다.

만들기, 업데이트, 삭제, 목록 등을 사용하여 부하 테스트를 관리하는 명령 그룹입니다.

명령

Name	Description	형식	상태
az load test app-component	앱 구성 요소를 관리하는 명령 그룹입니다.	내선 번호	미리 보기
az load test app-component add	테스트에 앱 구성 요소를 추가합니다.	내선 번호	미리 보기
az load test app-component list	테스트에 대한 모든 앱 구성 요소를 나열합니다.	내선 번호	미리 보기
az load test app-component remove	테스트에서 지정된 앱 구성 요소를 제거합니다.	내선 번호	미리 보기
az load test create	새 부하 테스트를 만듭니다.	내선 번호	미리 보기
az load test delete	기존 부하 테스트를 삭제합니다.	내선 번호	미리 보기
az load test download-files	기존 부하 테스트의 파일을 다운로드합니다.	내선 번호	미리 보기
az load test file	테스트 파일에 대한 작업에 대한 명령 그룹입니다.	내선 번호	미리 보기
az load test file delete	테스트에서 파일을 삭제합니다.	내선 번호	미리 보기
az load test file download	테스트에서 파일을 다운로드합니다.	내선 번호	미리 보기
az load test file list	테스트의 모든 파일을 나열합니다.	내선 번호	미리 보기
az load test file upload	테스트에 파일을 업로드합니다.	내선 번호	미리 보기
az load test list	지정된 부하 테스트 리소스의 모든 테스트를 나열합니다.	내선 번호	미리 보기
az load test server-metric	서버 메트릭을 관리하는 명령 그룹입니다.	내선 번호	미리 보기
az load test server-metric add	테스트에 서버 메트릭을 추가합니다.	내선 번호	미리 보기
az load test server-metric list	테스트에 대한 모든 서버 메트릭을 나열합니다.	내선 번호	미리 보기
az load test server-metric remove	테스트에서 지정된 서버 메트릭을 제거합니다.	내선 번호	미리 보기
az load test show	테스트 세부 정보를 표시합니다.	내선 번호	미리 보기
az load test update	기존 부하 테스트를 업데이트합니다.	내선 번호	미리 보기

az load test create

미리 보기

명령 그룹 '부하 테스트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

새 부하 테스트를 만듭니다.

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]

예제

부하 테스트 구성 파일을 사용하여 테스트를 만듭니다.

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

부하 테스트 구성 파일을 사용하여 테스트를 만들고, 인수를 사용하여 엔진 인스턴스를 재정의하고, 파일 업로드를 기다리지 마세요.

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

사용자가 할당한 관리 ID를 사용하여 비밀을 사용하여 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"

분할 CSV 옵션을 사용하도록 설정된 Virtual Network에서 프라이빗 엔드포인트에 대한 테스트를 만듭니다.

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

필수 매개 변수

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

부하 테스트 리소스의 이름 또는 ARM 리소스 ID입니다.

--test-id -t

부하 테스트의 테스트 ID입니다.

선택적 매개 변수

--certificate

'key[=value]' 형식의 단일 인증서입니다. 인증서는 PFX 형식으로 Azure Key Vault에 저장되어야 하며 인증서 식별자는 값으로 제공되어야 합니다.

--description

부하 테스트에 대한 설명입니다.

--display-name

부하 테스트의 표시 이름입니다.

--engine-instances

테스트를 실행해야 하는 엔진 인스턴스 수입니다.

--env

공백으로 구분된 환경 변수: key[=value] [key[=value] ...].

--keyvault-reference-id

키 자격 증명 모음에 액세스하는 데 사용할 ID입니다.

--load-test-config-file

부하 테스트 구성 파일의 경로입니다. 를 참조하세요 https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--secret

공백으로 구분된 비밀: key[=value] [key[=value] ...]. 비밀은 Azure Key Vault에 저장되어야 하며 비밀 식별자는 값으로 제공되어야 합니다.

--split-csv

CSV 파일을 엔진 인스턴스 간에 균등하게 분할합니다.

--subnet-id

프라이빗 부하 테스트에 사용할 서브넷의 리소스 ID입니다.

--test-plan

JMeter 스크립트의 경로입니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az load test delete

미리 보기

명령 그룹 '부하 테스트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

기존 부하 테스트를 삭제합니다.

az load test delete --load-test-resource
                    --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 리소스 ID입니다.

--test-id -t

부하 테스트의 테스트 ID입니다.

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--yes -y

확인 메시지를 표시하지 않습니다.

기본값: False

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az load test download-files

미리 보기

명령 그룹 '부하 테스트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

기존 부하 테스트의 파일을 다운로드합니다.

az load test download-files --load-test-resource
                            --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 리소스 ID입니다.

--path

파일을 다운로드할 디렉터리의 경로입니다.

--test-id -t

부하 테스트의 테스트 ID입니다.

선택적 매개 변수

--force

명령을 강제로 실행합니다. 파일이 없으면 파일을 다운로드할 디렉터리가 생성됩니다.

기본값: False

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az load test list

미리 보기

명령 그룹 '부하 테스트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

지정된 부하 테스트 리소스의 모든 테스트를 나열합니다.

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

예제

리소스의 모든 부하 테스트를 나열합니다.

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

필수 매개 변수

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

부하 테스트 리소스의 이름 또는 ARM 리소스 ID입니다.

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az load test show

미리 보기

명령 그룹 '부하 테스트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

테스트 세부 정보를 표시합니다.

az load test show --load-test-resource
                  --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 리소스 ID입니다.

--test-id -t

부하 테스트의 테스트 ID입니다.

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.

az load test update

미리 보기

명령 그룹 '부하 테스트'는 미리 보기로 개발 중입니다. 참조 및 지원 수준: https://aka.ms/CLI_refstatus

기존 부하 테스트를 업데이트합니다.

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]

예제

부하 테스트 구성 파일로 테스트를 업데이트하고 파일 업로드를 기다리지 않습니다.

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 참조 ID를 시스템 할당 관리 ID로 업데이트합니다.

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

필수 매개 변수

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

부하 테스트 리소스의 이름 또는 ARM 리소스 ID입니다.

--test-id -t

부하 테스트의 테스트 ID입니다.

선택적 매개 변수

--certificate

'key[=value]' 형식의 단일 인증서입니다. 인증서는 PFX 형식으로 Azure Key Vault에 저장되어야 하며 인증서 식별자는 값으로 제공되어야 합니다. ""를 사용하여 기존 인증서를 지웁니다.

--description

부하 테스트에 대한 설명입니다.

--display-name

부하 테스트의 표시 이름입니다.

--engine-instances

테스트를 실행해야 하는 엔진 인스턴스 수입니다.

--env

공백으로 구분된 환경 변수: key[=value] [key[=value] ...]. ""를 사용하여 기존 환경 변수를 지웁니다.

--keyvault-reference-id

키 자격 증명 모음에 액세스하는 데 사용할 ID입니다. 부하 테스트 리소스의 시스템 할당 ID를 제공 null 하거나 None 사용합니다.

--load-test-config-file

부하 테스트 구성 파일의 경로입니다. 를 참조하세요 https://learn.microsoft.com/azure/load-testing/reference-test-config-yaml.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

기본값: False

--resource-group -g

리소스 그룹의 이름입니다. 를 사용하여 az configure --defaults group=<name>기본 그룹을 구성할 수 있습니다.

--secret

공백으로 구분된 비밀: key[=value] [key[=value] ...]. 비밀은 Azure Key Vault에 저장되어야 하며 비밀 식별자는 값으로 제공되어야 합니다. ""를 사용하여 기존 비밀을 지웁니다.

--split-csv

CSV 파일을 엔진 인스턴스 간에 균등하게 분할합니다.

--subnet-id

프라이빗 부하 테스트에 사용할 서브넷의 리소스 ID입니다.

--test-plan

JMeter 스크립트의 경로입니다.

전역 매개 변수

--debug

로깅의 자세한 정도를 늘려 모든 디버그 로그를 표시합니다.

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

--output -o

출력 형식입니다.

허용되는 값: json, jsonc, none, table, tsv, yaml, yamlc

기본값: json

--query

JMESPath 쿼리 문자열입니다. 자세한 내용과 예제는 http://jmespath.org/를 참조하세요.

--subscription

구독의 이름 또는 ID입니다. 를 사용하여 az account set -s NAME_OR_ID기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 늘립니다. 전체 디버그 로그를 표시하려면 --debug를 사용합니다.