通过

从 EA 预留实例使用量详细信息 API 迁移

  • 项目

以前使用 Enterprise Reporting consumption.azure.com API 获取预留实例使用量详细信息的 EA 客户需要迁移到奇偶校验 Azure 资源管理器 API。 以下说明可帮助你迁移和讨论旧 API 与新 API 之间的任何协定差异。

注意

所有 Azure 企业报告 API 均已停用。 你应尽快迁移到 Microsoft 成本管理 API。

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

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

调用预留实例使用量详细信息 API

Microsoft 不会更新旧的基于同步的预留详细信息 API。 建议你在迁移过程中切换为更新的支持 SPN 的异步 API 调用模式。 异步请求可更好地处理大量数据，并减少超时错误。

支持的请求

在调用新的异步预留详细信息 API 时，请使用以下请求 URI。 你的注册号应用作 billingAccountId。 可以使用以下范围调用 API：

注册：providers/Microsoft.Billing/billingAccounts/{billingAccountId}

按计费帐户 ID 生成报表

生成预留详细信息报告的示例请求

POST https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate={startDate}&endDate={endDate}&api-version=2023-11-01

POST 请求返回位置以轮询报告生成状态，如以下响应中所述：

示例响应

状态代码 202

Location: https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2023-11-01
Retry-After: 60

状态代码 200

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.chinacloudapi.cn/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

轮询报告生成状态的示例请求

GET https://management.chinacloudapi.cn/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01

示例轮询响应

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.chinacloudapi.cn/details/20200911/00000000-0000-0000-0000-000000000000?sv=2016-05-31&sr=b&sig=jep8HT2aphfUkyERRZa5LRfd9RPzjXbzB%2F9TNiQ",
    "validUntil": "2020-09-12T02:56:55.5021869Z"
  }
}

响应正文更改

以下信息是旧版基于同步的预留详细信息 API 的响应示例。

旧响应：

{
    "reservationOrderId": "00000000-0000-0000-0000-000000000000",
    "reservationId": "00000000-0000-0000-0000-000000000000",
    "usageDate": "2018-02-01T00:00:00",
    "skuName": "Standard_F2s",
    "instanceId": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/resourvegroup1/providers/microsoft.compute/virtualmachines/VM1",
    "totalReservedQuantity": 18.000000000000000,
    "reservedHours": 432.000000000000000,
    "usedHours": 400.000000000000000
}

新响应：

新 API 可为你创建 CSV 文件。 请参阅以下文件字段。

旧属性 新属性 说明
InstanceFlexibilityGroup 新的实例大小灵活性属性。
InstanceFlexibilityRatio 新的实例大小灵活性属性。
instanceId InstanceName
类型 这是一个新属性。 值为 None、Reservation 或 IncludedQuantity。
reservationId 预订 ID
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

相关内容