Generate Reservation Details Report - By Billing Account Id

服務:

Cost Management

API 版本:

2025-03-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?api-version=2025-03-01&startDate={startDate}&endDate={endDate}

URI 參數

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

回應

名稱	類型	Description
200 OK	OperationStatus	Azure 作業已順利完成。
202 Accepted		已接受資源作業。 標題 Location: string
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?api-version=2025-03-01&startDate=2020-01-01&endDate=2020-01-30

範例回覆

狀態碼:

200

{
  "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"
  },
  "status": "Completed"
}

狀態碼:

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

定義

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

ErrorDetails

Object

錯誤的詳細數據。

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

ErrorResponse

Object

錯誤回應表示服務無法處理傳入要求。 錯誤訊息中會提供原因。 \n\n一些錯誤回應：\n\n * 429 TooManyRequests - 請求被限速。 等候 「x-ms-ratelimit-microsoft.consumption-retry-after」 標頭中指定的時間後重試。 \n\n * 503 服務不可用 - 服務暫時無法使用。 等候 「Retry-After」 標頭中指定的時間後重試。

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

OperationStatus

Object

長時間執行作業的狀態。

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

OperationStatusType

列舉型別

Enum 代表非同步操作的狀態。

值	Description
Running
Completed
Failed

ReservationReportSchema

列舉型別

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

值	Description
InstanceFlexibilityGroup
InstanceFlexibilityRatio
InstanceId
Kind
ReservationId
ReservationOrderId
ReservedHours
SkuName
TotalReservedQuantity
UsageDate
UsedHours