Restaure uma instância

MySQL   |  PostgreSQL   |  SQL Server

Esta página descreve como restaurar a sua instância a partir de uma cópia de segurança.

Para ver informações, práticas recomendadas e requisitos para operações de restauro, consulte o artigo Vista geral do restauro de uma instância.

Nota: este procedimento reinicia a instância. Consulte o artigo Quanto tempo as instâncias ficam desativadas durante o reinício?

Restaure a partir de uma cópia de segurança a pedido ou automática

Pode usar uma cópia de segurança a pedido ou automática para os seguintes cenários:

• Restaurar para uma instância diferente no mesmo projeto
• Restaurar para a mesma instância a partir da qual a cópia de segurança foi feita
• Restaurar para uma instância diferente num projeto ou numa região diferente

Se tiver a recuperação num determinado momento (PITR) ativada, pode recuperar a sua instância para um momento específico, com base nas definições de retenção de registos da sua instância.

Nota: a recuperação num determinado momento só é suportada para uma nova instância no mesmo projeto e região.

Restaurar para uma instância diferente

Quando restaura dados de uma cópia de segurança para uma instância diferente, atualiza os dados na instância de destino para o estado da instância de origem quando fez a cópia de segurança. Para mais informações, consulte os artigos Sugestões gerais sobre como fazer um restauro e Sugestões e requisitos para o restauro para uma instância diferente.

Se precisar de uma lista de cópias de segurança do projeto e não conseguir vê-las na página de vista geral da instância devido a uma indisponibilidade, pode usar a API backupRuns.list com um caráter universal (-). A opção de caráter universal obtém uma lista de todas as cópias de segurança em todas as instâncias do projeto. Para mais informações, consulte o artigo Ver cópias de segurança durante uma indisponibilidade.

Aviso: o processo de restauro substitui todos os dados atuais na instância, incluindo os registos de recuperação num determinado momento (PITR) anteriores. As cópias de segurança automáticas e a pedido anteriores na instância são mantidas.

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Se a instância de destino tiver réplicas de leitura, use o menu Mais ações para as eliminar.
3. Para abrir a página Vista geral de uma instância, clique no nome da instância.
4. No menu de navegação do SQL, selecione Cópias de segurança.
5. Encontre a cópia de segurança a partir da qual quer fazer o restauro e, de seguida, clique em Restaurar.
6. Na página Restaure uma instância a partir de uma cópia de segurança, confirme que selecionou a cópia de segurança correta em Reveja os detalhes da cópia de segurança.
7. Em Escolha o destino de restauro, selecione Substituir uma instância existente.
8. No menu Instância a ser substituída, selecione a instância que quer usar para a restauração. A instância que selecionar e todos os respetivos dados são substituídos.
9. Para confirmar a seleção, introduza o nome da instância a ser substituída no campo ID da instância de destino.
10. Para iniciar o processo de restauro, clique em Restaurar.
11. Para verificar o estado da operação de restauro, aceda à página Operações da instância.
12. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

gcloud

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

   gcloud sql instances describe TARGET_INSTANCE_NAME

   Tenha em atenção todas as instâncias apresentadas na coluna replicaNames.

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

   gcloud sql instances delete REPLICA_NAME

   Repita o processo para cada réplica.

3. Para apresentar uma lista das cópias de segurança da instância de origem, use o comando gcloud sql backups list:

   gcloud sql backups list \
   --instance SOURCE_INSTANCE_NAME

4. Encontre a cópia de segurança que quer usar e registe o respetivo valor ID.
   Nota: selecione uma cópia de segurança com o estado SUCCESSFUL.
5. Para restaurar a instância de destino a partir da cópia de segurança, 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 restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1

1. Para determinar se a instância tem réplicas de leitura e obter os IDs destas réplicas, liste todas as réplicas da instância alvo.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "replicaNames": [
       "REPLICA_NAME"
     ]
   }
   

2. Elimine todas as réplicas.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "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 o processo para cada réplica.

3. Para obter o ID da cópia de segurança que quer usar, liste as cópias de segurança da instância de origem.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   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-

   Se a sua instância estiver numa região com uma indisponibilidade, liste todas as cópias de segurança num projeto

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto
   • INSTANCE_ID: o ID da instância ou - para uma lista de todas as cópias de segurança no projeto

   Método HTTP e URL:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   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 a cópia de segurança da instância que precisa de restaurar.

4. Restaure a instância de destino a partir da cópia de segurança.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

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

   Método HTTP e URL:

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

   Corpo JSON do pedido:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id",
     "status": "PENDING",
     "user": "[e-mail]",
     "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"
   }
   

5. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1beta4

1. Para determinar se a instância tem réplicas de leitura e obter os IDs destas réplicas, liste todas as réplicas da instância alvo.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "replicaNames": [
       "REPLICA_NAME"
     ]
   }
   

2. Elimine todas as réplicas.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "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 o processo para cada réplica.

3. Para obter o ID da cópia de segurança que quer usar, liste as cópias de segurança da instância de origem.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backupRuns"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backupRuns" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   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"
       }
   
   

4. Restaure a instância de destino a partir da cópia de segurança.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

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

   Método HTTP e URL:

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

   Corpo JSON do pedido:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id",
     "status": "PENDING",
     "user": "[e-mail]",
     "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"
   }
   

5. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

Restaurar para a mesma instância

Quando restaura dados de uma cópia de segurança para a mesma instância, devolve os dados nessa instância ao estado em que se encontravam quando fez a cópia de segurança. Para ver informações sobre como restaurar uma instância, consulte Sugestões gerais sobre como fazer um restauro.

