Estrutura da exportação de metadados de CUD

Este documento fornece informações de referência para o esquema de metadados de desconto por compromisso de uso (CUD) do Cloud Billing exportados diariamente para cada tabela no BigQuery. Essa exportação fornece um snapshot diário dos metadados de compromisso de CUDs com base em gastos para uma tabela do BigQuery, que pode ser unida a outras exportações de dados de faturamento para melhorar o gerenciamento e a geração de 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, crie 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 CUD

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

As informações a seguir descrevem 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 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, Gemini Enterprise 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, Gemini Enterprise Flexible Savings Plan - 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.start_time Data/hora O início da janela de programação no fuso horário da América/Los_Angeles.
entitlement_schedule.end_time 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.

Para mais informações, consulte os seguintes tópicos.

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

Anterior
Estrutura da exportação de dados de preços
Avançar
Exemplo de consultas do Cloud Billing