Restaurar uma instância

MySQL | PostgreSQL | SQL Server

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 uma instância de um backup

Você pode usar um backup para restaurar a mesma instância que deu origem ao backup ou uma instância diferente no mesmo projeto.

Restaurar para uma instância diferente

Ao usar um backup para restaurar para 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 (-) para recuperar 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

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

Acesse "Instâncias do Cloud SQL"
Se a instância de destino tiver réplicas de leitura, use o menu "Mais ações" à extrema direita para excluí-las.
Para abrir a página Visão geral de uma instância, clique no nome da instância.
Selecione Backups no menu de navegação do SQL.
Encontre o backup para a restauração e selecione Restaurar.
Na página Restaurar uma instância de um backup, confirme se você selecionou o backup correto em Revisar detalhes do backup.
Em Escolher destino de restauração, selecione Substituir uma instância atual.
No menu suspenso Instância, 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.
Para confirmar a seleção, digite o nome da instância a ser substituída no campo ID da instância de destino.
Para iniciar o processo de restauração, clique em Restaurar.
Verifique o status da operação de restauração na guia Operações da instância de destino.
Após a conclusão da restauração, recrie as réplicas que você excluiu anteriormente.

gcloud

Descreva a instância de destino para ver se ela tem alguma réplica:
```
gcloud sql instances describe TARGET_INSTANCE_NAME
```
Observe todas as instâncias listadas em replicaNames.
Exclua todas as réplicas:
```
gcloud sql instances delete REPLICA_NAME
```
Repita para cada réplica.

Liste os backups da instância de origem:

gcloud sql backups list \ --instance SOURCE_INSTANCE_NAME

Encontre o backup a ser usado e registre o valor ID correspondente.
Observação: selecione um backup marcado como SUCCESSFUL.

Restaure o backup especificado na instância de destino:

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

Após a conclusão da restauração, recrie as réplicas que você excluiu anteriormente.

REST v1

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:
curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=replicaNames"
```
PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id?fields=replicaNames" | Select-Object -Expand Content
```
Você receberá uma resposta JSON semelhante a esta:
Resposta
```
 {   "replicaNames": [     "replica-name"   ] } 
```
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:
curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/replica-id"
```
PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/replica-id" | Select-Object -Expand Content
```
Você receberá uma resposta JSON semelhante a esta:
Resposta
```
 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/replica-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "DELETE_BACKUP",   "name": "operation-id",   "targetId": "replica-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" } 
```
Repita para cada réplica.
Liste os backups da instância de origem para ver o ID do backup 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
- 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:
curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns"
```
PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content
```
Você receberá uma resposta JSON semelhante a esta:
Resposta
```
 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }  
```
-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:
curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/-/backupRuns"
```
PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/-/backupRuns" | Select-Object -Expand Content
```
Você receberá uma resposta JSON semelhante a esta:
Resposta
```
 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"       "backupKind": "SNAPSHOT"     }  
```
Encontre o backup da instância que você precisa restaurar.

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:

curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id/restoreBackup"

PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/target-instance-id/restoreBackup" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "RESTORE_BACKUP",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

Após a conclusão da restauração, recrie as réplicas que você excluiu antes.

REST v1beta4

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:
curl (Linux, macOS ou Cloud Shell)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que faz login automaticamente na CLI gcloud. . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=replicaNames"
```
PowerShell (Windows)

Observação: o comando a seguir pressupõe que você fez login na CLI gcloud com sua conta de usuário executando gcloud init ou gcloud auth login . É possível verificar a conta ativa atual executando gcloud auth list.

execute o seguinte comando:
```
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id?fields=replicaNames" | Select-Object -Expand Content
```
Você receberá uma resposta JSON semelhante a esta:
Resposta
```
 {   "replicaNames": [     "replica-name"   ] } 
