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

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

要点

  • 建议迁移 - 强烈建议你考虑将自定义解决方案迁移到 Microsoft 成本管理 API。 它们正在积极开发中,提供改进的功能。
  • 停用日期 - 所有 Azure 企业报告 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.chinacloudapi.cn
开发状态 无,API 已停用。 在积极开发中
可用 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 的客户,建议使用这种解决方案。