Aviso: o processo de restauro substitui todos os dados atuais na instância, incluindo os registos de recuperação num determinado momento (PITR) anteriores. As cópias de segurança automáticas e a pedido anteriores na instância são mantidas.

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Se a instância de destino tiver réplicas de leitura, use o menu Mais ações para as eliminar.
3. Para abrir a página Vista geral de uma instância, clique no nome da instância.
4. No menu de navegação do SQL, selecione Cópias de segurança.
5. Encontre a cópia de segurança que quer usar e, de seguida, clique em Restaurar.
6. Na página Restaure uma instância a partir de uma cópia de segurança, confirme que selecionou a cópia de segurança correta em Reveja os detalhes da cópia de segurança.
7. Em Escolha o destino da 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, introduza o nome da instância no campo ID da instância de destino.
9. Para iniciar o processo de restauro, clique em Restaurar.
10. Para verificar o estado da operação de restauro, aceda à página Operações da instância.
11. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou 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

   Tenha em atenção todas as instâncias apresentadas na coluna replicaNames.

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

   gcloud sql instances delete REPLICA_NAME

   Repita o processo para cada réplica.

3. Para apresentar uma lista das cópias de segurança da instância, use o comando gcloud sql backups list:

   gcloud sql backups list --instance INSTANCE_NAME

4. Encontre a cópia de segurança que quer usar e registe o respetivo valor ID.
   Nota: selecione uma cópia de segurança com o estado SUCCESSFUL.
5. Para restaurar a instância a partir da cópia de segurança especificada, 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 restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1

1. Para obter o ID da cópia de segurança que quer usar, liste as cópias de segurança da instância.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   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"
       }
   
   

2. Restaure a instância a partir da cópia de segurança especificada.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

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

   Método HTTP e URL:

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

   Corpo JSON do pedido:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "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"
   }
   

3. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1beta4

1. Para obter o ID da cópia de segurança que quer usar, liste as cópias de segurança da instância.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backupRuns"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backupRuns" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   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"
       }
   
   

2. Restaure a instância a partir da cópia de segurança especificada.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto
   • INSTANCE_ID: o ID da instância
   • BACKUP_RUN_ID: uma indicação de data e hora de quando o Cloud SQL restaura a instância a partir da cópia de segurança

   Método HTTP e URL:

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

   Corpo JSON do pedido:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

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

3. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

Restaurar para uma instância noutro projeto

Pode usar o parâmetro project para restaurar dados para uma instância num projeto diferente daquele em que foi feita a cópia de segurança. Quando usar o parâmetro project, chame restoreBackup no projeto e na instância para a qual quer restaurar os dados. Quando faz o restauro a partir de uma cópia de segurança para uma instância diferente, atualiza os dados na instância de destino para o estado da instância de origem quando fez a cópia de segurança.

Autorizações

O utilizador que faz o restauro para um projeto diferente tem de ter a autorização cloudsql.instances.restoreBackup para o projeto de destino e a autorização cloudsql.backupRuns.get para a instância de origem. Estas autorizações estão incluídas na função Cloud SQL Admin.

Aviso: o processo de restauro substitui todos os dados atuais na instância, incluindo os registos de recuperação num determinado momento (PITR) anteriores. As cópias de segurança automáticas e a pedido anteriores na instância são mantidas.

Para restaurar dados para uma instância num projeto diferente:

gcloud

1. Liste as cópias de segurança da instância.

   gcloud sql backups list --instance INSTANCE_NAME

   Substitua INSTANCE_NAME pelo nome da instância.

2. Encontre a cópia de segurança que quer usar e registe o respetivo valor ID.
   Nota: selecione uma cópia de segurança marcada com SUCCESSFUL.

3. Restaurar dados para uma instância num 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 da cópia de segurança. Obteve este ID anteriormente neste procedimento.
   • TARGET_INSTANCE_NAME: a instância no projeto de destino para o qual está a restaurar dados.
   • SOURCE_INSTANCE_NAME: a instância no projeto de origem que contém os dados que 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 obter o backupId, execute o seguinte.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

Deve receber uma resposta JSON semelhante à seguinte:

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 cópia de segurança para uma instância num projeto diferente:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

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

Método HTTP e URL:

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

Corpo JSON do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/v1/projects/target-project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "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 acerca da propriedade project, consulte restoreBackup

REST v1beta4

Para obter o backupId, execute o seguinte.

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backupRuns"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backupRuns" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

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 cópia de segurança para uma instância num projeto diferente:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

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

Método HTTP e URL:

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

Corpo JSON do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/target-project-id/instances/target-instance-id",
  "status": "PENDING",
  "user": "[e-mail]",
  "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 acerca da propriedade project, consulte restoreBackup

Restauro a partir de uma cópia de segurança final

Pode usar uma cópia de segurança final nos seguintes cenários:

• Restaure a cópia de segurança final numa nova instância
• Restaurar para uma nova instância num projeto ou numa região diferente

Uma vez que está a usar uma cópia de segurança final de uma instância eliminada para restaurar a sua instância, também pode usar a cópia de segurança para criar uma instância com a configuração da instância eliminada e recuperar os seus dados.

Restaurar para uma nova instância

Quando cria uma instância a partir de uma cópia de segurança final, o Cloud SQL usa as definições de configuração da instância a partir da qual a cópia de segurança final é feita. Após a criação da instância, o Cloud SQL restaura os dados para o estado em que se encontravam quando foi feita a última cópia de segurança.

Nota: a instância que criar a partir da cópia de segurança final tem um endereço IP diferente da instância em que a cópia de segurança final é feita. Para obter informações sobre a restauração de uma instância, consulte as sugestões gerais sobre a realização de uma restauração.

Para restaurar dados de uma cópia de segurança final para uma nova instância, tem de ter a autorização cloudsql.instances.create para o projeto de destino, a autorização cloudsql.instances.restoreBackup para o projeto de destino e a autorização cloudsql.backupRuns.get para a cópia de segurança de origem. Estas autorizações estão incluídas na função Cloud SQL Admin.

Consola

