Esta página foi traduzida pela API Cloud Translation.

Restaure uma instância através de uma cópia de segurança

MySQL | PostgreSQL | SQL Server

Pode restaurar a sua instância a partir de uma cópia de segurança e recuperá-la durante um período específico para uma instância nova ou existente. Pode restaurar uma instância em direto ou eliminada. Para saber como funciona o restauro, consulte o artigo Vista geral do restauro.

Para restaurar uma instância através de uma cópia de segurança, tem de fazer o seguinte:

Encontre a cópia de segurança que quer restaurar
Use a cópia de segurança para restaurar a instância

A localização da sua cópia de segurança depende da opção de cópia de segurança da sua instância.

Restaure uma instância em direto

Pode restaurar uma cópia de segurança das seguintes formas:

Restaurar para a mesma instância onde a cópia de segurança é feita
Restaurar para uma instância nova ou existente no mesmo projeto
Restaurar para uma instância nova ou existente num projeto ou região diferente

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 restaurar a instância através de uma cópia de segurança na mesma instância, faça o seguinte:

Consola

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
Na página Cópias de segurança, clique em Nível padrão ou Nível melhorado, consoante a opção de cópia de segurança da sua instância.
Se a sua instância estiver a usar cópias de segurança padrão, selecione a instância para a qual quer ver as cópias de segurança.

Se a sua instância estiver a usar cópias de segurança melhoradas, 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.
Localize o nome da cópia de segurança que quer restaurar e, de seguida, clique em Restaurar.

Nota: todas as réplicas da instância de destino têm de ser eliminadas antes de restaurar.
Em Escolha o destino da restauração, selecione Substituir a instância de origem.
No campo ID da instância de destino, introduza o nome da instância a substituir para confirmar a sua seleção.
Clique em Restaurar.

O Cloud SQL restaura a cópia de segurança para a mesma instância. 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

Todas as réplicas têm de ser eliminadas da sua instância antes da restauração.

Determine se a sua instância tem réplicas de leitura através do comando gcloud sql instances describe:
```
gcloud sql instances describe INSTANCE_NAME
```
Substitua o seguinte:
- INSTANCE_NAME: o nome da instância.
Se a sua instância contiver réplicas, elimine-as com o comando gcloud sql instances delete:
```
gcloud sql instances delete REPLICA_NAME
```
Substitua o seguinte:
- REPLCICA_NAME: o nome da réplica.
Encontre a cópia de segurança que quer usar.

Se a sua instância estiver a usar cópias de segurança padrão, use o comando gcloud sql backups list para encontrar uma cópia de segurança e registar o respetivo valor ID:
```
gcloud sql backups list INSTANCE_NAME
```
Substitua o seguinte:
- INSTANCE_NAME: o nome da instância.
Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.
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=BACKUP_ID
```
Substitua o seguinte:
- BACKUP_ID: o ID da cópia de segurança que quer restaurar.
- INSTANCE_NAME: o nome da instância.
Após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1

Para determinar se a instância tem réplicas de leitura e obter os respetivos IDs, liste todas as réplicas 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?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 sessão automaticamente 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 Ads 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"
  ]
}
```

Elimine todas as réplicas da instância:

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 sessão automaticamente 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 Ads 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": "user@example.com",
  "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"
}

Obtenha o ID da cópia de segurança que quer usar.
- Se a sua instância estiver a usar cópias de segurança padrão, 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 sessão automaticamente 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 Ads 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"
    }
```
  - Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.

Restaure a instância 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
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)

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)

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": "user@example.com",
  "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"
}

Depois de concluir a operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1beta4

Para determinar se a instância tem réplicas de leitura e obter os respetivos IDs, liste todas as réplicas 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?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 sessão automaticamente 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 Ads 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"
  ]
}
```

Elimine todas as réplicas da instância:

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)

Execute o seguinte comando:

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

PowerShell (Windows)

Execute o seguinte comando:

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

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

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": "user@example.com",
  "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"
}

Obtenha o ID da cópia de segurança que quer usar.
- Se a sua instância estiver a usar cópias de segurança padrão, 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 sessão automaticamente 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 Ads 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"
    }
