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:
- Não é possível excluir uma instância que tenha réplicas. Você precisa excluir todas as réplicas primeiro.
- 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.
Console
-
No console do Google Cloud, acesse a página 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 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:
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" }
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:
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" }