Excluir e restaurar projetos

Nesta página, explicamos como encerrar e restaurar projetos do Google Cloud . Entenda o período de recuperação de 30 dias, os cronogramas de exclusão de recursos e como evitar a perda de dados.

Desligar (excluir) um projeto

Ao encerrar um projeto, todo o faturamento e o uso de recursos são interrompidos. Essa ação move imediatamente o projeto para um período de recuperação de 30 dias, após o qual o projeto e todos os dados associados são excluídos permanentemente. Somente projetos com um estado de ciclo de vida de ACTIVE podem ser desligados.

Processo e cronograma de exclusão

Quando você inicia um desligamento, os seguintes eventos ocorrem:

  1. Desligamento imediato: o projeto é marcado imediatamente para exclusão e fica inutilizável.

  2. Notificação: Google Cloud envia um e-mail de notificação ao usuário que iniciou a exclusão e aos contatos listados na categoria "Técnica" dos Contatos essenciais.

  3. Desconexão do faturamento: todas a conta do Cloud Billing associadas são desconectadas. Essa associação não será restabelecida automaticamente se o projeto for restaurado mais tarde.

  4. Janela de recuperação de 30 dias: o projeto permanece no estado DELETE_REQUESTED por 30 dias. Durante esse período, os proprietários do projeto podem restaurá-lo.

  5. Exclusão permanente: após 30 dias, o projeto e todos os recursos dele são excluídos permanentemente e não podem ser recuperados.

Considerações importantes

Antes de encerrar um projeto, analise os seguintes riscos:

  • Recuperação de recursos: embora a maioria dos recursos possa ser recuperada dentro do período de 30 dias, alguns serviços, como o Cloud Storage e o Pub/Sub, excluem recursos muito antes. Esses recursos podem não ser totalmente recuperados, mesmo que o projeto seja restaurado.

  • Atrasos na restauração: se você restaurar um projeto, alguns serviços podem levar até 36 horas para retomar totalmente as operações.

  • IDs do projeto: são exclusivos e permanentes. Depois que um projeto é totalmente excluído, o ID dele não pode ser reutilizado. Se você quiser preservar um ID do projeto personalizado para uso futuro, exclua os recursos dentro do projeto em vez de encerrar o projeto em si.

  • Cota de projeto: até que um projeto seja excluído permanentemente (após o período de 30 dias), ele continua sendo contabilizado na sua cota de projeto.

  • Cobranças de faturamento: os projetos podem continuar gerando cobranças até o fim do ciclo de faturamento atual. Para evitar cobranças inesperadas, desative o faturamento manualmente antes de iniciar um encerramento.

Salvaguardas

Para evitar a exclusão acidental de projetos críticos para a empresa, ative as recomendações de risco de alterações. Essas recomendações mostram avisos quando você tenta excluir projetos que o Google Cloudidentificou como importantes com base na atividade recente.

Para saber mais sobre retenção de dados e exclusão segura, consulte Como o Google retém os dados coletados.

É possível encerrar projetos usando o console Google Cloud , a Google Cloud CLI ou a API.

Console

  1. No Google Cloud console, acesse a página Configurações do IAM e do administrador.

    Acessar as configurações do IAM e do administrador

    As etapas restantes aparecem no console do Google Cloud .

  2. Na página Configurações IAM e administrador, selecione o projeto que você quer excluir e clique em Encerrar.

    A opção Desativar só aparece para usuários com a permissão resourcemanager.projects.delete no projeto atual.

  3. Clique em Encerrar.
  4. Digite o ID do projeto e clique em Encerrar mesmo assim.

gcloud

  1. No console do Google Cloud , ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

  2. Para excluir um projeto, use o comando gcloud projects delete:

    gcloud projects delete PROJECT_ID

    Em que PROJECT_ID é o código do projeto que você quer excluir.

REST

O snippet de código a seguir exclui o projeto especificado:

Solicitação:

DELETE https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123

Solução de problemas na exclusão de projetos

Se você encontrar problemas ao tentar desligar ou restaurar um projeto, isso geralmente ocorre devido a restrições de permissão ou "garantias" de recursos específicos. Para mais informações, consulte Resolver problemas de exclusão de projetos.

Restaurar um projeto

Os proprietários de projetos podem restaurar um projeto excluído dentro do período de recuperação de 30 dias, contados a partir do momento em que ele é encerrado.

Restaurar um projeto faz com que ele retorne ao estado em que estava antes de ser encerrado, com as seguintes exceções:

  • O faturamento é desativado no projeto quando ele é encerrado. Ele não é reativado automaticamente após a restauração. É necessário vincular manualmente o projeto a uma conta do Cloud Billing. Talvez seja necessário aguardar algumas horas antes de vincular um projeto restaurado recentemente a uma conta de faturamento.

  • É possível recuperar a maioria dos recursos se você restaurar um projeto dentro do período de 30 dias. Alguns serviços, como o Cloud Storage ou o Pub/Sub, podem excluir dados antes de 30 dias. Esses recursos podem não ser totalmente recuperáveis.

  • Pode levar até 36 horas para que todos os serviços de um projeto restaurado fiquem totalmente funcionais. Se os recursos não forem restaurados após esse período, entre em contato com o Suporte do Google.

  • Pode ser que alguns serviços precisem ser reiniciados manualmente. Para mais informações, consulte Como reiniciar os serviços do Google Cloud .

Para restaurar um projeto, você precisa ter a permissão resourcemanager.projects.undelete no projeto. Para ver os projetos pendentes de exclusão no console, você também precisa das seguintes permissões:

  • resourcemanager.projects.list
  • resourcemanager.folders.list (se o projeto estiver em uma pasta)
  • resourcemanager.projects.get

Para restaurar um projeto, use um dos seguintes métodos:

Console

  1. No console Google Cloud , acesse a página Gerenciar recursos.

    Acessar "Gerenciar recursos"

  2. No Seletor de projetos, na parte de cima da página, selecione o recurso da sua organização.

  3. Abaixo da lista de recursos da organização, pastas e projetos, clique em Recursos com exclusão pendente.

  4. Marque a caixa de seleção do projeto que você quer restaurar e clique em Restaurar. Na caixa de diálogo exibida, confirme que você quer restaurar o projeto.

gcloud

  1. No console do Google Cloud , ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

  2. Para restaurar um projeto, use o comando gcloud projects undelete:

    gcloud projects undelete PROJECT_ID

    Em que PROJECT_ID é o ID do projeto ou o número do projeto que você quer restaurar.

REST

O snippet de código a seguir restaura o projeto especificado:

Solicitação:

POST https://cloudresourcemanager.googleapis.com/v3/projects/my-project-123:undelete

A seguir