Elimine instâncias

MySQL   |  PostgreSQL   |  SQL Server

Esta página descreve como eliminar instâncias do Cloud SQL.

Aviso: todos os dados numa instância, incluindo as cópias de segurança, são perdidos permanentemente quando essa instância é eliminada. Para preservar os seus dados, exporte-os para o Cloud Storage antes de os eliminar. A função de administrador do Cloud SQL inclui a autorização para eliminar a instância. Para evitar a eliminação acidental, conceda esta função apenas quando necessário. Além disso, considere a proteção contra eliminação.

Tenha em atenção o seguinte quando planear eliminar uma instância:

• Não pode eliminar uma instância que tenha réplicas. Tem de eliminar primeiro todas as réplicas.
  Pode reduzir as probabilidades de eliminar acidentalmente uma instância criando uma réplica. Uma réplica tem de ser eliminada antes da respetiva instância principal.
• Depois de eliminar uma instância, esta pode continuar a aparecer no seu projeto com um tamanho "desconhecido", mas com o estado "A ser eliminada". Isto é normal e a instância desaparece completamente após um breve período.
• A eliminação completa dos recursos subjacentes relacionados com uma instância pode demorar até quatro dias, exceto no caso das réplicas de leitura, que são frequentemente eliminadas em poucos minutos.
• O nome da instância eliminada pode ser reutilizado imediatamente para criar uma nova instância.
• Se a proteção contra eliminação estiver ativada numa instância, tem de a desativar antes de eliminar a instância.
• Em caso de contingências, faça uma cópia de segurança final para restaurar a instância eliminada.

Autorizações necessárias

Por predefinição, apenas as contas de utilizador ou de serviço com a função Cloud SQL Admin (roles/cloudsql.admin) ou Owner (roles/owner) têm autorização para eliminar uma instância do Cloud SQL (cloudsql.instances.delete).

Também pode definir uma função personalizada do IAM para o utilizador ou a conta de serviço que inclui a autorização cloudsql.instances.delete. Esta autorização é suportada nas funções personalizadas do IAM.

Elimine uma instância

Pode eliminar uma instância do Cloud SQL através da Google Cloud consola, CLI gcloud ou da API. Se quiser manter cópias de segurança da instância antes de a eliminar, consulte o artigo Gerir cópias de segurança retidas.

Nota: antes de eliminar uma instância, confirme que é seguro fazê-lo. Em seguida, confirme que a proteção contra eliminação está desativada para a instância. Além disso, recomendamos vivamente que faça uma cópia de segurança final da instância antes de a eliminar.

Se usou o Cloud Key Management Service para encriptar a sua instância, mas as chaves do KMS não estão acessíveis, depois de eliminar a instância, o estado da cópia de segurança final é FAILED. Se isto ocorrer, peça a recuperação da sua instância contactando o apoio técnico ao cliente do Google Cloud no prazo de 4 dias a partir do momento em que eliminou a instância.

Se eliminar uma instância que tenha o Private Service Connect ativado, ocorrem as seguintes ações:

• A associação de serviços é removida automaticamente. No entanto, o ponto final do Private Service Connect que aponta para a associação do serviço não é eliminado automaticamente. Ao listar a regra de encaminhamento associada ao ponto final, pode ver que a regra tem o estado CLOSED. Depois de receber este estado, pode eliminar o ponto final.
• A ligação ao ponto final excede o tempo limite.

Para evitar incorrer em custos adicionais, recomendamos vivamente que elimine também a zona de DNS e o registo de DNS correspondentes.

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Para abrir a página Vista geral de uma instância, clique no nome da instância.
3. Clique em Eliminar.
4. Na caixa de diálogo Eliminar instância, conclua as seguintes ações:
1. No campo de texto, introduza o ID da instância apresentado.

2. Se quiser fazer uma cópia de segurança final da instância, deixe a caixa de verificação Fazer uma cópia de segurança final selecionada, expanda o menu Opções de retenção e, de seguida, no campo Manter durante, introduza o número de dias para reter a cópia de segurança final. Pode especificar um período de 1 a 365 dias.

   Se quiser eliminar a instância sem fazer uma cópia de segurança final, desmarque a caixa de verificação.

3. Na área de texto Descreva esta cópia de segurança, pode fornecer uma descrição da cópia de segurança.
4. Clique em Eliminar.