```
  - Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.

Restaure a instância 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
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)

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)

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": "user@example.com",
  "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"
}

Depois de concluir a operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

Restaurar para uma instância nova ou existente

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.

Se precisar de uma lista de cópias de segurança para o 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 no projeto. Para mais informações, consulte o artigo Ver cópias de segurança durante uma indisponibilidade.

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

Consola

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
Na página Cópias de segurança, clique em Nível padrão ou Nível melhorado, consoante a opção de cópia de segurança da sua instância.
Se a sua instância estiver a usar cópias de segurança padrão, selecione a instância para a qual quer ver as cópias de segurança.

Se a sua instância estiver a usar cópias de segurança melhoradas, 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.
Localize o nome da cópia de segurança que quer restaurar e, de seguida, clique em Restaurar.
Em Escolha o destino de restauro:
- Se quiser restaurar a sua instância para uma nova instância, selecione Restaurar para uma nova instância e atualize o seguinte:
  - 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.
- Se quiser restaurar a sua instância para uma instância existente, selecione Substituir uma instância existente e faça o seguinte:
  
  Nota: todas as réplicas da instância de destino têm de ser eliminadas antes de restaurar.
  - 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 vão ser substituídos.
  - No campo ID da instância de destino, introduza o nome da instância a substituir para confirmar a sua seleção.
Clique em Restaurar.

O Cloud SQL restaura a cópia de segurança para a instância nova ou existente, consoante a sua seleção. 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

Se estiver a restaurar para uma instância existente, todas as réplicas têm de ser eliminadas da instância de destino antes da restauração.

Determine se a sua instância tem réplicas de leitura através do comando gcloud sql instances describe:
```
gcloud sql instances describe TARGET_INSTANCE_NAME
```
Substitua o seguinte:
- TARGET_INSTANCE_NAME: o nome da instância.
Se a sua instância contiver réplicas, elimine-as com o comando gcloud sql instances delete:
```
gcloud sql instances delete REPLCICA_NAME
```
Substitua o seguinte:
- REPLCICA_NAME: o nome da réplica.
Encontre a cópia de segurança que quer usar.

Se a sua instância estiver a usar cópias de segurança padrão, use o comando gcloud sql backups list para encontrar uma cópia de segurança e registar o respetivo valor ID:
```
gcloud sql backups list INSTANCE_NAME
```
Substitua o seguinte:
- INSTANCE_NAME: o nome da instância.
Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.
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=TARGET_INSTANCE_NAME \
--backup-instance=SOURCE_INSTANCE_NAME
```
Substitua o seguinte:
- BACKUP_ID: o ID da cópia de segurança que quer restaurar.
- TARGET_INSTANCE_NAME: o nome da instância de destino nova ou existente.
- SOURCE_INSTANCE_NAME: o nome da instância da origem.
Se estiver a restaurar para uma instância existente, após a conclusão da operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1

Se estiver a usar uma instância existente, todas as réplicas têm de ser eliminadas antes da restauração. Determine se a instância tem réplicas de leitura e, para obter os respetivos IDs, liste todas as réplicas 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?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 sessão automaticamente 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 Ads 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"
  ]
}
```

Elimine todas as réplicas da instância:

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)

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)

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": "user@example.com",
  "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"
}

Obtenha o ID da cópia de segurança que quer usar.
- Se a sua instância estiver a usar cópias de segurança padrão, 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 sessão automaticamente 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 Ads 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"
    }
```
  - Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.

Restaure a instância 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 da 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)

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)

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": "user@example.com",
  "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"
}

Depois de concluir a operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1beta4

Para determinar se a instância tem réplicas de leitura e obter os respetivos IDs, liste todas as réplicas 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?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 sessão automaticamente 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 Ads 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"
  ]
}
```

Elimine todas as réplicas da instância:

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)

Execute o seguinte comando:

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

PowerShell (Windows)

Execute o seguinte comando:

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

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

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": "user@example.com",
  "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"
}

Obtenha o ID da cópia de segurança que quer usar.
- Se a sua instância estiver a usar cópias de segurança padrão, 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 sessão automaticamente 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 Ads 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"
    }
```
  - Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.

Restaure a instância 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 da 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)

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)

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": "user@example.com",
  "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"
}

Depois de concluir a 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 numa instância num projeto diferente. Quando faz o restauro a partir de uma cópia de segurança para uma instância 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.

O utilizador que faz o restauro para um projeto diferente tem de ter as seguintes autorizações para restaurar a instância: * Autorização cloudsql.instances.restoreBackup para o projeto de destino * Autorização cloudsql.backupRuns.get para o projeto de origem.

