Restaurar uma instância usando um backup

É possível restaurar sua instância de um backup e recuperá-la para um período específico em uma instância nova ou existente. É possível restaurar uma instância ativa ou excluída. Para saber mais sobre como funciona a restauração, consulte Visão geral da restauração.

Para restaurar uma instância usando um backup, faça o seguinte:

  1. Encontre o backup que você quer restaurar
  2. Usar o backup para restaurar a instância

A localização do backup depende da opção de backup da instância.

Restaurar uma instância ativa

É possível restaurar um backup das seguintes maneiras:

Restaurar para a mesma instância

Ao restaurar dados de um backup para a mesma instância, os dados nessa instância retornam ao estado em que estavam no momento em que o backup foi feito.

Para restaurar a instância usando um backup na mesma instância, faça o seguinte:

Console

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

    Acessar "Backups do Cloud SQL"

  2. Na página Backups, clique em Nível Standard ou Nível Enhanced, dependendo da opção de backup da sua instância.

  3. Se a instância estiver usando backups padrão, selecione a instância para que você quer ver os backups.

    Se a instância estiver usando backups aprimorados, selecione Nível aprimorado e escolha 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.

  4. Encontre o nome do backup que você quer restaurar e clique em Restaurar.

  5. Em Escolher destino de restauração, selecione Substituir a instância de origem.

  6. No campo ID da instância de destino, digite o nome da instância a ser substituída para confirmar a seleção.

  7. Clique em Restaurar.

    O Cloud SQL restaura o backup para a mesma instância. Para verificar o status da operação de restauração, acesse a página Operações da instância.

    É possível criar réplicas depois que a operação de restauração for concluída.

gcloud

  1. Todas as réplicas precisam ser excluídas da instância antes da restauração.

    Determine se a instância tem réplicas de leitura usando o comando gcloud sql instances describe:

    gcloud sql instances describe INSTANCE_NAME

    Substitua:

    • INSTANCE_NAME: o nome da instância.

    Se a instância tiver réplicas, exclua-as usando o comando gcloud sql instances delete:

    gcloud sql instances delete REPLICA_NAME

    Substitua:

    • REPLCICA_NAME: o nome da réplica.

  2. Encontre o backup que você quer usar.

    Se a instância estiver usando backups padrão, use o comando gcloud sql backups list para encontrar um backup e registrar o valor ID dele:

    gcloud sql backups list INSTANCE_NAME

    Substitua:

    • INSTANCE_NAME: o nome da instância.

    Se a instância estiver usando backups avançados, consulte Listar todos os backups em um backup vault.

  3. Para restaurar a instância do backup especificado, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID \
--restore-instance=BACKUP_ID

    Substitua:

    • BACKUP_ID: o ID do backup que você quer restaurar.
    • INSTANCE_NAME: o nome da instância.

  4. Após a conclusão da operação de restauração, recrie as réplicas que você excluiu neste procedimento.

REST v1

  1. Para determinar se a instância tem réplicas de leitura e receber os IDs delas, liste todas as réplicas da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • 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/instances/INSTANCE_ID?fields=replicaNames

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Exclua todas as réplicas da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;
    • REPLICA_ID: o ID da réplica

    Método HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  3. Receba o ID do backup que você quer usar.

    • Se a instância estiver usando backups padrão, execute o seguinte:

      Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

      • 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/instances/instance-id/backupRuns

      Para enviar a solicitação, expanda uma destas opções:

      Você receberá uma resposta JSON semelhante a esta:

  4. Restaure a instância do backup:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto
    • INSTANCE_ID: o ID da instância
    • BACKUP_ID o ID do backup

    Método HTTP e URL: 

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/restoreBackup

    Corpo JSON da solicitação:

    {
  "restoreBackupContext":
  {
    "backupRunId": "BACKUP_ID",
  }
}

    Para enviar a solicitação, expanda uma destas opções:

    Você vai receber uma resposta JSON semelhante a esta:

  5. Após a conclusão da operação de restauração, recrie todas as réplicas que você excluiu neste procedimento.