1. Na Google Cloud consola, aceda à página Cópias de segurança do Cloud SQL.

   Aceda às cópias de segurança do Cloud SQL

   Esta página lista todas as cópias de segurança, incluindo as cópias de segurança finais, associadas a um Google Cloud projeto.

2. Clique na cópia de segurança final que contém os dados que quer restaurar para uma nova instância.
3. Na caixa de diálogo Cópia de segurança final, clique em Restaurar.
4. Na página Restaure uma instância a partir de uma cópia de segurança, confirme que selecionou a cópia de segurança correta em Reveja os detalhes da cópia de segurança.
5. Em Escolha o destino de restauro, selecione Restaurar para uma nova instância.
6. No menu Região, selecione a região para a nova instância.
7. No campo ID da instância, introduza um ID para a nova instância.
8. Para iniciar o processo de restauro, clique em Restaurar.
9. Para verificar o estado da operação de restauro, aceda à página Operações da instância.

gcloud

1. Para listar as cópias de segurança finais da instância source, use o comando gcloud sql backups list:

   gcloud sql backups list \
   --filter='type:FINAL instance: SOURCE_INSTANCE_NAME'

2. Encontre a cópia de segurança que quer usar e registe o respetivo valor NAME.
3. Para restaurar uma nova instância a partir da cópia de segurança final especificada, use o comando gcloud sql backups restore:

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

REST v1

1. Para obter o ID da cópia de segurança que quer usar, liste as cópias de segurança finais da instância source.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
         "name": "projects/PROJECT_ID/backups/BACKUP_ID",
         "kind": "sql#backup",
         "state": "SUCCESSFUL",
         "backupInterval": {
               "startTime": "2020-01-21T11:25:33.858Z",
               "endTime": "2020-01-21T11:26:18.663Z",
          }
         "type": "FINAL",
         "instance": "INSTANCE_ID",
         "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
         "location": "us"
         "description": "This is a final backup.",
         "backupKind": "SNAPSHOT",
         "dataDiskSizeGB": "10",
         "expiryTime": "2020-01-30T11:26:18.663Z",
         "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
         "satisfies_pzs": false,
         "satisfies_pzi": false
   }
   

2. Restaurar uma nova instância a partir da cópia de segurança final especificada.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto
   • TARGET_INSTANCE_ID: o ID da instância de destino
   • BACKUP_ID: o ID da cópia de segurança
   Nota: a linha de código restore_instance_settings: {} permite que o Cloud SQL restaure os dados da cópia de segurança para a nova instância.

   Método HTTP e URL:

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

   Corpo JSON do pedido:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

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

REST v1beta4

1. Para obter o ID da cópia de segurança que quer usar, liste as cópias de segurança finais da instância source.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
         "name": "projects/PROJECT_ID/backups/BACKUP_ID",
         "kind": "sql#backup",
         "state": "SUCCESSFUL",
         "backupInterval": {
               "startTime": "2020-01-21T11:25:33.858Z",
               "endTime": "2020-01-21T11:26:18.663Z",
          }
         "type": "FINAL",
         "instance": "INSTANCE_ID",
         "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
         "location": "us"
         "description": "This is a final backup.",
         "backupKind": "SNAPSHOT",
         "dataDiskSizeGB": "10",
         "expiryTime": "2020-01-30T11:26:18.663Z",
         "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
         "satisfies_pzs": false,
         "satisfies_pzi": false
   }
   

2. Restaurar uma nova instância a partir da cópia de segurança final especificada.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto
   • TARGET_INSTANCE_ID: o ID da instância de destino
   • BACKUP_ID: o ID da cópia de segurança
   Nota: a linha de código restore_instance_settings: {} permite que o Cloud SQL restaure os dados da cópia de segurança para a nova instância.

   Método HTTP e URL:

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

   Corpo JSON do pedido:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

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

Restaurar para uma instância existente

Quando restaura dados de uma cópia de segurança final para uma instância existente, atualiza os dados na instância de destino para o estado da instância de origem quando fez a cópia de segurança. Para mais informações, consulte os artigos Sugestões gerais sobre como fazer um restauro e Sugestões e requisitos para o restauro para uma instância diferente.

Se precisar de uma lista de cópias de segurança do projeto e não conseguir vê-las na página de vista geral da instância devido a uma indisponibilidade, pode usar a API backupRuns.list.

Aviso: o processo de restauro substitui todos os dados atuais na instância, incluindo os registos de recuperação num determinado momento (PITR) anteriores. As cópias de segurança automáticas e a pedido anteriores na instância são mantidas.

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Se a instância de destino tiver réplicas de leitura, use o menu Mais ações para as eliminar.

3. Na Google Cloud consola, aceda à página Cópias de segurança do Cloud SQL.

   Aceda às cópias de segurança do Cloud SQL

   Esta página lista todas as cópias de segurança, incluindo as cópias de segurança finais, associadas a um Google Cloud projeto.

4. Clique na cópia de segurança final que contém os dados que quer restaurar para uma instância diferente.
5. Na caixa de diálogo Cópia de segurança final, clique em Restaurar.
6. Na página Restaure uma instância a partir de uma cópia de segurança, confirme que selecionou a cópia de segurança correta em Reveja os detalhes da cópia de segurança.
7. Em Escolha o destino de restauro, selecione Substituir uma instância existente.

8. No menu Instância a ser substituída, selecione a instância que quer usar para a restauração. A instância que selecionar e todos os respetivos dados são substituídos.

   Nota: só pode selecionar as instâncias que tenham o mesmo tipo de base de dados que a instância que usou para criar a cópia de segurança final (instância de origem). Além disso, a instância selecionada tem de ter uma versão igual ou superior à da instância de origem.
9. Para confirmar a seleção, no campo ID da instância de destino, introduza o nome da instância a substituir.
10. Para iniciar o processo de restauro, clique em Restaurar.
11. Para verificar o estado da operação de restauro, aceda à página Operações da instância.
12. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

