Generate Reservation Details Report - By Billing Account Id
根據註冊標識碼,以異步方式產生所提供日期範圍的保留詳細數據報告。保留使用量詳細數據只能由特定企業角色檢視。 如需角色的詳細資訊,請參閱 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 |
---|---|---|---|---|
billing
|
path | True |
string |
註冊標識碼 (舊版 BillingAccount 識別碼) |
api-version
|
query | True |
string |
用於此作業的 API 版本。 |
end
|
query | True |
string |
結束日期 |
start
|
query | True |
string |
開始日期 |
回應
名稱 | 類型 | Description |
---|---|---|
200 OK |
要求處理已完成。 |
|
202 Accepted |
已接受。 將會處理要求。 使用位置標頭來檢查狀態。 標題
|
|
Other Status Codes |
描述作業失敗原因的錯誤回應。 |
安全性
azure_auth
Azure Active Directory OAuth2 Flow。
類型:
oauth2
Flow:
implicit
授權 URL:
https://login.microsoftonline.com/common/oauth2/authorize
範圍
名稱 | Description |
---|---|
user_impersonation | 模擬您的用戶帳戶 |
範例
ReservationDetails
範例要求
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
範例回覆
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": "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 |
---|---|
Error |
錯誤的詳細數據。 |
Error |
錯誤回應表示服務無法處理傳入要求。 錯誤訊息中提供了原因。 某些錯誤回應:
|
Operation |
長時間執行作業的狀態。 |
Operation |
長時間執行作業的狀態。 |
Reservation |
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 |
錯誤的詳細數據。 |
OperationStatus
長時間執行作業的狀態。
名稱 | 類型 | Description |
---|---|---|
properties.reportUrl |
reportUrl Blob 連結中的 CSV 檔案包含保留使用量數據,具有下列每日數據粒度的架構 |
|
properties.validUntil |
string |
報表 URL 變成無效的時間。 |
status |
長時間執行作業的狀態。 |
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 |