Structure de l'exportation des métadonnées des remises sur engagement d'utilisation

Ce document fournit des informations de référence pour le schéma des métadonnées de remise sur engagement d'utilisation (REU) Cloud Billing exportées quotidiennement vers chaque table dans BigQuery. Cette exportation fournit un instantané quotidien des métadonnées d'engagement de vos remises sur engagement d'utilisation basées sur les dépenses dans une table BigQuery, que vous pouvez joindre à d'autres exportations de données de facturation pour une meilleure gestion et de meilleurs rapports sur les remises sur engagement d'utilisation.

Règles d'Ingress et de sortie

Si vous utilisez VPC Service Controls pour les ressources BigQuery de votre projet ou organisation, vous devez créer des règles d'entrée et de sortie pour activer correctement les exportations de données vers BigQuery.

  1. Créez une règle d'entrée qui donne à l'utilisateur l'accès nécessaire pour créer l'exportation : 
    
  - 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'

    Pour en savoir plus sur les formats des identifiants principaux, consultez Identifiants principaux.

  2. Créez une règle de sortie pour autoriser Google Cloud l'accès à l'ensemble de données BigQuery via 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'

Schéma des données d'exportation des REU

Dans votre ensemble de données BigQuery, les données de remise sur engagement d'utilisation de votre compte de facturation Cloud sont chargées dans une table de données nommée cud_subscriptions_export.

Les informations suivantes décrivent le schéma des données exportées vers BigQuery.

Champ Type Description
billing_account_id Chaîne ID de compte de facturation alphanumérique de 18 caractères associé aux données de REU, par exemple, 010101-F0FFF0-10XX01.
cud_product.id Chaîne ID de définition du produit, par exemple, 344fffc1-17f9-4e34-abf2-cfffff409fa2.
cud_product.display_name Chaîne Nom à afficher du produit associé à l'engagement, par exemple, Gemini Enterprise Flexible Savings Plans.
cud_product.type Chaîne Type d'engagement, par exemple, Spend-Based.
consumption_model.id Chaîne ID du modèle de consommation utilisé par l'engagement, par exemple, 5515-81A8-03A2.
consumption_model.description Chaîne Description du modèle de consommation pour l'engagement, par exemple, Gemini Enterprise Flexible Savings Plan - 1 Year.
subscription.entitlement_scope Chaîne Champ d'application de l'autorisation pour l'engagement, par exemple, billingAccounts/010101-F0FFF0-10XX01.
subscription.instance_id Chaîne ID d'instance d'abonnement, qui est un GUID, par exemple, 769c55ea-c50f-4258-bcf5-04b6688fa5fa.
subscription.display_name Chaîne Nom à afficher de l'engagement, que vous avez défini au moment de l' achat.
subscription.entitlement_period Chaîne Période de récurrence de l'engagement, Monthly ou Hourly.
subscription.payment_terms Chaîne Conditions de paiement de l'engagement, par exemple, Postpay.
region Chaîne Région associée à l'engagement, par exemple, us-central1. Si l'engagement est global, ce champ est vide.
commitment_amount Enregistrement répété Détails du montant de l'engagement.
commitment_amount.unit Chaîne Unité de mesure de la consommation de ressources pour l'engagement, par exemple, $/mo ou $/hr.
commitment_amount.value Numérique Valeur du montant de l'engagement.
commitment_fee Enregistrer Détails des frais d'engagement.
commitment_fee.sku Chaîne ID de SKU associé aux frais d'engagement.
commitment_fee.description Chaîne Description du SKU de frais.
term Chaîne Durée de l'engagement au format de durée ISO 8601, où P1Y représente un an et P3Y représente trois ans.
start_time Horodatage Horodatage de début de l'engagement, par exemple, 2026-07-20 21:35:48 UTC.
end_time Horodatage Horodatage de fin de l'engagement, par exemple, 2027-07-20 21:35:48 UTC.
entitlement_schedule Enregistrement répété Détails de la programmation de l'autorisation.
entitlement_schedule.start_time Date/Heure Début de la période de programmation dans le fuseau horaire America/Los_Angeles zone.
entitlement_schedule.end_time Date/Heure Fin de la période de programmation dans le fuseau horaire America/Los_Angeles zone.
entitlement_schedule.commitment_amount Numérique Montant de l'engagement pour cette période de programmation spécifique.
state Chaîne État actuel de l'engagement, qui peut être Pending, Active, ou Expired.

Pour en savoir plus, consultez les articles suivants.

Rapports sur les coûts et la tarification disponibles dans la Google Cloud console

Précédent
Structure de l'exportation des données de tarification
Suivant
Exemples de requêtes pour Cloud Billing