Para inspecionar as configurações de um relatório, como escopo e métricas, ou verificar o expiry time, use a App Optimize API para acessar os metadados do relatório.
Essa solicitação de API não retorna as linhas de dados reais no relatório. Para baixar essas informações, é necessário ler os dados do relatório.
Antes de começar
- Faça login na sua Google Cloud conta do. Se você começou a usar o Google Cloudagora, crie uma conta para avaliar o desempenho dos nossos produtos em situações reais. Clientes novos também recebem US $300 em créditos para executar, testar e implantar cargas de trabalho.
-
Instale a Google Cloud CLI.
-
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init -
Verifique se você tem as permissões necessárias para concluir este guia.
-
Instale a Google Cloud CLI.
-
Ao usar um provedor de identidade (IdP) externo, primeiro faça login na gcloud CLI com sua identidade federada.
-
Para inicializar a CLI gcloud, execute o seguinte comando:
gcloud init -
Verifique se você tem as permissões necessárias para concluir este guia.
Funções exigidas
Para receber as permissões necessárias para ler os metadados de um relatório, peça ao administrador para conceder a você o papel do IAM de Leitor do App Optimize (roles/appoptimize.viewer) no projeto que possui o recurso do relatório.
Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.
Também é possível conseguir as permissões necessárias usando personalizados papéis ou outros predefinidos papéis.
Acessar metadados do relatório
Para recuperar os metadados de um relatório usando a API REST, envie uma solicitação HTTP GET para o endpoint do recurso do relatório.
Use o seguinte curl comando para acessar os metadados
do relatório:
curl -H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://appoptimize.googleapis.com/v1beta/projects/PROJECT_ID/locations/global/reports/REPORT_ID"
Substitua:
PROJECT_ID: o ID do Google Cloud projeto que possui o recurso do relatório que você quer recuperar.REPORT_ID: o ID do relatório a ser recuperado. Esse ID foi especificado quando o relatório foi criado e pode ser obtido listando os relatórios.
Se a solicitação for bem-sucedida, a API vai retornar uma resposta JSON contendo os metadados do relatório.
Confira um exemplo de resposta bem-sucedida, incluindo a dimensão e a métrica selecionadas, o escopo do projeto e quando o relatório está programado para expirar:
{
"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"
]
}