Informes de listas

Puedes enumerar los informes de tu proyecto Google Cloud para identificar los que quieres leer o los que quieres borrar antes de la fecha de vencimiento.

Antes de comenzar

gcloud

En la consola de Google Cloud , activa Cloud Shell.

Activa Cloud Shell

En la parte inferior de la consola de Google Cloud , se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.

Para obtener información sobre cómo configurar la autenticación para un entorno de producción, consulta Configura las credenciales predeterminadas de la aplicación para el código que se ejecuta en Google Cloud en la documentación de autenticación de Google Cloud .

Python

  1. Instala la biblioteca cliente de Python para la API de App Optimize.

  2. Para usar las muestras de Python de esta página en un entorno de desarrollo local, instala e inicializa la gcloud CLI y, luego, configura las credenciales predeterminadas de la aplicación con tus credenciales de usuario.

    1. Instala Google Cloud CLI.

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

    3. Si usas una shell local, crea credenciales de autenticación locales para tu cuenta de usuario: 

      gcloud auth application-default login

      No es necesario que lo hagas si usas Cloud Shell.

      Si se muestra un error de autenticación y usas un proveedor de identidad (IdP) externo, confirma que accediste a la gcloud CLI con tu identidad federada.

    Para obtener más información, consulta Configura ADC para un entorno de desarrollo local en la documentación de autenticación de Google Cloud .

    Para obtener información sobre cómo configurar la autenticación para un entorno de producción, consulta Configura las credenciales predeterminadas de la aplicación para el código que se ejecuta en Google Cloud en la documentación de autenticación de Google Cloud .

REST

Para usar las muestras de la API de REST incluidas en esta página en un entorno de desarrollo local, debes usar las credenciales que proporciones a la gcloud CLI.

    Instala Google Cloud CLI.

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

Para obtener más información, consulta Autentícate para usar REST en la documentación de autenticación de Google Cloud .

Para obtener información sobre cómo configurar la autenticación para un entorno de producción, consulta Configura las credenciales predeterminadas de la aplicación para el código que se ejecuta en Google Cloud en la documentación de autenticación de Google Cloud .

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.

Informes de lista

La operación de lista devuelve los metadatos del informe, incluidos el nombre del recurso, el alcance, las dimensiones, las métricas y la hora de vencimiento de cada informe. Para descargar la información de costos y uso solicitada, debes leer los datos del informe.

Para enumerar los informes en un proyecto, sigue las instrucciones del método que prefieras:

gcloud

Usa el comando gcloud beta app-optimize reports list para enumerar los informes de un proyecto.

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

Reemplaza PROJECT_ID por el ID del proyecto Google Cloudque posee los recursos del informe que deseas enumerar.

El comando gcloud controla la paginación automáticamente y devuelve todos los recursos solicitados.

Python

El siguiente código de Python usa AppOptimizeClient.list_reports() para mostrar una lista de informes en un proyecto.

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)

Reemplaza PROJECT_ID por el ID del proyecto Google Cloudque posee los recursos del informe que deseas enumerar.

La biblioteca cliente controla la paginación automáticamente y genera resultados del iterador.

REST

Usa el siguiente comando curl 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 del informe que deseas enumerar.
  • PAGE_SIZE: Es la cantidad máxima de informes que se pueden mostrar por página. Si se omite, la API usa un valor predeterminado. Es posible que el servidor devuelva menos informes de los que se solicitaron.

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

{
  "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 devolvió la API.

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

Verifica si hay un campo nextPageToken en la respuesta. Si el token existe, ejecuta el siguiente comando curl para recuperar la página siguiente, incluido el parámetro de búsqueda 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?