az load test

  • プレビュー
  • リファレンス

Note

このリファレンスは、Azure CLI (バージョン 2.41.0 以降) の読み込み拡張機能の一部です。 拡張機能は、az load test コマンドを初めて実行するときに自動的にインストールされます。 拡張機能の詳細をご覧ください。

このコマンド グループはプレビュー段階であり、開発中です。 参照レベルとサポート レベル: https://aka.ms/CLI_refstatus

ロード テストを管理するコマンド グループ。

作成、更新、削除、一覧表示などを使用してロード テストを管理するコマンド グループ。

コマンド

名前 説明 型 Status
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

ロード テスト構成ファイルを使用してテストを作成し、引数を使用して engine-instance と 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

ユーザー割り当てマネージド 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 オプションを有効にして、仮想ネットワーク内のプライベート エンドポイントのテストを作成します。

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]' 形式の 1 つの証明書。 証明書は PFX 形式で Azure Key Vault に格納し、証明書識別子を値として指定する必要があります。

--description

ロード テストの説明。

--display-name

ロード テストの表示名。

--engine-instances

テストを実行するエンジン インスタンスの数。

--env

スペース区切りの環境変数: key[=value] [key[=value] ...]

--keyvault-reference-id

キー コンテナーへのアクセスに使用される ID。

--load-test-config-file

ロード テスト構成ファイルへのパス。 [https://access.redhat.com/solutions/3082481](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]' 形式の 1 つの証明書。 証明書は 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://access.redhat.com/solutions/3082481](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 を使います。