Generate Reservation Details Report - By Billing Account Id

Service:

Cost Management

API Version:

2023-11-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=2023-11-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		已接受。 將會處理要求。 使用位置標頭來檢查狀態。 Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow。

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

範例

ReservationDetails

Sample Request

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=2023-11-01

Sample Response

Status code:

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

Status code:

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