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
必須のパラメーター
ロード テスト リソースの名前または ARM リソース ID。
ロード テストのテスト ID。
省略可能のパラメーター
'key[=value]' 形式の 1 つの証明書。 証明書は PFX 形式で Azure Key Vault に格納し、証明書識別子を値として指定する必要があります。
ロード テストの説明。
ロード テストの表示名。
テストを実行するエンジン インスタンスの数。
スペース区切りの環境変数: key[=value] [key[=value] ...]
キー コンテナーへのアクセスに使用される ID。
ロード テスト構成ファイルへのパス。 [https://access.redhat.com/solutions/3082481](https://video2.skills-academy.com/azure/load-testing/reference-test-config-yaml) を参照してください。
実行時間の長い操作の終了を待機しません。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
スペース区切りのシークレット: key[=value] [key[=value] ...]シークレットは Azure Key Vault に格納し、シークレット識別子を値として指定する必要があります。
エンジン インスタンス間で CSV ファイルを均等に分割します。
プライベート ロード テストに使用するサブネットのリソース ID。
JMeter スクリプトへのパス。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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
必須のパラメーター
ロード テスト リソースの名前または ARM リソース ID。
ロード テストのテスト ID。
省略可能のパラメーター
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
確認のダイアログを表示しません。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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
必須のパラメーター
ロード テスト リソースの名前または ARM リソース ID。
ファイルをダウンロードするディレクトリのパス。
ロード テストのテスト ID。
省略可能のパラメーター
コマンドを強制的に実行します。 これにより、ファイルが存在しない場合にダウンロードするディレクトリが作成されます。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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
必須のパラメーター
ロード テスト リソースの名前または ARM リソース ID。
省略可能のパラメーター
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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
必須のパラメーター
ロード テスト リソースの名前または ARM リソース ID。
ロード テストのテスト ID。
省略可能のパラメーター
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --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
必須のパラメーター
ロード テスト リソースの名前または ARM リソース ID。
ロード テストのテスト ID。
省略可能のパラメーター
'key[=value]' 形式の 1 つの証明書。 証明書は PFX 形式で Azure Key Vault に格納し、証明書識別子を値として指定する必要があります。既存の証明書をクリアするには、"" を使用します。
ロード テストの説明。
ロード テストの表示名。
テストを実行するエンジン インスタンスの数。
スペース区切りの環境変数: key[=value] [key[=value] ...]既存の環境変数をクリアするには、"" を使用します。
キー コンテナーへのアクセスに使用される ID。 ロード テスト リソースのシステム割り当て ID を指定 null
または None
使用します。
ロード テスト構成ファイルへのパス。 [https://access.redhat.com/solutions/3082481](https://video2.skills-academy.com/azure/load-testing/reference-test-config-yaml) を参照してください。
実行時間の長い操作の終了を待機しません。
リソース グループの名前。 az configure --defaults group=<name>
を使用して、既定のグループを構成できます。
スペース区切りのシークレット: key[=value] [key[=value] ...]シークレットは Azure Key Vault に格納し、シークレット識別子を値として指定する必要があります。既存のシークレットをクリアするには、"" を使用します。
エンジン インスタンス間で CSV ファイルを均等に分割します。
プライベート ロード テストに使用するサブネットのリソース ID。
JMeter スクリプトへのパス。
グローバル パラメーター
すべてのデバッグ ログを表示するようにログの詳細レベルを上げます。
このヘルプ メッセージを表示して終了します。
エラーのみを表示し、警告は抑制します。
出力形式。
JMESPath クエリ文字列。 詳細と例については、http://jmespath.org/ をご覧ください。
サブスクリプションの名前または ID。 az account set -s NAME_OR_ID
を使用して、既定のサブスクリプションを構成できます。
ログの詳細レベルを上げます。 詳細なデバッグ ログを表示するには --debug を使います。
Azure CLI