az load test-run

手記

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

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

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

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

コマンド

名前	説明	型	状態
az load test-run app-component	ロード テストの実行アプリ コンポーネントを管理するコマンド グループ。	延長	プレビュー
az load test-run app-component add	アプリ コンポーネントをテスト実行に追加します。	延長	プレビュー
az load test-run app-component list	テスト実行のすべてのアプリ コンポーネントを一覧表示します。	延長	プレビュー
az load test-run app-component remove	テスト実行からアプリ コンポーネントを削除します。	延長	プレビュー
az load test-run create	新しいロード テストの実行を作成します。	延長	プレビュー
az load test-run delete	既存のロード テストの実行を削除します。	延長	プレビュー
az load test-run download-files	既存のロード テスト実行用のファイルをダウンロードします。	延長	プレビュー
az load test-run get-artifacts-url	ストレージ アカウントから成果物を取得する SAS URL を返します。	延長	プレビュー
az load test-run list	すべてのテスト実行を一覧表示します。	延長	プレビュー
az load test-run metrics	ロード テストの実行メトリックを取得するコマンド グループ。	延長	プレビュー
az load test-run metrics get-definitions	ロード テスト実行のすべてのメトリック定義を取得します。	延長	プレビュー
az load test-run metrics get-dimensions	ロード テスト実行のすべてのメトリック ディメンション値を取得します。	延長	プレビュー
az load test-run metrics get-namespaces	ロード テスト実行のすべてのメトリック名前空間を取得します。	延長	プレビュー
az load test-run metrics list	ロード テストの実行のメトリックを一覧表示します。	延長	プレビュー
az load test-run server-metric	ロード テストの実行サーバー メトリックを管理するコマンド グループ。	延長	プレビュー
az load test-run server-metric add	テスト実行にサーバー メトリックを追加します。	延長	プレビュー
az load test-run server-metric list	テスト実行のすべてのサーバー メトリックを一覧表示します。	延長	プレビュー
az load test-run server-metric remove	テスト実行からサーバー メトリックを削除します。	延長	プレビュー
az load test-run show	テスト実行の詳細を表示します。	延長	プレビュー
az load test-run stop	ロード テストの実行を停止します。	延長	プレビュー
az load test-run update	既存のロード テストの実行を更新します。	延長	プレビュー

az load test-run create

プレビュー

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

新しいロード テストの実行を作成します。

特定のテストに対して新しいロード テストの実行を作成します。 既存のテスト実行が指定されている場合は、テストの実行が再実行されます。 既定では、このコマンドはテストの実行が完了するまで待機します。 この待機をスキップするには、--no-wait を使用します。

az load test-run create --load-test-resource
                        --test-id
                        --test-run-id
                        [--certificate]
                        [--debug-mode]
                        [--description]
                        [--display-name]
                        [--env]
                        [--existing-test-run-id]
                        [--no-wait]
                        [--resource-group]
                        [--secret]

例

テストの実行が完了するのを待たずに、テストのテスト実行を作成します。

az load test-run create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --test-run-id sample-test-run-id --no-wait

既存のテスト実行を再実行します。

az load test-run create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --test-run-id sample-test-run-id --description "Test run description" --existing-test-run-id existing_test_run_id

デバッグ レベルのログ記録を有効にしてテスト実行を作成します。

az load test-run create --load-test-resource sample-alt-resource --resource-group sample-rg --test-id sample-test-id --test-run-id sample-test-run-id --debug-mode

必須のパラメーター

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

ロード テスト リソースの名前または ARM リソース ID。

--test-id -t

ロード テストのテスト ID。

--test-run-id -r

ロード テストの実行のテスト実行 ID。

省略可能のパラメーター

--certificate

'key[=value]' 形式の 1 つの証明書。 証明書は PFX 形式で Azure Key Vault に格納し、証明書識別子を値として指定する必要があります。既存の証明書をクリアするには、"" を使用します。

--debug-mode

テスト実行のデバッグ レベルのログ記録を有効にします。

規定値: False

--description

ロード テストの実行の説明。

--display-name

ロード テストの実行の表示名。

--env

スペース区切りの環境変数: key[=value] [key[=value] ...]既存の環境変数をクリアするには、"" を使用します。

--existing-test-run-id

再実行する必要がある既存のロード テスト実行のテスト実行 ID。

--no-wait

実行時間の長い操作が完了するまで待つ必要はありません。

規定値: False

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--secret

スペース区切りのシークレット: key[=value] [key[=value] ...]シークレットは Azure Key Vault に格納し、シークレット識別子を値として指定する必要があります。既存のシークレットをクリアするには、"" を使用します。

グローバル パラメーター

--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-run delete

プレビュー

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

既存のロード テストの実行を削除します。

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

例

テストの実行を削除します。

az load test-run delete --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --yes

必須のパラメーター

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

ロード テスト リソースの名前または ARM リソース ID。

--test-run-id -r

ロード テストの実行のテスト実行 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-run download-files

プレビュー

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

既存のロード テスト実行用のファイルをダウンロードします。

az load test-run download-files --load-test-resource
                                --path
                                --test-run-id
                                [--force]
                                [--input]
                                [--log]
                                [--report]
                                [--resource-group]
                                [--result]

例

テスト実行用の入力、ログ、結果、ダッシュボードのレポート ファイルをダウンロードします。 ディレクトリは既に存在している必要があります。

az load test-run download-files --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --path ~/Downloads/OutputArtifacts --input --log --result --report

ディレクトリが存在しない場合は、ディレクトリを作成して、テスト実行の入力ファイルとログ ファイルをダウンロードします。

az load test-run download-files --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --path ~/Downloads/OutputArtifacts --input --log --force

必須のパラメーター

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

ロード テスト リソースの名前または ARM リソース ID。

--path

ファイルをダウンロードするディレクトリのパス。

--test-run-id -r

ロード テストの実行のテスト実行 ID。

省略可能のパラメーター

--force

コマンドを強制的に実行します。 これにより、ファイルが存在しない場合にダウンロードするディレクトリが作成されます。

規定値: False

--input

入力ファイル zip をダウンロードします。

規定値: False

--log

ログ ファイル zip をダウンロードします。

規定値: False

--report

ダッシュボード レポート ファイル zip をダウンロードします。

規定値: False

--resource-group -g

リソース グループの名前。 az configure --defaults group=<name>を使用して既定のグループを構成できます。

--result

結果ファイル zip をダウンロードします。

規定値: 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-run get-artifacts-url

プレビュー

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

ストレージ アカウントから成果物を取得する SAS URL を返します。

az load test-run get-artifacts-url --load-test-resource
                                   --test-run-id
                                   [--resource-group]

例

SAS URL をフェッチします。

az load test-run get-artifacts-url --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id

必須のパラメーター

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

ロード テスト リソースの名前または ARM リソース ID。

--test-run-id -r

ロード テストの実行のテスト実行 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-run list

プレビュー

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

すべてのテスト実行を一覧表示します。

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

例

テスト内のすべてのテストの実行を一覧表示します。

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

必須のパラメーター

--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-run show

プレビュー

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

テスト実行の詳細を表示します。

指定された test-run-id で識別されるテスト実行の詳細を表示します。

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

例

テストの実行の詳細を取得します。

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

必須のパラメーター

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

ロード テスト リソースの名前または ARM リソース ID。

--test-run-id -r

ロード テストの実行のテスト実行 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-run stop

プレビュー

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

ロード テストの実行を停止します。

az load test-run stop --load-test-resource
                      --test-run-id
                      [--resource-group]
                      [--yes]

例

テストの実行を停止します。

az load test-run stop --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --yes

必須のパラメーター

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

ロード テスト リソースの名前または ARM リソース ID。

--test-run-id -r

ロード テストの実行のテスト実行 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-run update

プレビュー

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

既存のロード テストの実行を更新します。

az load test-run update --load-test-resource
                        --test-run-id
                        [--description]
                        [--display-name]
                        [--resource-group]

例

テスト実行の説明を更新する

az load test-run update --load-test-resource sample-alt-resource --resource-group sample-rg --test-run-id sample-test-run-id --description "Test run description"

必須のパラメーター

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

ロード テスト リソースの名前または ARM リソース ID。

--test-run-id -r

ロード テストの実行のテスト実行 ID。

省略可能のパラメーター

--description

ロード テストの実行の説明。

--display-name

ロード テストの実行の表示名。

--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 を使用します。