从 EA 市场存储费用 API 进行迁移

以前使用 Enterprise Reporting consumption.azure.com API 获取其市场存储费用的 EA 客户需要迁移到替换 Azure 资源管理器 API。 本文可帮助你按照以下说明进行迁移。 它还解释了旧 API 和新 API 之间的协定差异。

注意

所有 Azure 企业报告 API 均已停用。 你应尽快迁移到 Microsoft 成本管理 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 市场和 Azure 使用情况记录合并到单个成本详细信息数据集中。

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

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

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

向服务主体分配权限以调用 API

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

避免使用 Microsoft 消耗市场 API

消耗市场 API 是目前支持 EA 客户的另一终结点。 请勿迁移到此 API。 迁移到导出或成本详细信息 API,如本文档前面所述。 将来将弃用消耗市场 API。

字段差异

下表汇总了从市场 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 在适当的情况下,继续使用“频率”和“期限”字段。