Excluir instâncias

MySQL   |  PostgreSQL   |  SQL Server

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

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é uma semana 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.

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 a gcloud CLI ou a API.

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.

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 do banco de dados, clique em OK.

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 que contém a instância que você quer excluir

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

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI 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. . É 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://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É 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://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 subjacente é 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: 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:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI 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. . É 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://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É 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://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 subjacente é criada nesta tarefa, consulte APIs Explorer na página "instances:delete".