Elenco report

Gestisci in modo efficace i report dell'API App Optimize elencando tutte le configurazioni dei report all'interno del tuo progetto. Google Cloud In questo modo puoi identificare un report specifico per leggerne i dati o eliminarlo prima della data di scadenza, se non è più necessario.

L'operazione di elenco restituisce i metadati del report, inclusi il nome della risorsa, l'ambito, le dimensioni, le metriche e l'ora di scadenza di ogni report. Per scaricare le informazioni su costi e utilizzo richieste, devi leggere i dati del report.

Prima di iniziare

  1. Accedi al tuo Google Cloud account. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

  2. Installa Google Cloud CLI.

  3. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  4. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  5. Verifica di disporre delle autorizzazioni necessarie per completare questa guida.

  6. Installa Google Cloud CLI.

  7. Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

  8. Per inizializzare gcloud CLI, esegui questo comando: 

    gcloud init

  9. Verifica di disporre delle autorizzazioni necessarie per completare questa guida.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per elencare le risorse dei report di un progetto, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore di App Optimize (roles/appoptimize.viewer) sul progetto. Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Elenca i report

Per elencare i report in un progetto, utilizzando l'API REST, invia una richiesta HTTP GET all'endpoint di raccolta dei report.

Utilizza il seguente curl comando per elencare i report di un progetto:

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del Google Cloud progetto che possiede le risorse dei report che vuoi elencare.
  • PAGE_SIZE: il numero massimo di report da restituire per pagina. Se omesso, l'API utilizza un valore predefinito. Il server potrebbe restituire un numero di report inferiore a quello richiesto.

Se la richiesta va a buon fine, l'API restituisce una risposta JSON contenente un elenco di risorse dei report. Ecco un esempio di risposta a una chiamata riuscita:

{
  "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"
      ]
    }
  ]
}

L'array reports contiene i metadati di ogni report. Se la richiesta non va a buon fine, esamina il messaggio di errore restituito dall'API.

Se la risposta include una stringa nextPageToken, significa che ci sono altri report da recuperare.

Controlla la risposta per verificare la presenza di un campo nextPageToken. Se il token esiste, esegui la seguente richiesta curl per recuperare la pagina successiva, incluso il parametro di query pageToken. Puoi continuare a utilizzare il parametro pageSize.

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"

Sostituisci quanto segue:

  • NEXT_PAGE_TOKEN: il valore di nextPageToken ricevuto nella risposta precedente.
  • PAGE_SIZE: le dimensioni della pagina che vuoi per questa richiesta.

Ripeti questa procedura finché la risposta non contiene più un nextPageToken, il che indica che hai recuperato tutti i report.

Passaggi successivi