Excluir instâncias

MySQL | PostgreSQL | SQL Server

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.

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 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 ocorrer, 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

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

Acesse "Instâncias do Cloud SQL"
Para abrir a página Visão geral de uma instância, clique no nome da instância.
Clique em Excluir.
Na caixa de diálogo Excluir instância, conclua as seguintes ações:

No campo de texto, insira o ID da instância que aparece.
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.
Na área de texto Descrever este backup, você pode fornecer uma descrição do backup.
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.

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 o número de dias para reter o backup final. 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: esse é um carimbo de data/hora (em UTC) de quando o backup está definido para expirar. Ele não pode exceder um ano. Para fornecer 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 projeto que contém a instância que você quer excluir.
INSTANCE_NAME: o 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 o número de dias para reter o backup final. 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 esse parâmetro ou final_backup_expiry_time.
final_backup_expiry_time: esse é um carimbo de data/hora (em UTC) de quando o backup está definido para expirar. Ele não pode exceder um ano. Para fornecer o período de armazenamento, use esse 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": "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 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 projeto que contém a instância que você quer excluir.
INSTANCE_NAME: o 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 o número de dias para reter o backup final. 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 esse parâmetro ou final_backup_expiry_time.
final_backup_expiry_time: esse é um carimbo de data/hora (em UTC) de quando o backup está definido para expirar. Ele não pode exceder um ano. Para fornecer o período de armazenamento, use esse 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)

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)

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": "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.

Excluir instâncias Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Permissões necessárias

Excluir uma instância

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Restaurar uma instância excluída

Excluir instâncias