你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

az load

注意

此参考是 Azure CLI（版本 2.41.0 或更高版本）的负载扩展的一部分。 该扩展将在首次运行 az load 命令时自动安装。 详细了解扩展。

管理 Azure 负载测试资源。

命令

名称	说明	类型	状态
az load create	创建 Azure 负载测试资源。	分机	GA
az load delete	删除 Azure 负载测试资源。	扩展	GA
az load list	列出 Azure 负载测试资源。	扩展	GA
az load show	显示一个或多个 Azure 负载测试资源的详细信息。	扩展	GA
az load test	用于管理负载测试的命令组。	分机	预览
az load test-run	用于管理负载测试运行的命令组。	分机	预览
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 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 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 update	更新 Azure 负载测试资源。	扩展	GA
az load wait	将 CLI 置于等待状态，直到满足条件。	扩展	GA

az load create

创建 Azure 负载测试资源。

负载测试资源名称必须对资源组是唯一的。

az load create --name
               --resource-group
               [--encryption-identity]
               [--encryption-key]
               [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
               [--location]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--tags]
               [--user-assigned]

示例

创建新的 Azure 负载测试资源

az load create --name sample-resource --resource-group sample-rg --location westus2
az load create -n sample-resource -g sample-rg -l westus2

使用标记创建新的 Azure 负载测试资源

az load create -n sample-resource -g sample-rg -l westus2 --tags type=testing target=infra

使用托管标识创建新的 Azure 负载测试资源

az load create -n sample-resource -g sample-rg -l westus2 --identity-type SystemAssigned,UserAssigned --user-assigned "{'/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-mi':{}}"

使用 CMK 加密创建新的 Azure 负载测试资源

az load create -n sample-resource -g sample-rg -l westus2 --identity-type SystemAssigned,UserAssigned --user-assigned "{'/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-mi':{}}" --encryption-key https://sample-kv.vault.azure.net/keys/samplekey/2d1ccd5c50234ea2a0858fe148b69cde --encryption-identity /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-mi

必需参数

--name -n

新的 Azure 负载测试资源的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group= 配置默认组。

可选参数

--encryption-identity

客户管理的密钥设置的托管标识，用于定义应使用哪些标识进行身份验证以密钥库。

--encryption-key

加密密钥 URL（版本控制）。 例如 https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78。

--identity-type

托管服务标识的类型。

接受的值: None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned

默认值: None

--location -l

Location。 值来源：az account list-locations。 可以使用 az configure --defaults location=配置默认位置。 如果未指定，将使用资源组的位置。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--user-assigned

与资源关联的用户分配标识的列表。 用户分配的标识将是 ARM 资源 ID。例如，用户分配的标识列表类似于“{'/subscriptions/ abcdef01-2345-6789-0abc-def012345678 /resourcegroups/sample-rg/providers/microsoft.managedidentity/userassignedidentities/identity1'，'/subscriptions/ abcdef01-2345-6789-0abc-def012345678 /resourcegroups/test-rg/providers/microsoft.managedidentity/userassignedidentities/identity2'}” 支持速记语法， json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

全局参数

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

删除 Azure 负载测试资源。

az load delete [--ids]
               [--name]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--resource-group]
               [--subscription]
               [--yes]

示例

删除 Azure 负载测试资源

az load delete --name sample-resource --resource-group sample-rg

删除多个 Azure 负载测试资源

az load delete --ids /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.LoadTestService/loadtests/sample-resource1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg2/providers/Microsoft.LoadTestService/loadtests/sample-resource2

可选参数

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

Azure 负载测试资源的名称。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group= 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--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 list

列出 Azure 负载测试资源。

az load list [--resource-group]

示例

列出 Azure 负载测试资源

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

可选参数

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group= 配置默认组。

全局参数

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

显示一个或多个 Azure 负载测试资源的详细信息。

az load show [--ids]
             [--name]
             [--resource-group]
             [--subscription]

示例

显示 Azure 负载测试资源

az load show --name sample-resource --resource-group sample-rg

显示 Azure 负载测试资源

az load show --ids /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.LoadTestService/loadtests/sample-resource1 /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg2/providers/Microsoft.LoadTestService/loadtests/sample-resource2

可选参数

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

Azure 负载测试资源的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group= 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

全局参数

--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 update

更新 Azure 负载测试资源。

az load update [--encryption-identity]
               [--encryption-key]
               [--identity-type {None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned}]
               [--ids]
               [--name]
               [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
               [--resource-group]
               [--subscription]
               [--tags]
               [--user-assigned]

示例

更新 Azure 负载测试资源

az load update --name sample-resource --resource-group sample-rg --identity-type SystemAssigned
az load update --name sample-resource --resource-group sample-rg --tags type=server
az load update --name sample-resource --resource-group sample-rg --encryption-key https://sample-kv.vault.azure.net/keys/samplekey2/2d1ccd5c50234ea2a0858fe148b69cde
az load update --name sample-resource --resource-group sample-rg --identity-type SystemAssigned,UserAssigned --user-assigned "{'/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/sample-rg/providers/Microsoft.ManagedIdentity/userAssignedIdentities/sample-mi':{}}" --encryption-key https://sample-kv.vault.azure.net/keys/samplekey2/2d1ccd5c50234ea2a0858fe148b69cde --encryption-identity SystemAssigned

可选参数

--encryption-identity

客户管理的密钥设置的托管标识，用于定义应使用哪些标识进行身份验证以密钥库。

--encryption-key

加密密钥 URL（版本控制）。 例如 https://contosovault.vault.azure.net/keys/contosokek/562a4bb76b524a1493a6afe8e536ee78。

--identity-type

托管服务标识的类型。

接受的值: None, SystemAssigned, SystemAssigned,UserAssigned, UserAssigned

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--name -n

Azure 负载测试资源的名称。

--no-wait

不等待长时间运行的操作完成。

接受的值: 0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group= 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

--user-assigned

与资源关联的用户分配标识的列表。 支持速记语法、json-file 和 yaml-file。 请尝试“？？” 以显示更多内容。

全局参数

--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 wait

将 CLI 置于等待状态，直到满足条件。

az load wait [--created]
             [--custom]
             [--deleted]
             [--exists]
             [--ids]
             [--interval]
             [--name]
             [--resource-group]
             [--subscription]
             [--timeout]
             [--updated]

可选参数

--created

等待在“Succeeded”中使用“provisioningState”创建。

默认值: False

--custom

等待条件满足自定义 JMESPath 查询。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--deleted

等到删除为止。

默认值: False

--exists

等待资源存在。

默认值: False

--ids

一个或多个资源 ID（空格分隔）。 它应该是包含“资源 ID”参数的所有信息的完整资源 ID。 应提供 --id 或其他“资源 ID”参数。

--interval

轮询间隔（以秒为单位）。

默认值: 30

--name -n

Azure 负载测试资源的名称。

--resource-group -g

资源组的名称。 可以使用 az configure --defaults group= 配置默认组。

--subscription

订阅的名称或 ID。 可以使用 az account set -s NAME_OR_ID 配置默认订阅。

--timeout

最大等待（以秒为单位）。

默认值: 3600

--updated

等到 provisioningState 更新为“Succeeded”。

默认值: 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 获取完整的调试日志。