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

通过自动化功能管理成本

项目
12/12/2023

可以使用成本管理自动化生成一组自定义解决方案来检索和管理成本数据。本文介绍成本管理自动化的常见方案以及根据你的情况提供的选项。如果要使用 API 进行开发，则提供了常见的 API 请求示例来帮助加速开发过程。

实现成本数据检索的自动化以进行脱机分析

可能需要下载 Azure 成本数据以将其与其他数据集合并。或者，可能需要将成本数据集成到你自己的系统中。根据所涉及的数据量，可以使用不同的选项。在任何情况下，都必须在适当范围内拥有成本管理权限，才能使用 API 和工具。有关详细信息，请参阅向数据分配访问权限。

处理大型数据集的建议

如果组织在多个资源或订阅中存在大量的 Azure 状态，你将获得大量的使用情况详细信息数据结果。 Excel 通常无法加载此类大型文件。在这种情况下，我们建议使用以下选项：

Power BI

Power BI 用于引入和处理大量数据。如果你是企业协议客户，则可以使用 Power BI 模板应用来分析计费帐户的成本。报表包含客户使用的重要视图。有关详细信息，请参阅使用 Power BI 模板应用分析 Azure 成本。

Power BI 数据连接器

如果要每天分析数据，我们建议使用 Power BI 数据连接器获取详细分析的数据。该连接器会将你创建的任何报表都保持为最新状态，这会产生更多的费用。

成本管理导出

可能不需要每天分析数据。如果是这样，请考虑使用成本管理的导出功能，计划将数据导出到 Azure 存储帐户。然后，可以根据需要将数据加载到 Power BI 中，如果文件足够小，则在 Excel 中进行分析。 Azure 门户中提供了导出功能，或者可以使用导出 API 配置导出。

使用情况详细信息 API

如果有少量成本数据集，请考虑使用使用情况详细信息 API。下面是建议的最佳做法：

如果需要获取最新成本数据，建议每天最多查询一次。报告每四小时刷新一次。如果更频繁地调用，则会收到相同的数据。
在为历史发票下载成本数据后，除非明确收到通知，否则费用不会更改。建议在某个可查询的存储中缓存成本数据，以防止对相同数据的重复调用。
将调用拆分为较小的日期范围，以获取可下载的更易管理的文件。例如，如果你每月的 Azure 使用情况文件都很大，建议按天或按周来分块。
如果你有包含大量使用情况数据的范围（例如计费帐户），请考虑将多个调用置于子范围内，以便获得可以下载的更易于管理的文件。
如果数据集每月都超过 2 GB，请考虑使用导出作为更可缩放的解决方案。

使用使用情况详细信息 API 实现检索的自动化

借助使用情况详细信息 API，可以轻松地获取与 Azure 帐单相对应的原始、未聚合的成本数据。当你的组织需要编程数据检索解决方案时，API 非常有用。如果要分析较小的成本数据集，请考虑使用 API。但是，如果你有更大的数据集，则应使用以前确定的其他解决方案。使用情况详细信息中的数据每天按计量提供。计算每月帐单时使用此方法。这些 API 的正式发布版 (GA) 是 2019-10-01。使用 2019-04-01-preview 通过 API 访问预留和 Azure 市场购买的预览版本。

如果要定期获取大量导出的数据，请参阅使用导出功能定期检索大型成本数据集。

使用情况详细信息 API 建议

请求计划

我们建议每天向使用情况详细信息 API 发出的请求不超过一个。有关成本数据的刷新频率以及如何处理舍入的详细信息，请参阅了解成本管理数据。

无筛选的目标顶级范围

使用 API 在可用的最高级别范围内获取所需的所有数据。请等到引入所有所需数据，再执行任何筛选、分组或聚合分析。 API 专门进行了优化，以提供大量未聚合的原始成本数据。若要详细了解成本管理中提供的范围，请参阅了解并使用范围。下载某个范围的所需数据后，便可使用 Excel 通过筛选器和透视表进一步分析数据。

有关定价的说明

如果要将使用情况和费用与价目表或发票进行协调，请参阅成本详细信息中的定价行为。

单个资源一天内可能有多条记录

Azure 资源提供程序向计费系统发出使用情况和费用，并填充使用情况记录的 Additional Info 字段。有时，资源提供程序可能会发出给定的某一天的使用情况，并在使用情况记录的 Additional Info 字段中标记不同数据中心的记录。这可能会导致一天内的使用情况文件中显示一个计量/资源的多条记录。在此情况下，不会向你额外收取费用。多条记录表示那一天资源的计量的全部费用。

示例使用情况详细信息 API 请求

