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

从 Azure 企业报告迁移到 Microsoft 成本管理 API 概述

  • 项目

本文向使用 Azure Enterprise 报告 API 构建了自定义解决方案的开发人员通报重要更改。 较新的 Microsoft 成本管理 API 现在提供增强型功能和对服务主体的支持，使它们成为项目更可靠的选择。

要点：

  • 建议迁移 - 强烈建议你考虑将自定义解决方案迁移到 Microsoft 成本管理 API。 它们正在积极开发中，提供改进的功能。
  • 停用日期 - Azure Enterprise 报告 API 将于 2024 年 5 月 1 日停用。 在此日期之后，API 将停止响应请求。

本文提供：

  • Azure Enterprise 报告 API 和成本管理 API 之间的差异的概述。
  • 有关迁移到成本管理 API 时预期会出现的结果的指南。
  • 深入了解成本管理 API 提供的新功能。

行动号召：

  • 为了确保顺利过渡，我们鼓励你在停用日期之前尽早开始计划向成本管理 API 的迁移。

API 差异

以下信息描述了旧 Azure 企业报告 API 与新的成本管理 API 之间的差异。

用途 Azure 企业报告 API Microsoft 成本管理 API
身份验证 在 Azure 门户中预配的 API 密钥 使用用户令牌或服务主体的 Microsoft Entra 身份验证。 服务主体取代了 API 密钥。
范围和权限 所有请求都处于注册范围内。 API 密钥权限分配将确定是否返回整个注册、某个部门或某个特定帐户的数据。 无用户身份验证。 为用户或服务主体分配了对注册、部门或帐户范围的访问权限。
URI 终结点 https://consumption.azure.com https://management.azure.com
开发状态 处于维护模式。 即将弃用。 在积极开发中
可用 API 仅限于当前可用的内容 可使用等效的 API 替换每个 EA API。 还提供了其他成本管理 API，其中包括：
- 预算
- 警报
- 导出

迁移核对清单

  • 熟悉 Azure 资源管理器 REST API。
  • 在从 Azure 企业报告迁移到 Microsoft 成本管理 API 中确定所使用的企业报告 API 并查看要移动到的成本管理 API。
  • 为成本管理 API 配置服务授权和身份验证。 有关详细信息，请参阅向 ACM API 分配权限。
  • 测试 API，然后更新任何编程代码，将企业报告 API 调用替换为成本管理 API 调用。
  • 更新错误处理，以使用新的错误代码。 部分注意事项包括：
    • 成本管理 API 的超时期限为 60 秒。
    • 成本管理 API 设置了速率限制。 如果超过了速率，将导致 429 throttling error。 构建解决方案，以便在短时间内不会进行太多的 API 调用。
  • 查看通过 Azure 资源管理器提供的其他成本管理 API，并评估以备后用。 有关详细信息，请参阅从 Azure 企业报告迁移到 Microsoft 成本管理 API。

企业报告 API 到新成本管理 API 的映射

使用以下信息来确定当前使用的企业报告 API，以及要改用的替代成本管理 API。

方案 企业报告 API 成本管理 API
从 EA 使用情况详细信息 API 迁移 /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 对所有定期数据引入工作负载使用 Microsoft.CostManagement/Exports。
对小型按需数据集使用成本详细信息报表。
从 EA 余额摘要 API 迁移 /balancesummary Microsoft.Consumption/balances
从 EA 价目表 API 迁移 /pricesheet 对于协商价格，请使用 Microsoft.Consumption/pricesheets/default
对于零售价格，请使用零售价格 API
从 EA 预留实例使用量详细信息 API 迁移 /reservationdetails Microsoft.CostManagement/generateReservationDetailsReport
从 EA 预留实例使用量摘要 API 迁移 /reservationsummaries Microsoft.Consumption/reservationSummaries
从 EA 预留实例建议 API 迁移 /SharedReservationRecommendations
/SingleReservationRecommendations		 Microsoft.Consumption/reservationRecommendations
从 EA 预留实例费用 API 迁移 /reservationcharges Microsoft.Consumption/reservationTransactions

使用其他成本管理 API

在现有报告方案中迁移到成本管理 API 后，也可以使用许多其他 API。 还可以通过 Azure 资源管理器获取这些 API，并使用基于服务主体的身份验证自动执行这些 API。 以下是可以使用的新功能的快速摘要。

  • 预算 - 用于设置阈值，以主动监视成本、提醒相关利益干系人，以及根据阈值违反情况自动执行操作。
  • 警报 - 用于查看警报信息，包括但不限于预算警报、账单警报、信用警报和配额警报。
  • 导出 - 用于计划将费用数据定期导出到所选的 Azure 存储帐户。 对于需要分析数据并将其用于自己的内部系统且大量使用 Azure 的客户，建议使用这种解决方案。

后续步骤