REST v1beta4

  1. Para determinar se a instância tem réplicas de leitura e receber os IDs delas, liste todas as réplicas da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • 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/instances/INSTANCE_ID?fields=replicaNames

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Exclua todas as réplicas da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;
    • REPLICA_ID: o ID da réplica

    Método HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  3. Receba o ID do backup que você quer usar.

    • Se a instância estiver usando backups padrão, execute o seguinte:

      Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

      • 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/instances/instance-id/backupRuns

      Para enviar a solicitação, expanda uma destas opções:

      Você receberá uma resposta JSON semelhante a esta:

  4. Restaure a instância do backup:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto
    • INSTANCE_ID: o ID da instância
    • BACKUP_RUN_ID: um carimbo de data e hora de quando o Cloud SQL restaura a instância do backup

    Método HTTP e URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID/restoreBackup

    Corpo JSON da solicitação:

    {
  "restoreBackupContext":
  {
    "backupRunId": "BACKUP_RUN_ID",
  }
}

    Para enviar a solicitação, expanda uma destas opções:

    Você vai receber uma resposta JSON semelhante a esta:

  5. Após a conclusão da operação de restauração, recrie todas as réplicas que você excluiu neste procedimento.

Restaurar para uma instância nova ou atual

Ao usar um backup para restaurar dados em uma instância diferente, os dados na instância de destino são atualizados para o estado em que eles estavam na instância de origem no momento em que o backup foi feito.

Se você precisar de uma lista de backups do projeto e não conseguir visualizá-los na página de visão geral da instância devido a uma interrupção, use a API backupRuns.list com um caractere curinga (-). A opção de caractere curinga recupera uma lista de todos os backups de todas as instâncias do projeto. Para mais informações, consulte Como ver backups durante uma interrupção.

Para restaurar sua instância em uma nova ou existente, faça o seguinte:

Console

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

    Acessar "Backups do Cloud SQL"

  2. Na página Backups, clique em Nível Standard ou Nível Enhanced, dependendo da opção de backup da sua instância.

  3. Se a instância estiver usando backups padrão, selecione a instância para que você quer ver os backups.

    Se a instância estiver usando backups aprimorados, selecione Nível aprimorado e escolha 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.

  4. Encontre o nome do backup que você quer restaurar e clique em Restaurar.

  5. Em Escolher destino de restauração:

    • Se quiser restaurar a instância para uma nova, selecione Restaurar para uma nova instância e atualize o seguinte:

      • Em Região, confirme a região. A região precisa corresponder à da nova instância.
      • Na caixa ID da instância, atribua um nome à nova instância. Esse nome é permanente e não pode ser mudado.

    • Se quiser restaurar a instância para uma instância atual, selecione Substituir uma instância atual e faça o seguinte:

      • No menu Instância a ser substituída, selecione a instância que você quer usar para a restauração. A instância selecionada e todos os respectivos dados serão substituídos.

      • No campo ID da instância de destino, digite o nome da instância a ser substituída para confirmar a seleção.

  6. Clique em Restaurar.

    O Cloud SQL restaura o backup na instância nova ou atual, dependendo da sua seleção. Para verificar o status da operação de restauração, acesse a página Operações da instância.

    É possível criar réplicas depois que a operação de restauração for concluída.

