Estrutura da exportação de assinaturas de CUD

Este documento fornece informações de referência para o esquema dos metadados de assinaturas de descontos por uso contínuo (CUD, na sigla em inglês) exportados diariamente para o BigQuery. Essa exportação fornece um snapshot diário dos metadados de compromisso de CUDs com base em gastos e planos de economia flexíveis (FSPs, na sigla em inglês) para uma tabela do BigQuery. É possível unir essa tabela a outras exportações de dados de faturamento para gerenciamento e relatórios de CUD.

Regras de entrada e saída

Se você usa VPC Service Controls para recursos do BigQuery no seu projeto ou organização, é necessário criar regras de entrada e saída para ativar corretamente as exportações de dados para o BigQuery.

  1. Crie uma regra de entrada que conceda acesso individual para criar a exportação: 
    
  - 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'

    Consulte Identificadores principais para mais informações sobre formatos de identificadores principais.

  2. Crie uma regra de saída para permitir Google Cloud o acesso ao conjunto de dados do BigQuery pelo VPC Service Controls: 
    
  - egressTo:
       operations:
      - serviceName: bigquery.googleapis.com
        methodSelectors:
        - method: "*"
      resources:
      - projects/132468967293
  egressFrom:
      identityType: ANY_IDENTITY
      sources:
      - accessLevel: "*"
      sourceRestriction: RESTRICTION_STATUS
  title: 'Egress Rule Name'

Esquema dos dados de exportação de assinaturas CUD

No conjunto de dados do BigQuery, os dados de assinaturas de CUD da conta do Cloud Billing são carregados em uma tabela chamada cud_subscriptions_export.

A tabela a seguir descreve o esquema dos dados exportados para o BigQuery.

Campo Tipo Descrição
billing_account_id String O ID da conta de faturamento alfanumérico de 18 caracteres associado aos dados de assinaturas CUD, por exemplo, 010101-F0FFF0-10XX01.
cud_product.id String O ID da definição do produto, por exemplo, 344fffc1-17f9-4e34-abf2-cfffff409fa2.
cud_product.display_name String O nome de exibição do produto associado ao compromisso, por exemplo, Flexible Savings Plans.
cud_product.type String O tipo de compromisso, por exemplo, Spend-Based.
consumption_model.id String O ID do modelo de consumo usado pelo compromisso, por exemplo, 5515-81A8-03A2.
consumption_model.description String A descrição do modelo de consumo para o compromisso, por exemplo, Vertex AI FSP - 1 Year.
subscription.entitlement_scope String O escopo do direito para o compromisso, por exemplo, billingAccounts/010101-F0FFF0-10XX01.
subscription.instance_id String O ID da instância de assinatura, que é um GUID, por exemplo, 769c55ea-c50f-4258-bcf5-04b6688fa5fa.
subscription.display_name String O nome de exibição do compromisso, definido por você no momento da compra.
subscription.entitlement_period String O período de recorrência do compromisso, Monthly ou Hourly.
subscription.payment_terms String As condições de pagamento do compromisso, por exemplo, Postpay.
region String A região associada ao compromisso, por exemplo, us-central1. Se o compromisso for global, esse campo estará vazio.
commitment_amount Registro repetido Os detalhes do valor do compromisso.
commitment_amount.unit String A unidade de medida do consumo de recursos para o compromisso, por exemplo, $/mo ou $/hr.
commitment_amount.value Numérico O valor do compromisso.
commitment_fee Gravar Os detalhes da taxa de compromisso.
commitment_fee.sku String O ID da SKU associado à taxa de compromisso.
commitment_fee.description String A descrição da SKU da taxa.
term String O prazo do compromisso no formato de duração ISO 8601, em que P1Y representa um ano e P3Y representa três anos.
start_time Carimbo de data/hora O carimbo de data/hora de início do compromisso, por exemplo, 2026-07-20 21:35:48 UTC.
end_time Carimbo de data/hora O carimbo de data/hora de término do compromisso, por exemplo, 2027-07-20 21:35:48 UTC.
entitlement_schedule Registro repetido Os detalhes da programação do direito.
entitlement_schedule.date_start Data/hora O início da janela de programação no fuso horário da América/Los_Angeles.
entitlement_schedule.date_end Data/hora O fim da janela de programação no fuso horário da América/Los_Angeles.
entitlement_schedule.commitment_amount Numérico O valor do compromisso para essa janela de programação específica.
state String O status atual do compromisso, que pode ser Pending, Active, ou Expired.

Relatórios de custos e preços disponíveis no Google Cloud console