このドキュメントでは、BigQuery に毎日エクスポートされる確約利用割引(CUD)サブスクリプション メタデータのスキーマのリファレンス情報を提供します。このエクスポートでは、費用ベースの CUD と Flexible Savings Plans(FSP)のコミットメント メタデータの 1 日単位のスナップショットが BigQuery テーブルに提供されます。このテーブルは、他の課金データ エクスポートと結合して、CUD の管理とレポート作成を行うことができます。
上り(内向き)と下り(外向き)のルール
プロジェクトまたは組織の BigQuery リソースで VPC Service Controls を使用している場合は、BigQuery へのデータ エクスポートを適切に有効にするために、上り(内向き)ルールと下り(外向き)ルールを作成する必要があります。
-
ユーザーがアクセスしてエクスポートを作成できるように、上り(内向き)ルールを作成します。
- 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 をご覧ください。
- 下り(外向き)ルールを作成し、 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 のいずれか)。 |