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 nome risorsa, ambito, dimensioni, metriche e ora di scadenza per ogni report. Per scaricare le informazioni richieste su costi e utilizzo, devi leggere i dati del report.

Prima di iniziare

gcloud

Nella console Google Cloud , attiva Cloud Shell.

Attiva Cloud Shell

Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

Per informazioni sulla configurazione dell'autenticazione per un ambiente di produzione, consulta Configura le Credenziali predefinite dell'applicazione per il codice in esecuzione su Google Cloud nella documentazione sull'autenticazione di Google Cloud .

Python

  1. Installa la libreria client Python per l'API App Optimize.

  2. Per utilizzare gli esempi di Python in questa pagina in un ambiente di sviluppo locale, installa e inizializza gcloud CLI, quindi configura Credenziali predefinite dell'applicazione con le tue credenziali utente.

    1. Installa Google Cloud CLI.

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

    3. Se utilizzi una shell locale, crea le credenziali di autenticazione locali per il tuo account utente: 

      gcloud auth application-default login

      Non è necessario eseguire questa operazione se utilizzi Cloud Shell.

      Se viene restituito un errore di autenticazione e utilizzi un provider di identità (IdP) esterno, verifica di aver acceduto a gcloud CLI con la tua identità federata.

    Per saperne di più, consulta Configura ADC per un ambiente di sviluppo locale nella documentazione sull'autenticazione di Google Cloud .

    Per informazioni sulla configurazione dell'autenticazione per un ambiente di produzione, consulta Configura le Credenziali predefinite dell'applicazione per il codice in esecuzione su Google Cloud nella documentazione sull'autenticazione di Google Cloud .

REST

Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.

    Installa Google Cloud CLI.

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

Per saperne di più, consulta Autenticati per usare REST nella documentazione sull'autenticazione di Google Cloud .

Per informazioni sulla configurazione dell'autenticazione per un ambiente di produzione, consulta Configura le Credenziali predefinite dell'applicazione per il codice in esecuzione su Google Cloud nella documentazione sull'autenticazione di Google Cloud .

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per elencare le risorse dei report di un progetto, chiedi all'amministratore di concederti il ruolo IAM App Optimize Viewer (roles/appoptimize.viewer) nel 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.

Report di elenco

Per elencare i report in un progetto, segui le istruzioni per il metodo che preferisci:

gcloud

Utilizza il comando gcloud beta app-optimize reports list per elencare i report in un progetto.

gcloud beta app-optimize reports list \
  --project=PROJECT_ID \
  --location=global

Sostituisci PROJECT_ID con l'ID del progetto Google Cloudche possiede le risorse del report che vuoi elencare.

Il comando gcloud gestisce automaticamente la paginazione, restituendo tutte le risorse richieste.

Python

Il seguente codice Python utilizza AppOptimizeClient.list_reports() per visualizzare un elenco di report in un progetto.

from google.cloud import appoptimize_v1beta

project_id = "PROJECT_ID"

# Create the App Optimize client and request the project's reports
client = appoptimize_v1beta.AppOptimizeClient()
request = appoptimize_v1beta.ListReportsRequest(
    parent=f"projects/{project_id}/locations/global"
)
page_result = client.list_reports(request=request)

# Iterate over the list of reports and display each one
for response in page_result:
    print(response)

Sostituisci PROJECT_ID con l'ID del progetto Google Cloudche possiede le risorse del report che vuoi elencare.

La libreria client gestisce automaticamente la paginazione, restituendo i risultati dell'iteratore.

REST

Utilizza il seguente comando curl per elencare i report per 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 proprietario delle risorse del 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 meno report di quelli richiesti.

Se la richiesta riesce, l'API restituisce una risposta JSON contenente un elenco di risorse report. Ecco un esempio di risposta corretta alla chiamata:

{
  "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 un campo nextPageToken. Se il token esiste, esegui il seguente comando 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ù nextPageToken, che indica che hai recuperato tutti i report.

Passaggi successivi