Reservation Transactions - List By Billing Profile

リファレンス

サービス:: Consumption

API バージョン:: 2024-08-01

課金プロファイルスコープでの予約インスタンスのトランザクションの一覧。払戻トランザクションは、購入トランザクションと共に転記されます (つまり、購入請求月)。たとえば、払い戻しは 2021 年 5 月に要求されます。この払い戻しトランザクションのイベント日は 2021 年 5 月、請求月は予約購入時の 2020 年 4 月になります。注: ARM のペイロードサイズの制限は 12 MB であるため、応答サイズが ARM の制限を超えると、現在呼び出し元は 400 を受け取ります。このような場合は、より小さな日付範囲で API 呼び出しを行う必要があります。

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/reservationTransactions?api-version=2024-08-01

省略可能なパラメーターを含む:

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/{billingAccountId}/billingProfiles/{billingProfileId}/providers/Microsoft.Consumption/reservationTransactions?$filter={$filter}&api-version=2024-08-01

URI パラメーター

名前	/	必須	型	説明
billingAccountId	path	True	string	BillingAccount ID
billingProfileId	path	True	string	Azure Billing Profile ID。
api-version	query	True	string	クライアント要求で使用する API のバージョン。現在のバージョンは 2023-03-01 です。
$filter	query		string	日付範囲で予約トランザクションをフィルター処理します。開始日と終了日のプロパティ/EventDate。フィルターは 'le' と 'ge' をサポートしています。注: API は、開始日と終了日の請求月全体のデータを返します。たとえば、フィルタープロパティ/eventDate+ge+2020-01-01+AND+properties/eventDate+le+2020-12-29 には、2020 年 12 月全体のデータが含まれます (つまり、日付 12 月 30 日と 31 日のレコードが含まれます)。

応答

名前	型	説明
200 OK	ModernReservationTransactionsListResult	わかりました。要求は成功しました。
Other Status Codes	ErrorResponse	操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

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

スコープ

名前	説明
user_impersonation	ユーザーアカウントを偽装する

例

ReservationTransactionsByBillingProfileId

要求のサンプル

HTTP

GET https://management.azure.com/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/providers/Microsoft.Consumption/reservationTransactions?$filter=properties/eventDate+ge+2020-05-20+AND+properties/eventDate+le+2020-05-30&api-version=2024-08-01

応答のサンプル

状態コード:: 200

{
  "value": [
    {
      "id": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/providers/Microsoft.Consumption/reservationTransactions",
      "name": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
      "type": "Microsoft.Consumption/reservationTransactions",
      "properties": {
        "eventDate": "2020-04-25T21:21:38Z",
        "reservationOrderId": "a838a8c3-a408-49e1-ac90-42cb95bff9b2",
        "description": "Reserved VM Instance, Standard_B1ls, US East, 3 Years",
        "eventType": "Purchase",
        "quantity": 1,
        "amount": 1.44,
        "currency": "USD",
        "reservationOrderName": "VM_RI_03-25-2020_14-18",
        "armSkuName": "Standard_B1ls",
        "billingFrequency": "Recurring",
        "billingProfileId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB",
        "billingProfileName": "IT Department*",
        "invoice": "T000456437",
        "invoiceId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/billingProfiles/Z76D-SGAF-BG7-TGB/invoices/T000456437",
        "invoiceSectionId": "/providers/Microsoft.Billing/billingAccounts/fcebaabc-fced-4284-a83d-79f83dee183c:45796ba8-988f-45ad-bea9-7b71fc6c7513_2018-09-30/invoiceSections/QBTB-EYAK-PJA-TGB",
        "invoiceSectionName": "IT Department",
        "purchasingSubscriptionGuid": "d924ad15-4a3d-4047-971d-c8b1b300a97b",
        "purchasingSubscriptionName": "contoso",
        "region": "eastus",
        "term": "P3Y"
      }
    }
  ]
}

定義

名前	説明
ErrorDetails	エラーの詳細。
ErrorResponse	エラー応答は、サービスが受信要求を処理できないことを示します。エラーメッセージに理由が示されます。いくつかのエラー応答: 429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。 503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。 504 ゲートウェイタイムアウト - 要求の処理中にサービスがタイムアウトしました。可能であれば、要求の日付範囲を減らします。
ModernReservationTransaction	最新の予約トランザクションリソース。
ModernReservationTransactionsListResult	予約に関する推奨事項を一覧表示した結果。

ErrorDetails

Object

エラーの詳細。

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

ErrorResponse

Object

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

いくつかのエラー応答:

429 TooManyRequests - 要求が調整されました。 "x-ms-ratelimit-microsoft.consumption-retry-after" ヘッダーで指定された時刻を待機した後に再試行します。
503 ServiceUnavailable - サービスは一時的に使用できません。 "Retry-After" ヘッダーで指定された時刻を待機した後に再試行します。
504 ゲートウェイタイムアウト - 要求の処理中にサービスがタイムアウトしました。可能であれば、要求の日付範囲を減らします。

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

ModernReservationTransaction

Object

最新の予約トランザクションリソース。

名前	型	説明
id	string	リソース ID。
name	string	リソース名。
properties.amount	number (decimal)	トランザクションの料金。
properties.armSkuName	string	これは ARM SKU 名です。これは、使用状況レコードの追加情報の serviceType フィールドとの結合に使用できます。
properties.billingFrequency	string	請求頻度。1 回限りまたは繰り返しの頻度を指定できます。
properties.billingProfileId	string	課金プロファイル ID。
properties.billingProfileName	string	課金プロファイル名。
properties.currency	string	トランザクションが請求される ISO 通貨 (USD など)。
properties.description	string	取引の説明。
properties.eventDate	string (date-time)	トランザクションの日付
properties.eventType	string	トランザクションの種類 (購入、キャンセル、または払い戻し)。
properties.invoice	string	請求書番号
properties.invoiceId	string	特定のトランザクションが表示される請求書の請求書 ID。
properties.invoiceSectionId	string	請求書セクション ID
properties.invoiceSectionName	string	請求書セクション名。
properties.purchasingSubscriptionGuid	string (uuid)	トランザクションを行うサブスクリプション GUID。
properties.purchasingSubscriptionName	string	トランザクションを作成するサブスクリプション名。
properties.quantity	number (decimal)	トランザクションの数量。
properties.region	string	トランザクションのリージョン。
properties.reservationOrderId	string	予約注文 ID は、予約購入の識別子です。各予約注文 ID は、1 つの購入トランザクションを表します。予約注文には予約が含まれます。予約注文では、予約の VM サイズとリージョンを指定します。
properties.reservationOrderName	string	予約注文の名前。
properties.term	string	これはトランザクションの用語です。
tags	string[]	リソースタグ。
type	string	リソースの種類。

ModernReservationTransactionsListResult

Object

予約に関する推奨事項を一覧表示した結果。

名前	型	説明
nextLink	string	結果の次のページへのリンク (URL)。
value	ModernReservationTransaction[]	予約に関する推奨事項の一覧。

次の方法で共有

Reservation Transactions - List By Billing Profile

URI パラメーター

応答

セキュリティ

azure_auth

スコープ

例

ReservationTransactionsByBillingProfileId

要求のサンプル

応答のサンプル

定義

ErrorDetails

ErrorResponse

ModernReservationTransaction

ModernReservationTransactionsListResult

その他のリソース