Excluir instâncias

Nesta página, você verá como excluir instâncias do Cloud SQL.

Considere estas informações na hora de planejar a exclusão de uma instância:

  • Depois você de excluir uma instância, ela pode continuar aparecendo no projeto com um tamanho "desconhecido", mas com o status "Sendo excluída". Isso é normal, e a instância desaparece completamente após um breve período.
  • Pode levar até quatro dias para que os recursos relacionados a uma instância sejam completamente excluídos, exceto as réplicas de leitura, que geralmente são excluídas em alguns minutos.
  • O nome da instância excluída pode ser reutilizado imediatamente para criar uma nova instância.
  • Se a proteção contra exclusão estiver ativada em uma instância, será necessário desativá-la antes de excluí-la.
  • Em caso de imprevistos, faça um backup final para restaurar a instância excluída.

Permissões necessárias

Por padrão, somente contas de usuário ou serviço com os papéis Cloud SQL Admin (roles/cloudsql.admin) ou Owner (roles/owner) têm permissão para excluir uma instância do Cloud SQL (cloudsql.instances.delete).

Também é possível definir um papel personalizado do IAM para a conta de usuário ou serviço que inclui a permissão cloudsql.instances.delete. Essa permissão é suportada por papéis personalizados do IAM.

Excluir uma instância

Você pode excluir uma instância do Cloud SQL usando o Google Cloud console, a CLI gcloud, ou a API. Se você quiser manter os backups da instância antes de excluir, consulte Gerenciar backups retidos.

Console

  1. Noconsole, acesse a página Instâncias do Cloud SQL. Google Cloud

    Acesse "Instâncias do Cloud SQL"

  2. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  3. Clique em Excluir.
  4. Na caixa de diálogo Excluir instância, conclua as seguintes ações:
    1. No campo de texto, insira o ID da instância que aparece.

    2. Se você quiser fazer um backup final da instância, deixe a caixa de seleção Fazer um backup final marcada, expanda o menu Opções de retenção e, no campo Reter por, insira o número de dias para reter o backup final. É possível especificar de 1 a 365 dias.

      Se você quiser excluir a instância sem fazer um backup final, desmarque a caixa de seleção.

    3. Na área de texto Descrever este backup, você pode fornecer uma descrição do backup.
    4. Clique em Excluir.

gcloud

Para excluir uma instância, use o comando gcloud sql instances delete:

gcloud sql instances delete INSTANCE_NAME \
--project=PROJECT_ID

Faça as seguintes substituições:

  • INSTANCE_NAME: o nome da instância.
  • PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância que você quer excluir.

REST v1

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

  • PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância que você quer excluir.
  • INSTANCE_NAME: o nome da instância.

Método HTTP e URL: 

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
Para saber como a solicitação de API REST é criada nesta tarefa, consulte APIs Explorer na página instances:delete.

REST v1beta4

Antes de usar qualquer um dos dados da solicitação, faça as seguintes substituições:

  • PROJECT_ID: o ID ou número do projeto do Google Cloud projeto que contém a instância que você quer excluir.
  • INSTANCE_NAME: o nome da instância.

Método HTTP e URL: 

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_NAME",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}
Para saber como a solicitação de API REST é criada nesta tarefa, consulte APIs Explorer na página instances:delete.

Restaurar uma instância excluída

Quando você exclui uma instância, o Cloud SQL exclui todos os recursos dela, incluindo backups sob demanda e backups automáticos.

Se você fizer um backup final como parte da exclusão de uma instância, poderá usar esse backup para recuperar a instância, criando uma instância a partir do backup final ou restaurando o backup final para uma instância atual.

Se você usar um backup final para recuperar a instância, ela poderá ter um endereço IP diferente da instância original excluída.

Se você excluir uma instância acidentalmente sem fazer um backup final, poderá solicitar a recuperação da instância entrando em contato com o Cloud Customer Care em até quatro dias após a exclusão. Se a instância puder ser recuperada, a configuração dela, incluindo os endereços IP usados antes da exclusão, será restaurada. Todos os backups disponíveis no momento da exclusão também serão recuperados.