gcloud

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

   gcloud sql instances describe TARGET_INSTANCE_NAME

   Tenha em atenção todas as instâncias apresentadas na coluna replicaNames.

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

   gcloud sql instances delete REPLICA_NAME

   Repita o processo para cada réplica.

3. Para listar as cópias de segurança 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 a cópia de segurança que quer usar e registe o respetivo valor NAME.
   Nota: selecione uma cópia de segurança com o estado SUCCESSFUL.
5. Para restaurar a instância de destino a partir da cópia de segurança, 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 restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1

1. Para determinar se a instância tem réplicas de leitura e obter os IDs destas réplicas, liste todas as réplicas da instância alvo.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "replicaNames": [
       "REPLICA_NAME"
     ]
   }
   

2. Elimine todas as réplicas.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "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 o processo para cada réplica.

3. Para obter o ID da cópia de segurança final que quer usar, liste as cópias de segurança da instância source.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
         "name": "projects/PROJECT_ID/backups/BACKUP_ID",
         "kind": "sql#backup",
         "state": "SUCCESSFUL",
         "backupInterval": {
               "startTime": "2020-01-21T11:25:33.858Z",
               "endTime": "2020-01-21T11:26:18.663Z",
          }
         "type": "FINAL",
         "instance": "INSTANCE_ID",
         "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
         "location": "us"
         "description": "This is a final backup.",
         "backupKind": "SNAPSHOT",
         "dataDiskSizeGB": "10",
         "expiryTime": "2020-01-30T11:26:18.663Z",
         "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
         "satisfies_pzs": false,
         "satisfies_pzi": false
   }
   

   Encontre a cópia de segurança da instância que precisa de restaurar.

4. Restaure a instância de destino a partir da cópia de segurança.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto
   • TARGET_INSTANCE_ID: o ID da instância de destino
   • BACKUP_ID: o ID da cópia de segurança

   Método HTTP e URL:

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

   Corpo JSON do pedido:

   {
     backup: projects/PROJECT_ID/backups/BACKUP_ID
   }
   

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

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

5. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1beta4

1. Para determinar se a instância tem réplicas de leitura e obter os IDs destas réplicas, liste todas as réplicas da instância alvo.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "replicaNames": [
       "REPLICA_NAME"
     ]
   }
   

2. Elimine todas as réplicas.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "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 o processo para cada réplica.

3. Para obter o ID da cópia de segurança final que quer usar, liste as cópias de segurança da instância source.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
         "name": "projects/PROJECT_ID/backups/BACKUP_ID",
         "kind": "sql#backup",
         "state": "SUCCESSFUL",
         "backupInterval": {
               "startTime": "2020-01-21T11:25:33.858Z",
               "endTime": "2020-01-21T11:26:18.663Z",
          }
         "type": "FINAL",
         "instance": "INSTANCE_ID",
         "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
         "location": "us"
         "description": "This is a final backup.",
         "backupKind": "SNAPSHOT",
         "dataDiskSizeGB": "10",
         "expiryTime": "2020-01-30T11:26:18.663Z",
         "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
         "satisfies_pzs": false,
         "satisfies_pzi": false
   }
   

   Encontre a cópia de segurança da instância que precisa de restaurar.
4. Restaure a instância de destino a partir da cópia de segurança.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto
   • TARGET_INSTANCE_ID: o ID da instância de destino
   • BACKUP_ID: o ID da cópia de segurança

   Método HTTP e URL:

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

   Corpo JSON do pedido:

   {
     backup: projects/PROJECT_ID/backups/BACKUP_ID
   }
   

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

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

5. Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

Restaurar para uma instância noutro projeto

O utilizador que restaura dados para uma instância num projeto diferente tem de ter a autorização cloudsql.instances.restoreBackup , a autorização cloudsql.instances.create para o projeto de destino e a autorização cloudsql.backupRuns.get para a instância de origem. Estas autorizações estão incluídas na função Cloud SQL Admin.

Aviso: o processo de restauro substitui todos os dados atuais na instância, incluindo os registos de recuperação num determinado momento (PITR) anteriores. As cópias de segurança automáticas e a pedido anteriores na instância são mantidas.

Para restaurar dados para uma instância num projeto diferente:

REST v1

Para obter o backupId da cópia de segurança final, execute o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
       }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "This is a final backup.",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

Restaure a cópia de segurança para uma instância num projeto diferente:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança

Método HTTP e URL:

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

Corpo JSON do pedido:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

Para mais informações acerca da propriedade project, consulte restoreBackup

REST v1beta4

Para obter o backupId da cópia de segurança final, execute o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
       }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "This is a final backup.",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

Restaure a cópia de segurança para uma instância num projeto diferente:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança

Método HTTP e URL:

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

Corpo JSON do pedido:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

Para mais informações acerca da propriedade project, consulte restoreBackup

Restaurar para uma nova instância noutra região

O utilizador que restaura dados para uma nova instância numa região diferente tem de ter a autorização cloudsql.instances.restoreBackup para o projeto de destino e a autorização cloudsql.backupRuns.get para a instância de origem. Estas autorizações estão incluídas na função Cloud SQL Admin.

Além disso, para criar uma instância numa região diferente, tem de cumprir os critérios das políticas da organização dessa região.

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

gcloud

1. Para listar as cópias de segurança finais da instância source, use o comando gcloud sql backups list:

   gcloud sql backups list \
   --filter='type:FINAL instance: SOURCE_INSTANCE_NAME'

2. Encontre a cópia de segurança que quer usar e registe o respetivo valor NAME.
3. Para usar a cópia de segurança final para restaurar dados para uma nova instância numa região diferente, use o comando gcloud sql backups restore:

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

REST v1

Para obter o backupId da cópia de segurança final, execute o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
       }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "This is a final backup.",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

