从 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 的客户,建议使用这种解决方案。
相关内容
- 熟悉 Azure 资源管理器 REST API。
- 如果需要,在从 Azure 企业报告迁移到 Microsoft 成本管理 API 中确定所使用的企业报告 API 并查看要移动到的成本管理 API。
- 如果你未曾用过 Azure 资源管理器 API,请将客户端应用注册到 Microsoft Entra ID。
- 请根据需要更新任何编程代码,以对服务主体使用 Microsoft Entra 身份验证。