gcloud

  1. Se você estiver restaurando para uma instância atual, todas as réplicas precisarão ser excluídas da instância de destino antes da restauração.

    Determine se a instância tem réplicas de leitura usando o comando gcloud sql instances describe:

    gcloud sql instances describe TARGET_INSTANCE_NAME

    Substitua:

    • TARGET_INSTANCE_NAME: o nome da instância.

    Se a instância tiver réplicas, exclua-as usando o comando gcloud sql instances delete:

    gcloud sql instances delete REPLCICA_NAME

    Substitua:

    • REPLCICA_NAME: o nome da réplica.

  2. Encontre o backup que você quer usar.

    Se a instância estiver usando backups padrão, use o comando gcloud sql backups list para encontrar um backup e registrar o valor ID dele:

    gcloud sql backups list INSTANCE_NAME

    Substitua:

    • INSTANCE_NAME: o nome da instância.

    Se a instância estiver usando backups avançados, consulte Listar todos os backups em um backup vault.

  3. Para restaurar a instância do backup especificado, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID \
--restore-instance=TARGET_INSTANCE_NAME \
--backup-instance=SOURCE_INSTANCE_NAME

    Substitua:

    • BACKUP_ID: o ID do backup que você quer restaurar.
    • TARGET_INSTANCE_NAME: o nome da instância de destino, nova ou atual.
    • SOURCE_INSTANCE_NAME: o nome da instância de origem.

  4. Se você estiver restaurando para uma instância atual, após a conclusão da operação de restauração, recrie as réplicas que foram excluídas neste procedimento.

REST v1

  1. Se você estiver usando uma instância atual, todas as réplicas precisam ser excluídas antes da restauração. Para determinar se a instância tem réplicas de leitura e receber os IDs delas, liste todas as réplicas da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • 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/instances/INSTANCE_ID?fields=replicaNames

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Exclua todas as réplicas da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;
    • REPLICA_ID: o ID da réplica

    Método HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  3. Receba o ID do backup que você quer usar.

    • Se a instância estiver usando backups padrão, execute o seguinte:

      Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

      • 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/instances/instance-id/backupRuns

      Para enviar a solicitação, expanda uma destas opções:

      Você receberá uma resposta JSON semelhante a esta:

  4. Restaure a instância do backup:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • project-id: o ID do projeto
    • target-instance-id: o ID da instância de destino
    • source-instance-id: o ID da instância de origem
    • backup-id O ID de backup

    Método HTTP e URL:

    POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id/restoreBackup

    Corpo JSON da solicitação:

    {
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "instanceId": "source-instance-id"
  }
}

    Para enviar a solicitação, expanda uma destas opções:

    Você vai receber uma resposta JSON semelhante a esta:

  5. Após a conclusão da operação de restauração, recrie todas as réplicas que você excluiu neste procedimento.

REST v1beta4

  1. Para determinar se a instância tem réplicas de leitura e receber os IDs delas, liste todas as réplicas da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • 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/instances/INSTANCE_ID?fields=replicaNames

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Exclua todas as réplicas da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;
    • REPLICA_ID: o ID da réplica

    Método HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  3. Receba o ID do backup que você quer usar.

    • Se a instância estiver usando backups padrão, execute o seguinte:

      Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

      • 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/instances/instance-id/backupRuns

      Para enviar a solicitação, expanda uma destas opções:

      Você receberá uma resposta JSON semelhante a esta:

  4. Restaure a instância do backup:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • project-id: o ID do projeto
    • target-instance-id: o ID da instância de destino
    • source-instance-id: o ID da instância de origem
    • backup-id O ID de backup

    Método HTTP e URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id/restoreBackup

    Corpo JSON da solicitação:

    {
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "instanceId": "source-instance-id"
  }
}

    Para enviar a solicitação, expanda uma destas opções:

    Você vai receber uma resposta JSON semelhante a esta:

  5. Após a conclusão da operação de restauração, recrie todas as réplicas que você excluiu neste procedimento.

Restaurar para uma instância em outro projeto

É possível usar o parâmetro project para restaurar dados para uma instância em um projeto diferente. Ao usar um backup para restaurar para uma instância em um projeto diferente, os dados na instância de destino são atualizados para o estado em que eles estavam na instância de origem no momento em que o backup foi feito.

