从消耗市场 API 迁移

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

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

迁移目标

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

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

注意

成本详细信息报告仅适用于具有企业协议或 Microsoft 客户协议的客户。如果你有 MSDN、即用即付或 Visual Studio 订阅，则可以迁移到导出或使用消耗使用情况详细信息 API 继续。

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

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

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

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

旧属性	新属性	备注
	PublisherType	用于标识市场使用情况记录
accountName	AccountName
additionalProperties	AdditionalInfo
costCenter	CostCenter
departmentName	BillingProfileName
billingPeriodId		使用 BillingPeriodStartDate/BillingPeriodEndDate
usageStart		使用日期
usageEnd		使用日期
INSTANCENAME	ResourceName
instanceId	ResourceId
currency	BillingCurrencyCode
consumedQuantity	数量
pretaxCost	CostInBillingCurrency
isEstimated		不可用
meterId	计量 ID
offerName	OfferId
resourceGroup	ResourceGroup
orderNumber		不可用
publisherName	PublisherName
planName	PlanName
resourceRate	EffectivePrice
subscriptionGuid	SubscriptionId
subscriptionName	SubscriptionName
unitOfMeasure	UnitOfMeasure
isRecurringCharge		在适当的情况下，继续使用“频率”和“期限”字段。