Estrutura da exportação de assinaturas de CUD

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

Regras de entrada e saída

Se você usa o 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 ao indivíduo acesso 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 de principais para mais informações sobre os formatos de identificadores de principais.

  2. Crie uma regra de saída para permitir que o Google Cloud acesse o 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 de 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 alfanumérico de 18 caracteres da conta de faturamento associada aos dados de assinaturas de CUD, por exemplo, 010101-F0FFF0-10XX01.
cud_product.id String O ID de 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 do compromisso, por exemplo, Vertex AI FSP - 1 Year.
subscription.entitlement_scope String O escopo do direito de uso do 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 vai ficar 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 A duração do compromisso no formato 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 do período de agendamento de horários no fuso horário America/Los_Angeles.
entitlement_schedule.date_end Data/hora O fim do período de agendamento de horários no fuso horário America/Los_Angeles.
entitlement_schedule.commitment_amount Numérico O valor do compromisso para este período de agendamento de horários específico.
state String O status atual do compromisso, que pode ser Pending, Active ou Expired.

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