Excluir instâncias

MySQL   |  PostgreSQL   |  SQL Server

A exclusão de uma instância do Cloud SQL permite remover permanentemente bancos de dados desnecessários e interromper as cobranças de computação e armazenamento. Como a exclusão apaga permanentemente os dados e backups da instância, você pode fazer um backup final ou exportar dados para o Cloud Storage com antecedência para preservar suas informações. Antes de excluir uma instância principal, remova todas as réplicas de leitura e desative a proteção contra exclusão, se ela estiver ativada.

Antes de começar

Aviso:ao excluir uma instância, todos os dados contidos nela são perdidos permanentemente, inclusive backups. Para preservá-los, exporte os dados para o Cloud Storage antes de excluir a instância. O papel de administrador do Cloud SQL inclui a permissão para excluir a instância. Para evitar exclusões acidentais, conceda esse papel somente quando necessário. Além disso, considere a proteção contra exclusão.

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

• Não é possível excluir uma instância que tenha réplicas. Você precisa excluir todas as réplicas primeiro.
  Crie uma réplica para reduzir as chances de excluir acidentalmente uma instância. Além disso, uma réplica precisa ser excluída antes da instância principal.
• 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 contingências, 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

É possível excluir uma instância do Cloud SQL usando o console do Google Cloud , a CLI gcloud ou a API. Se você quiser reter backups da sua instância antes de excluir, consulte Gerenciar backups retidos.

Observação: antes de excluir uma instância, confirme se é seguro fazer isso. Em seguida, confirme se a proteção contra exclusão está desativada na instância. Além disso, recomendamos que você faça um backup final da instância antes de excluí-la.

Se você usou o Cloud Key Management Service para criptografar a instância, mas as chaves do KMS não estão acessíveis, depois de excluir a instância, o status do backup final será FAILED. Se isso acontecer, solicite a recuperação da instância entrando em contato com o Cloud Customer Care em até quatro dias após a exclusão.

Se você excluir uma instância que tem o Private Service Connect ativado, vão ocorrer as seguintes ações:

• O anexo de serviço será removido automaticamente. No entanto, o endpoint do Private Service Connect que aponta para o anexo de serviço não será excluído automaticamente. Ao listar a regra de encaminhamento associada ao endpoint, é possível ver que a regra tem um status CLOSED. Depois de receber esse status, você pode excluir o endpoint.
• Você verá a conexão com o endpoint expirar.

Para evitar custos adicionais, recomendamos que você também exclua a zona de DNS e o registro DNS correspondentes.

Console

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

   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, abra 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 Descreva este backup, forneça 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: nome da instância
• PROJECT_ID: o ID ou número do projeto do Google Cloud que contém a instância que você quer excluir

Observação : se você quiser fazer um backup final da instância, use as seguintes flags:

• --enable-final-backup: defina o valor dessa flag como true para fazer um backup final. Se você quiser excluir a instância sem fazer um backup final, defina o valor como false.
• --final-backup-description: forneça detalhes sobre o backup final. O valor padrão é vazio.
• --final-backup-ttl-days: especifique por quantos dias o backup final será mantido. Isso é conhecido como time to live (TTL). O valor padrão é de 30 dias. O período de armazenamento permitido varia de 1 a 365 dias. Para fornecer o período de armazenamento, use essa flag ou --final-backup-expiry-time.
• --final-backup-expiry-time: é um carimbo de data/hora (em UTC) de quando o backup está definido para expirar. Esse período não pode exceder 1 ano. Para informar o período de armazenamento, use essa flag ou --final-backup-ttl-days.

REST v1

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Observação : se você quiser fazer um backup final da instância, use os seguintes parâmetros de consulta:

• enable_final_backup: defina o valor desse parâmetro como true para fazer um backup final. Se você quiser excluir a instância sem fazer um backup final, defina o valor como false.
• final_backup_description: forneça detalhes sobre o backup final. O valor padrão é vazio.
• final_backup_ttl_days: especifique por quantos dias o backup final será mantido. Isso é conhecido como time to live (TTL). O valor padrão é de 30 dias. O período de armazenamento permitido varia de 1 a 365 dias. Para informar o período de armazenamento, use este parâmetro ou final_backup_expiry_time.
• final_backup_expiry_time: é um carimbo de data/hora (em UTC) de quando o backup está definido para expirar. Esse período não pode exceder 1 ano. Para informar o período de armazenamento, use este parâmetro ou final_backup_ttl_days.

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:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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": "[e-mail]",
  "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 os dados da solicitação abaixo, faça as substituições a seguir:

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

Observação : se você quiser fazer um backup final da instância, use os seguintes parâmetros de consulta:

• enable_final_backup: defina o valor desse parâmetro como true para fazer um backup final. Se você quiser excluir a instância sem fazer um backup final, defina o valor como false.
• final_backup_description: forneça detalhes sobre o backup final. O valor padrão é vazio.
• final_backup_ttl_days: especifique por quantos dias o backup final será mantido. Isso é conhecido como time to live (TTL). O valor padrão é de 30 dias. O período de armazenamento permitido varia de 1 a 365 dias. Para informar o período de armazenamento, use este parâmetro ou final_backup_expiry_time.
• final_backup_expiry_time: é um carimbo de data/hora (em UTC) de quando o backup está definido para expirar. Esse período não pode exceder 1 ano. Para informar o período de armazenamento, use este parâmetro ou final_backup_ttl_days.

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:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI do gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você tenha feito login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Para saber qual é a conta ativa no momento, execute o comando gcloud auth list.

Execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

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": "[e-mail]",
  "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 automatizados.

Se você fizer um backup final ao excluir uma instância, poderá usá-lo para recuperar a instância, seja criando uma instância com base no backup final ou restaurando o backup final em 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 dela 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 são recuperados.