Generate Reservation Details Report - By Billing Account Id

服務:

Cost Management

API 版本:

2024-08-01

根據註冊標識碼，以異步方式產生所提供日期範圍的保留詳細數據報告。保留使用量詳細數據只能由特定企業角色檢視。 如需角色的詳細資訊，請參閱 https://docs.microsoft.com/en-us/azure/cost-management-billing/manage/understand-ea-roles#usage-and-costs-access-by-role

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

URI 參數

名稱	位於	必要	類型	Description
billingAccountId	path	True	string	註冊識別碼 （舊版 BillingAccount 識別符）
api-version	query	True	string	要用於這項作業的 API 版本。
endDate	query	True	string	結束日期
startDate	query	True	string	開始日期

回應

名稱	類型	Description
200 OK	OperationStatus	要求處理已完成。
202 Accepted		接受。 將會處理要求。 使用位置標頭來檢查狀態。 標題 Location: string Retry-After: integer
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

類型: oauth2
Flow: implicit
授權 URL: https://login.microsoftonline.com/common/oauth2/authorize

範圍

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

ReservationDetails

範例要求

HTTP

POST https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/generateReservationDetailsReport?startDate=2020-01-01&endDate=2020-01-30&api-version=2024-08-01

範例回覆

狀態碼:

202

Location: https://management.azure.com/providers/Microsoft.Billing/billingAccounts/9845612/providers/Microsoft.CostManagement/reservationDetailsOperationResults/cf9f95c9-af6b-41dd-a622-e6f4fc60c3ee?api-version=2019-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"
  }
}

定義

名稱	Description
ErrorDetails	錯誤的詳細數據。
ErrorResponse	錯誤回應表示服務無法處理傳入要求。 錯誤訊息中會提供原因。 某些錯誤回應： 429 TooManyRequests - 要求已節流。 等候 「x-ms-ratelimit-microsoft.consumption-retry-after」 標頭中指定的時間後重試。 503 ServiceUnavailable - 服務暫時無法使用。 等候 「Retry-After」 標頭中指定的時間後重試。
OperationStatus	長時間執行作業的狀態。
OperationStatusType	長時間執行作業的狀態。
ReservationReportSchema	來自 reportUrl Blob 連結的 CSV 檔案是由保留使用量數據所組成，具有每日數據粒度的下列架構

ErrorDetails

錯誤的詳細數據。

名稱	類型	Description
code	string	錯誤碼。
message	string	錯誤訊息，指出作業失敗的原因。

ErrorResponse

錯誤回應表示服務無法處理傳入要求。 錯誤訊息中會提供原因。

某些錯誤回應：

• 429 TooManyRequests - 要求已節流。 等候 「x-ms-ratelimit-microsoft.consumption-retry-after」 標頭中指定的時間後重試。

• 503 ServiceUnavailable - 服務暫時無法使用。 等候 「Retry-After」 標頭中指定的時間後重試。

名稱	類型	Description
error	ErrorDetails	錯誤的詳細數據。

OperationStatus

長時間執行作業的狀態。

名稱	類型	Description
properties.reportUrl	ReservationReportSchema	來自 reportUrl Blob 連結的 CSV 檔案是由保留使用量數據所組成，具有每日數據粒度的下列架構
properties.validUntil	string	報表 URL 無效的時間。
status	OperationStatusType	長時間執行作業的狀態。

OperationStatusType

長時間執行作業的狀態。

名稱	類型	Description
Completed	string
Failed	string
Running	string

ReservationReportSchema

來自 reportUrl Blob 連結的 CSV 檔案是由保留使用量數據所組成，具有每日數據粒度的下列架構

名稱	類型	Description
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string