```

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:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/replica-id"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/replica-id" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/replica-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "DELETE_BACKUP",   "name": "operation-id",   "targetId": "replica-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

Repita para cada réplica.

Liste os backups da instância de origem para ver o ID do backup 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
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:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

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:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id/restoreBackup"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/target-instance-id/restoreBackup" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "RESTORE_BACKUP",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

Após a conclusão da restauração, recrie as réplicas que você excluiu anteriormente.

Restaurar para a mesma instância

A restauração 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

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

Acesse "Instâncias do Cloud SQL"
Se a instância de destino tiver réplicas de leitura, use o menu "Mais ações" à extrema direita para excluí-las.
Para abrir a página Visão geral de uma instância, clique no nome da instância.
Selecione Backups no menu de navegação do SQL.
Encontre o backup que você quer usar e selecione Restaurar.
Na página Restaurar uma instância de um backup, confirme se você selecionou o backup correto em Revisar detalhes do backup.
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.
Para confirmar a seleção, digite o nome da instância no campo ID da instância de destino.
Para iniciar o processo de restauração, clique em Restaurar.
Verifique o status da operação de restauração. Para isso, acesse a página Operações da instância.
Após a conclusão da operação de restauração, recrie todas as réplicas que você excluiu na primeira etapa.

gcloud

Descreva a instância para ver se ela tem alguma réplica:
```
gcloud sql instances describe INSTANCE_NAME
```
Observe todas as instâncias listadas em replicaNames.
Exclua todas as réplicas:
```
gcloud sql instances delete REPLICA_NAME
```
Repita para todas as réplicas.

Liste os backups da instância:

gcloud sql backups list --instance INSTANCE_NAME

Encontre o backup a ser usado e registre o valor ID correspondente.
Observação: selecione um backup marcado como SUCCESSFUL.

Restaure a instância a partir do backup especificado:

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

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

REST v1

Liste os backups da instância para ver o ID do backup a ser usado.

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:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

Restaure a instância 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
instance-id: o ID da instância
backup-id O ID de 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:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/restoreBackup"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/restoreBackup" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "RESTORE_BACKUP",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

Após a conclusão da restauração, recrie as réplicas que você excluiu antes.

REST v1beta4

Liste os backups da instância para ver o ID do backup a ser usado.

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:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

Restaure a instância 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
instance-id: o ID da instância
backup-id O ID de 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-id",   } }

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

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/restoreBackup"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/restoreBackup" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "RESTORE_BACKUP",   "name": "operation-id",   "targetId": "instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/operations/operation-id",   "targetProject": "project-id" }

Após a conclusão da restauração, recrie as réplicas que você excluiu antes.

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:

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:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

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:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/v1/projects/target-project-id/instances/target-instance-id/restoreBackup"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/target-project-id/instances/target-instance-id/restoreBackup" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/v1/projects/target-project-id/instances/target-instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "RESTORE_VOLUME",   "name": "operation-id",   "targetId": "target-instance-id",   "selfLink": "https://sqladmin.googleapis.com/v1/projects/target-project-id/operations/operation-id",   "targetProject": "target-project-id" }

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:

curl (Linux, macOS ou Cloud Shell)

execute o seguinte comando:

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns"

PowerShell (Windows)

execute o seguinte comando:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {       "kind": "sql#backupRun",       "status": "SUCCESSFUL",       "enqueuedTime": "2020-01-21T11:25:33.818Z",       "id": "backup-id",       "startTime": "2020-01-21T11:25:33.858Z",       "endTime": "2020-01-21T11:26:18.663Z",       "type": "AUTOMATED",       "windowStartTime": "2020-01-21T10:00:00.479Z",       "instance": "instance-id",       "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id",       "location": "us"     }

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:

curl (Linux, macOS ou Cloud Shell)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/target-project-id/instances/target-instance-id/restoreBackup"

PowerShell (Windows)

Salve o corpo da solicitação em um arquivo com o nome request.json e execute o comando a seguir:

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/target-project-id/instances/target-instance-id/restoreBackup" | Select-Object -Expand Content

Você receberá uma resposta JSON semelhante a esta:

Resposta

 {   "kind": "sql#operation",   "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/target-project-id/instances/target-instance-id",   "status": "PENDING",   "user": "[email protected]",   "insertTime": "2020-01-21T22:43:37.981Z",   "operationType": "RESTORE_VOLUME",   "name": "operation-id",   "targetId": "target-instance-id",   "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/target-project-id/operations/operation-id",   "targetProject": "target-project-id" }

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

Executar uma recuperação pontual

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

Restaurar uma instância Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Restaurar uma instância de um backup

Restaurar para uma instância diferente

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Restaurar para a mesma instância

Console

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Restaurar para uma instância em outro projeto

Permissões

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Executar uma recuperação pontual

A seguir

Restaurar uma instância