Gerenciar backups aprimorados

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 e DR

Para usar backups avançados com suas instâncias do Cloud SQL, primeiro ative a API Backup e DR:

Ativar a API Backup and 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:

  1. Identifique o backup vault e o plano de backup que você quer usar.
  2. 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:

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. 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.

  3. Clique em Editar.

  4. Na seção Proteção de dados, em Nível de backup, selecione Nível de backup aprimorado.

  5. Na seção Plano de backup, clique em Selecionar.

  6. Na janela Selecionar um plano de backup, faça o seguinte:

    1. Em Projeto, clique em Procurar e pesquise e selecione o projeto do Backup e DR que contém o plano de backup.

    2. 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.

  7. 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

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. 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.

  3. Clique em Editar.

  4. 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.

  5. 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:

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. 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.

  3. Clique em Editar.

  4. Na seção Proteção de dados, em Nível de backup, selecione Nível de backup aprimorado.

  5. 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.

  6. 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:

  1. No console Google Cloud , acesse a página Backups do Cloud SQL.

    Acessar "Backups do Cloud SQL"

  2. Clique em Criar backup.

  3. 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.

  4. 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

  1. No console Google Cloud , acesse a página Backups do Cloud SQL.

    Acessar "Backups do Cloud SQL"

  2. 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:

  1. No console Google Cloud , acesse a página Instâncias do Cloud SQL.

    Acesse "Instâncias do Cloud SQL"

  2. 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.

  3. Clique em Editar.

  4. 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.

  5. 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:

A seguir