Generate Reservation Details Report - By Billing Account Id

サービス:

Cost Management

API バージョン:

2024-08-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=2024-08-01

URI パラメーター

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

応答

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

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

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

定義

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

ErrorDetails

Object

エラーの詳細。

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

ErrorResponse

Object

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

いくつかのエラー応答:

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

• 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。

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

OperationStatus

Object

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

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

OperationStatusType

列挙

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

値	説明
Completed
Failed
Running

ReservationReportSchema

列挙

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

値	説明
InstanceFlexibilityGroup
InstanceFlexibilityRatio
InstanceId
Kind
ReservationId
ReservationOrderId
ReservedHours
SkuName
TotalReservedQuantity
UsageDate
UsedHours