Restaure a cópia de segurança para uma nova instância numa região diferente:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança
• 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 do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

Para mais informações acerca da propriedade project, consulte restoreBackup

REST v1beta4

Para obter o backupId da cópia de segurança final, execute o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• 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 o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups?filter='type:FINAL AND instance:INSTANCE_ID'" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
       }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "This is a final backup.",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

Restaure a cópia de segurança para uma nova instância numa região diferente:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança
• 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 do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

Para mais informações acerca da propriedade project, consulte restoreBackup

Restaurar a partir de uma cópia de segurança retida

Pode usar uma cópia de segurança retida para os seguintes cenários:

• Restaure a cópia de segurança retida para uma nova instância
• Restaure a cópia de segurança retida para uma instância existente
• Restaurar para uma instância nova ou existente num projeto ou região diferente

Uma vez que está a usar uma cópia de segurança retida de uma instância eliminada para restaurar a sua instância, também pode usar a cópia de segurança para criar uma instância com a configuração da instância eliminada e recuperar os seus dados.

Nota: a instância que criar a partir da cópia de segurança retida tem um endereço IP diferente da instância em que a cópia de segurança retida é feita. Para obter informações sobre a restauração de uma instância, consulte Sugestões gerais sobre a realização de uma restauração.

Restaure uma cópia de segurança retida para uma nova instância

Quando cria uma nova instância a partir de uma cópia de segurança retida, o Cloud SQL usa as definições de configuração da instância a partir da qual a cópia de segurança retida foi feita.

Para restaurar dados de uma cópia de segurança retida para uma nova instância, tem de ter a autorização cloudsql.instances.create.

Consola

1. Na Google Cloud consola, aceda à página Cópias de segurança do Cloud SQL.

   Aceda às cópias de segurança do Cloud SQL

2. Clique no nome da instância eliminada que contém a cópia de segurança que quer restaurar.

3. Localize o nome da cópia de segurança que quer restaurar e, de seguida, clique em Restaurar.

4. Na página Restaure uma instância a partir de uma cópia de segurança, confirme que selecionou a cópia de segurança correta em Reveja os detalhes da cópia de segurança.

5. Em Escolha o destino de restauro, selecione Restaurar para uma nova instância.

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

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

8. Clique em Restaurar.

   O Cloud SQL restaura a cópia de segurança para uma nova instância. Para verificar o estado da operação de restauro, aceda à página Operações da instância.

gcloud

1. Use gcloud sql backups list para encontrar a cópia de segurança que quer armazenar numa nova instância.

   gcloud sql backups list
   --project=PROJECT_ID
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .

2. Encontre a cópia de segurança que quer usar e registe o respetivo valor BACKUP_NAME.

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

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

   Substitua o seguinte:

   • BACKUP_NAME: o nome da cópia de segurança retida que quer restaurar.

   • TARGET_INSTANCE_NAME: o nome da nova instância para a qual quer restaurar a cópia de segurança.

REST v1

Restaurar uma nova instância a partir da cópia de segurança retida especificada

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança

Nota: a linha de código restore_instance_settings: {} permite que o Cloud SQL restaure os dados da cópia de segurança para a nova instância.

Método HTTP e URL:

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

Corpo JSON do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

REST v1beta4

Restaurar uma nova instância a partir da cópia de segurança retida especificada

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança

Nota: a linha de código restore_instance_settings: {} permite que o Cloud SQL restaure os dados da cópia de segurança para a nova instância.

Método HTTP e URL:

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

Corpo JSON do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

Restaure uma cópia de segurança retida para uma instância existente

Quando restaura dados de uma cópia de segurança retida para uma instância existente, atualiza os dados na instância de destino para o estado da instância de origem quando fez a cópia de segurança.

Aviso: o processo de restauro substitui todos os dados atuais na instância, incluindo os registos de recuperação num determinado momento (PITR) anteriores. As cópias de segurança automáticas e a pedido anteriores na instância são mantidas.

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Se a instância de destino tiver réplicas de leitura, use o menu Mais ações para as eliminar. Todas as réplicas têm de ser eliminadas antes de poder restaurar a cópia de segurança retida para a instância existente.

3. Na Google Cloud consola, aceda à página Cópias de segurança do Cloud SQL.

   Aceda às cópias de segurança do Cloud SQL

4. Clique no nome da instância eliminada que contém a cópia de segurança que quer restaurar.

5. Localize o nome da cópia de segurança que quer restaurar e, de seguida, clique em Restaurar.

6. Na página Restaure uma instância a partir de uma cópia de segurança, confirme que selecionou a cópia de segurança correta em Reveja os detalhes da cópia de segurança.

7. Em Escolha o destino de restauro, selecione Substituir uma instância existente.

8. No menu Instância a ser substituída, selecione a instância que quer usar para o restauro. A instância que selecionar e todos os respetivos dados vão ser substituídos.

9. Para confirmar a seleção, no campo ID da instância de destino, introduza o nome da instância a substituir.

10. Clique em Restaurar.

    O Cloud SQL restaura a cópia de segurança para a instância existente. Para verificar o estado da operação de restauro, aceda à página Operações da instância.

    Pode criar réplicas assim que a operação de restauro estiver concluída.

gcloud

1. Determine se a instância de destino tem réplicas de leitura através do comando gcloud sql instances describe:

   gcloud sql instance describe TARGET_INSTANCE_NAME
   

   Substitua o seguinte:

   • TARGET_INSTANCE_NAME: o nome da instância de destino para a qual quer restaurar a cópia de segurança.

2. Elimine todas as réplicas da instância de destino com o comando gcloud sql instances delete:

   gcloud sql instance delete REPLICA_NAME
   

   Substitua o seguinte:

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

   Todas as réplicas têm de ser eliminadas antes de poder restaurar para uma instância existente.

