Estrutura da exportação de metadados de CUD

Este documento fornece informações de referência sobre o esquema dos metadados do desconto por compromisso de uso (CUD) do Cloud Billing que são exportados diariamente para cada tabela no BigQuery. Essa exportação fornece um snapshot diário dos metadados de compromisso dos 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 o 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 dê acesso à pessoa para criar a exportação:
    
      - ingressFrom:
          identities:
          - PRINCIPAL_IDENTIFIER_OF_USER_INITIATING_EXPORT
          sources:
          - accessLevel: "*"
      ingressTo:
          roles:
          - roles/bigquery.dataOwner
          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 o acesso Google Cloud ao conjunto de dados do BigQuery usando o VPC Service Controls:
    
      - egressTo:
          roles:
          - roles/bigquery.dataOwner
          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 da assinatura, por exemplo, 344fffc1-17f9-4e34-abf2-cfffff409fa2.
cud_product.display_name String O nome amigável do produto associado ao compromisso, por exemplo, Flexible CUD.
cud_product.type String O tipo de compromisso de produto, por exemplo, Spend-Based.
consumption_model.id String O ID do modelo de consumo usado pelo CUD, por exemplo, 5515-81A8-03A2.
consumption_model.description String A descrição do modelo de consumo do CUD, por exemplo, Cloud Spanner CUD - 1 Year.
subscription.entitlement_scope String O escopo do direito para a CUD. Por exemplo, um direito no escopo da conta pode ser 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 CUD, definido pelo cliente no momento da compra, por exemplo, Recommended Cloud Run CUD commitment in us-central1 on Sep 3, 2023.
region String A região associada ao CUD, por exemplo, us-central1.
commitent_amount.unit String A unidade de medida do consumo de recursos para o compromisso, por exemplo, $/hr.
commitent_amount.value Numérico O valor do compromisso comprado, por exemplo, 100 ou 0.05.
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, 2024-09-27 18:08:20 UTC.
end_time Carimbo de data/hora O carimbo de data/hora de término do compromisso, por exemplo, 2025-02-18 12:11:20 UTC.
state String O estado do compromisso, por exemplo, Active ou Expired.

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