Restaurar uma instância

Nesta página, veja como restaurar sua instância de um backup.

Para mais informações, práticas recomendadas e requisitos para operações e restauração, consulte Visão geral da restauração de uma instância.

Restaurar de um backup sob demanda ou automatizado

É possível usar um backup sob demanda ou automatizado nos seguintes cenários:

  • Restaurar para uma instância diferente no mesmo projeto
  • Restaure na mesma instância em que o backup foi feito.
  • Restaurar para uma instância diferente em outro projeto ou região

Se a recuperação pontual (PITR) estiver ativada, será possível recuperar a instância para um momento específico com base nas configurações de retenção de registros dela.

A restauração de uma instância a partir de um backup exige que as instâncias de backup e de destino estejam no mesmo fuso horário.

Restaurar para uma instância diferente

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. Para mais informações, consulte Dicas para executar uma restauração e Dicas e requisitos de restauração para uma instância diferente.

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.

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.
  3. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  4. No menu de navegação SQL, selecione Backups.
  5. Encontre o backup que você quer restaurar e clique em Restaurar.
  6. Na página Restaurar uma instância de um backup, confirme se você selecionou o backup correto em Revisar detalhes do backup.
  7. Em Escolher destino de restauração, selecione Substituir uma instância atual.
  8. 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.
  9. Para confirmar a seleção, digite o nome da instância a ser substituída no campo ID da instância de destino.
  10. Para iniciar o processo de restauração, clique em Restaurar.
  11. Para verificar o status da operação de restauração, acesse a página Operações da instância.
  12. Após a conclusão da operação de restauração, recrie as réplicas que você excluiu neste procedimento.

gcloud

  1. Para determinar se a instância de destino tem réplicas de leitura, use o comando gcloud sql instances describe: 
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Anote todas as instâncias listadas na coluna replicaNames.

  2. Para excluir todas as réplicas, use o comando gcloud sql instances delete: 
    gcloud sql instances delete REPLICA_NAME

    Repita para cada réplica.

  3. Para listar os backups da instância de origem, use o comando gcloud sql backups list: 
    gcloud sql backups list \
--instance SOURCE_INSTANCE_NAME
  4. Encontre o backup que você quer usar e registre o valor ID correspondente.
  5. Para restaurar a instância de destino usando o backup, use o comando gcloud sql backups restore: 
    gcloud sql backups restore BACKUP_ID \
--restore-instance=TARGET_INSTANCE_NAME \
--backup-instance=SOURCE_INSTANCE_NAME
  6. Após a conclusão da operação de restauração, recrie todas 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 de destino.

    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.

    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:

    Repita para cada réplica.

  3. Para ver o ID do backup que você quer usar, liste os backups da instância de origem.

    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:

    -OU-

    Caso sua instância esteja em uma região com interrupção, liste todos os backups em um projeto

    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 ou - para uma lista de todos os backups no projeto

    Método HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/-/backupRuns

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

    Você receberá uma resposta JSON semelhante a esta:

    Encontre o backup da instância que você precisa restaurar.

  4. Restaure a instância de destino por meio 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 de destino.

    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.

    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:

    Repita para cada réplica.

  3. Para ver o ID do backup que você quer usar, liste os backups da instância de origem.

    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 de destino por meio 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 a mesma instância

A restauração de dados de um backup na mesma instância retorna os dados para o estado em que estavam no momento do backup. Para informações sobre como restaurar uma instância, consulte as Dicas sobre como fazer uma restauração.

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.
  3. Para abrir a página Visão geral de uma instância, clique no nome da instância.
  4. No menu de navegação SQL, selecione Backups.
  5. Encontre o backup que você quer usar e clique em Restaurar.
  6. Na página Restaurar uma instância de um backup, confirme se você selecionou o backup correto em Revisar detalhes do backup.
  7. Em Escolher destino de restauração, selecione Substituir a instância de origem.

    Verifique se o nome da instância de origem está especificado entre parênteses.

  8. Para confirmar a seleção, digite o nome da instância no campo ID da instância de destino.
  9. Para iniciar o processo de restauração, clique em Restaurar.
  10. Para verificar o status da operação de restauração, acesse a página Operações da instância.
  11. Após a conclusão da operação de restauração, recrie as réplicas que você excluiu neste procedimento.

