Per esaminare le impostazioni di un report, ad esempio l'ambito e le metriche, o per controllare la data di scadenza, utilizza l'API App Optimize per recuperare i metadati del report.
Questa richiesta API non restituisce le righe di dati effettive all'interno del report. Per scaricare queste informazioni, devi leggere i dati del report.
Prima di iniziare
- 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.
-
Installa Google Cloud CLI.
-
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init -
Verifica di disporre delle autorizzazioni necessarie per completare questa guida.
-
Installa Google Cloud CLI.
-
Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.
-
Per inizializzare gcloud CLI, esegui questo comando:
gcloud init -
Verifica di disporre delle autorizzazioni necessarie per completare questa guida.
Ruoli obbligatori
Per ottenere le autorizzazioni necessarie per leggere i metadati di un report, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore di App Optimize (roles/appoptimize.viewer) sul progetto proprietario della risorsa report.
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.
Recupera i metadati del report
Per recuperare i metadati di un report utilizzando l'API REST, invia una richiesta HTTP GET all'endpoint della risorsa del report.
Utilizza il seguente curl comando per recuperare i metadati del report:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports/REPORT_ID"
Sostituisci quanto segue:
PROJECT_ID: l'ID del Google Cloud progetto proprietario della risorsa report che vuoi recuperare.REPORT_ID: l'ID del report da recuperare. Questo ID è stato specificato al momento della creazione del report e può essere ottenuto elencando i report.
Se la richiesta va a buon fine, l'API restituisce una risposta JSON contenente i metadati del report.
Di seguito è riportato un esempio di risposta corretta, inclusi la dimensione e la metrica selezionate, l'ambito del progetto e la data di scadenza pianificata del report:
{
"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"
]
}