Recupero dei metadati di un report

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 ottenere i metadati del report.

Questa richiesta API non restituisce le righe di dati effettivi all'interno del report. Per scaricare queste informazioni, 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 leggere i metadati di un report, chiedi all'amministratore di concederti il ruolo IAM Visualizzatore 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.

Recupero dei metadati del report

Per recuperare i metadati di un report, segui le istruzioni per il metodo che preferisci:

gcloud

Utilizza il comando gcloud beta app-optimize reports describe per ottenere i metadati di un report.

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

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto Google Cloud proprietario della risorsa report che vuoi recuperare.
  • REPORT_ID: l'ID del report da recuperare. Questo ID è stato specificato durante la creazione del report e può essere ottenuto elencando i report.

Python

Il seguente codice Python utilizza AppOptimizeClient.get_report() per ottenere i metadati di un report.

from google.cloud import appoptimize_v1beta

project_id = "PROJECT_ID"
report_id = "REPORT_ID"
name = f"projects/{project_id}/locations/global/reports/{report_id}"

# Create the App Optimize client and request the report's metadata
client = appoptimize_v1beta.AppOptimizeClient()
request = appoptimize_v1beta.GetReportRequest(name=name)
response = client.get_report(request=request)

# Display the metadata
print(response)

Sostituisci quanto segue:

  • PROJECT_ID: l'ID del progetto Google Cloud proprietario della risorsa report che vuoi recuperare.
  • REPORT_ID: l'ID del report da recuperare. Questo ID è stato specificato durante la creazione del report e può essere ottenuto elencando i report.

REST

Utilizza il seguente comando curl per ottenere 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 progetto Google Cloud proprietario della risorsa report che vuoi recuperare.
  • REPORT_ID: l'ID del report da recuperare. Questo ID è stato specificato durante la creazione del report e può essere ottenuto elencando i report.

Se la richiesta riesce, 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"
  ]
}

Passaggi successivi