gcloud

  1. Para determinar se a instância tem réplicas de leitura, use o comando gcloud sql instances describe: 
    gcloud sql instances describe INSTANCE_NAME

    Anote todas as instâncias listadas na coluna replicaNames.

  2. Para excluir todas as réplicas, use o comando gcloud sql instances delete: 
    gcloud sql instances delete REPLICA_NAME

    Repita para cada réplica.

  3. Para listar os backups da instância, use o comando gcloud sql backups list: 
    gcloud sql backups list --instance INSTANCE_NAME
  4. Encontre o backup que você quer usar e registre o valor ID correspondente.
  5. Para restaurar a instância do backup especificado, use o comando gcloud sql backups restore: 
    gcloud sql backups restore BACKUP_ID \
--restore-instance=INSTANCE_NAME
  6. Após a conclusão da operação de restauração, recrie todas as réplicas que você excluiu neste procedimento.

REST v1

  1. Para conferir o ID do backup que você quer usar, liste os backups 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/backupRuns

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

    Você receberá uma resposta JSON semelhante a esta:

  2. Restaure a instância por meio do backup especificado.

    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:

  3. 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 conferir o ID do backup que você quer usar, liste os backups 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/backupRuns

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

    Você receberá uma resposta JSON semelhante a esta:

  2. Restaure a instância por meio do backup especificado.

    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:

  3. 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 daquele em que o backup foi feito. Ao usar o parâmetro project, chame restoreBackup no projeto e na instância em que você quer restaurar os dados. Ao fazer a restauração a partir de um backup em uma instância diferente, você atualiza os dados na instância de destino para o estado em que estavam na instância de origem no momento do backup.

Permissões

O usuário que está restaurando para um projeto diferente precisa ter a permissão cloudsql.instances.restoreBackup para o projeto de destino e a permissão cloudsql.backupRuns.get para a instância de origem. Essas permissões estão incluídas no papel Cloud SQL Admin.

Para restaurar dados para uma instância em um projeto diferente, faça o seguinte:

gcloud

  1. Liste os backups da instância. 

    gcloud sql backups list --instance INSTANCE_NAME

    Substitua INSTANCE_NAME pelo nome da instância.

  2. Encontre o backup a ser usado e registre o valor ID correspondente.

  3. Restaure dados para uma instância em um projeto diferente. 

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

    Faça as seguintes substituições:

    • BACKUP_ID: o ID do backup. Você recebeu esse ID anteriormente neste procedimento.
    • TARGET_INSTANCE_NAME: a instância no projeto de destino para onde você está restaurando dados.
    • SOURCE_INSTANCE_NAME: a instância no projeto de origem que contém os dados que você quer restaurar para a instância no projeto de destino.
    • SOURCE_INSTANCE_PROJECT: o projeto que contém a instância de origem.

REST v1

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:

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:

Para mais informações sobre a propriedade project, consulte restoreBackup

REST v1beta4

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:

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:

Para mais informações sobre a propriedade project, consulte restoreBackup

Restaurar de um backup final

É possível usar um backup final nos seguintes cenários:

  • Restaure o backup final para uma nova instância
  • Restaurar para uma nova instância em um projeto ou região diferente

Como você está usando um backup final de uma instância excluída para restaurar a instância, também é possível usar o backup para criar uma instância com a configuração da instância excluída e recuperar seus dados.

Restaurar para uma nova instância

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

Console

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

    Acessar "Backups do Cloud SQL"

    Nesta página, listamos todos os backups, incluindo os finais, associados a um projeto Google Cloud .

  2. Clique no backup final que contém os dados que você quer restaurar em uma nova instância.
  3. Na caixa de diálogo Backup final, clique em Restaurar.
  4. Na página Restaurar uma instância de um backup, confirme se você selecionou o backup correto em Revisar detalhes do backup.
  5. Em Escolher destino de restauração, selecione Restaurar para uma nova instância.
  6. No menu Região, selecione a região da nova instância.
  7. No campo ID da instância, insira um ID para a nova instância.
  8. Para iniciar o processo de restauração, clique em Restaurar.
  9. Para verificar o status da operação de restauração, acesse a página Operações da instância.

gcloud

  1. Para listar os backups finais da instância de origem, use o comando gcloud sql backups list: 
    gcloud sql backups list \
--filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  2. Encontre o backup que você quer usar e registre o valor NAME correspondente.
  3. Para restaurar uma nova instância do backup final especificado, use o comando gcloud sql backups restore: 
    gcloud sql backups restore BACKUP_NAME \
--restore-instance=TARGET_INSTANCE_NAME

