CUD サブスクリプションのエクスポートの構造

このドキュメントでは、BigQuery に毎日エクスポートされる確約利用割引(CUD)サブスクリプション メタデータのスキーマのリファレンス情報を提供します。このエクスポートでは、費用ベースの CUD と Flexible Savings Plans(FSP)のコミットメント メタデータの 1 日単位のスナップショットが BigQuery テーブルに提供されます。このテーブルは、他の課金データ エクスポートと結合して、CUD の管理とレポート作成を行うことができます。

上り(内向き)と下り(外向き)のルール

プロジェクトまたは組織の BigQuery リソースで VPC Service Controls を使用している場合は、BigQuery へのデータ エクスポートを適切に有効にするために、上り(内向き)ルールと下り(外向き)ルールを作成する必要があります。

  1. ユーザーがアクセスしてエクスポートを作成できるように、上り(内向き)ルールを作成します。
    
      - ingressFrom:
          identities:
          - PRINCIPAL_IDENTIFIER_OF_USER_INITIATING_EXPORT
          sources:
          - accessLevel: "*"
      ingressTo:
          operations:
          - serviceName: bigquery.googleapis.com
            methodSelectors:
            - method: "*"
          resources:
          - projects/YOUR_PROJECT_ID_TO_HOST_EXPORT_DATA
      title: 'Ingress Rule Name'
      

    プリンシパル ID の形式の詳細については、プリンシパル ID をご覧ください。

  2. 下り(外向き)ルールを作成し、 Google Cloud が VPC Service Controls を介して BigQuery データセットにアクセスできるようにします。
    
      - egressTo:
           operations:
          - serviceName: bigquery.googleapis.com
            methodSelectors:
            - method: "*"
          resources:
          - projects/132468967293
      egressFrom:
          identityType: ANY_IDENTITY
          sources:
          - accessLevel: "*"
          sourceRestriction: RESTRICTION_STATUS
      title: 'Egress Rule Name'
      

CUD サブスクリプションのエクスポート データのスキーマ

BigQuery データセットで、Cloud 請求先アカウントの CUD サブスクリプション データは cud_subscriptions_export というテーブルに読み込まれます。

次の表に、BigQuery にエクスポートされるデータのスキーマを示します。

フィールド タイプ 説明
billing_account_id 文字列 CUD サブスクリプション データに関連付けられている 18 文字の英数字の請求先アカウント ID(例: 010101-F0FFF0-10XX01)。
cud_product.id 文字列 商品定義 ID(例: 344fffc1-17f9-4e34-abf2-cfffff409fa2)。
cud_product.display_name 文字列 コミットメントに関連付けられているプロダクトの表示名(Flexible Savings Plans など)。
cud_product.type 文字列 コミットメントのタイプ(Spend-Based など)。
consumption_model.id 文字列 コミットメントで使用される使用量モデルの ID(例: 5515-81A8-03A2)。
consumption_model.description 文字列 コミットメントの使用量モデルの説明(Vertex AI FSP - 1 Year など)。
subscription.entitlement_scope 文字列 コミットメントの利用資格の範囲(billingAccounts/010101-F0FFF0-10XX01 など)。
subscription.instance_id 文字列 サブスクリプション インスタンス ID(GUID)。例: 769c55ea-c50f-4258-bcf5-04b6688fa5fa。
subscription.display_name 文字列 購入時にユーザーが定義したコミットメントの表示名。
subscription.entitlement_period 文字列 コミットメントの繰り返し期間(Monthly または Hourly)。
subscription.payment_terms 文字列 コミットメントの支払い条件(Postpay など)。
region 文字列 コミットメントに関連付けられているリージョン(us-central1 など)。コミットメントがグローバルの場合、このフィールドは空です。
commitment_amount 繰り返しレコード コミットメント金額の詳細。
commitment_amount.unit 文字列 コミットメントのリソース使用量の測定単位($/mo、$/hr など)。
commitment_amount.value 数値 コミットメント額の値。
commitment_fee 記録 コミットメント料金の詳細。
commitment_fee.sku 文字列 コミットメント料金に関連付けられた SKU ID。
commitment_fee.description 文字列 料金 SKU の説明。
term 文字列 ISO 8601 期間形式のコミットメント期間。P1Y は 1 年、P3Y は 3 年を表します。
start_time タイムスタンプ コミットメントの開始タイムスタンプ(2026-07-20 21:35:48 UTC など)。
end_time タイムスタンプ コミットメントの終了タイムスタンプ(例: 2027-07-20 21:35:48 UTC)。
entitlement_schedule 繰り返しレコード 利用資格のスケジュール詳細。
entitlement_schedule.date_start 日時 America/Los_Angeles タイムゾーンでのスケジュール ウィンドウの開始。
entitlement_schedule.date_end 日時 America/Los_Angeles タイムゾーンでのスケジュール ウィンドウの終了。
entitlement_schedule.commitment_amount 数値 この特定のスケジュール ウィンドウのコミットメント額。
state 文字列 コミットメントの現在のステータス(Pending、Active、Expired のいずれか)。

Google Cloud コンソールで利用可能な費用と料金のレポート