以前使用 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 | 在适当的情况下，继续使用“频率”和“期限”字段。 |