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

az footprint profile

注释

此参考是 Azure CLI（版本 2.11.0 或更高版本）的 占用 扩展的一部分。 该扩展将在首次运行 az footprint profile 命令时自动安装。 了解更多关于扩展 的相关信息。

此命令组是试验性的，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

用于管理占用空间配置文件的命令。

命令

名称	说明	类型	Status
az footprint profile create	创建或更新具有指定属性的占用空间配置文件。	扩展	实验性
az footprint profile delete	删除现有的占用空间配置文件。	扩展	实验性
az footprint profile list	检索有关订阅下所有占用空间配置文件的信息。	扩展	实验性
az footprint profile show	检索有关单个占用空间配置文件的信息。	扩展	实验性
az footprint profile update	更新现有的占用空间配置文件资源。	扩展	实验性

az footprint profile create

实验

命令组“占用配置文件”是实验性的，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

创建或更新具有指定属性的占用空间配置文件。

az footprint profile create --measurement-count
                            --name
                            --resource-group
                            --start-delay-ms
                            [--description]
                            [--location]
                            [--reporting-endpoints]
                            [--sample-rate-cold]
                            [--tags]

示例

创建或更新占用空间配置文件。

az footprint profile create --location "westus2" --measurement-count 3 --start-delay-ms 5000 --tags key1="value1" key2="value2" --name "fpProfile1" --resource-group "rgName"

必需参数

--measurement-count

要执行的度量数。

--name --profile-name -n

占用空间配置文件资源的名称。

--resource-group -g

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

--start-delay-ms

客户端应等待的延迟（以毫秒为单位），直到它们开始执行度量。

可选参数

--description

占用空间配置文件的说明。

--location -l

Location。 az account list-locations 中的值。 可以使用 az configure --defaults location=<location> 配置默认位置。

--reporting-endpoints

要向其上传度量的终结点。

--sample-rate-cold

冷路径度量存储的默认采样百分比。

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数

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

实验

命令组“占用配置文件”是实验性的，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

删除现有的占用空间配置文件。

az footprint profile delete [--ids]
                            [--name]
                            [--resource-group]
                            [--subscription]
                            [--yes]

示例

删除占用空间配置文件。

az footprint profile delete --name "fpProfile1" --resource-group "rgName"

可选参数

--ids

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

--name --profile-name -n

占用空间配置文件资源的名称。

--resource-group -g

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

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

实验

命令组“占用配置文件”是实验性的，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

检索有关订阅下所有占用空间配置文件的信息。

az footprint profile list [--resource-group]

示例

列出资源组下的所有占用情况配置文件。

az footprint profile list --resource-group "rgName"

可选参数

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

实验

命令组“占用配置文件”是实验性的，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

检索有关单个占用空间配置文件的信息。

az footprint profile show [--ids]
                          [--name]
                          [--resource-group]
                          [--subscription]

示例

获取占用空间配置文件的详细信息。

az footprint profile show --name "fpProfile1" --resource-group "rgName"

可选参数

--ids

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

--name --profile-name -n

占用空间配置文件资源的名称。

--resource-group -g

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

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

实验

命令组“占用配置文件”是实验性的，正在开发中。 参考和支持级别：https://aka.ms/CLI_refstatus

更新现有的占用空间配置文件资源。

az footprint profile update [--ids]
                            [--name]
                            [--resource-group]
                            [--subscription]
                            [--tags]

示例

更新占用空间配置文件。

az footprint profile update --tags key1="value1" key2="value2" --name "fpProfile1" --resource-group "rgName"

可选参数

--ids

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

--name --profile-name -n

占用空间配置文件资源的名称。

--resource-group -g

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

--subscription

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

--tags

空格分隔标记：key[=value] [key[=value] ...]。使用“”清除现有标记。

全局参数

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