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 a la 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
-
Verify that you have the permissions required to complete this guide.
Selecciona la pestaña según cómo planeas usar las muestras de este documento:
gcloud
Instala Google Cloud CLI.
Configura gcloud CLI para usar tu identidad federada.
Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.
Para inicializar gcloud CLI, ejecuta el siguiente comando:
gcloud initDespués de inicializar gcloud CLI, actualízala y, luego, instala los componentes necesarios:
gcloud components update gcloud components install beta
Para obtener información sobre cómo configurar la autenticación de 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 Google Cloud documentación de autenticación de.
Python
- Instala la biblioteca cliente de Python para la API de App Optimize.
-
Para usar las muestras de Python incluidas en 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.
-
Instala Google Cloud CLI.
-
Configura gcloud CLI para usar tu identidad federada.
Para obtener más información, consulta Accede a la gcloud CLI con tu identidad federada.
-
Crea credenciales de autenticación locales para tu cuenta de usuario:
gcloud auth application-default login
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 Google Cloud documentación de autenticación de.
Para obtener información sobre cómo configurar la autenticación de 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 Google Cloud documentación de autenticación de.
-
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 y, luego, accede a 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 de 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 Google Cloud documentación de autenticación de.
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, sigue las instrucciones del método preferido:
gcloud
Usa el comando gcloud beta app-optimize reports describe para obtener los metadatos de un informe.
gcloud beta app-optimize reports describe REPORT_ID \
--project=PROJECT_ID \
--location=global
Reemplaza lo siguiente:
PROJECT_ID: el ID del Google Cloud proyecto que posee el recurso del informe que deseas recuperar.REPORT_ID: 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.
Python
El siguiente código de Python usa AppOptimizeClient.get_report() para obtener los metadatos de un informe.
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)
Reemplaza lo siguiente:
PROJECT_ID: el ID del Google Cloud proyecto que posee el recurso del informe que deseas recuperar.REPORT_ID: 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.
REST
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: el ID del Google Cloud proyecto que posee el recurso del informe que deseas recuperar.REPORT_ID: 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 vence 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"
]
}