Esta página descreve como gerenciar backups finais para sua instância do Cloud SQL. Antes de excluir uma instância , você pode fazer um backup final dela. Em seguida, você pode restaurar o backup final para uma instância nova ou existente. Dessa forma, você pode recriar quaisquer instâncias excluídas acidentalmente ou usá-las para cenários de recuperação de desastres.
Ao contrário dos backups automatizados e sob demanda, que são associados a uma instância, você pode fazer um backup final antes de excluí-la. O Cloud SQL armazena esse backup além do tempo de vida útil da instância.
Você pode usar os comandos CLI do gcloud existentes para listar, descrever, atualizar e excluir um backup final. Se estiver usando funções personalizadas, adicione as seguintes permissões às funções:
cloudsql.backupRuns.list
cloudsql.backupRuns.get
cloudsql.backupRuns.update
cloudsql.backupRuns.delete
Para obter mais informações sobre essas permissões, consulte Permissões necessárias . Além disso, para obter mais informações sobre como os backups funcionam, consulte Sobre backups do Cloud SQL .
Permissões necessárias
Google Cloud console
Para gerenciar backups finais em um Google Cloud projeto, você precisa das seguintes permissões:
Para gerenciar backups finais em um Google Cloud projeto, você precisa das seguintes permissões:
Ação
Comando
Permissões necessárias
Listar backups finais
gcloud sql backups list
cloudsql.backupRuns.list
Descreva um backup final
gcloud sql backups describe
cloudsql.backupRuns.get
Atualizar um backup final
gcloud sql backups patch
cloudsql.backupRuns.update
Excluir um backup final
gcloud sql backups delete
cloudsql.backupRuns.delete
DESCANSAR
Para gerenciar backups finais em um Google Cloud projeto, você precisa das seguintes permissões:
Ação
Método
Permissões necessárias
Listar backups finais
Backups.ListBackups
cloudsql.backupRuns.list
Descreva um backup final
Backups.GetBackup
cloudsql.backupRuns.get
Atualizar um backup final
Backups.UpdateBackup
cloudsql.backupRuns.update
Excluir um backup final
Backups.DeleteBackup
cloudsql.backupRuns.delete
Ver uma lista de backups finais
Você pode visualizar uma lista de backups finais e detalhes sobre um backup usando o Google Cloud console,gcloud CLI ou a API do Cloud SQL.
O Google Cloud O console não mostra backups ignorados ou com falha no histórico de backups. Para ver esses tipos de backups, use o gcloud ou a API do Cloud SQL.
Console
No Google Cloud console, acesse a página Backups do Cloud SQL .
Esta página lista todos os backups, incluindo backups finais, que estão associados a um Google Cloud projeto.
Para visualizar detalhes sobre um backup final, clique no backup. Uma caixa de diálogo de backup final será exibida. Esta caixa de diálogo exibe as seguintes informações:
A data e a hora em que a instância usada para criar o backup final foi excluída
O nome e a versão da instância excluída
Um registro de data e hora de quanto tempo o Cloud SQL retém o backup final
Uma descrição do backup final
gcloud
Para obter uma lista de todos os backups finais associados a um Google Cloud projeto, use o comando gcloud sql backups list :
Você obtém o BACKUP_NAME a partir da saída da execução do comando gcloud sql backups list . O BACKUP_NAME tem o seguinte formato: projects/ PROJECT_ID /backups/ BACKUP_ID .
REST v1
Obtenha uma lista de backups finais
Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto
INSTANCE_ID : o ID da instância
Método HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL
Para enviar sua solicitação, expanda uma destas opções:
Use este exemplo para visualizar os detalhes de um backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.GetBackup .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto.
BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
Método HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID
Para enviar sua solicitação, expanda uma destas opções:
Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto
INSTANCE_ID : o ID da instância
Método HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL
Para enviar sua solicitação, expanda uma destas opções:
Use este exemplo para visualizar os detalhes de um backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.GetBackup .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto.
BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
Método HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID
Para enviar sua solicitação, expanda uma destas opções:
Você obtém o BACKUP_NAME a partir da saída da execução do comando gcloud sql backups list . O BACKUP_NAME tem o seguinte formato: projects/ PROJECT_ID /backups/ BACKUP_ID .
Para os sinalizadores --expiry-time e --ttl-days , use as seguintes diretrizes:
Para o sinalizador --expiry-time , especifique um registro de data e hora de quando o Cloud SQL excluirá o backup final automaticamente.
Para o sinalizador --ttl-days , especifique o período de retenção do backup final (de 1 a 365 dias). Isso é conhecido como tempo de vida (TTL) . O período de retenção começa na data e hora atuais, e o período máximo de retenção permitido pelo Cloud SQL é de 1 ano (ou 365 dias).
REST v1
Obtenha uma lista de backups finais
Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto
INSTANCE_ID : o ID da instância
Método HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL
Para enviar sua solicitação, expanda uma destas opções:
Você pode atualizar o período de retenção de um backup final de uma das seguintes maneiras:
Dias de retenção : modifique o número de dias que o Cloud SQL retém o backup.
Hora de expiração : forneça um registro de data e hora atualizado para quando o Cloud SQL excluir o backup automaticamente.
Atualizar os dias de retenção
Use este exemplo para atualizar o número de dias que o Cloud SQL retém o backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto.
BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
TTL_DAYS : o período de retenção do backup final (de 1 a 365 dias). Isso é conhecido como tempo de vida (TTL) . O período de retenção começa na data e hora atuais, e o período máximo de retenção permitido pelo Cloud SQL é de 1 ano (ou 365 dias).
Use este exemplo para fornecer um registro de data e hora atualizado para quando o Cloud SQL excluir o backup. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto.
BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
DATE_AND_TIME_STAMP : um registro de data e hora de quando o Cloud SQL exclui o backup final automaticamente.
Use este exemplo para atualizar a descrição do backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto.
BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
DESCRIPTION : a descrição atualizada para o backup final.
Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto
INSTANCE_ID : o ID da instância
Método HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL
Para enviar sua solicitação, expanda uma destas opções:
Você pode atualizar o período de retenção de um backup final de uma das seguintes maneiras:
Dias de retenção : modifique o número de dias que o Cloud SQL retém o backup
Hora de expiração : forneça um registro de data e hora atualizado para quando o Cloud SQL excluir o backup automaticamente.
Atualizar os dias de retenção
Use este exemplo para atualizar o número de dias que o Cloud SQL retém o backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto.
BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
TTL_DAYS : o período de retenção do backup final (de 1 a 365 dias). Isso é conhecido como tempo de vida (TTL) . O período de retenção começa na data e hora atuais, e o período máximo de retenção permitido pelo Cloud SQL é de 1 ano (ou 365 dias).
Use este exemplo para fornecer um registro de data e hora atualizado para quando o Cloud SQL excluir o backup. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto.
BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
DATE_AND_TIME_STAMP : um registro de data e hora de quando o Cloud SQL exclui o backup final automaticamente.
Use este exemplo para atualizar a descrição do backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto.
BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
DESCRIPTION : a descrição atualizada para o backup final.
Você pode excluir um backup final usando o Google Cloud console,gcloud CLI ou a API do Cloud SQL.
Excluir um backup pode não liberar tanto espaço quanto o tamanho do backup. Isso ocorre porque os backups são incrementais, portanto, excluir um backup mais antigo pode transferir parte do seu conteúdo para um backup mais recente, preservando a integridade do backup mais recente.
Console
No Google Cloud console, acesse a página Backups do Cloud SQL .
Você obtém o BACKUP_NAME a partir da saída da execução do comando gcloud sql backups list . O BACKUP_NAME tem o seguinte formato: projects/ PROJECT_ID /backups/ BACKUP_ID .
REST v1
Obtenha uma lista de backups finais
Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto
INSTANCE_ID : o ID da instância
Método HTTP e URL:
GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL
Para enviar sua solicitação, expanda uma destas opções:
Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .
Antes de usar qualquer um dos dados solicitados, faça as seguintes substituições:
PROJECT_ID : o ID do projeto
INSTANCE_ID : o ID da instância
Método HTTP e URL:
GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL
Para enviar sua solicitação, expanda uma destas opções:
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-05-16 UTC."],[],[]]