O usuário que está restaurando para um projeto diferente precisa ter as seguintes permissões para restaurar a instância: * Permissão cloudsql.instances.restoreBackup para o projeto de destino * Permissão cloudsql.backupRuns.get para o projeto de origem.

Essas permissões estão incluídas no papel Cloud SQL Admin.

Para restaurar sua instância usando um backup em uma instância em um projeto ou região diferente, faça o seguinte:

gcloud

Para restaurar um backup de um cofre de backup para uma instância atual, faça o seguinte:

  1. Se você estiver restaurando para uma instância atual, determine se a instância de destino tem réplicas de leitura usando o comando gcloud sql instances describe:

    gcloud sql instance describe TARGET_INSTANCE_NAME

    Substitua:

    • TARGET_INSTANCE_NAME: o nome da instância de destino em que você quer restaurar o backup.

    Exclua todas as réplicas da instância de destino usando o comando gcloud sql instances delete:

    gcloud sql instance delete REPLICA_NAME

    Substitua:

    • REPLICA_NAME: o nome da réplica da instância de destino.

    Todas as réplicas precisam ser excluídas antes que você possa restaurar uma instância existente.

  2. Encontre o backup que você quer usar.

    Se a instância estiver usando backups padrão, use o comando gcloud sql backups list para encontrar um backup e registre o valor ID dele:

    gcloud sql backups list INSTANCE_NAME

    Substitua:

    • INSTANCE_NAME: o nome da instância.

    Se a instância estiver usando backups avançados, consulte Listar todos os backups em um backup vault.

  3. Para restaurar para uma instância nova ou atual em um novo projeto, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID
--restore-instance=TARGET_INSTANCE_NAME
--backup-instance=SOURCE_INSTANCE_NAME
--backup-project=SOURCE_INSTANCE_PROJECT

    Substitua:

    • BACKUP_ID: o ID do backup do cofre de backup. É necessário incluir o caminho completo do backup nesse campo.

    • TARGET_INSTANCE_NAME: a instância no projeto de destino em que você está restaurando dados.

    • SOURCE_INSTANCE_NAME: o nome da instância no projeto de origem em que os dados estão.

    • SOURCE_INSTANCE_PROJECT: o projeto que contém a instância de origem.

REST v1

  1. Para conseguir o backupId, execute o seguinte:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • 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/instances/instance-id/backupRuns

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Restaure o backup para uma instância em um projeto diferente:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • source-project-id: o ID do projeto de origem
    • target-project-id: o ID do projeto de destino
    • target-instance-id: o ID da instância de destino
    • source-instance-id: o ID da instância de origem
    • backup-id O ID de backup

    Método HTTP e URL:

    POST https://sqladmin.googleapis.com/v1/projects/target-project-id/instances/target-instance-id/restoreBackup

    Corpo JSON da solicitação:

    {
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "project": "source-project-id",
    "instanceId": "source-instance-id"
  }
}

    Para enviar a solicitação, expanda uma destas opções:

    Você vai receber uma resposta JSON semelhante a esta:

REST v1beta4

  1. Para conseguir o backupId, execute o seguinte:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • 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/instances/instance-id/backupRuns

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Restaure o backup para uma instância em um projeto diferente:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • source-project-id: o ID do projeto de origem
    • target-project-id: o ID do projeto de destino
    • target-instance-id: o ID da instância de destino
    • source-instance-id: o ID da instância de origem
    • backup-id O ID de backup

    Método HTTP e URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/target-project-id/instances/target-instance-id/restoreBackup

    Corpo JSON da solicitação:

    {
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "project": "source-project-id",
    "instanceId": "source-instance-id"
  }
}

    Para enviar a solicitação, expanda uma destas opções:

    Você vai receber uma resposta JSON semelhante a esta:

Restaurar uma instância excluída

É possível usar um backup final ou um backup retido para restaurar uma instância excluída nos seguintes cenários:

Restaurar para uma instância atual

Ao restaurar dados de um backup final ou retido para uma instância atual, você atualiza os dados na instância de destino para o estado em que estavam na instância de origem no momento do backup. Para mais informações sobre como restaurar uma instância, consulte Dicas gerais sobre como fazer uma restauração.

Para restaurar uma instância excluída usando um backup em uma instância atual, 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. Se a instância de destino tiver réplicas de leitura, use o menu "Mais ações" Ícone mais ações. para excluí-las. Todas as réplicas precisam ser excluídas antes que você possa restaurar um backup retido ou final para a instância atual.

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

    Acessar "Backups do Cloud SQL"

  4. Na página Backups, clique em Nível Standard ou Nível Enhanced, dependendo da opção de backup da sua instância.

  5. Se a instância estiver usando backups padrão, clique no nome da instância excluída que contém o backup que você quer restaurar.

    Se a instância estiver usando backups aprimorados, selecione Nível aprimorado e escolha 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.

  6. Encontre o nome do backup que você quer restaurar e clique em Restaurar.

  7. Na página Restaurar uma instância de um backup, confirme se você selecionou o backup correto em Revisar detalhes do backup.

  8. Na seção Escolher destino de restauração, selecione Substituir uma instância atual.

  9. No menu Instância a ser substituída, selecione a instância em que você quer restaurar o backup. A instância selecionada e todos os respectivos dados serão substituídos.

  10. Para confirmar a seleção, no campo ID da instância de destino, digite o nome da instância a ser substituída.

  11. Clique em Restaurar.

    O Cloud SQL vai restaurar o backup na instância atual. Para verificar o status da operação de restauração, acesse a página Operações da instância.

    É possível criar réplicas depois que a operação de restauração for concluída.

gcloud 

1.  When restoring to an existing instance, all replicas must be deleted
from your target instance prior to restoring.

Determine if your instance has any read replicas using the
[`gcloud sql instances describe`](/sdk/gcloud/reference/sql/instances/describe)
command:

```gcloud
gcloud sql instances describe TARGET_INSTANCE_NAME
```

Replace the following:

*   `TARGET_INSTANCE_NAME`: the name of the instance.

If your instance contains replicas, then delete the replicas
using the
[`gcloud sql instances delete`](/sdk/gcloud/reference/sql/instances/delete)
command:

```gcloud
gcloud sql instances delete REPLCICA_NAME
```

Replace the following:

*   `REPLCICA_NAME`: the name of the replica.

  1. Encontre o backup que você quer usar.

    Se a instância estiver usando backups padrão, use o comando gcloud sql backups list para encontrar um backup e registrar o valor ID dele:

    gcloud sql backups list INSTANCE_NAME

    Substitua:

    • INSTANCE_NAME: o nome da instância.

    Se a instância estiver usando backups avançados, consulte Listar todos os backups em um backup vault.

  2. Para restaurar a instância do backup especificado, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID \
--restore-instance=TARGET_INSTANCE_NAME

    Substitua:

    • BACKUP_ID: o ID do backup que você quer restaurar.
    • TARGET_INSTANCE_NAME: o nome da instância de destino nova ou atual.

  3. Após a conclusão da operação de restauração, recrie todas as réplicas que você excluiu neste procedimento.