Microsoft 客户使用以下示例请求来解决你可能遇到的常见情况。

获取特定日期范围内范围的使用情况详细信息

请求返回的数据对应于计费系统收到使用情况的日期。其中可能包含多张发票的费用。所用调用因订阅类型而异。

对于具有企业协议 (EA) 或即用即付订阅的旧客户，请使用以下调用：

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?$filter=properties%2FusageStart%20ge%20'2020-02-01'%20and%20properties%2FusageEnd%20le%20'2020-02-29'&$top=1000&api-version=2019-10-01

对于具有 Microsoft 客户协议的新客户，请使用以下调用：

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?startDate=2020-08-01&endDate=2020-08-05&$top=1000&api-version=2019-10-01

注意

Microsoft 客户协议不支持 $filter 参数。

获取摊销成本详细信息

如果需要实际成本，以便将购买显示为应记项，则请在以下请求中将 metric 更改为 ActualCost。若要使用摊销成本和实际成本，则必须使用 2019-04-01-preview 版本。当前 API 版本的工作方式与 2019-10-01 版本相同，新的 type/metric 特性和已更改的属性名称除外。如果你有 Microsoft 客户协议，则筛选器在以下示例中为 startDate 和 endDate。

GET https://management.azure.com/{scope}/providers/Microsoft.Consumption/usageDetails?metric=AmortizedCost&$filter=properties/usageStart+ge+'2019-04-01'+AND+properties/usageEnd+le+'2019-04-30'&api-version=2019-04-01-preview

通过预算自动发出警报和执行操作

可通过以下两个组件最大化云投资价值。一个是自动创建预算。另一个是配置基于成本的业务流程，以应对预算警报。有不同的方法可以自动创建预算。超过配置的警报阈值时，会发生各种警报响应。

以下各节介绍了可用选项，并提供了示例 API 请求，以帮助你开始使用预算自动化。

如何根据预算限额计算成本

每天根据预算限额计算一次成本。创建新预算或在预算重置日时，与限额相比的成本为零/Null，因为可能没有进行计算。

当 Azure 检测到你的成本已超过阈值时，系统将在检测期间的一小时内触发通知。

查看当前成本

若要查看当前成本，需要使用查询 API 进行 GET 调用。

对预算 API 的 GET 调用不返回“成本分析”中显示的当前成本。相反，此调用返回上次计算的成本。

自动创建预算

可以使用预算 API 自动创建预算。你也可以使用预算模板创建预算。模板是使 Azure 部署标准化同时确保适当配置和强制实施成本控制的简单方法。

预算警报电子邮件支持的区域设置

设定预算后，将在超过设定的限额时向你发出警报。每个预算最多可设置五个电子邮件收件人。收件人在超过预算限额后 24 小时内收到电子邮件警报。不过，收件人可能需要接收以其他语言编写的电子邮件。可以将以下语言区域性代码用于预算 API。使用 locale 参数设置区域性代码，如以下示例所示。

{
  "eTag": "\"1d681a8fc67f77a\"",
  "properties": {
    "timePeriod": {
      "startDate": "2020-07-24T00:00:00Z",
      "endDate": "2022-07-23T00:00:00Z"
    },
    "timeGrain": "BillingMonth",
    "amount": 1,
    "currentSpend": {
      "amount": 0,
      "unit": "USD"
    },
    "category": "Cost",
    "notifications": {
      "actual_GreaterThan_10_Percent": {
        "enabled": true,
        "operator": "GreaterThan",
        "threshold": 20,
        "locale": "en-us",
        "contactEmails": [
          "user@contoso.com"
        ],
        "contactRoles": [],
        "contactGroups": [],
        "thresholdType": "Actual"
      }
    }
  }
}

区域性代码支持的语言：

区域性代码	语言
zh-cn	英语（美国）
ja-jp	日语（日本）
zh-cn	中文（简体，中国）
de-de	德语(德国)
es-es	西班牙语（西班牙，国际）
fr-fr	法语(法国)
it-it	意大利语（意大利）
ko-kr	韩语(韩国)
pt-br	葡萄牙语(巴西)
ru-ru	俄语（俄罗斯）
zh-tw	中文（繁体，台湾）
cs-cz	捷克语（捷克共和国）
pl-pl	波兰语（波兰）
tr-tr	土耳其语 (Türkiye)
da-dk	丹麦语（丹麦）
en-gb	英语（英国）
hu-hu	匈牙利语(匈牙利)
nb-no	挪威博克马尔语（挪威）
nl-nl	荷兰语（荷兰）
pt-pt	葡萄牙语(葡萄牙)
sv-se	瑞典语（瑞典）

常见预算 API 配置

