Nesta página, descrevemos como ativar e gerenciar backups avançados para suas instâncias e projetos do Cloud SQL.
Com os backups aprimorados, é possível usar o serviço de Backup e DR com suas instâncias do Cloud SQL para gerenciar os backups. Para mais informações, consulte Backups avançados. Para mais informações sobre como os backups funcionam no Cloud SQL e as opções disponíveis para suas instâncias, consulte Sobre backups do Cloud SQL.
Antes de começar
Antes de gerenciar backups avançados para suas instâncias do Cloud SQL, faça o seguinte:
- Ativar a API Backup and DR
- Confirme se você tem as permissões necessárias
Ativar a API Backup e DR
Para usar backups avançados com suas instâncias do Cloud SQL, primeiro ative a API Backup e DR:
Permissões necessárias
As seguintes permissões são necessárias para configurar backups avançados nas instâncias do Cloud SQL:
backupdr.backupPlans.list
backupdr.backupPlanAssociations.createForCloudSqlInstance
backupdr.backupPlanAssociations.fetchForCloudSqlInstance
backupdr.backupPlanAssociations.list
backupdr.backupPlanAssociations.getForCloudSqlInstance
backupdr.backupPlanAssociations.triggerBackupForCloudSqlInstance
backupdr.backupPlanAssociations.deleteForCloudSqlInstance
backupdr.backupPlans.useForCloudSqlInstance
backupdr.bvdataSources.get
backupdr.bvdataSources.list
Para mais informações sobre essas permissões, consulte Papéis e permissões de backup e DR.
Ativar backups avançados
Para ativar os backups avançados da sua instância, faça o seguinte:
- Identifique o backup vault e o plano de backup que você quer usar.
- Associe sua instância do Cloud SQL ao plano de backup.
Para mais informações sobre backups avançados, consulte Sobre backups do Cloud SQL.
Identifique o plano de backup que você quer usar
O plano de backup é usado pelos backups avançados para definir a programação e as configurações de retenção de backup da instância. Para associar sua instância do Cloud SQL a um plano de backup, primeiro identifique o plano de backup que você quer usar. Para mais informações, consulte Criar e gerenciar um plano de backup.
Depois de identificar o plano de backup que você quer associar, use o nome dele para associar à sua instância do Cloud SQL.
Associar um plano de backup a uma instância do Cloud SQL
Para associar um plano de backup a uma instância do Cloud SQL, você precisa do nome do plano que quer usar. Para mais informações sobre como encontrar o nome do plano de backup, consulte Criar e gerenciar um plano de backup.
Console
Para associar um plano de backup à sua instância do Cloud SQL, faça o seguinte:
No console Google Cloud , acesse a página Instâncias do Cloud SQL.
Encontre a instância a que você quer associar o plano de backup. Para abrir a página Visão geral da instância, clique no nome dela.
Clique em Editar.
Na seção Proteção de dados, em Nível de backup, selecione Nível de backup aprimorado.
Na seção Plano de backup, clique em Selecionar.
Na janela Selecionar um plano de backup, faça o seguinte:
Em Projeto, clique em Procurar e pesquise e selecione o projeto do Backup e DR que contém o plano de backup.
Depois de selecionar o projeto, uma lista de todos os planos de backup disponíveis vai aparecer. Encontre o plano que você quer usar e clique em Selecionar.
Clique em Salvar.
Sua instância está ativada para backups avançados e usando as configurações de backup e retenção do plano de backup associado.
gcloud
Para associar um plano de backup à sua instância do Cloud SQL, execute o comando a seguir:
gcloud backup-dr backup-plan-associations create BACKUP_PLAN_ASSOCIATION_NAME
--project=PROJECT_ID
--resource=INSTANCE_ID
--backup-plan=BACKUP_PLAN_NAME
--resource-type=sqladmin.googleapis.com/Instance
--location=REGION_ID
Substitua:
- BACKUP_PLAN_ASSOCIATION_NAME: o nome da associação do plano de backup.
- PROJECT_ID: o ID do projeto da instância.
- INSTANCE_ID: o ID da instância a que você quer associar o plano de backup.
- BACKUP_PLAN_NAME: o nome do plano de backup que você quer usar. Para mais informações, consulte identificar o plano de backup que você quer usar.
- REGION_ID: a região da instância.
REST v1
Para criar uma associação de plano de backup, use o método
backupPlanAssociations
na
API Backup and DR.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- backup-plan-association-id: o ID da associação do plano de backup
- resource-name: o nome completo da instância do Cloud SQL, no formato
projects/project-id/locations/location/instances/instance-name
- backup-plan-name: o nome do plano de backup no formato
projects/project-id/backupPlans/backup-plan-name
Método HTTP e URL:
POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations
Corpo JSON da solicitação:
{ "name": "backup-plan-association-id", "resourceType": "sql.googleapis.com/Instance", "resource": "resource-name", "backupPlan": "backup-plan-name" }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Gerenciar backups aprimorados
Depois que a instância for ativada para backups avançados e um plano de backup for associado a ela, será possível fazer um backup sob demanda, ver todos os backups no backup vault ou mudar o plano de backup associado.
Para gerenciar um plano de backup, consulte Criar e gerenciar um plano de backup. Para gerenciar um cofre de backup, consulte Criar e gerenciar um cofre de backup.
Mudar o plano de backup associado à instância
É possível mudar o plano de backup associado à sua instância do Cloud SQL. Para mudar o plano de backup aplicado à sua instância do Cloud SQL, o novo plano precisa estar no mesmo backup vault que o atual e na mesma região da instância do Cloud SQL.
Para mudar o plano de backup associado, faça o seguinte:
Remover o plano de backup associado
Para mudar para um novo plano de backup, primeiro remova a associação do plano de backup atual da instância do Cloud SQL. Para remover o plano de backup, faça o seguinte:
Console
No console Google Cloud , acesse a página Instâncias do Cloud SQL.
Encontre a instância para a qual você quer mudar a opção de backup. Para abrir a página Visão geral de uma instância, clique no nome dela.
Clique em Editar.
Na seção Proteção de dados, em Nível de backup, selecione o Nível de backup padrão. Atualize as configurações de backups padrão da sua instância conforme necessário.
Clique em Salvar.
O plano de backup associado da instância é excluído, e ela passa a ser gerenciada na opção de backups padrão. Agora você pode associar o novo plano de backup à sua instância.
gcloud
Para mudar para um novo plano de backup, primeiro remova a associação do plano de backup atual da instância do Cloud SQL. Para remover o plano de backup, faça o seguinte:
gcloud backup-dr backup-plan-associations delete BACKUP_PLAN_ASSOCIATION_NAME
--location=BACKUP_VAULT_LOCATION
Substitua:
- BACKUP_PLAN_ASSOCIATION_NAME: o nome da associação de plano de backup que você quer excluir.
- BACKUP_VAULT_LOCATION: o local do backup vault.
O plano de backup associado da instância é excluído, e ela passa a ser gerenciada na opção de backups padrão. Agora você pode associar o novo plano de backup à sua instância.
REST v1
Para mudar uma associação de plano de backup, primeiro remova a associação atual. Use o método
backupPlanAssociations
na
API Backup and DR.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- backup-plan-association-id: o ID da associação do plano de backup, no formato
projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id
Método HTTP e URL:
POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete
Corpo JSON da solicitação:
{ "name": "backup-plan-association-id", }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Associe o novo plano de backup à sua instância
Depois de remover o plano de backup atual, é possível associar um novo plano à instância do Cloud SQL:
Console
Para associar o novo plano de backup à sua instância, faça o seguinte:
No console Google Cloud , acesse a página Instâncias do Cloud SQL.
Encontre a instância para mudar o plano de backup. Para abrir a página Visão geral da instância, clique no nome dela.
Clique em Editar.
Na seção Proteção de dados, em Nível de backup, selecione Nível de backup aprimorado.
Na janela Selecionar um plano de backup, faça o seguinte:
Em Projeto, clique em Procurar, pesquise e selecione o projeto do Backup e DR que contém o plano de backup que você quer usar.
Depois de selecionar o projeto, você vai ver uma lista de todos os planos de backup disponíveis. Encontre o plano que você quer usar e clique em Selecionar.
Clique em Salvar.
Sua instância está ativada para backups avançados e usando o novo plano de backup selecionado.
gcloud
Para associar o novo plano de backup à sua instância, faça o seguinte:
gcloud backup-dr backup-plan-associations create BACKUP_PLAN_ASSOCIATION_NAME
--project=PROJECT_ID
--resource=INSTANCE_ID
--backup-plan=BACKUP_PLAN_NAME
--resource-type=sqladmin.googleapis.com/Instance
--location=REGION_ID
Substitua:
- BACKUP_PLAN_ASSOCIATION_NAME: o nome da associação do plano de backup.
- PROJECT_ID: o ID do projeto da instância.
- INSTANCE_ID: o ID da instância.
- BACKUP_PLAN_NAME: o nome do plano de backup. Para mais informações, consulte Identificar o plano de backup que você quer usar.
- REGION_ID: a região da instância.
REST v1
Depois de excluir a associação do plano de backup atual, associe o novo plano usando o método backupPlanAssociations
na API Backup and DR.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- backup-plan-association-id: o ID da associação do plano de backup
- resource-name: o nome completo da instância do Cloud SQL, no formato
projects/project-id/locations/location/instances/instance-name
- backup-plan-name: o nome do plano de backup no formato
projects/project-id/backupPlans/backup-plan-name
Método HTTP e URL:
POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations
Corpo JSON da solicitação:
{ "name": "backup-plan-association-id", "resourceType": "sql.googleapis.com/Instance", "resource": "resource-name", "backupPlan": "backup-plan-name" }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Fazer um backup sob demanda
É possível fazer um backup sob demanda de uma instância do Cloud SQL com um plano de backup associado usando o console Google Cloud , a gcloud CLI ou a API Cloud SQL.
Console
Para fazer um backup sob demanda de uma instância com backups avançados ativados, faça o seguinte:
No console Google Cloud , acesse a página Backups do Cloud SQL.
Clique em Criar backup.
Na janela Criar um backup on demand, em Escolher uma regra de backup, selecione o tipo de backup on demand que você quer fazer. A regra de backup define o período de armazenamento do backup sob demanda.
Clique em Criar.
Seu backup sob demanda será criado.
gcloud
Para fazer um backup sob demanda de uma instância com backups avançados ativados, execute o seguinte comando:
gcloud backup-dr backup-plan-associations trigger-backup BACKUP_PLAN_ASSOCIATION_NAME
--backup-rule-id=BACKUP_RULE_ID
--project=PROJECT_ID
--location=BACKUP_VAULT_LOCATION
[--no-async]
Substitua:
- BACKUP_PLAN_ASSOCIATION_NAME: o nome da associação do plano de backup da instância do Cloud SQL. Para encontrar uma lista de todos os planos de backup associados a uma instância do Cloud SQL, consulte Listar todas as associações de planos de backup.
- BACKUP_RULE_ID: o nome da regra de backup para o tipo de
backup sob demanda que você quer fazer (por exemplo,
rule-daily
). - PROJECT_ID: o ID do projeto da instância.
- BACKUP_VAULT_LOCATION: o local do cofre de backup associado ao seu plano de backup.
REST v1
Para acionar um backup sob demanda da sua instância do Cloud SQL, use o método
backupPlanAssociations
na
API Backup e DR.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- backup-rule-id: o ID da regra de backup para que um backup seja acionado.
Método HTTP e URL:
GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id:triggerBackup
Corpo JSON da solicitação:
{ "ruleId": "backup-rule-id" }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Liste todos os backups em um backup vault para sua instância
É possível listar todos os backups no cofre de backup da sua instância do Cloud SQL usando o Google Cloud console, a gcloud CLI ou a API Cloud SQL.
Console
No console Google Cloud , acesse a página Backups do Cloud SQL.
No menu suspenso Nível de backup, selecione Nível avançado e escolha o cofre de backup que contém o backup que você quer usar.
Todos os backups disponíveis no backup vault da instância selecionada são mostrados.
gcloud
Para listar todos os backups disponíveis da sua instância do Cloud SQL no
cofre de backup, primeiro encontre o data-source
da sua
instância do Cloud SQL e execute o comando gcloud backup-dr backups list
.
Para encontrar a data-source
da sua instância, execute o seguinte comando:
gcloud backup-dr data-source-references
fetch-for-resource-type sqladmin.googleapis.com/Instance
--location=REGION_ID | grep INSTANCE_NAME
Substitua:
- REGION_ID: o ID da região da instância do Cloud SQL.
- INSTANCE_NAME: o nome da instância do Cloud SQL.
Para listar todos os backups em um cofre de backup da sua instância, execute o seguinte comando:
gcloud backup-dr backups list
--data-source=DATA_SOURCE
--location=REGION_ID
--backup-vault=BACKUP_VAULT_NAME
Substitua:
- DATA_SOURCE: o
data-source
da sua instância do Cloud SQL. - REGION_ID: o ID da região do cofre de backup.
- BACKUP_VAULT_NAME: o nome do cofre de backup associado ao seu plano de backup.
REST v1
Para listar todos os backups disponíveis da sua instância do Cloud SQL no cofre de backup, primeiro encontre a fonte de dados da sua instância do Cloud SQL e depois receba todos os backups usando o nome da fonte de dados.
Encontrar a fonte de dados da instância
Para encontrar a fonte de dados da sua instância, use o método
dataSource.References
na API Backup and DR.
Método HTTP e URL:
GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/dataSourceReferences:fetchForResourceType?filter=dataSourceGcpResourceInfo.gcp_resourcename="projects/project-id/instances/instance-id
Corpo JSON da solicitação:
{ "resourceType": "sqladmin.googleapis.com/Instance" }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Listar os backups da instância
Para listar os backups da sua instância usando o ID da fonte de dados, use o método
backupVaults.dataSources.backups
na API Backup and DR.
Método HTTP e URL:
GET https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupVaults/backup-vault-id/dataSources/data-source-id/backups
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta:
Desativar backups avançados
Para desativar os backups aprimorados, mude a instância do Cloud SQL de volta para a opção de backups padrão. Isso exclui a associação entre o plano de backup e sua instância.
Mudar a instância para backups padrão
Console
Para desativar os backups avançados e voltar para a opção de backups padrão, faça o seguinte:
No console Google Cloud , acesse a página Instâncias do Cloud SQL.
Encontre a instância para a qual você quer mudar a opção de backup. Para abrir a página Visão geral da instância, clique no nome dela.
Clique em Editar.
Na seção Proteção de dados, em Nível de backup, selecione Nível de backup padrão. Atualize as configurações de backups padrão da instância conforme necessário.
Clique em Salvar.
O plano de backup associado à instância é excluído, e ela passa a ser gerenciada na opção "Backups padrão" do Cloud SQL.
gcloud
Para desativar os backups avançados e mudar a instância de volta para a opção de backups padrão, execute o seguinte comando:
gcloud backup-dr backup-plan-associations delete BACKUP_PLAN_ASSOCIATION_NAME
--location=BACKUP_VAULT_LOCATION
Substitua:
- BACKUP_PLAN_ASSOCIATION_NAME: o nome da associação de plano de backup que você quer excluir.
- BACKUP_VAULT_LOCATION: o local do backup vault.
REST v1
Para desativar os backups avançados, remova a associação do plano de backup usando o método backupPlanAssociations
na API Backup e DR.
Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:
- backup-plan-association-id: o ID da associação do plano de backup, no formato
projects/project-id/locations/location/backupPlanAssociations/backup-plan-association-id
Método HTTP e URL:
POST https://backupdr.googleapis.com/v1/projects/project-id/locations/location/backupPlanAssociations/delete
Corpo JSON da solicitação:
{ "name": "backup-plan-association-id", }
Para enviar a solicitação, expanda uma destas opções:
Você receberá uma resposta JSON semelhante a esta: