从消费市场 API 迁移

本文讨论如何从消耗市场 API 迁离。升级的解决方案现已推出，提供增强的功能和改进的性能。建议客户转换到这些更新的替代项，以获得最佳结果。

本文仅适用于具有企业协议或 MSDN、即用即付或Visual Studio订阅的客户。

迁移目标

我们已将Azure 市场和Azure使用情况记录合并到单个使用情况详细信息数据集中。在选择适合工作负载的解决方案之前，请阅读选择成本详细信息解决方案一文。一般情况下，如果有持续的数据引入需求或大型每月使用情况详细信息数据集，建议使用导出。有关详细信息，请参阅导入使用明细数据。

如果使用情况详细信息数据集较小或场景不满足导出的条件，请考虑改用成本详细信息报告。有关详细信息，请参阅按需获取小型成本数据集。

注意

Cost Details 报表仅适用于具有企业协议或Microsoft 客户协议的客户。如果您拥有 MSDN、按需付费或 Visual Studio 订阅，您可以迁移到导出功能，或继续使用使用情况详细信息 API。

与耗使用情况详细信息 API 相比，新解决方案提供了许多优势。摘要如下：

所有使用情况详细信息的单一数据集 - Azure 和 Azure 市场使用情况详细信息合并到一个数据集中。它减少了您为查看所有费用而需要调用的 API 计数。
可扩展性 - Marketplaces API 已弃用，因为它支持的调用模式无法随着 Azure 使用量的增加而扩展。随着将更多资源部署到云中，使用情况详细信息数据集可能会变得非常大。市场 API 是一个分页同步 API，因此它没有经过优化，无法通过网络高效可靠地有效传输大量数据。导出与成本详细信息报告异步进行。它们提供可通过网络直接下载的 CSV 文件。
API 改进 - 导出和成本详细信息 API 是 Azure 未来支持的解决方案。所有新功能都集成到其中。
架构一致性 - 成本详细信息API 和导出过程提供具有匹配字段的文件，使你可以根据自己的情况在不同解决方案间切换。
成本分配集成 - 企业协议和Microsoft 客户协议客户使用导出或成本详细信息API时，可以查看与他们配置的成本分配规则相关的费用。有关成本分配的详细信息，请参阅分配成本。

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

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

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