Informes de listas

Administra tus informes de la API de App Optimize de manera eficaz enumerando todas las configuraciones de informes dentro de tu proyecto. Google Cloud Esto te ayuda a identificar un informe específico para leer sus datos o borrarlo antes de su fecha de vencimiento si ya no es necesario.

La operación de lista muestra los metadatos del informe, incluidos el nombre del recurso, el alcance, las dimensiones, las métricas y el tiempo de vencimiento de cada informe. Para descargar la información de costos y uso solicitada, 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 enumerar los recursos de informes de un proyecto, pídele a tu administrador que te otorgue el rol de IAM de visualizador de App Optimize (roles/appoptimize.viewer) en el proyecto. 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.

Enumerar informes

Para enumerar informes en un proyecto, usa la API de REST y envía una solicitud GET HTTP al extremo de la colección de informes.

Usa el siguiente curl comando para enumerar los informes de un proyecto:

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

Reemplaza lo siguiente:

  • PROJECT_ID: Es el ID del Google Cloud proyecto que posee los recursos de informes que deseas enumerar.
  • PAGE_SIZE: Es la cantidad máxima de informes que se mostrarán por página. Si se omite, la API usa un valor predeterminado. Es posible que el servidor muestre menos informes de los que se solicitaron.

Si la solicitud se realiza correctamente, la API muestra una respuesta JSON que contiene una lista de recursos de informes. A continuación, se muestra un ejemplo de respuesta de llamada correcta:

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

El array reports contiene los metadatos de cada informe. Si la solicitud no se realiza correctamente, revisa el mensaje de error que muestra la API.

Si la respuesta incluye una cadena nextPageToken, significa que hay más informes para recuperar.

Verifica la respuesta para ver si hay un campo nextPageToken. Si el token existe, ejecuta la siguiente solicitud curl para recuperar la página siguiente, incluido el parámetro de consulta pageToken. Puedes seguir usando el parámetro 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"

Reemplaza lo siguiente:

  • NEXT_PAGE_TOKEN: Es el valor de nextPageToken que se recibió en la respuesta anterior.
  • PAGE_SIZE: Es el tamaño de página que deseas para esta solicitud.

Repite este proceso hasta que la respuesta ya no contenga un nextPageToken, lo que indica que recuperaste todos los informes.

¿Qué sigue?