3. Use gcloud sql backups list para encontrar a cópia de segurança que quer restaurar na instância existente.

   gcloud sql backups list
   --project=PROJECT_ID
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .

4. Encontre a cópia de segurança que quer usar e registe o respetivo valor BACKUP_NAME.

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

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

   Substitua o seguinte:

   • BACKUP_NAME: o nome da cópia de segurança retida que quer restaurar.

   • TARGET_INSTANCE_NAME: o nome da instância existente para a qual quer restaurar a cópia de segurança.

   Quando a operação de restauro estiver concluída, recrie todas as réplicas que foram eliminadas.

REST v1

1. Para determinar se a instância tem réplicas de leitura e obter os IDs destas réplicas, liste todas as réplicas da instância de destino.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "replicaNames": [
       "REPLICA_NAME"
     ]
   }
   

2. Elimine todas as réplicas da instância de destino.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "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"
   }
   

3. Obtenha o ID da cópia de segurança retida que quer restaurar.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto

   Método HTTP e URL:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
         "name": "projects/PROJECT_ID/backups/BACKUP_ID",
         "kind": "sql#backup",
         "state": "SUCCESSFUL",
         "backupInterval": {
               "startTime": "2020-01-21T11:25:33.858Z",
               "endTime": "2020-01-21T11:26:18.663Z",
          }
         "type": "FINAL",
         "instance": "INSTANCE_ID",
         "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
         "location": "us"
         "description": "This is a final backup.",
         "backupKind": "SNAPSHOT",
         "dataDiskSizeGB": "10",
         "expiryTime": "2020-01-30T11:26:18.663Z",
         "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
         "satisfies_pzs": false,
         "satisfies_pzi": false
   }
   

4. Restaure a instância de destino a partir da cópia de segurança retida.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto
   • TARGET_INSTANCE_ID: o ID da instância de destino
   • BACKUP_ID: o ID da cópia de segurança

   Método HTTP e URL:

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

   Corpo JSON do pedido:

   {
     backup: projects/PROJECT_ID/backups/BACKUP_ID
   }
   

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

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

REST v1beta4

1. Para determinar se a instância tem réplicas de leitura e obter os IDs destas réplicas, liste todas as réplicas da instância de destino.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "replicaNames": [
       "REPLICA_NAME"
     ]
   }
   

2. Elimine todas as réplicas da instância de destino.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • 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 o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
     "kind": "sql#operation",
     "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID",
     "status": "PENDING",
     "user": "[e-mail]",
     "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"
   }
   

3. Obtenha o ID da cópia de segurança retida que quer restaurar.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto

   Método HTTP e URL:

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

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups"

   PowerShell (Windows)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups" | Select-Object -Expand Content

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

   {
         "name": "projects/PROJECT_ID/backups/BACKUP_ID",
         "kind": "sql#backup",
         "state": "SUCCESSFUL",
         "backupInterval": {
               "startTime": "2020-01-21T11:25:33.858Z",
               "endTime": "2020-01-21T11:26:18.663Z",
          }
         "type": "FINAL",
         "instance": "INSTANCE_ID",
         "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
         "location": "us"
         "description": "This is a final backup.",
         "backupKind": "SNAPSHOT",
         "dataDiskSizeGB": "10",
         "expiryTime": "2020-01-30T11:26:18.663Z",
         "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
         "satisfies_pzs": false,
         "satisfies_pzi": false
   }
   

4. Restaure a instância de destino a partir da cópia de segurança retida.

   Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

   • PROJECT_ID: o ID do projeto
   • TARGET_INSTANCE_ID: o ID da instância de destino
   • BACKUP_ID: o ID da cópia de segurança

   Método HTTP e URL:

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

   Corpo JSON do pedido:

   {
     backup: projects/PROJECT_ID/backups/BACKUP_ID
   }
   

   Para enviar o seu pedido, expanda uma destas opções:

   curl (Linux, macOS ou Cloud Shell)

   Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   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)

   Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

   Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

   $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

   Deve receber uma resposta JSON semelhante à seguinte:

   Resposta

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

Restaurar para uma instância noutro projeto

Para restaurar uma instância através de uma cópia de segurança retida num projeto diferente, tem de ter as seguintes autorizações:

• Projeto de destino: cloudsql.instances.restoreBackup
• Projeto de origem: cloudsql.backupRuns.get

Só pode fazer o restauro para outro projeto através da CLI gcloud ou da API Cloud SQL.

gcloud

1. Use gcloud sql backups list para encontrar a cópia de segurança que quer armazenar numa nova instância.

   gcloud sql backups list
   --project=PROJECT_ID
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .

2. Encontre a cópia de segurança que quer usar e registe o respetivo valor BACKUP_NAME.

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

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

   Substitua o seguinte:

   • BACKUP_ID: o nome da cópia de segurança retida que quer restaurar.

   • TARGET_INSTANCE_NAME: o nome da nova instância localizada no projeto de destino para o qual quer restaurar a cópia de segurança.

REST v1

Para obter o backupID da cópia de segurança retida, execute o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto

Método HTTP e URL:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
       }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "This is a final backup.",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

Restaure para um projeto diferente

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança

Método HTTP e URL:

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

Corpo JSON do pedido:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

REST v1beta4

Para obter o backupID da cópia de segurança retida, execute o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto

Método HTTP e URL:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
       }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "This is a final backup.",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

Restaure para um projeto diferente

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança

Método HTTP e URL:

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

Corpo JSON do pedido:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

Restaurar para uma instância noutra região

Para restaurar uma instância através de uma cópia de segurança retida numa região diferente, tem de ter as seguintes autorizações:

• Projeto de destino: cloudsql.instances.restoreBackup
• Projeto de origem: cloudsql.backupRuns.get

Só pode fazer o restauro para outra região através da CLI gcloud ou da API Cloud SQL. A região de destino tem de cumprir as políticas da organização para a região.