REST v1

  1. Ao restaurar para uma instância atual, todas as réplicas precisam ser excluídas da instância de destino antes da restauração. Para determinar se a instância tem réplicas de leitura, execute o seguinte:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • 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/instances/INSTANCE_ID?fields=replicaNames

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Exclua todas as réplicas de leitura da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;
    • REPLICA_ID: o ID da réplica

    Método HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  3. Receba o ID do backup final ou retido que você quer usar:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;

    Método HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  4. Restaure a instância de destino por meio do backup retido ou final.

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;
    • TARGET_INSTANCE_ID: o ID da instância de destino
    • BACKUP_ID: o ID do backup

    Método HTTP e URL: 

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Corpo JSON da solicitação:

    {
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

    Para enviar a solicitação, expanda uma destas opções:

    Você vai receber uma resposta JSON semelhante a esta:

REST v1beta4

  1. Ao restaurar para uma instância atual, todas as réplicas precisam ser excluídas da instância de destino antes da restauração. Para determinar se a instância tem réplicas de leitura, execute o seguinte:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • 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/instances/INSTANCE_ID?fields=replicaNames

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  2. Exclua todas as réplicas de leitura da instância:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;
    • REPLICA_ID: o ID da réplica

    Método HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  3. Receba o ID do backup final ou retido que você quer usar:

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;

    Método HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

    Para enviar a solicitação, expanda uma destas opções:

    Você receberá uma resposta JSON semelhante a esta:

  4. Restaure a instância de destino por meio do backup retido ou final.

    Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

    • PROJECT_ID: o ID do projeto;
    • TARGET_INSTANCE_ID: o ID da instância de destino
    • BACKUP_ID: o ID do backup

    Método HTTP e URL: 

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Corpo JSON da solicitação:

    {
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

    Para enviar a solicitação, expanda uma destas opções:

    Você vai receber uma resposta JSON semelhante a esta:

Restaurar para uma nova instância

Quando você cria uma instância de um backup final ou retido, o Cloud SQL usa as configurações de configuração da instância de onde o backup é feito. Depois que a instância é criada, o Cloud SQL restaura os dados para o estado em que estavam quando o backup foi feito.

Para restaurar dados de um backup final ou retido para uma nova instância, você precisa ter as seguintes permissões:

  • Permissão cloudsql.instances.create para o projeto de destino
  • Permissão cloudsql.instances.restoreBackup para o projeto de destino
  • cloudsql.backupRuns.get permission para o backup de origem.

Essas permissões estão incluídas no papel de administrador do Cloud SQL.

Para restaurar uma instância excluída usando um backup em uma nova instância, faça o seguinte:

Console

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

    Acessar "Backups do Cloud SQL"

  2. Na página Backups, clique em Nível Standard ou Nível Enhanced, dependendo da opção de backup da sua instância.

  3. Se a instância estiver usando backups padrão, clique no nome da instância excluída que contém o backup que você quer restaurar.

    Se a instância estiver usando backups aprimorados, selecione Nível aprimorado e escolha 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 mostrados.

  4. Encontre o nome do backup que você quer restaurar e clique em Restaurar.

  5. Na página Restaurar uma instância de um backup, confirme se você selecionou o backup correto em Revisar detalhes do backup.

  6. Na seção Escolher destino de restauração, selecione Restaurar para uma nova instância.

  7. No menu Região, selecione a região da nova instância.

  8. No campo ID da instância, insira um ID para a nova instância. Esse ID não pode ser alterado depois de criado.

  9. Clique em Restaurar.

    O Cloud SQL vai restaurar o backup na instância atual. Para verificar o status da operação de restauração, acesse a página Operações da instância.

gcloud

  1. Encontre o backup que você quer usar.

    Se a instância estiver usando backups padrão, use o comando gcloud sql backups list para encontrar um backup e registrar o valor ID dele:

    gcloud sql backups list INSTANCE_NAME

    Substitua:

    • INSTANCE_NAME: o nome da instância.

    Se a instância estiver usando backups avançados, consulte Listar todos os backups em um backup vault.

  2. Para restaurar a instância do backup especificado, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID \
--restore-instance=TARGET_INSTANCE_NAME

    Substitua:

    • BACKUP_ID: o ID do backup que você quer restaurar.

  3. TARGET_INSTANCE_NAME: o nome da instância de destino nova ou atual.

REST v1

Restaurar uma nova instância do backup final ou retido especificado

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • TARGET_INSTANCE_ID: o ID da instância de destino
  • BACKUP_ID: o ID do backup

Método HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Corpo JSON da solicitação:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {}
}

Para enviar a solicitação, expanda uma destas opções:

Você vai receber uma resposta JSON semelhante a esta:

REST v1beta4

Restaurar uma nova instância do backup final ou retido especificado

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • TARGET_INSTANCE_ID: o ID da instância de destino
  • BACKUP_ID: o ID do backup

Método HTTP e URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Corpo JSON da solicitação:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {}
}

Para enviar a solicitação, expanda uma destas opções:

Você vai receber uma resposta JSON semelhante a esta:

Restaurar para uma instância nova ou atual em um projeto diferente

É possível usar o parâmetro project para restaurar dados para uma instância em um projeto diferente. Quando você restaura uma instância excluída de um backup para uma instância em um projeto diferente, a instância de destino é atualizada para o estado da instância de origem no momento em que o backup foi feito.

O usuário que está restaurando para um projeto diferente precisa ter as seguintes permissões para restaurar a instância: * Permissão cloudsql.instances.create para o projeto de destino * Permissão cloudsql.instances.restoreBackup para o projeto de destino * cloudsql.backupRuns.get permission para o backup de origem.

Essas permissões estão incluídas no papel Cloud SQL Admin.

Para restaurar sua instância usando um backup em uma instância em um projeto ou região diferente, faça o seguinte:

gcloud

  1. Se você estiver restaurando para uma instância atual, determine se a instância de destino tem réplicas de leitura usando o comando gcloud sql instances describe:

    gcloud sql instance describe TARGET_INSTANCE_NAME

    Substitua:

    • TARGET_INSTANCE_NAME: o nome da instância de destino em que você quer restaurar o backup.

    Exclua todas as réplicas da instância de destino usando o comando gcloud sql instances delete:

    gcloud sql instance delete REPLICA_NAME

    Substitua:

    • REPLICA_NAME: o nome da réplica da instância de destino.

    Todas as réplicas precisam ser excluídas antes que você possa restaurar uma instância existente.

    1. Encontre o backup que você quer usar.

    Se a instância estiver usando backups padrão, use o comando gcloud sql backups list para encontrar um backup e registrar o valor ID dele:

    gcloud sql backups list INSTANCE_NAME

    Substitua:

    • INSTANCE_NAME: o nome da instância.

    Se a instância estiver usando backups avançados, consulte Listar todos os backups em um backup vault.

  2. Para restaurar para uma instância nova ou atual em um novo projeto, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_ID
--restore-instance=TARGET_INSTANCE_NAME
--backup-instance=SOURCE_INSTANCE_NAME
--backup-project=SOURCE_INSTANCE_PROJECT

    Substitua:

    • BACKUP_ID: o ID do backup do cofre de backup. É necessário incluir o caminho completo do backup nesse campo.

    • TARGET_INSTANCE_NAME: a instância no projeto de destino em que você está restaurando dados.

    • SOURCE_INSTANCE_NAME: o nome da instância no projeto de origem em que os dados estão.

    • SOURCE_INSTANCE_PROJECT: o projeto que contém a instância de origem.

REST v1

Para conseguir o backupID do backup retido ou final, execute o seguinte:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;

Método HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Restaurar para um projeto diferente

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • TARGET_INSTANCE_ID: o ID da instância de destino
  • BACKUP_ID: o ID do backup

Método HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Corpo JSON da solicitação:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar a solicitação, expanda uma destas opções:

Você vai receber uma resposta JSON semelhante a esta:

REST v1beta4

Para conseguir o backupID do backup retido ou final, execute o seguinte:

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;

Método HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups

Para enviar a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Restaurar para um projeto diferente

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • TARGET_INSTANCE_ID: o ID da instância de destino
  • BACKUP_ID: o ID do backup

Método HTTP e URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Corpo JSON da solicitação:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar a solicitação, expanda uma destas opções:

Você vai receber uma resposta JSON semelhante a esta:

A seguir

* Saiba como fazer backup dos seus dados. * Veja como fazer o backup dos dados.