REST v1

  1. Para conferir o ID do backup que você quer usar, liste os backups finais da instância de origem.

    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/backups?filter='type:FINAL AND instance:INSTANCE_ID'

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

    Você receberá uma resposta JSON semelhante a esta:

  2. Restaure uma nova instância do backup final 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

  1. Para conferir o ID do backup que você quer usar, liste os backups finais da instância de origem.

    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/backups?filter='type:FINAL AND instance:INSTANCE_ID'

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

    Você receberá uma resposta JSON semelhante a esta:

  2. Restaure uma nova instância do backup final 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 atual

Ao restaurar dados de um backup final para uma instância atual, 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. Para mais informações, consulte Dicas para executar uma restauração e Dicas e requisitos de restauração para uma instância diferente.

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.

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.

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

    Acessar "Backups do Cloud SQL"

    Nesta página, listamos todos os backups, incluindo os finais, associados a um projeto Google Cloud .

  4. Clique no backup final que contém os dados que você quer restaurar em outra instância.
  5. Na caixa de diálogo Backup final, clique em Restaurar.
  6. Na página Restaurar uma instância de um backup, confirme se você selecionou o backup correto em Revisar detalhes do backup.
  7. Em Escolher destino de restauração, selecione Substituir uma instância atual.

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

  9. Para confirmar a seleção, digite o nome da instância a ser substituída no campo ID da instância de destino.
  10. Para iniciar o processo de restauração, clique em Restaurar.
  11. Para verificar o status da operação de restauração, acesse a página Operações da instância.
  12. Após a conclusão da operação de restauração, recrie as réplicas que você excluiu neste procedimento.

gcloud

  1. Para determinar se a instância de destino tem réplicas de leitura, use o comando gcloud sql instances describe: 
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Anote todas as instâncias listadas na coluna replicaNames.

  2. Para excluir todas as réplicas, use o comando gcloud sql instances delete: 
    gcloud sql instances delete REPLICA_NAME

    Repita para cada réplica.

  3. Para listar os backups finais da instância de origem, use o comando gcloud sql backups list: 
    gcloud sql backups list \
--filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  4. Encontre o backup que você quer usar e registre o valor NAME correspondente.
  5. Para restaurar a instância de destino usando o backup, use o comando gcloud sql backups restore: 
    gcloud sql backups restore BACKUP_NAME \
--restore-instance=TARGET_INSTANCE_NAME
  6. Após a conclusão da operação de restauração, recrie todas 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 de destino.

    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.

    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:

    Repita para cada réplica.

  3. Para conferir o ID do backup final que você quer usar, liste os backups da instância de origem.

    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/backups?filter='type:FINAL AND instance:INSTANCE_ID'

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

    Você receberá uma resposta JSON semelhante a esta:

    Encontre o backup da instância que você precisa restaurar.

  4. Restaure a instância de destino por meio 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
    • 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:

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

    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.

    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:

    Repita para cada réplica.

  3. Para conferir o ID do backup final que você quer usar, liste os backups da instância de origem.

    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/backups?filter='type:FINAL AND instance:INSTANCE_ID'

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

    Você receberá uma resposta JSON semelhante a esta:

    Encontre o backup da instância que você precisa restaurar.
  4. Restaure a instância de destino por meio 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
    • 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:

  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

O usuário que está restaurando dados para uma instância em um projeto diferente precisa ter a permissão cloudsql.instances.restoreBackup, a permissão cloudsql.instances.create para o projeto de destino e a permissão cloudsql.backupRuns.get para a instância de origem. Essas permissões estão incluídas no papel Cloud SQL Admin.

Para restaurar dados para uma instância em um projeto diferente, faça o seguinte:

REST v1

Para conseguir o backupId do backup 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
  • 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 AND instance:INSTANCE_ID'

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

Você receberá uma resposta JSON semelhante a esta:

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:

  • 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:

Para mais informações sobre a propriedade project, consulte restoreBackup

REST v1beta4

Para conseguir o backupId do backup 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
  • 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 AND instance:INSTANCE_ID'

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

Você receberá uma resposta JSON semelhante a esta:

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:

  • 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:

Para mais informações sobre a propriedade project, consulte restoreBackup

Restaurar para uma nova instância em outra região

O usuário que está restaurando dados para uma nova instância em uma região diferente precisa ter a permissão cloudsql.instances.restoreBackup para o projeto de destino e a permissão cloudsql.backupRuns.get para a instância de origem. Essas permissões estão incluídas no papel Cloud SQL Admin.

Além disso, para criar uma instância em outra região, é necessário atender aos critérios das políticas da organização para essa região.

Para restaurar dados para uma nova instância em uma região diferente:

gcloud

  1. Para listar os backups finais da instância de origem, use o comando gcloud sql backups list: 
    gcloud sql backups list \
--filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  2. Encontre o backup que você quer usar e registre o valor NAME correspondente.
  3. Para usar o backup final e restaurar dados em uma nova instância em outra região, use o comando gcloud sql backups restore: 
    gcloud sql backups restore BACKUP_NAME \
--restore-instance=TARGET_INSTANCE_NAME \
--region=TARGET_REGION

REST v1

Para conseguir o backupId do backup 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
  • 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 AND instance:INSTANCE_ID'

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

Você receberá uma resposta JSON semelhante a esta:

Restaure o backup para uma nova instância em uma região 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
  • REGION: a região da instância de destino (por exemplo, us-central1)

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: {
    region: REGION
  }
}

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

Você vai receber uma resposta JSON semelhante a esta:

Para mais informações sobre a propriedade project, consulte restoreBackup

REST v1beta4

Para conseguir o backupId do backup 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
  • 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 AND instance:INSTANCE_ID'

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

Você receberá uma resposta JSON semelhante a esta:

Restaure o backup para uma nova instância em uma região 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
  • REGION: a região da instância de destino (por exemplo, us-central1)

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: {
    region: REGION
  }
}

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

Você vai receber uma resposta JSON semelhante a esta:

Para mais informações sobre a propriedade project, consulte restoreBackup

Restaurar de um backup retido

Você pode usar um backup retido nos seguintes cenários:

  • Restaure o backup retido para uma nova instância
  • Restaurar o backup retido para uma instância atual
  • Restaurar para uma instância nova ou atual em outro projeto ou região

Como você está usando um backup retido de uma instância excluída para restaurar sua instância, também é possível usar o backup para criar uma instância com a configuração da instância excluída e recuperar seus dados.

Restaurar um backup retido para uma nova instância

Ao criar uma instância com base em um backup retido, o Cloud SQL usa as configurações da instância de origem do backup.

Para restaurar dados de um backup retido em uma nova instância, você precisa ter a permissão cloudsql.instances.create.

Console

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

    Acessar "Backups do Cloud SQL"

  2. Clique no nome da instância excluída que contém o backup que você quer restaurar.

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

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

  5. Em Escolher destino de restauração, selecione Restaurar para uma nova instância.

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

  7. No campo ID da instância, insira um ID para a nova instância.

  8. Clique em Restaurar.

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

gcloud

  1. Use gcloud sql backups list para encontrar o backup que você quer armazenar em uma nova instância.

    gcloud sql backups list
--project=PROJECT_ID

    Substitua:

    • PROJECT_ID: o ID do seu projeto Google Cloud .

  2. Encontre o backup a ser usado e registre o valor BACKUP_NAME correspondente.

  3. Para restaurar em uma nova instância, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_NAME
--restore-instance=TARGET_INSTANCE_NAME

    Substitua:

    • BACKUP_NAME: o nome do backup retido que você quer restaurar.

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

REST v1

Restaurar uma nova instância do backup 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 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 um backup retido para uma instância atual

Ao restaurar dados de um backup retido para uma instância atual, 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.

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 o backup retido possa ser restaurado na instância atual.

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

    Acessar "Backups do Cloud SQL"

  4. Clique no nome da instância excluída que contém o backup que você quer restaurar.

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

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

  7. Em Escolher destino de restauração, selecione Substituir uma instância atual.

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

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

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

  2. 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 que você quer excluir.

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

  3. Use gcloud sql backups list para encontrar o backup que você quer restaurar na instância atual.

    gcloud sql backups list
--project=PROJECT_ID

    Substitua:

    • PROJECT_ID: o ID do seu projeto Google Cloud .

  4. Encontre o backup a ser usado e registre o valor BACKUP_NAME correspondente.

  5. Para restaurar uma instância, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_NAME
--restore-instance=TARGET_INSTANCE_NAME

    Substitua:

    • BACKUP_NAME: o nome do backup retido que você quer restaurar.

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

    Quando a operação de restauração for concluída, recrie as réplicas que foram excluídas.

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

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

    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. Encontre o ID do backup retido que você quer restaurar.

    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 usando o backup retido.

    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. Para determinar se a instância tem réplicas de leitura e receber os IDs delas, liste todas as réplicas da instância de destino.

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

    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. Encontre o ID do backup retido que você quer restaurar.

    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 usando o backup retido.

    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 instância em outro projeto

Para restaurar uma instância usando um backup retido em um projeto diferente, você precisa ter as seguintes permissões:

É possível restaurar para outro projeto usando apenas a gcloud CLI ou a API Cloud SQL.