gcloud

1. Use gcloud sql backups list para encontrar a cópia de segurança que quer armazenar numa nova instância.

   gcloud sql backups list
   --project=PROJECT_ID
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Google Cloud .

2. Encontre a cópia de segurança que quer usar e registe o respetivo valor NAME.

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

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

   Substitua o seguinte:

   • BACKUP_ID: o nome da cópia de segurança retida que quer restaurar.

   • TARGET_INSTANCE_NAME: o nome da nova instância localizada no projeto de destino para o qual quer restaurar a cópia de segurança.

   • TARGET_REGION: a nova região para a qual quer restaurar a cópia de segurança.

REST v1

Para obter o backupID da cópia de segurança retida, execute o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto

Método HTTP e URL:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
       }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "This is a final backup.",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

Restaure para um projeto diferente

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança
• 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 do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

REST v1beta4

Para obter o backupID da cópia de segurança retida, execute o seguinte:

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto

Método HTTP e URL:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando 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/backups"

PowerShell (Windows)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando 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/backups" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "state": "SUCCESSFUL",
      "backupInterval": {
            "startTime": "2020-01-21T11:25:33.858Z",
            "endTime": "2020-01-21T11:26:18.663Z",
       }
      "type": "FINAL",
      "instance": "INSTANCE_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID",
      "location": "us"
      "description": "This is a final backup.",
      "backupKind": "SNAPSHOT",
      "dataDiskSizeGB": "10",
      "expiryTime": "2020-01-30T11:26:18.663Z",
      "backup_run": "projects/PROJECT_ID/instances/INSTANCE_ID/backupRuns/BACKUP_RUN_ID",
      "satisfies_pzs": false,
      "satisfies_pzi": false
}

Restaure para um projeto diferente

Antes de usar qualquer um dos dados do pedido, faça as seguintes substituições:

• PROJECT_ID: o ID do projeto
• TARGET_INSTANCE_ID: o ID da instância de destino
• BACKUP_ID: o ID da cópia de segurança
• 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 do pedido:

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

Para enviar o seu pedido, expanda uma destas opções:

curl (Linux, macOS ou Cloud Shell)

Nota: O comando seguinte pressupõe que tem sessão iniciada na CLI gcloud com a sua conta de utilizador executando gcloud init ou gcloud auth login, ou usando o Cloud Shell, que inicia automaticamente sessão na CLI gcloud. Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

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)

Nota: O comando seguinte pressupõe que iniciou sessão na CLI do Google Cloud com a sua conta de utilizador executando gcloud init ou gcloud auth login .gcloud Pode verificar a conta atualmente ativa executando o comando gcloud auth list.

Guarde o corpo do pedido num ficheiro com o nome request.json, e execute o seguinte comando:

$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

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

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

Restauro a partir de uma cópia de segurança no cofre de cópias de segurança

Pré-visualização — Enhanced backups

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. Pode tratar dados pessoais para esta funcionalidade conforme descrito na Alteração ao Tratamento de Dados do Cloud, sujeito às obrigações e restrições descritas no contrato ao abrigo do qual acede ao Google Cloud. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Se a sua instância do Cloud SQL estiver ativada para usar cópias de segurança melhoradas, pode restaurar a instância a partir de uma cópia de segurança no cofre de cópias de segurança. Pode restaurar a sua instância nos seguintes cenários:

• Restaurar para uma nova instância
• Restaurar para uma instância existente
• Restaurar para uma instância nova ou existente num projeto diferente

Restaure uma cópia de segurança da área de segurança de cópias de segurança para uma nova instância

Quando restaura dados de uma cópia de segurança para uma nova instância, atualiza os dados na instância de destino para o estado da instância de origem quando fez a cópia de segurança.

Consola

1. Na Google Cloud consola, aceda à página Cópias de segurança do Cloud SQL.

   Aceda às cópias de segurança do Cloud SQL

2. No menu pendente Nível de cópia de segurança, selecione Nível melhorado e, de seguida, selecione o cofre de cópias de segurança que contém a cópia de segurança que quer usar.

   São apresentadas todas as cópias de segurança disponíveis no cofre de cópias de segurança para a instância selecionada.

3. Localize o nome da cópia de segurança que quer restaurar e, de seguida, clique em Restaurar.

4. Na página Restaure uma instância a partir de uma cópia de segurança, confirme que selecionou a cópia de segurança correta em Reveja os detalhes da cópia de segurança.

5. Em Escolha o destino de restauro, selecione Restaurar para uma nova instância e, em seguida, atualize o seguinte:

   • Em Projeto, selecione o projeto para a nova instância. O projeto tem de estar na mesma região que o cofre de cópias de segurança e tem de ter acesso ao projeto.

   • Em Região, confirme a região. A região deve corresponder à região da nova instância.

   • Na caixa ID da instância, atribua um nome à nova instância. Este nome é permanente e não pode ser alterado.

6. Clique em Restaurar.

   O Cloud SQL restaura a cópia de segurança para uma nova instância. Para verificar o estado da operação de restauro, aceda à página Operações da instância.

   A nova instância usa por predefinição a opção de cópias de segurança padrão. Para atualizar para as cópias de segurança melhoradas, consulte o artigo Ative as cópias de segurança melhoradas.

   Pode criar réplicas assim que a operação de restauro estiver concluída.

gcloud

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

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

Substitua o seguinte:

• BACKUP_ID: o ID da cópia de segurança do cofre de cópias de segurança. Tem de incluir o caminho completo da cópia de segurança neste campo. Para encontrar o caminho completo, consulte o artigo Liste todas as cópias de segurança no cofre de cópias de segurança de uma instância.

• TARGET_INSTANCE_NAME: o nome da nova instância para a qual quer restaurar a cópia de segurança.

REST v1

REST v1beta4

