Excluir um relatório

Um relatório criado pela API App Optimize é excluído automaticamente 24 horas após a criação. No entanto, é possível usar a API para excluir o relatório explicitamente antes do vencimento programado, se ele não for mais necessário.

Depois de excluído, um relatório e os dados dele não ficam mais acessíveis na API App Optimize.

Antes de começar

gcloud

  • Instale a Google Cloud CLI.

  • Configure a CLI gcloud para usar sua identidade federada.

    Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.

  • Para inicializar a CLI gcloud, execute o seguinte comando: 

    gcloud init

  • Depois de inicializar a CLI gcloud, atualize-a e instale os componentes necessários: 

    gcloud components update
gcloud components install beta

    • Para informações sobre como configurar a autenticação em um ambiente de produção, consulte Configurar o Application Default Credentials para código em execução em Google Cloud na documentação de autenticação. Google Cloud

    Python

    1. Instale a biblioteca de cliente Python para a App Optimize API.

    2. Para usar os exemplos do Python nesta página em um ambiente de desenvolvimento local, instale e inicialize a CLI gcloud e configure o Application Default Credentials com suas credenciais de usuário.

      1. Instale a Google Cloud CLI.

      2. Configure a CLI gcloud para usar sua identidade federada.

        Para mais informações, consulte Fazer login na CLI gcloud com sua identidade federada.

      3. Crie credenciais de autenticação local para sua conta de usuário: 

        gcloud auth application-default login

        Se um erro de autenticação for retornado e você estiver usando um provedor de identidade (IdP) externo, confirme se você fez login na CLI gcloud com sua identidade federada.

      Saiba mais em Configurar o ADC para um ambiente de desenvolvimento local na documentação de autenticação do. Google Cloud

      Para informações sobre como configurar a autenticação em um ambiente de produção, consulte Configurar o Application Default Credentials para código em execução em Google Cloud na documentação de autenticação. Google Cloud

    REST

    Para usar as amostras da API REST desta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para a CLI gcloud.

      Instale a Google Cloud CLI e faça login na CLI gcloud com sua identidade federada.

    Saiba mais em Autenticar para usar REST na documentação de Google Cloud autenticação.

    Para informações sobre como configurar a autenticação em um ambiente de produção, consulte Configurar o Application Default Credentials para código em execução em Google Cloud na documentação de autenticação. Google Cloud

    Funções exigidas

    Para receber as permissões necessárias para excluir um relatório, peça ao administrador para conceder a você o papel do IAM de administrador do App Optimize (roles/appoptimize.admin) 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.

    Excluir um relatório

    Para excluir um relatório, siga as instruções do método preferido:

    gcloud

    Use o comando gcloud beta app-optimize reports delete para remover o relatório.

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

    Substitua:

    • PROJECT_ID: o ID do Google Cloud projeto que possui o recurso do relatório que você quer excluir.
    • REPORT_ID: o ID do relatório a ser excluído. Esse ID foi especificado quando o relatório foi criado e pode ser obtido por listando relatórios no projeto.

    Python

    O código Python a seguir usa AppOptimizeClient.delete_report() para remover o relatório.

    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 a report deletion
client = appoptimize_v1beta.AppOptimizeClient()
request = appoptimize_v1beta.DeleteReportRequest(name=name)
client.delete_report(request=request)
print(f"Deleted report: {name}")

    Substitua:

    • PROJECT_ID: o ID do Google Cloud projeto que possui o recurso do relatório que você quer excluir.
    • REPORT_ID: o ID do relatório a ser excluído. Esse ID foi especificado quando o relatório foi criado e pode ser obtido por listando relatórios no projeto.

    REST

    Use o comando curl a seguir para enviar uma solicitação HTTP DELETE ao endpoint do recurso do relatório:

    curl -X DELETE \
  -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 excluir.
    • REPORT_ID: o ID do relatório a ser excluído. Esse ID foi especificado quando o relatório foi criado e pode ser obtido por listando relatórios no projeto.

    Se a solicitação for bem-sucedida, a API retornará a resposta JSON vazia {}.

    A seguir