gcloud

  1. Use gcloud sql backups list para encontrar o backup que você quer armazenar em uma nova instância.

    gcloud sql backups list
--project=PROJECT_ID

    Substitua:

    • PROJECT_ID: o ID do seu projeto Google Cloud .

  2. Encontre o backup a ser usado e registre o valor BACKUP_NAME correspondente.

  3. Para restaurar em uma nova instância, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_NAME
--restore-instance=TARGET_INSTANCE_NAME

    Substitua:

    • BACKUP_NAME: o nome do backup retido que você quer restaurar.

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

REST v1

Para receber o backupID do backup retido, 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 receber o backupID do backup retido, 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:

Restaurar para uma instância em outra região

Para restaurar uma instância usando um backup retido em uma região diferente, você precisa das seguintes permissões:

É possível restaurar para outra região usando apenas a gcloud CLI ou a API Cloud SQL. A região de destino precisa obedecer às políticas da organização para a região.

gcloud

  1. Use gcloud sql backups list para encontrar o backup que você quer armazenar em uma nova instância.

    gcloud sql backups list
--project=PROJECT_ID

    Substitua:

    • PROJECT_ID: o ID do seu projeto Google Cloud .

  2. Encontre o backup a ser usado e registre o valor NAME correspondente.

  3. Para restaurar em uma nova instância, use o comando gcloud sql backups restore:

    gcloud sql backups restore BACKUP_NAME
--restore-instance=TARGET_INSTANCE_NAME
--region=TARGET_REGION

    Substitua:

    • BACKUP_NAME: o nome do backup retido que você quer restaurar.

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

    • TARGET_REGION: a nova região em que você quer restaurar o backup.

REST v1

Para receber o backupID do backup retido, 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
  • REGION: a região da instância de destino (por exemplo, us-central1)

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: {
    region: REGION
  }
}

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

Você vai receber uma resposta JSON semelhante a esta:

REST v1beta4

Para receber o backupID do backup retido, 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
  • REGION: a região da instância de destino (por exemplo, us-central1)

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: {
    region: REGION
  }
}

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

Você vai receber uma resposta JSON semelhante a esta:

Restaurar de um backup no cofre de backup

Se a instância do Cloud SQL estiver ativada para usar backups avançados, será possível restaurá-la de um backup no cofre de backups. É possível restaurar a instância nos seguintes cenários:

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

Restaurar um backup do cofre de backup para uma nova instância

Ao restaurar dados de um backup para uma nova instância, 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.

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.

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

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

  5. Em Escolher destino de restauração, selecione Restaurar para uma nova instância e atualize o seguinte:

    • Em Projeto, selecione o projeto para a nova instância. O projeto precisa estar na mesma região do backup vault, e você precisa ter acesso a ele.

    • Em Região, confirme a região. A região precisa corresponder à região 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.

  6. Clique em Restaurar.

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

    A nova instância usa a opção de backups padrão por padrão. Para atualizar para backups aprimorados, consulte Ativar backups aprimorados.

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

gcloud

Para restaurar em uma nova instância, 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 do cofre de backup. Você precisa incluir o caminho completo do backup nesse campo. Para encontrar o caminho completo, consulte Listar todos os backups no cofre de backup de uma instância.

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

REST v1

REST v1beta4

Restaurar um backup do cofre de backup para uma instância atual

Ao restaurar dados de um backup para uma instância atual, 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.

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 o backup retido possa ser restaurado na instância atual.

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

    Acessar "Backups do Cloud SQL"

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

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

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

  7. Em Escolher destino de restauração, selecione Substituir uma instância atual.

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

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

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

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

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

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

  3. Encontre o backup que você quer usar usando listar todos os backups no backup vault de uma instância. Você vai precisar do endereço completo do caminho de backup para fazer a restauração.

  4. Para restaurar uma instância, use o comando gcloud sql backups restore:

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

    Substitua:

    Quando a operação de restauração for concluída, recrie as réplicas que foram excluídas.

REST v1

REST v1beta4

Restaure um backup do cofre de backup para uma instância nova ou atual em um projeto diferente

Ao restaurar dados de um backup para uma instância nova ou atual 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. É possível restaurar para uma instância em outro projeto usando apenas a gcloud CLI ou a API Cloud SQL.

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 restaurar usando liste todos os backups no backup vault de uma instância. Você vai precisar do endereço completo do caminho de backup para restaurar.

  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

REST v1beta4

Executar uma recuperação pontual

Para executar uma recuperação pontual, consulte Recuperação pontual.

A seguir