Estas autorizações estão incluídas na função Cloud SQL Admin.

Para restaurar a instância através de uma cópia de segurança para uma instância num projeto ou numa região diferente, faça o seguinte:

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:

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.
Encontre a cópia de segurança que quer usar.

Se a sua instância estiver a usar cópias de segurança padrão, use o comando gcloud sql backups list para encontrar uma cópia de segurança e registar o respetivo valor ID:
```
gcloud sql backups list INSTANCE_NAME
```
Substitua o seguinte:
- INSTANCE_NAME: o nome da instância.
Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.
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

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)

Execute o seguinte comando:

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

PowerShell (Windows)

Execute o seguinte comando:

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

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

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 da 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)

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)

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": "user@example.com",
  "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"
}

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)

Execute o seguinte comando:

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

PowerShell (Windows)

Execute o seguinte comando:

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

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

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 da 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)

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)

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": "user@example.com",
  "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"
}

Restaure uma instância eliminada

Pode usar uma cópia de segurança final ou uma cópia de segurança retida para restaurar uma instância eliminada nos seguintes cenários:

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

Restaurar para uma instância existente

Quando restaura dados de uma cópia de segurança final ou 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. Para mais informações sobre a restauração de uma instância, consulte o artigo Dicas gerais sobre a realização de uma restauração.

Para restaurar uma instância eliminada através de uma cópia de segurança para uma instância existente, faça o seguinte:

Consola

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

Aceda a Instâncias do Cloud SQL
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 uma cópia de segurança retida ou final para a instância existente.
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
Na página Cópias de segurança, clique em Nível padrão ou Nível melhorado, consoante a opção de cópia de segurança da sua instância.
Se a sua instância estiver a usar cópias de segurança padrão, clique no nome da instância eliminada que contém a cópia de segurança que quer restaurar.

Se a sua instância estiver a usar cópias de segurança melhoradas, 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.
Localize o nome da cópia de segurança que quer restaurar e, de seguida, clique em Restaurar.
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.
Na secção Escolha o destino da restauração, selecione Substituir uma instância existente.
No menu Instância a ser substituída, selecione a instância na qual quer restaurar a cópia de segurança. A instância que selecionar e todos os respetivos dados vão ser substituídos.
Para confirmar a seleção, no campo ID da instância de destino, introduza o nome da instância a substituir.
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.  When restoring to an existing instance, all replicas must be deleted
from your target instance prior to restoring.

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

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

Replace the following:

*   `TARGET_INSTANCE_NAME`: the name of the instance.

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

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

Replace the following:

*   `REPLCICA_NAME`: the name of the replica.

Encontre a cópia de segurança que quer usar.

Se a sua instância estiver a usar cópias de segurança padrão, use o comando gcloud sql backups list para encontrar uma cópia de segurança e registar o respetivo valor ID:
```
gcloud sql backups list INSTANCE_NAME
```
Substitua o seguinte:
- INSTANCE_NAME: o nome da instância.
Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.
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=TARGET_INSTANCE_NAME
```
Substitua o seguinte:
- BACKUP_ID: o ID da cópia de segurança que quer restaurar.
- TARGET_INSTANCE_NAME: o nome da instância de destino nova ou existente.
Depois de concluir a operação de restauro, recrie todas as réplicas que eliminou neste procedimento.

REST v1

Quando faz a restauração para uma instância existente, todas as réplicas têm de ser eliminadas da instância de destino antes da restauração. Para determinar se a instância tem réplicas de leitura, execute o seguinte:

Antes de usar 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 sessão automaticamente 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 Ads 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"
  ]
}
```

Elimine todas as réplicas de leitura da instância:

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)

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)

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": "user@example.com",
  "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"
}

Obtenha o ID da cópia de segurança final ou retida que quer usar:

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)

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)

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 a instância de destino a partir da cópia de segurança retida ou final.

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)

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)

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": "user@example.com",
  "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

Quando faz a restauração para uma instância existente, todas as réplicas têm de ser eliminadas da instância de destino antes da restauração. Para determinar se a instância tem réplicas de leitura, execute o seguinte:

Antes de usar 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 sessão automaticamente 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 Ads 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"
  ]
}
```

Elimine todas as réplicas de leitura da instância:

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)

Execute o seguinte comando:

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

PowerShell (Windows)

Execute o seguinte comando:

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

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

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": "user@example.com",
  "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"
}

Obtenha o ID da cópia de segurança final ou retida que quer usar:

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)

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)

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 a instância de destino a partir da cópia de segurança retida ou final.

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)

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)

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": "user@example.com",
  "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 nova instância

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

Para restaurar dados de uma cópia de segurança final ou retida para uma nova instância, tem de ter as seguintes autorizações:

Autorização cloudsql.instances.create para o projeto de destino
Autorização cloudsql.instances.restoreBackup para o projeto de destino
cloudsql.backupRuns.get permission para a cópia de segurança de origem.

Estas autorizações estão incluídas na função de administrador do Cloud SQL.

Para restaurar uma instância eliminada através de uma cópia de segurança numa nova instância, faça o seguinte:

Consola

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
Na página Cópias de segurança, clique em Nível padrão ou Nível melhorado, consoante a opção de cópia de segurança da sua instância.
Se a sua instância estiver a usar cópias de segurança padrão, clique no nome da instância eliminada que contém a cópia de segurança que quer restaurar.

Se a sua instância estiver a usar cópias de segurança melhoradas, 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.
Encontre o nome da cópia de segurança que quer restaurar e clique em Restaurar.
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.
Na secção Escolha o destino da restauração, selecione Restaurar para uma nova instância.
No menu Região, selecione a região para a nova instância.
No campo ID da instância, introduza um ID para a nova instância. Não é possível alterar este ID depois de o criar.
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.

gcloud

Encontre a cópia de segurança que quer usar.

Se a sua instância estiver a usar cópias de segurança padrão, use o comando gcloud sql backups list para encontrar uma cópia de segurança e registar o respetivo valor ID:
```
gcloud sql backups list INSTANCE_NAME
```
Substitua o seguinte:
- INSTANCE_NAME: o nome da instância.
Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.
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=TARGET_INSTANCE_NAME
```
Substitua o seguinte:
- BACKUP_ID: o ID da cópia de segurança que quer restaurar.
TARGET_INSTANCE_NAME: o nome da instância de destino nova ou existente.

REST v1

Restaurar uma nova instância a partir da cópia de segurança final ou 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)

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)

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": "user@example.com",
  "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 final ou 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)

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)

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": "user@example.com",
  "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 nova ou existente num projeto diferente

Pode usar o parâmetro project para restaurar dados numa instância num projeto diferente. Quando restaura uma instância eliminada a partir de uma cópia de segurança para uma instância num projeto diferente, a instância de destino é atualizada para o estado da instância de origem quando fez a cópia de segurança.

O utilizador que faz o restauro para um projeto diferente tem de ter as seguintes autorizações para restaurar a instância: * Autorização cloudsql.instances.create para o projeto de destino * Autorização cloudsql.instances.restoreBackup para o projeto de destino * cloudsql.backupRuns.get permission para a cópia de segurança de origem.

Estas autorizações estão incluídas na função Cloud SQL Admin.

Para restaurar a instância através de uma cópia de segurança para uma instância num projeto ou numa região diferente, faça o seguinte:

gcloud

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.
1. Encontre a cópia de segurança que quer usar.
Se a sua instância estiver a usar cópias de segurança padrão, use o comando gcloud sql backups list para encontrar uma cópia de segurança e registar o respetivo valor ID:
```
gcloud sql backups list INSTANCE_NAME
```
Substitua o seguinte:
- INSTANCE_NAME: o nome da instância.
Se a sua instância estiver a usar cópias de segurança melhoradas, consulte o artigo Liste todas as cópias de segurança num cofre de cópias de segurança.
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

Para obter o backupID da cópia de segurança retida ou 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

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)

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)

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)

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)

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": "user@example.com",
  "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 ou 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

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)

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)

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)

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)

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": "user@example.com",
  "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"
}

O que se segue?

* Saiba mais sobre como fazer uma cópia de segurança dos seus dados. * Veja como fazer uma cópia de segurança dos seus dados.

Restaure uma instância através de uma cópia de segurança Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Restaure uma instância em direto

Restaurar para a mesma instância

Consola

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Restaurar para uma instância nova ou existente

Consola

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Restaurar para uma instância noutro projeto

gcloud

REST v1

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

REST v1beta4

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

curl (Linux, macOS ou Cloud Shell)

PowerShell (Windows)

Resposta

Restaure uma instância eliminada

Restaurar para uma instância existente

Consola

gcloud

Restaure uma instância através de uma cópia de segurança