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, é necessário desativar 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:

• 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.