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.
Encerrar (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 encerrados.
Processo e cronograma de exclusão
Quando você inicia um encerramento, os seguintes eventos ocorrem:
Encerramento imediato: o projeto é marcado para exclusão imediatamente e fica inutilizável.
Notificação: Google Cloud envia um e-mail de notificação para o usuário que iniciou a exclusão e para os contatos listados na categoria Técnica dos Contatos essenciais.
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.
Janela de recuperação de 30 dias: o projeto permanece no estado
DELETE_REQUESTEDpor 30 dias. Durante esse período, os proprietários do projeto podem restaurar o projeto.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.
Acompanhar o progresso da exclusão
Depois de iniciar um desligamento, use o comando gcloud projects describe
para acompanhar o progresso do período de exclusão de 30 dias:
gcloud projects describe PROJECT_ID
A saída mostra o lifecycleState e outros detalhes do projeto, conforme mostrado no
exemplo a seguir:
createTime: '2025-06-14T10:00:00.000Z'
lifecycleState: DELETE_REQUESTED
name: Test Project
parent:
id: '123456789012'
type: folder
projectId: Test Project
projectNumber: '987654321098'
Considerações importantes
Antes de encerrar um projeto, analise os seguintes riscos:
Recuperação de recursos: embora a maioria dos recursos seja recuperável dentro do período de 30 dias, alguns serviços, como o Cloud Storage e o Pub/Sub, podem excluir recursos muito antes. Esses recursos podem não ser totalmente recuperados, mesmo se o projeto for 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.
Descontos por compromisso de uso (CUDs) ativos: se você tiver CUDs ativos em um projeto, a exclusão dele pode causar problemas inesperados de faturamento ou o cancelamento dos descontos. Para evitar a exclusão acidental de projetos com CUDs ativos, recomendamos aplicar garantias de projeto.
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 Cloud identificou 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 que coletamos.
É possível encerrar projetos usando o console do Google Cloud , a Google Cloud CLI ou a API.
Console
-
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 .
-
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.deleteno projeto atual. - Clique em Encerrar.
- Digite o ID do projeto e clique em Encerrar mesmo assim.
Outra opção é excluir um projeto na página Gerenciar recursos:
No console Google Cloud , acesse a página Gerenciar recursos.
Selecione o projeto que você quer excluir.
Clique em Excluir.
Digite o ID do projeto e clique em Encerrar.
gcloud
-
No console do Google Cloud , ative 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.
Para excluir um projeto, use o comando
gcloud projects delete:gcloud projects delete PROJECT_IDEm 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
Resolver problemas na exclusão de projetos
Se você tiver problemas ao tentar encerrar ou restaurar um projeto, isso geralmente ocorre devido a restrições de permissão ou "ônus" de recursos específicos. Para mais informações, consulte Resolver problemas de exclusão de projetos.
Restaurar um projeto
Os proprietários do projeto podem restaurar um projeto excluído dentro do período de recuperação de 30 dias, que começa quando o projeto é 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 o projeto é 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. Por exemplo, os recursos do Cloud Storage protegidos pela exclusão reversível podem ser excluídos após 7 dias, dependendo da duração da retenção da exclusão reversível, mas os buckets com a exclusão reversível desativada podem ser excluídos imediatamente e não podem ser recuperados. A taxa de sucesso da recuperação de recursos está vinculada às dependências deles.
Pode levar até 36 horas para que todos os serviços de um projeto restaurado fiquem totalmente funcionais. Em especial, os clientes OAuth podem levar de 1 a 3 dias para ficar totalmente operacionais após a restauração de um projeto. 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.listresourcemanager.folders.list(se o projeto estiver em uma pasta)resourcemanager.projects.get
Para restaurar um projeto, use um dos seguintes métodos:
Console
No console Google Cloud , acesse a página Gerenciar recursos.
No Seletor de projetos na parte de cima da página, selecione o recurso da sua organização.
Abaixo da lista de recursos, pastas e projetos da organização, clique em Recursos pendentes de exclusão.
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
-
No console do Google Cloud , ative 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.
Para restaurar um projeto, use o comando
gcloud projects undelete:gcloud projects undelete PROJECT_IDPROJECT_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
- Saiba como mover um projeto na hierarquia de recursos.
- Saiba como migrar um projeto de um recurso de organização para outro.