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

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

本文可帮助使用 Azure 企业报告 API 构建了自定义解决方案的开发人员迁移到 Microsoft 成本管理 API。 新的成本管理 API 中提供了服务主体支持,并且这些 API 仍在积极开发中。 请考虑停止使用旧 Azure 企业报告 API,以迁移到这些新的 API。 旧 API 将被弃用。 本文可帮助你了解 Azure 企业报告 API 与成本管理 API 之间的差异、迁移到成本管理 API 时应发生的情况,以及成本管理 API 提供的新功能。

API 差异

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

用途 Azure 企业报告 API Microsoft 成本管理 API
身份验证 企业协议 (EA) 门户中预配的 API 密钥 使用用户令牌或服务主体的 Azure Active Directory (Azure AD) 身份验证。 服务主体取代了 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 的客户,建议使用这种解决方案。

后续步骤