CUD 订阅导出数据的结构

本文档介绍了每天导出到 BigQuery 的承诺使用折扣 (CUD) 订阅元数据的架构参考信息。此导出功能可将基于支出的 CUD 和灵活节省方案 (FSP) 承诺元数据的每日快照导出到 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'

    如需详细了解主账号标识符格式，请参阅主账号标识符。

  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 Billing 账号 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 表示一年，P3Y 表示三年。
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 控制台中提供的费用和价格报告