Esta página foi traduzida pela API Cloud Translation.

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

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

Observe o seguinte quando você planeja excluir uma instância:

Não é possível excluir uma instância que tenha réplicas. É necessário excluir todas as réplicas primeiro.
Você pode reduzir suas chances de excluir acidentalmente uma instância criando uma réplica; uma réplica deve ser excluída antes de sua instância primária.
Após excluir uma instância, ela pode continuar aparecendo no seu 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 subjacentes relacionados a uma instância sejam completamente excluídos, com exceção das réplicas de leitura, que geralmente são excluídas em poucos 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 habilitada em uma instância, você deverá desabilitá-la antes de excluí-la.
Em caso de contingências, 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 a função 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 ).

Você também pode definir uma função personalizada do IAM para a conta de usuário ou serviço que inclua a permissão cloudsql.instances.delete . Essa permissão é compatível com funções personalizadas do IAM.

Excluir uma instância

Você pode excluir uma instância do Cloud SQL usando o Google Cloud console, CLI do gcloud ou a API. Se quiser manter backups da sua instância antes de excluí-la, consulte Gerenciar backups retidos .

Observação: antes de excluir uma instância, confirme se é seguro fazê-lo. Em seguida, confirme se a proteção contra exclusão está desativada para a instância. Além disso, recomendamos fortemente que você faça um backup final da instância antes de excluí-la.

Se você usou o Cloud Key Management Service para criptografar sua instância, mas as chaves KMS não estão acessíveis, após a exclusão da instância, o status do backup final será FAILED . Se isso ocorrer, solicite a recuperação da sua instância entrando em contato com o Atendimento ao Cliente do Cloud em até 4 dias a partir do momento da exclusão.

Se você excluir uma instância que tenha o Private Service Connect habilitado, as seguintes ações ocorrerão:

O anexo de serviço é removido automaticamente. No entanto, o endpoint do Private Service Connect que aponta para o anexo de serviço não é excluído automaticamente. Ao listar a regra de encaminhamento associada ao endpoint, você pode ver que a regra tem o status CLOSED . Após receber esse status, você pode excluir o endpoint.
Você vê que a conexão com o ponto de extremidade atingiu o tempo limite.

Para evitar custos adicionais, recomendamos fortemente que você também exclua a zona DNS e o registro DNS correspondentes.

Console

No Google Cloud console, acesse a página Instâncias do Cloud SQL .
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 desejar 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 manter o backup final. Você pode 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 Descreva 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ê deseja excluir

Observação: se você quiser fazer um backup final da instância, use os seguintes sinalizadores:

--enable-final-backup : defina o valor deste sinalizador como true para fazer um backup final. Se desejar excluir a instância sem fazer um backup final, defina o valor como false .
--final-backup-description : fornece detalhes sobre o backup final. O valor padrão é vazio.
--final-backup-ttl-days : especifique o número de dias para manter o backup final. Isso é conhecido como tempo de vida (TTL). O valor padrão é 30 dias. O período de retenção permitido varia de 1 a 365 dias. Para fornecer o período de retenção, use este sinalizador ou --final-backup-expiry-time .
--final-backup-expiry-time : este é um registro de data e hora (em UTC) de quando o backup está definido para expirar. Não pode exceder 1 ano. Para fornecer o período de retenção, use este sinalizador ou --final-backup-ttl-days .

REST v1

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

PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância que você deseja 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 deste parâmetro como true para fazer um backup final. Se desejar 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 manter o backup final. Isso é conhecido como tempo de vida (TTL). O valor padrão é 30 dias. O período de retenção permitido varia de 1 a 365 dias. Para fornecer o período de retenção, use este parâmetro ou final_backup_expiry_time .
final_backup_expiry_time : este é um registro de data e hora (em UTC) de quando o backup está definido para expirar. Não pode exceder 1 ano. Para fornecer 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 sua solicitação, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login , ou usando o Cloud Shell , que efetua login automaticamente na CLI gcloud . Você pode verificar a conta ativa no momento 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ê tenha efetuado login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . Você pode verificar a conta ativa no momento 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ê 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": "[email protected]",
  "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 a solicitação da API REST subjacente é construída para esta tarefa, consulte o APIs Explorer na página instances:delete .

REST v1beta4

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

PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância que você deseja 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 deste parâmetro como true para fazer um backup final. Se desejar 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 manter o backup final. Isso é conhecido como tempo de vida (TTL). O valor padrão é 30 dias. O período de retenção permitido varia de 1 a 365 dias. Para fornecer o período de retenção, use este parâmetro ou final_backup_expiry_time .
final_backup_expiry_time : este é um registro de data e hora (em UTC) de quando o backup está definido para expirar. Não pode exceder 1 ano. Para fornecer 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 sua 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ê 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": "[email protected]",
  "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 a solicitação da API REST subjacente é construída para esta tarefa, consulte o 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 da instância, incluindo backups sob demanda e backups automatizados .

