从 EA Marketplace 商店收费 API 迁移

以前通过企业报告 consumption.azure.com API 获取其市场费用的 EA 客户需要迁移到替换的 Azure Resource Manager API。本文可帮助你按照以下说明进行迁移。它还解释了旧 API 和新 API 之间的协定差异。

注意

所有Azure企业报告 API 都已停用。应尽快迁移到Microsoft Cost Management API接口。

要停止使用的终结点：

端点	API 注释
`/v3/enrollments/{enrollmentNumber}/marketplacecharges`	• API 方法：GET • 同步（非轮询） • 数据格式：JSON
`/v3/enrollments/{enrollmentNumber}/billingPeriods/{billingPeriod}/marketplacecharges`	• API 方法：GET • 同步（非轮询） • 数据格式：JSON
`/v3/enrollments/{enrollmentNumber}/marketplacechargesbycustomdate?startTime=2017-01-01&endTime=2017-01-10`	• API 方法：GET • 同步（非轮询） • 数据格式：JSON

新解决方案正式发布

我们将Azure Marketplace和Azure使用情况记录合并到单个成本详细信息数据集中。

下表提供了可用迁移目标的摘要，以及选择哪种解决方案最适合时要考虑的事项摘要。

解决方案	目的	注意事项	入职详细信息
导出	按设定计划将周期性数据转储到存储设备中	• 适合你工作负载的最具可缩放性的解决方案。 • 可配置为对更大的数据集使用文件分区。 • 非常适合建立和增加可与你自己的可查询数据存储集成的成本数据集。 • 需要具有对可以保存数据的存储帐户的访问权限。	• 在 Azure 门户中配置使用 API 自动创建导出 • 导出 API 参考
成本详细信息 API	按需下载	• 适用于小型成本数据集。 • 对于由于安全性或可管理性问题，导出到Azure存储不可行的情况非常有用。	• 按需获取小型成本数据集 • 成本详细信息 API

如果有持续的数据引入需求或大量的每月成本详细信息数据集，我们建议使用导出。有关详细信息，请参阅引入成本详细信息数据。如果需要其他信息来帮助你为工作负载做出决策，请参阅选择成本详细信息解决方案。

在调用 API 之前，需要配置具有正确权限的服务主体。使用服务主体调用 API。有关详细信息，请参阅向成本管理 API 分配权限。

目前支持 EA 客户的另一个终端接口是 Consumption Marketplaces API。请勿迁移到此 API。请迁移到“导出功能”或“成本详细信息应用程序接口”，如本文档前面所述。将来将弃用消耗市场 API。

下表汇总了从市场 API 提供的数据转换到导出和成本详细信息 API 所需的字段映射。这两种解决方案都提供 CSV 文件下载，而不是通过消费 API 提供的分页形式的 JSON 响应。

使用情况记录可以通过 PublisherType 字段识别为组合数据集中的市场记录。此外，更新的解决方案中有许多新字段可能对你有用。有关可用字段的详细信息，请参阅了解使用情况详细信息字段。

旧属性	新属性	备注
	发布者类型	用于标识市场使用情况记录
账户名称	账户名称
附加属性	附加信息
成本中心	CostCenter
部门名称	BillingProfileName
账单周期编号		使用 BillingPeriodStartDate/BillingPeriodEndDate
usageStart		使用日期
usageEnd		使用日期
instanceName	资源名称
instanceId	ResourceId
货币	账单货币代码
消耗量	数量
税前成本	以计费货币计算的成本
是否估计		不可用
meterId	计量标识
offer名称	优惠编号
resourceGroup	ResourceGroup
订单号		不可用
出版商名称	出版社名称
计划名称	计划名称
资源使用率	EffectivePrice
订阅指南	SubscriptionId（订阅ID）
订阅名称	订阅名称
计量单位	度量单位
是否是周期性收费		在适当的情况下，继续使用“频率”和“期限”字段。