可以通过多种方法在 Azure 环境中配置预算。首先考虑方案，然后确定启用该方案的配置选项。查看以下选项：

时间粒度 - 表示预算用于累积和计算成本的重复周期。最常用的选项是“每月”、“每季度”和“每年”。
时间段 - 表示预算有效期。仅当预算仍然有效时，系统才会主动监控预算并向你发出通知。
通知
- 联系电子邮件 - 当预算累积成本且超过定义的阈值时，电子邮件地址会收到警报。
- 联系角色 - 在给定范围内具有匹配的 Azure 角色的所有用户都会收到带有此选项的电子邮件警报。例如，订阅所有者可能会收到在订阅范围内创建的预算警报。
- 联系人组 - 超出警报阈值时，预算将调用已配置的操作组。
成本维度筛选器 - 可以通过成本分析或查询 API 进行的筛选，也可以对预算进行。使用此筛选器，可以缩小对于预算要监视的成本范围。

确定满足你需求的预算创建选项后，请使用 API 创建预算。以下示例可帮助你开始使用常见预算配置。

创建筛选到多种资源和标记的预算

请求 URL：PUT https://management.azure.com/subscriptions/{SubscriptionId} /providers/Microsoft.Consumption/budgets/{BudgetName}/?api-version=2019-10-01

{
  "eTag": "\"1d34d016a593709\"",
  "properties": {
    "category": "Cost",
    "amount": 100.65,
    "timeGrain": "Monthly",
    "timePeriod": {
      "startDate": "2017-10-01T00:00:00Z",
      "endDate": "2018-10-31T00:00:00Z"
    },
    "filter": {
      "and": [
        {
          "dimensions": {
            "name": "ResourceId",
            "operator": "In",
            "values": [
              "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{meterName}",
              "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{meterName}"
            ]
          }
        },
        {
          "tags": {
            "name": "category",
            "operator": "In",
            "values": [
              "Dev",
              "Prod"
            ]
          }
        },
        {
          "tags": {
            "name": "department",
            "operator": "In",
            "values": [
              "engineering",
              "sales"
            ]
          }
        }
      ]
    },
    "notifications": {
      "Actual_GreaterThan_80_Percent": {
        "enabled": true,
        "operator": "GreaterThan",
        "threshold": 80,
        "contactEmails": [
          "user1@contoso.com",
          "user2@contoso.com"
        ],
        "contactRoles": [
          "Contributor",
          "Reader"
        ],
        "contactGroups": [
          "/subscriptions/{subscriptionID}/resourceGroups/{resourceGroupName}/providers/microsoft.insights/actionGroups/{actionGroupName}
        ],
        "thresholdType": "Actual"
      }
    }
  }
}

为预算警报配置基于成本的业务流程

可以配置预算以使用 Azure 操作组启动自动执行操作。要了解有关使用预算自动化操作的更多信息，请参阅使用预算自动化。

数据延迟和速率限制

我们建议每天调用 API 的次数不超过一次。从 Azure 资源提供程序接收新的使用情况数据时，每隔 4 小时刷新一次成本管理数据。更频繁地调用并不会提供更多数据。相反，它会导致负载增加。

查询 API 查询处理单位

除了现有的速率限制流程外，查询 API 还会根据 API 调用的成本限制处理。 API 调用的成本表示为查询处理单位 (QPU)。 QPU 是一种性能货币，例如 Cosmos DB RU。它们将系统资源抽象化，如 CPU 和内存。

QPU 计算

目前，从分配的配额中查询 1 个月的数据，将扣除 1 个 QPU。此逻辑可能会更改，恕不另行通知。

QPU 因素

以下因素会影响 API 请求消耗的 QPU 数量。

日期范围，随着请求中日期范围的增加，消耗的 QPU 数量也随之增加。

可能会添加其他 QPU 因素，恕不另行通知。

QPU 配额

为每个租户配置了以下配额。当以下任何配额用尽时，请求将受到限制。

每 10 秒 12 个 QPU
每 1 分钟 60 个 QPU
每 1 小时 600 个 QPU

可能会根据需要更改配额，并且可以添加更多配额。

响应头

可以检查响应头，以跟踪 API 请求所消耗的 QPU 数量和剩余的 QPU 数量。

x-ms-ratelimit-microsoft.costmanagement-qpu-retry-after

指示回退时间（以秒为单位）。当请求被限制为 429 时，请先回退到此标头中指定的时间，然后再重试请求。

x-ms-ratelimit-microsoft.costmanagement-qpu-consumed

API 调用所消耗的 QPU。

x-ms-ratelimit-microsoft.costmanagement-qpu-remaining

剩余配额列表。