Se você fizer um backup final como parte da exclusão de uma instância, poderá usá-lo para recuperar a instância, criando uma instância a partir do backup final ou restaurando o backup final para uma instância existente.

Se você usar um backup final para recuperar sua 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 Atendimento ao Cliente do Cloud em até 4 dias a partir do momento da exclusão. Se a instância puder ser recuperada, a configuração da instância, 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.

MySQL | PostgreSQL | SQL Server

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

Observe o seguinte quando você planeja excluir uma instância:

Não é possível excluir uma instância que tenha réplicas. É necessário excluir todas as réplicas primeiro.
Você pode reduzir suas chances de excluir acidentalmente uma instância criando uma réplica; uma réplica deve ser excluída antes de sua instância primária.
Após excluir uma instância, ela pode continuar aparecendo no seu 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 subjacentes relacionados a uma instância sejam completamente excluídos, com exceção das réplicas de leitura, que geralmente são excluídas em poucos 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 habilitada em uma instância, você deverá desabilitá-la antes de excluí-la.
Em caso de contingências, faça um backup final para restaurar a instância excluída.

Permissões necessárias

Excluir uma instância

Se você excluir uma instância que tenha o Private Service Connect habilitado, as seguintes ações ocorrerão:

O anexo de serviço é removido automaticamente. No entanto, o endpoint do Private Service Connect que aponta para o anexo de serviço não é excluído automaticamente. Ao listar a regra de encaminhamento associada ao endpoint, você pode ver que a regra tem o status CLOSED . Após receber esse status, você pode excluir o endpoint.
Você vê que a conexão com o ponto de extremidade atingiu o tempo limite.

Para evitar custos adicionais, recomendamos fortemente que você também exclua a zona DNS e o registro DNS correspondentes.

Console

No Google Cloud console, acesse a página Instâncias do Cloud SQL .
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 desejar 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 manter o backup final. Você pode 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 Descreva 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ê deseja excluir

Observação: se você quiser fazer um backup final da instância, use os seguintes sinalizadores:

--enable-final-backup : defina o valor deste sinalizador como true para fazer um backup final. Se desejar excluir a instância sem fazer um backup final, defina o valor como false .
--final-backup-description : fornece detalhes sobre o backup final. O valor padrão é vazio.
--final-backup-ttl-days : especifique o número de dias para manter o backup final. Isso é conhecido como tempo de vida (TTL). O valor padrão é 30 dias. O período de retenção permitido varia de 1 a 365 dias. Para fornecer o período de retenção, use este sinalizador ou --final-backup-expiry-time .
--final-backup-expiry-time : este é um registro de data e hora (em UTC) de quando o backup está definido para expirar. Não pode exceder 1 ano. Para fornecer o período de retenção, use este sinalizador ou --final-backup-ttl-days .

REST v1

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

PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância que você deseja 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 deste parâmetro como true para fazer um backup final. Se desejar 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 manter o backup final. Isso é conhecido como tempo de vida (TTL). O valor padrão é 30 dias. O período de retenção permitido varia de 1 a 365 dias. Para fornecer o período de retenção, use este parâmetro ou final_backup_expiry_time .
final_backup_expiry_time : este é um registro de data e hora (em UTC) de quando o backup está definido para expirar. Não pode exceder 1 ano. Para fornecer 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 sua 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/v1/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/v1/projects/PROJECT_ID/instances/INSTANCE_NAME" | Select-Object -Expand Content

Você 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": "[email protected]",
  "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 a solicitação da API REST subjacente é construída para esta tarefa, consulte o APIs Explorer na página instances:delete .

REST v1beta4

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

PROJECT_ID : o ID ou número do projeto do Google Cloud projeto que contém a instância que você deseja 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 deste parâmetro como true para fazer um backup final. Se desejar 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 manter o backup final. Isso é conhecido como tempo de vida (TTL). O valor padrão é 30 dias. O período de retenção permitido varia de 1 a 365 dias. Para fornecer o período de retenção, use este parâmetro ou final_backup_expiry_time .
final_backup_expiry_time : este é um registro de data e hora (em UTC) de quando o backup está definido para expirar. Não pode exceder 1 ano. Para fornecer 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 sua 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ê 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": "[email protected]",
  "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 a solicitação da API REST subjacente é construída para esta tarefa, consulte o 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 da instância, incluindo backups sob demanda e backups automatizados .

Se você usar um backup final para recuperar sua instância, ela poderá ter um endereço IP diferente da instância original excluída.

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

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
Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.