分享方式：

從 EA 保留執行個體使用量詳細資料 API 移轉

  • 文章

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

注意

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

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

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

呼叫保留執行個體使用量詳細資料 API

Microsoft 不會更新較舊的同步型保留詳細資料 API。 建議您在遷移過程中，移至較新的非同步 API 呼叫模式 (支援 SPN)。 非同步要求會更妥善地處理大量資料，並減少逾時錯誤。

支援的要求

呼叫新的非同步保留詳細資料 API 時，請使用下列要求 URI。 您的註冊號碼應該用來作為 billingAccountId。 您可以使用下列範圍來呼叫 API：

註冊：providers/Microsoft.Billing/billingAccounts/{billingAccountId}

依計費帳戶標識碼產生報告

產生保留詳細資料報告的範例要求

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

POST 要求會傳回位置來輪詢報表產生狀態，如下列回應中所述：

範例回覆

狀態代碼 202

Location: https://management.azure.com/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.windows.net/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.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/providers/Microsoft.CostManagement/reservationDetailsOperationResults/{operationId}?api-version=2023-11-01

範例輪詢回應

{
  "status": "Completed",
  "properties": {
    "reportUrl": "https://storage.blob.core.windows.net/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 ReservationId
reservationOrderId ReservationOrderId
reservedHours ReservedHours
skuName SkuName
totalReservedQuantity TotalReservedQuantity
usageDate UsageDate
usedHours UsedHours

相關內容