gcloud

Para eliminar 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 o número do projeto do Google Cloud projeto que contém a instância que quer eliminar

Nota: se quiser fazer uma cópia de segurança final da instância, use as seguintes flags:

• --enable-final-backup: defina o valor desta flag como true para fazer uma cópia de segurança final. Se quiser eliminar a instância sem fazer uma cópia de segurança final, defina o valor como false.
• --final-backup-description: indique detalhes sobre a cópia de segurança final. O valor predefinido está vazio.
• --final-backup-ttl-days: especifique o número de dias para reter a cópia de segurança final. Isto é conhecido como tempo de vida (TTL). O valor predefinido é 30 dias. O período de retenção permitido varia entre 1 e 365 dias. Para indicar o período de retenção, use esta flag ou --final-backup-expiry-time.
• --final-backup-expiry-time: esta é uma data/hora (em UTC) da expiração da cópia de segurança. Não pode exceder 1 ano. Para indicar o período de retenção, use esta flag ou --final-backup-ttl-days.

REST v1

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância que quer eliminar
• INSTANCE_NAME: o nome da instância

Nota: se quiser fazer uma cópia de segurança final da instância, use os seguintes parâmetros de consulta:

• enable_final_backup: defina o valor deste parâmetro como true para fazer uma cópia de segurança final. Se quiser eliminar a instância sem fazer uma cópia de segurança final, defina o valor como false.
• final_backup_description: indique detalhes sobre a cópia de segurança final. O valor predefinido está vazio.
• final_backup_ttl_days: especifique o número de dias para reter a cópia de segurança final. Isto é conhecido como tempo de vida (TTL). O valor predefinido é 30 dias. O período de retenção permitido varia entre 1 e 365 dias. Para indicar o período de retenção, use este parâmetro ou final_backup_expiry_time.
• final_backup_expiry_time: esta é uma data/hora (em UTC) da expiração da cópia de segurança. Não pode exceder 1 ano. Para indicar o período de retenção, 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 ver como o pedido da API REST subjacente é construído para esta tarefa, consulte o Explorador de APIs na página instances:delete.

REST v1beta4

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID ou o número do projeto do Google Cloud projeto que contém a instância que quer eliminar
• INSTANCE_NAME: o nome da instância

Nota: se quiser fazer uma cópia de segurança final da instância, use os seguintes parâmetros de consulta:

• enable_final_backup: defina o valor deste parâmetro como true para fazer uma cópia de segurança final. Se quiser eliminar a instância sem fazer uma cópia de segurança final, defina o valor como false.
• final_backup_description: indique detalhes sobre a cópia de segurança final. O valor predefinido está vazio.
• final_backup_ttl_days: especifique o número de dias para reter a cópia de segurança final. Isto é conhecido como tempo de vida (TTL). O valor predefinido é 30 dias. O período de retenção permitido varia entre 1 e 365 dias. Para indicar o período de retenção, use este parâmetro ou final_backup_expiry_time.
• final_backup_expiry_time: esta é uma data/hora (em UTC) da expiração da cópia de segurança. Não pode exceder 1 ano. Para indicar o período de retenção, 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando 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

Deve receber uma resposta JSON semelhante à seguinte:

{
  "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 ver como o pedido da API REST subjacente é construído para esta tarefa, consulte o Explorador de APIs na página instances:delete.

Restaure uma instância eliminada

Quando elimina uma instância, o Cloud SQL elimina todos os recursos da instância, incluindo cópias de segurança a pedido e cópias de segurança automáticas.

Se fizer uma cópia de segurança final como parte da eliminação de uma instância, pode usar esta cópia de segurança para recuperar a instância, quer criando uma instância a partir da cópia de segurança final, quer restaurando a cópia de segurança final para uma instância existente.

Se usar uma cópia de segurança final para recuperar a instância, esta pode ter um endereço IP diferente do da instância original eliminada.

Se eliminar uma instância acidentalmente sem fazer uma cópia de segurança final, pode pedir a recuperação da instância contactando o apoio técnico do Google Cloud no prazo de 4 dias a partir do momento em que a instância é eliminada. Se for possível recuperar a instância, a configuração da instância, incluindo os endereços IP usados antes da eliminação, é restaurada. Todas as cópias de segurança disponíveis no momento da eliminação também são recuperadas.