Berichte auflisten

Sie können Ihre App Optimize API-Berichte effektiv verwalten, indem Sie alle Berichtskonfigurationen in Ihrem Google Cloud -Projekt auflisten. So können Sie einen bestimmten Bericht identifizieren, um seine Daten zu lesen oder ihn vor seinem Ablaufdatum zu löschen, wenn er nicht mehr benötigt wird.

Der Listenvorgang gibt die Berichtsmetadaten zurück, einschließlich des Ressourcennamens, des Bereichs, der Dimensionen, der Messwerte und der Ablaufzeit für jeden Bericht. Wenn Sie die angeforderten Kosten- und Nutzungsinformationen herunterladen möchten, müssen Sie die Daten des Berichts lesen.

Hinweis

  1. Melden Sie sich in Ihrem Google Cloud -Konto an. Wenn Sie mit Google Cloudnoch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit 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.

  2. Installieren Sie die Google Cloud CLI.

  3. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  4. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  5. Prüfen Sie, ob Sie die Berechtigungen haben, die für diese Anleitung erforderlich sind.

  6. Installieren Sie die Google Cloud CLI.

  7. Wenn Sie einen externen Identitätsanbieter (IdP) verwenden, müssen Sie sich zuerst mit Ihrer föderierten Identität in der gcloud CLI anmelden.

  8. Führen Sie den folgenden Befehl aus, um die gcloud CLI zu initialisieren: 

    gcloud init

  9. 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 zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Auflisten der Berichtsressourcen eines Projekts 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.

Berichte auflisten

Wenn Sie Berichte in einem Projekt mit der REST API auflisten möchten, senden Sie eine HTTP-GET-Anfrage an den Endpunkt der Sammlung „reports“.

Verwenden Sie den folgenden curl-Befehl, um die Berichte für ein Projekt aufzulisten:

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

Ersetzen Sie Folgendes:

  • PROJECT_ID: die ID des Google Cloud Projekts, zu dem die Berichtsressourcen gehören, die Sie auflisten möchten.
  • PAGE_SIZE: Die maximale Anzahl von Berichten, die pro Seite zurückgegeben werden sollen. Wenn keine Angabe gemacht wird, wird ein Standardwert verwendet. Der Server gibt möglicherweise weniger Berichte als angefordert zurück.

Wenn die Anfrage erfolgreich ist, gibt die API eine JSON-Antwort mit einer Liste von Berichtsressourcen zurück. Hier ist ein Beispiel für eine erfolgreiche Antwort auf einen Aufruf:

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

Das reports-Array enthält die Metadaten für jeden Bericht. Wenn die Anfrage fehlschlägt, sehen Sie sich die von der API zurückgegebene Fehlermeldung an.

Wenn die Antwort den String nextPageToken enthält, sind weitere Berichte abzurufen.

Suchen Sie in der Antwort nach dem Feld nextPageToken. Wenn das Token vorhanden ist, führen Sie die folgende curl-Anfrage aus, um die nächste Seite abzurufen. Fügen Sie dazu den Abfrageparameter pageToken ein. Sie können den Parameter pageSize weiterhin verwenden.

curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
  "https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports?pageToken=NEXT_PAGE_TOKEN&pageSize=PAGE_SIZE"

Ersetzen Sie Folgendes:

  • NEXT_PAGE_TOKEN: Der Wert von nextPageToken, der in der vorherigen Antwort empfangen wurde.
  • PAGE_SIZE: die Seitengröße, die Sie für diese Anfrage wünschen.

Wiederholen Sie diesen Vorgang, bis die Antwort kein nextPageToken mehr enthält. Das bedeutet, dass Sie alle Berichte abgerufen haben.

Nächste Schritte