Compartilhar via

从 Azure Enterprise Reporting 迁移到 Microsoft 成本管理 API 概述

本文告知已使用 Azure Enterprise Reporting API 构建自定义解决方案的开发人员关于一些重要更改的信息。 较新的Microsoft 成本管理 API 现在为服务主体提供增强的功能和支持，使它们成为项目更可靠的选择。

要点：

  • 建议迁移 - 强烈建议考虑将自定义解决方案迁移到Microsoft 成本管理 API。 它们正在积极开发中，提供改进的功能。
  • 停用日期 - 所有Azure企业报告 API 停用。

本文提供：

  • 概述Azure企业报告 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。
  • 确定您正在使用哪些企业报告 API，并查看可迁移到的成本管理 API，详细信息请参阅从 Azure 企业报告迁移到 Microsoft 成本管理 API。
  • 为成本管理 API 配置服务授权和身份验证。 有关详细信息，请参阅向 ACM API 分配权限。
  • 测试 API，然后更新任何编程代码，将企业报告 API 调用替换为成本管理 API 调用。
  • 更新错误处理，以使用新的错误代码。 部分注意事项包括：
    • 成本管理 API 的超时期限为 60 秒。
    • 成本管理 API 设置了速率限制。 如果速率被超出，结果是 429 throttling error。 构建解决方案，以便在短时间内不会进行太多的 API 调用。
  • 查看通过Azure 资源管理器提供的其他成本管理 API，并评估供以后使用。 有关详细信息，请参阅从 Azure Enterprise Reporting 到 Microsoft 成本管理 API 的 Migrate。

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

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

场景 企业报告生成接口API 成本管理 API
从 EA 使用情况详细信息 API 迁移 /usagedetails/download
/usagedetails/submit
/usagedetails
/usagedetailsbycustomdate		 使用 Microsoft.CostManagement/Exports 处理所有定期数据引入的工作负荷。
对小型按需数据集使用成本详细信息报表。
从 EA 余额摘要 API 迁移 /balancesummary Microsoft。消耗/余额
从 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。 这些 API 也可通过Azure 资源管理器使用，并且可以使用基于服务主体的身份验证进行自动化。 以下是可以使用的新功能的快速摘要。

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

相关内容

  • Last updated on