Como excluir instâncias

MySQL   |  PostgreSQL   |  SQL Server

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

Aviso: quando uma instância é excluída, todos os dados contidos nela são perdidos permanentemente, inclusive backups. Para preservá-los, exporte-os para o Cloud Storage antes de excluí-la. 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.

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

• Você não pode 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.
• Não é possível reutilizar um nome de instância uma semana depois de excluí-la.

Excluir uma instância

Console

1. Acesse a página Instâncias do Cloud SQL no Console do Google Cloud.

   Acessar a página "Instâncias" do Cloud SQL

2. Selecione uma instância a ser excluída clicando no nome dela.
3. Clique em Excluir.
4. Na caixa de diálogo Excluir instância do banco de dados, clique em OK.

gcloud

Exclua a instância.

gcloud sql instances delete [INSTANCE_NAME]

REST

Exclua a instância.

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

• project-id: o ID do projeto
• instance-id: o ID da instância

Método HTTP e URL:

DELETE https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

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

curl (Linux, macOS ou Cloud Shell)

Observação: em relação ao comando abaixo, presume-se que você usou gcloud init ou gcloud auth login para autenticar gcloud com sua conta de usuário. É possível verificar a conta ativa atual executando gcloud auth list.

Execute o seguinte comando:

curl -X DELETE \
-H "Authorization: Bearer "$(gcloud auth print-access-token) \
https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

PowerShell (Windows)

Observação: em relação ao comando abaixo, presume-se que você usou gcloud init ou gcloud auth login para autenticar gcloud com sua conta de usuário. É possível verificar a conta ativa atual executando 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://www.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

{
  "kind": "sql#operation",
  "targetLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/instances/var>instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "insertTime": "2020-01-15T00:10:22.078Z",
  "operationType": "DELETE",
  "name": "operation-id",
  "targetId": "instance-id",
  "selfLink": "https://www.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",
  "targetProject": "project-id"
}

Para ver como a solicitação da API REST subjacente é criada nesta tarefa, consulte o APIs Explorer na página "instances:delete"..