Generate Reservation Details Report - By Billing Account Id

Service:

Cost Management

API Version:

2023-11-01

登録 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 パラメーター

名前	/	必須	型	説明
billingAccountId	path	True	string	登録 ID (レガシ BillingAccount ID)
api-version	query	True	string	この操作に使用する API バージョン。
endDate	query	True	string	終了日
startDate	query	True	string	開始日

応答

名前	型	説明
200 OK	OperationStatus	要求処理が完了しました。
202 Accepted		受理されました。 要求が処理されます。 location ヘッダーを使用して、状態をチェックします。 Headers Location: string Retry-After: integer
Other Status Codes	ErrorResponse	操作に失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

Scopes

名前	説明
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"
  }
}

定義

名前	説明
ErrorDetails	エラーの詳細。
ErrorResponse	エラー応答は、サービスが受信要求を処理できないことを示します。 理由は、エラー メッセージに表示されます。 いくつかのエラー応答: 429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時間を待ってから再試行します。 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻まで待ってから、再試行してください。
OperationStatus	実行時間の長い操作の状態。
OperationStatusType	実行時間の長い操作の状態。
ReservationReportSchema	reportUrl BLOB リンクの CSV ファイルは、毎日の粒度で次のスキーマを持つ予約使用状況データで構成されます

ErrorDetails

エラーの詳細。

名前	型	説明
code	string	エラー コード。
message	string	操作が失敗した理由を示すエラー メッセージ。

ErrorResponse

エラー応答は、サービスが受信要求を処理できないことを示します。 理由は、エラー メッセージに表示されます。

いくつかのエラー応答:

• 429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時間を待ってから再試行します。

• 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻まで待ってから、再試行してください。

名前	型	説明
error	ErrorDetails	エラーの詳細。

OperationStatus

実行時間の長い操作の状態。

名前	型	説明
properties.reportUrl	ReservationReportSchema	reportUrl BLOB リンクの CSV ファイルは、毎日の粒度で次のスキーマを持つ予約使用状況データで構成されます
properties.validUntil	string	レポート URL が無効になる時刻。
status	OperationStatusType	実行時間の長い操作の状態。

OperationStatusType

実行時間の長い操作の状態。

名前	型	説明
Completed	string
Failed	string
Running	string

ReservationReportSchema

reportUrl BLOB リンクの CSV ファイルは、毎日の粒度で次のスキーマを持つ予約使用状況データで構成されます

名前	型	説明
InstanceFlexibilityGroup	string
InstanceFlexibilityRatio	string
InstanceId	string
Kind	string
ReservationId	string
ReservationOrderId	string
ReservedHours	string
SkuName	string
TotalReservedQuantity	string
UsageDate	string
UsedHours	string