分享方式:


從 EA 保留執行個體使用量摘要 API 移轉

先前使用 Enterprise 報表 consumption.azure.com API 取得保留執行個體使用量摘要的 EA 客戶,需要移轉到同位 Azure Resource Manager API。 下列指示可協助您移轉和討論舊 API 與新 API 之間的任何合約差異。

注意

所有 Azure 企業報告 API 都會淘汰。 您應該儘快移轉至 Microsoft 成本管理 API

將許可權指派給服務主體以呼叫 API

呼叫 API 之前,您必須使用正確的權限設定服務主體。 您可以使用服務主體呼叫 API。 如需詳細資訊,請參閱 將許可權指派給成本管理 API

呼叫保留執行個體使用量摘要 API

使用下列要求 URI 來呼叫新的保留摘要 API。

支援的要求

使用下列範圍來呼叫 API:

  • 註冊:providers/Microsoft.Billing/billingAccounts/{billingAccountId}

取得每日保留摘要

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2023-05-01 

取得每月保留摘要

https://management.azure.com/{scope}/Microsoft.Consumption/reservationSummaries?grain=daily&$filter=properties/usageDate ge 2017-10-01 AND properties/usageDate le 2017-11-20&api-version=2023-05-01 

回應主題變更

舊回應

[
     {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_F1s",
        "reservedHours": 24,
        "usageDate": "2018-05-01T00:00:00",
        "usedHours": 23,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 95.83,
        "maxUtilizationPercentage": 100
    }
]

新回應

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/12345/providers/Microsoft.Consumption/reservationSummaries/reservationSummaries_Id1",
      "name": "reservationSummaries_Id1",
      "type": "Microsoft.Consumption/reservationSummaries",
      "tags": null,
      "properties": {
        "reservationOrderId": "00000000-0000-0000-0000-000000000000",
        "reservationId": "00000000-0000-0000-0000-000000000000",
        "skuName": "Standard_B1s",
        "reservedHours": 720,
        "usageDate": "2018-09-01T00:00:00-07:00",
        "usedHours": 0,
        "minUtilizationPercentage": 0,
        "avgUtilizationPercentage": 0,
        "maxUtilizationPercentage": 0
      }
    }
  ]
}