Wenn Sie die Einstellungen eines Berichts wie den Umfang und die Messwerte prüfen oder die Ablaufzeit ermitteln möchten, rufen Sie die Metadaten des Berichts mit der App Optimize API ab.
Diese API-Anfrage gibt nicht die tatsächlichen Datenzeilen im Bericht zurück. Wenn Sie diese Informationen herunterladen möchten, müssen Sie die Daten des Berichts lesen.
Hinweis
- Melden Sie sich in Ihrem Google Cloud Konto an. Wenn Sie noch kein Google Cloud-Nutzer sind, erstellen Sie ein Konto, um die Leistung unserer Produkte in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.
-
Installieren Sie die Google Cloud CLI.
-
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
-
Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init -
Prüfen Sie, ob Sie die Berechtigungen haben, die für diese Anleitung erforderlich sind.
-
Installieren Sie die Google Cloud CLI.
-
Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.
-
Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren:
gcloud init -
Prüfen Sie, ob Sie die Berechtigungen haben, die für diese Anleitung erforderlich sind.
Erforderliche Rollen
Bitten Sie Ihren Administrator, Ihnen die IAM-Rolle „App Optimize Viewer (roles/appoptimize.viewer)“ für das Projekt zu erteilen, in dem sich die Berichtsressource befindet, um die Berechtigungen zu erhalten, die Sie zum Lesen der Metadaten eines Berichts benötigen.
Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.
Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder andere vordefinierte Rollen erhalten.
Berichtsmetadaten abrufen
Wenn Sie die Metadaten für einen Bericht mit der REST API abrufen möchten, senden Sie eine HTTP-GET-Anfrage an den Ressourcenendpunkt des Berichts.
Verwenden Sie den folgenden curl-Befehl, um die Berichts
metadaten abzurufen:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports/REPORT_ID"
Ersetzen Sie Folgendes:
PROJECT_ID: die ID des Google Cloud Projekts , in dem sich die Berichtsressource befindet, die Sie abrufen möchten.REPORT_ID: die ID des Berichts, der abgerufen werden soll. Diese ID wurde beim Erstellen des Berichts angegeben und kann durch Auflisten von Berichten abgerufen werden.
Wenn die Anfrage erfolgreich ist, gibt die API eine JSON-Antwort mit den Berichtsmetadaten zurück.
Hier ist ein Beispiel für eine erfolgreiche Antwort mit der ausgewählten Dimension und dem ausgewählten Messwert, dem Projektumfang und dem Ablaufdatum des Berichts:
{
"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"
]
}