Obtenir les métadonnées d'un rapport

Pour inspecter les paramètres d'un rapport, tels que son champ d'application et ses métriques, ou pour vérifier son délai d'expiration, utilisez l'API App Optimize pour obtenir les métadonnées du rapport.

Cette requête d'API ne renvoie pas les lignes de données réelles du rapport. Pour télécharger ces informations, vous devez lire les données du rapport.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud . Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $de crédits sans frais pour exécuter, tester et déployer des charges de travail.

  2. Installez la Google Cloud CLI.

  3. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  4. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

  5. Vérifiez que vous disposez des autorisations requises pour suivre les instructions de ce guide.

  6. Installez la Google Cloud CLI.

  7. Si vous utilisez un fournisseur d'identité (IdP) externe, vous devez d'abord vous connecter à la gcloud CLI avec votre identité fédérée.

  8. Pour initialiser la gcloud CLI, exécutez la commande suivante : 

    gcloud init

  9. Vérifiez que vous disposez des autorisations requises pour suivre les instructions de ce guide.

Rôles requis

Pour obtenir les autorisations nécessaires pour lire les métadonnées d'un rapport, demandez à votre administrateur de vous accorder le rôle IAM Lecteur App Optimize (roles/appoptimize.viewer) sur le projet qui possède la ressource de rapport. Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.

Vous pouvez également obtenir les autorisations requises avec des rôles personnalisés ou d'autres rôles prédéfinis.

Obtenir les métadonnées d'un rapport

Pour récupérer les métadonnées d'un rapport à l'aide de l'API REST, envoyez une requête HTTP GET au point de terminaison de la ressource du rapport.

Exécutez la commande curl suivante pour obtenir les métadonnées du rapport :

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports/REPORT_ID"

Remplacez les éléments suivants :

  • PROJECT_ID : ID du Google Cloud projet propriétaire de la ressource de rapport que vous souhaitez récupérer.
  • REPORT_ID : ID du rapport à récupérer. Cet ID a été spécifié lors de la création du rapport et peut être obtenu en listant les rapports.

Si la requête aboutit, l'API renvoie une réponse JSON contenant les métadonnées du rapport.

Voici un exemple de réponse réussie, incluant la dimension et la métrique sélectionnées, le champ d'application du projet et la date d'expiration prévue du rapport :

{
  "name": "projects/PROJECT_ID/locations/global/reports/REPORT_ID",
  "dimensions": [
    "location",
    "product_display_name",
    "project",
    "resource",
    "resource_type"
  ],
  "scopes": [
    {
      "project": "projects/PROJECT_ID"
    }
  ],
  "filter": "hour >= now - duration(\"168h\")",
  "expireTime": "2026-02-05T18:50:25.273833857Z",
  "metrics": [
    "cost",
    "cpu_mean_utilization"
  ]
}

Étapes suivantes