您现在访问的是微软AZURE全球版技术文档网站,若需要访问由世纪互联运营的MICROSOFT AZURE中国区技术文档网站,请访问 https://docs.azure.cn.

az costmanagement

备注

此引用是用于 Azure CLI 的 costmanagement 扩展的一部分,需要版本2.3.1 或更高版本。 首次运行 az costmanagement 命令时,该扩展将自动安装。 详细了解扩展。

在 Azure 中管理成本和计费。

命令

az costmanagement export

Costmanagement 导出。

az costmanagement export create

用于创建导出的操作。

az costmanagement export delete

删除导出的操作。

az costmanagement export list

用于列出给定范围内的所有导出的操作。

az costmanagement export show

用于按导出名称获取已定义范围的导出的执行历史记录的操作。

az costmanagement export update

用于更新导出的操作。

az costmanagement query

查询定义的作用域的使用情况数据。

az costmanagement query

查询定义的作用域的使用情况数据。

az costmanagement query --scope
                        --timeframe {BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate}
                        --type {ActualCost, AmortizedCost, Usage}
                        [--dataset-aggregation]
                        [--dataset-configuration]
                        [--dataset-filter]
                        [--dataset-grouping]
                        [--time-period]

示例

在 ManagementGroup 范围内查询

az costmanagement query --type "Usage" --dataset-filter "{\"and\":[{\"or\":[{\"dimension\":{\"name\":\"ResourceLocation\",\"operator\":\"In\",\"values\":[\"East US\",\"West Europe\"]}},{\"tag\":{\"name\":\"Environment\",\"operator\":\"In\",\"values\":[\"UAT\",\"Prod\"]}}]},{\"dimension\":{\"name\":\"ResourceGroup\",\"operator\":\"In\",\"values\":[\"API\"]}}]}" --timeframe "MonthToDate" --scope "providers/Microsoft.Management/managementGroups/MyMgId"

通过分组在 ManagementGroupQuery 范围内查询

az costmanagement query --type "Usage" --dataset-aggregation "{\"totalCost\":{\"name\":\"PreTaxCost\",\"function\":\"Sum\"}}" --dataset-grouping name="ResourceGroup" type="Dimension" --timeframe "TheLastMonth" --scope "providers/Microsoft.Management/managementGroups/MyMgId"

在资源组范围内查询

az costmanagement query --type "Usage" --dataset-filter "{\"and\":[{\"or\":[{\"dimension\":{\"name\":\"ResourceLocation\",\"operator\":\"In\",\"values\":[\"East US\",\"West Europe\"]}},{\"tag\":{\"name\":\"Environment\",\"operator\":\"In\",\"values\":[\"UAT\",\"Prod\"]}}]},{\"dimension\":{\"name\":\"ResourceGroup\",\"operator\":\"In\",\"values\":[\"API\"]}}]}" --timeframe "MonthToDate" --scope "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ScreenSharingTest-peer"

通过分组在 ResourceGroupQuery 范围内查询

az costmanagement query --type "Usage" --dataset-aggregation "{\"totalCost\":{\"name\":\"PreTaxCost\",\"function\":\"Sum\"}}" --dataset-grouping name="ResourceType" type="Dimension" --timeframe "TheLastMonth" --scope "subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/ScreenSharingTest-peer"

订阅范围中的查询

az costmanagement query --type "Usage" --dataset-filter "{\"and\":[{\"or\":[{\"dimension\":{\"name\":\"ResourceLocation\",\"operator\":\"In\",\"values\":[\"East US\",\"West Europe\"]}},{\"tag\":{\"name\":\"Environment\",\"operator\":\"In\",\"values\":[\"UAT\",\"Prod\"]}}]},{\"dimension\":{\"name\":\"ResourceGroup\",\"operator\":\"In\",\"values\":[\"API\"]}}]}" --timeframe "MonthToDate" --scope "subscriptions/00000000-0000-0000-0000-000000000000"

通过分组在订阅范围内查询

az costmanagement query --type "Usage" --dataset-aggregation "{\"totalCost\":{\"name\":\"PreTaxCost\",\"function\":\"Sum\"}}" --dataset-grouping name="ResourceGroup" type="Dimension" --timeframe "TheLastMonth" --scope "subscriptions/00000000-0000-0000-0000-000000000000"

必需参数

--scope

与查询和导出操作相关联的作用域。 这包括 "/subscriptions/{subscriptionId}/" (对于订阅范围) "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}" (对于资源组作用域为 "/providers/Microsoft.Management/managementGroups/{managementGroupId}")。

--timeframe

用于拉取查询数据的时间范围。如果是自定义的,则必须提供特定时间段。

接受的值: BillingMonthToDate, Custom, MonthToDate, TheLastBillingMonth, TheLastMonth, WeekToDate
--type

查询的类型。

接受的值: ActualCost, AmortizedCost, Usage

可选参数

--dataset-aggregation

要在查询中使用的聚合表达式的字典。 字典中每个项的键是聚合列 aliasfor。 查询最多可以有2个聚合子句。 预期值: json-string/@json-file 。

--dataset-configuration

包含导出中数据的配置信息。 如果提供了聚合和分组,则将忽略配置。 预期值:列 = xx。

--dataset-filter

具有要在查询中使用的筛选表达式。 预期值: json-string/@json-file 。

--dataset-grouping

要在查询中使用的 group by 表达式的数组。 查询最多可以有2个 group by 子句。预期值: KEY1 = VALUE1 KEY2 = VALUE2 ...,可用键为: type,name。

--time-period

具有用于请求查询数据的时间段。 预期值: from = TIMESTAMP1 = TIMESTAMP2。 时间戳格式类似于 2020-05-01T00:00:00。