Restaure uma cópia de segurança do cofre de cópias de segurança para uma instância existente

Quando restaura dados de uma cópia de segurança para uma instância existente, atualiza os dados na instância de destino para o estado da instância de origem quando fez a cópia de segurança.

Aviso: o processo de restauro substitui todos os dados atuais na instância, incluindo os registos de recuperação num determinado momento (PITR) anteriores. As cópias de segurança automáticas e a pedido anteriores na instância são mantidas.

Consola

1. Na Google Cloud consola, aceda à página Instâncias do Cloud SQL.

   Aceda a Instâncias do Cloud SQL

2. Se a instância de destino tiver réplicas de leitura, use o menu Mais ações para as eliminar. Todas as réplicas têm de ser eliminadas antes de poder restaurar a cópia de segurança retida para a instância existente.

3. Na Google Cloud consola, aceda à página Cópias de segurança do Cloud SQL.

   Aceda às cópias de segurança do Cloud SQL

4. No menu pendente Nível de cópia de segurança, selecione Nível melhorado e, de seguida, selecione o cofre de cópias de segurança que contém a cópia de segurança que quer usar.

   São apresentadas todas as cópias de segurança disponíveis no cofre de cópias de segurança para a instância selecionada.

5. Localize o nome da cópia de segurança que quer restaurar e, de seguida, clique em Restaurar.

6. Na página Restaure uma instância a partir de uma cópia de segurança, confirme que selecionou a cópia de segurança correta em Reveja os detalhes da cópia de segurança.

7. Em Escolha o destino de restauro, selecione Substituir uma instância existente.

8. No menu Instância a ser substituída, selecione a instância que quer usar para o restauro. A instância que selecionar e todos os respetivos dados vão ser substituídos.

9. Para confirmar a seleção, no campo ID da instância de destino, introduza o nome da instância a substituir.

10. Clique em Restaurar.

    O Cloud SQL restaura a cópia de segurança para a instância existente. Para verificar o estado da operação de restauro, aceda à página Operações da instância.

    Pode criar réplicas assim que a operação de restauro estiver concluída.

gcloud

Para restaurar uma cópia de segurança de um cofre de cópias de segurança para uma instância existente, faça o seguinte:

1. Determine se a instância de destino tem réplicas de leitura através do comando gcloud sql instances describe:

   gcloud sql instance describe TARGET_INSTANCE_NAME
   

   Substitua o seguinte:

   • TARGET_INSTANCE_NAME: o nome da instância de destino.

2. Elimine todas as réplicas da instância de destino com o comando gcloud sql instances delete:

   gcloud sql instance delete REPLICA_NAME
   

   Substitua o seguinte:

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

   Todas as réplicas têm de ser eliminadas antes de poder restaurar para uma instância existente.

3. Encontre a cópia de segurança que quer usar através da opção list all the backups in the backup vault for an instance (listar todas as cópias de segurança no cofre de cópias de segurança de uma instância). Precisa do endereço do caminho completo da cópia de segurança para fazer o restauro.

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

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

   Substitua o seguinte:

   • BACKUP_ID: o ID da cópia de segurança do cofre de cópias de segurança. Tem de incluir o caminho completo da cópia de segurança neste campo. Para encontrar o caminho completo, consulte o artigo Liste todas as cópias de segurança no cofre de cópias de segurança de uma instância.

   • TARGET_INSTANCE_NAME: o nome da instância existente para a qual quer restaurar a cópia de segurança.

   Quando a operação de restauro estiver concluída, recrie todas as réplicas que foram eliminadas.

REST v1

REST v1beta4

Restaure uma cópia de segurança do cofre de cópias de segurança para uma instância nova ou existente num projeto diferente

Quando restaura dados de uma cópia de segurança para uma instância nova ou existente num projeto diferente, atualiza os dados na instância de destino para o estado da instância de origem quando fez a cópia de segurança. Pode restaurar para uma instância noutro projeto através da CLI gcloud ou apenas da API Cloud SQL.

Aviso: o processo de restauro substitui todos os dados atuais na instância, incluindo os registos de recuperação num determinado momento (PITR) anteriores. As cópias de segurança automáticas e a pedido anteriores na instância são mantidas.

gcloud

Para restaurar uma cópia de segurança de um cofre de cópias de segurança para uma instância existente, faça o seguinte:

1. Se estiver a restaurar para uma instância existente, determine se a instância de destino tem réplicas de leitura através do comando gcloud sql instances describe:

   gcloud sql instance describe TARGET_INSTANCE_NAME
   

   Substitua o seguinte:

   • TARGET_INSTANCE_NAME: o nome da instância de destino para a qual quer restaurar a cópia de segurança.

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

   gcloud sql instance delete REPLICA_NAME
   

   Substitua o seguinte:

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

   Todas as réplicas têm de ser eliminadas antes de poder restaurar para uma instância existente.

2. Encontre a cópia de segurança que quer restaurar através da opção listar todas as cópias de segurança no cofre de cópias de segurança de uma instância. Precisa do endereço do caminho completo da cópia de segurança para fazer o restauro.

3. Para restaurar para uma instância nova ou existente num 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 o seguinte:

   • BACKUP_ID: o ID da cópia de segurança do cofre de cópias de segurança. Tem de incluir o caminho completo da cópia de segurança neste campo.

   • TARGET_INSTANCE_NAME: a instância no projeto de destino para o qual está a restaurar dados.

   • SOURCE_INSTANCE_NAME: o nome da instância no projeto de origem onde os dados se encontram.

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

REST v1

REST v1beta4

Faça uma recuperação pontual

Para fazer uma recuperação pontual, consulte o artigo Recuperação pontual.

O que se segue?

• Saiba mais sobre a restauro.
• Saiba mais acerca da cópia de segurança dos seus dados.
• Saiba como fazer uma cópia de segurança dos seus dados.