Obtén los metadatos de un informe

Para inspeccionar la configuración de un informe, como su alcance y sus métricas, o para verificar su hora de vencimiento, usa la API de App Optimize para obtener los metadatos del informe.

Esta solicitud de API no muestra las filas de datos reales dentro del informe. Para descargar esta información, debes leer los datos del informe.

Antes de comenzar

  1. Accede a tu Google Cloud cuenta de. Si eres nuevo en Google Cloud, crea una cuenta para evaluar el rendimiento de nuestros productos en situaciones reales. Los clientes nuevos también obtienen $300 en créditos gratuitos para ejecutar, probar y, además, implementar cargas de trabajo.

  2. Instala Google Cloud CLI.

  3. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  4. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    gcloud init

  5. Verifica que tengas los permisos necesarios para completar esta guía.

  6. Instala Google Cloud CLI.

  7. Si usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.

  8. Para inicializar gcloud CLI, ejecuta el siguiente comando: 

    gcloud init

  9. Verifica que tengas los permisos necesarios para completar esta guía.

Roles obligatorios

Para obtener los permisos que necesitas para leer los metadatos de un informe, pídele a tu administrador que te otorgue el rol de visualizador de App Optimize (roles/appoptimize.viewer) de IAM en el proyecto que posee el recurso del informe. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios a través de roles personalizados o cualquier otro rol predefinido.

Obtén metadatos del informe

Para recuperar los metadatos de un informe, usa la API de REST y envía una solicitud GET HTTP al extremo del recurso del informe.

Usa el siguiente curl comando para obtener los metadatos del informe:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del Google Cloud proyecto que posee el recurso del informe que deseas recuperar.
  • REPORT_ID: Es el ID del informe que se recuperará. Este ID se especificó cuando se creó el informe y se puede obtener mediante la creación de una lista de informes.

Si la solicitud se realiza correctamente, la API muestra una respuesta JSON que contiene los metadatos del informe.

Este es un ejemplo de una respuesta correcta, que incluye la dimensión y la métrica seleccionadas, el alcance del proyecto y cuándo vencerá el informe:

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

¿Qué sigue?