Os backups aprimorados permitem usar o serviço de Backup e DR com as instâncias do Cloud SQL para gerenciar seus backups. É possível ativar backups avançados para qualquer instância associando-a a um plano de backup do Backup e DR. Também é possível gerenciar backups avançados para sua instância fazendo o seguinte:
- Mudar o plano de backup associado à instância
- Fazer um backup sob demanda
- Listar todos os backups no backup vault da sua instância
Para mais informações sobre como os backups avançados funcionam e a integração deles com o Backup e DR, consulte Backups avançados. Para mais informações sobre como os backups funcionam no Cloud SQL, consulte Visão geral 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 e DR
- Verifique 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 é necessário ativar a API Backup e DR:
Permissões necessárias
As permissões a seguir são necessárias para configurar backups avançados para suas instâncias do Cloud SQL:
backupdr.backupPlans.listbackupdr.backupPlanAssociations.createForCloudSqlInstancebackupdr.backupPlanAssociations.fetchForCloudSqlInstancebackupdr.backupPlanAssociations.listbackupdr.backupPlanAssociations.getForCloudSqlInstancebackupdr.backupPlanAssociations.triggerBackupForCloudSqlInstancebackupdr.backupPlanAssociations.deleteForCloudSqlInstancebackupdr.backupPlanAssociations.updateForCloudSqlInstancebackupdr.backupPlans.useForCloudSqlInstancebackupdr.bvdataSources.getbackupdr.bvdataSources.list
Para mais informações sobre essas permissões, consulte Papéis e permissões de backup e DR.
Ativar backups aprimorados
Para ativar os backups avançados na 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
Para associar sua instância do Cloud SQL a um plano de backup, primeiro crie ou identifique o plano de backup que você quer usar. O plano escolhido define a programação de backup da instância e as configurações de retenção de registros.
Para criar um plano de backup, primeiro use o serviço de Backup e DR para criar um vault em que os backups serão armazenados e, em seguida, crie o plano no console de Backup e DR.
O backup vault usado pelo plano de backup pode estar em uma região diferente da instância. Para mais informações, consulte Backups entre regiões.
Depois de identificar o plano de backup que você quer associar, use o nome dele para associá-lo à 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 de backup 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 à instância do Cloud SQL, faça o seguinte:
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
Encontre a instância que você quer associar ao 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 avançado.
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, pesquise e selecione o projeto de Backup e DR que contém o plano de backup.
Depois de selecionar o projeto, você verá uma lista de todos os planos de backup disponíveis. Encontre o plano de backup que você quer usar e clique em Selecionar.
Clique em Salvar.
A instância está ativada para backups aprimorados e usando as configurações de backup e retenção do plano de backup associado.
gcloud
Para associar um plano de backup à instância do Cloud SQL, execute o seguinte comando:
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 que você quer associar ao 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 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
- 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ê vai receber uma resposta JSON semelhante a esta:
Gerenciar backups aprimorados
Depois que a instância estiver ativada para backups aprimorados e um plano de backup estiver associado a ela, será possível realizar um backup sob demanda, visualizar 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 backup vault, consulte Criar e gerenciar um backup vault.
Mudar o plano de backup associado à instância
É possível mudar o plano de backup a ser usado com a instância do Cloud SQL. Para mudar o plano de backup associado à instância do Cloud SQL, o novo plano precisa estar no mesmo backup vault que o plano atual e na mesma região que a instância do Cloud SQL.
Para mudar para um novo plano de backup, faça o seguinte:
Console
Para associar o novo plano de backup à sua instância, faça o seguinte:
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
Encontre a instância em que você quer 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 avançado.
Clique no botão Alterar.
Na janela Selecionar um plano de backup, escolha o novo plano.
Clique em Salvar.
Sua instância está ativada para backups aprimorados e está usando o novo plano de backup que você selecionou.
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, associe o novo plano 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
- 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ê vai receber uma resposta JSON semelhante a esta:
Fazer um backup on demand
É possível realizar um backup on demand para uma instância do Cloud SQL com um plano de backup associado usando o console do Google Cloud , a CLI gcloud ou a API Cloud SQL.
Console
Para realizar um backup sob demanda de uma instância com backups avançados ativados, faça o seguinte:
No console do Google Cloud , acesse a página Backups do Cloud SQL.
Clique em Criar backup.
Na janela Criar um backup sob demanda, siga um destes procedimentos:
- 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.
- Selecione a opção Com base no período de retenção personalizado para especificar um período de armazenamento personalizado para o backup. Ao usar um período de armazenamento personalizado, considere as seguintes regras:
- Lógica do intervalo de retenção: o intervalo de retenção permitido é determinado pela interseção da retenção mínima obrigatória do backup vault e da configuração de retenção personalizada máxima do plano de backup.
- Padrões implícitos: se
max_custom_on_demand_retention_daysnão for definido explicitamente no plano de backup, o serviço vai usar um limite superior padrão da retenção mínima obrigatória do backup vault mais 30 dias. - Limite máximo: independentemente da configuração, a retenção máxima permitida para qualquer backup personalizado sob demanda é de 10 anos (3.653 dias).
Clique em Criar.
O backup sob demanda foi criado.
gcloud
Para realizar um backup on demand 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
--custom-retention-days=CUSTOM_RETENTION
[--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 on demand que você quer fazer (por exemplo,
rule-daily). - PROJECT_ID: o ID do projeto da instância.
- BACKUP_VAULT_LOCATION: o local do backup vault associado ao plano de backup.
REST v1
Para acionar um backup sob demanda para sua instância do Cloud SQL, 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-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ê vai receber uma resposta JSON semelhante a esta:
Listar todos os backups em um backup vault da sua instância
É possível listar todos os backups no backup vault da sua instância do Cloud SQL usando o console do Google Cloud , a CLI gcloud ou a API Cloud SQL.
Console
No console do Google Cloud , acesse a página Backups do Cloud SQL.
No menu suspenso Nível de backup, selecione Nível avançado e, na lista Backup vault, selecione o backup vault que contém o backup que você quer usar.
Todos os backups disponíveis no backup vault da instância selecionada são exibidos.
gcloud
Para listar todos os backups disponíveis para sua instância do Cloud SQL no
backup vault, primeiro encontre o data-source da
instância do Cloud SQL e execute o comando
gcloud backup-dr backups list.
Para encontrar o data-source da instância, execute o seguinte comando:
gcloud backup-dr data-source-references
fetch-for-resource-type sqladmin.googleapis.com/Instance
--location=BACKUP_VAULT_LOCATION | grep INSTANCE_NAME
Substitua:
- BACKUP_VAULT_LOCATION: o local do backup vault. Se você usar backups entre regiões, esse local será diferente da região da sua instância do Cloud SQL.
- INSTANCE_NAME: o nome da instância do Cloud SQL.
Para listar todos os backups em um backup vault da sua instância, execute o seguinte comando:
gcloud backup-dr backups list
--data-source=DATA_SOURCE
--location=BACKUP_VAULT_LOCATION
--backup-vault=BACKUP_VAULT_NAME
Substitua:
- DATA_SOURCE: o
data-sourceda sua instância do Cloud SQL. - BACKUP_VAULT_LOCATION: o local do backup vault, que pode ser diferente da região da instância do Cloud SQL.
- BACKUP_VAULT_NAME: o nome do backup vault associado ao plano de backup.
REST v1
Para listar todos os backups disponíveis para sua instância do Cloud SQL no backup vault, primeiro encontre a fonte de dados da sua instância do Cloud SQL e, em seguida, use o nome da fonte de dados para acessar todos os backups.
Encontrar a fonte de dados da instância
Para encontrar a fonte de dados da instância, use o método dataSource.References na API Backup e 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ê vai 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 e 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 otimizados
Para desativar os backups avançados, volte para a opção de backups padrão na instância do Cloud SQL. 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 a usar a opção de backups padrão na instância, faça o seguinte:
No console do Google Cloud , acesse a página Instâncias do Cloud SQL.
Encontre a instância em que 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 o 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 pela opção de backups padrão, gerenciada pelo Cloud SQL.
gcloud
Para desativar os backups avançados e voltar 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 do 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ê vai receber uma resposta JSON semelhante a esta: