Algumas ou todas as informações nesta página podem não se aplicar à Trusted Cloud by S3NS. Consulte o artigo Diferenças em relação ao Google Cloud para mais detalhes.

Esta página foi traduzida pela API Cloud Translation.

Faça a gestão das cópias de segurança finais

MySQL | PostgreSQL | SQL Server

Esta página descreve como gerir cópias de segurança finais para a sua instância do Cloud SQL. Antes de eliminar uma instância, pode fazer uma cópia de segurança final da instância. Em seguida, pode restaurar a cópia de segurança final numa instância nova ou existente. Desta forma, pode recriar instâncias que tenha eliminado acidentalmente ou usar estas instâncias para cenários de recuperação de desastres.

Ao contrário das cópias de segurança automáticas e a pedido, que estão associadas a uma instância, pode fazer uma cópia de segurança final antes de eliminar a instância. O Cloud SQL armazena esta cópia de segurança para além da duração da instância.

Pode usar os comandos da CLI gcloud existentes para listar, descrever, atualizar e eliminar uma cópia de segurança final. Se estiver a usar funções personalizadas, adicione as seguintes autorizações às funções:

cloudsql.backupRuns.list
cloudsql.backupRuns.get
cloudsql.backupRuns.update
cloudsql.backupRuns.delete

Para mais informações acerca destas autorizações, consulte o artigo Autorizações necessárias. Além disso, para mais informações sobre o funcionamento das cópias de segurança, consulte o artigo Acerca das cópias de segurança do Cloud SQL.

Autorizações necessárias

Trusted Cloud consola

Para gerir cópias de segurança finais num Trusted Cloud projeto, precisa das seguintes autorizações:

Tarefa	Autorizações necessárias
Liste as cópias de segurança finais	`cloudsql.backupRuns.list`
Descreva uma cópia de segurança final	`cloudsql.backupRuns.get`
Atualize uma cópia de segurança final	`cloudsql.backupRuns.update`
Elimine uma cópia de segurança final	`cloudsql.backupRuns.delete`

CLI gcloud

Para gerir cópias de segurança finais num Trusted Cloud projeto, precisa das seguintes autorizações:

Ação	Comando	Autorizações necessárias
Liste as cópias de segurança finais	`gcloud sql backups list`	`cloudsql.backupRuns.list`
Descreva uma cópia de segurança final	`gcloud sql backups describe`	`cloudsql.backupRuns.get`
Atualize uma cópia de segurança final	`gcloud sql backups patch`	`cloudsql.backupRuns.update`
Elimine uma cópia de segurança final	`gcloud sql backups delete`	`cloudsql.backupRuns.delete`

REST

Para gerir cópias de segurança finais num Trusted Cloud projeto, precisa das seguintes autorizações:

Ação	Método	Autorizações necessárias
Liste as cópias de segurança finais	`Backups.ListBackups`	`cloudsql.backupRuns.list`
Descreva uma cópia de segurança final	`Backups.GetBackup`	`cloudsql.backupRuns.get`
Atualize uma cópia de segurança final	`Backups.UpdateBackup`	`cloudsql.backupRuns.update`
Elimine uma cópia de segurança final	`Backups.DeleteBackup`	`cloudsql.backupRuns.delete`

Veja uma lista das cópias de segurança finais

Pode ver uma lista de cópias de segurança finais e detalhes sobre uma cópia de segurança através da Trusted Cloud consola, da CLI gcloud ou da API Cloud SQL.

A Trusted Cloud consola não mostra cópias de segurança ignoradas ou com falhas no histórico de cópias de segurança. Para ver estes tipos de cópias de segurança, use gcloud ou a API Cloud SQL.

Consola

Na Trusted 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 Trusted Cloud projeto.
Para ver detalhes sobre uma cópia de segurança final, clique na cópia de segurança. É apresentada uma caixa de diálogo Cópia de segurança final. Esta caixa de diálogo apresenta as seguintes informações:
- A data e a hora em que a instância, que foi usada para criar a cópia de segurança final, foi eliminada
- O nome e a versão da instância eliminada
- Uma indicação de data/hora de quanto tempo o Cloud SQL retém a cópia de segurança final
- Uma descrição da cópia de segurança final

gcloud

Para obter uma lista de todas as cópias de segurança finais associadas a um Trusted Cloud projeto, use o comando gcloud sql backups list:
```
gcloud sql backups list \
--filter="type=FINAL"
```
Nota: ao usar este comando, pode obter informações sobre as cópias de segurança, incluindo os respetivos IDs. Precisa de um ID da cópia de segurança para ver os detalhes de uma cópia de segurança final.

Além disso, pode filtrar e controlar os resultados da execução deste comando através de parâmetros de lista padrão. Para ver uma lista completa, consulte a página de referência de comandos gcloud sql backups list.
Para ver detalhes sobre uma cópia de segurança final, use o comando gcloud sql backups describe:
```
gcloud sql backups describe \
BACKUP_NAME
```
Obtém o BACKUP_NAME a partir da saída da execução do comando gcloud sql backups list. O BACKUP_NAME tem o seguinte formato: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Aceda a uma lista das cópias de segurança finais

Use este exemplo para obter uma lista de todas as cópias de segurança finais associadas a um Trusted Cloud projeto. Para ver uma lista completa dos parâmetros desta chamada, consulte a página Backups.ListBackups.

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

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"

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" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "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": "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
}

Veja detalhes sobre uma cópia de segurança final

Use este exemplo para ver os detalhes de uma cópia de segurança final. Para ver uma lista completa dos parâmetros desta chamada, consulte a página Backups.GetBackup.

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.

Método HTTP e URL:

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

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/BACKUP_ID"

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/BACKUP_ID" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "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": "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
    }

REST v1beta4

Aceda a uma lista das cópias de segurança finais

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

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?filter=type=FINAL"

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?filter=type=FINAL" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "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": "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
}

Veja detalhes sobre uma cópia de segurança final

Use este exemplo para ver os detalhes de uma cópia de segurança final. Para ver uma lista completa dos parâmetros desta chamada, consulte a página Backups.GetBackup.

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.

Método HTTP e URL:

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

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/BACKUP_ID"

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/BACKUP_ID" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "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": "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
    }

Atualize uma cópia de segurança final

Pode atualizar durante quanto tempo o Cloud SQL retém uma cópia de segurança final de uma instância e a descrição da cópia de segurança através da Trusted Cloud consola, da CLI gcloud ou da API Cloud SQL.

Consola

Na Trusted 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 Trusted Cloud projeto.
Para atualizar uma cópia de segurança final, clique na cópia de segurança. É apresentada uma caixa de diálogo Cópia de segurança final.
Para atualizar o tempo durante o qual o Cloud SQL retém a cópia de segurança final, conclua as seguintes ações:
1. Clique no ícone Editar retenção junto ao campo Cópia de segurança retida até.
2. Clique no ícone Selecionar data junto ao campo Manter cópia de segurança até.
3. No calendário, selecione a nova data que indica durante quanto tempo o Cloud SQL retém a cópia de segurança final.
4. Clique em Atualizar. Regressa à página Cópias de segurança do Cloud SQL.
Para atualizar a descrição da cópia de segurança final, conclua as seguintes ações:
1. Clique na cópia de segurança final.
2. Clique no ícone Editar descrição junto ao campo Descrição.
3. No campo Descreva esta cópia de segurança, introduza a descrição atualizada da cópia de segurança final.
4. Clique em Atualizar. Regressa à página Cópias de segurança do Cloud SQL.

gcloud

Para obter uma lista de todas as cópias de segurança finais associadas a um Trusted Cloud projeto, use o comando gcloud sql backups list:
```
gcloud sql backups list \
--filter="type=FINAL"
```
Nota: ao usar este comando, pode obter informações sobre as cópias de segurança finais, incluindo os respetivos IDs. Precisa de um ID alternativo para atualizar uma cópia de segurança final.

Além disso, pode filtrar e controlar os resultados da execução deste comando através de parâmetros de lista padrão. Para ver uma lista completa, consulte a página de referência de comandos gcloud sql backups list.
Para atualizar a descrição e o período de retenção de uma cópia de segurança final, use o comando gcloud sql backups patch:
```
gcloud sql backups patch \
BACKUP_NAME  \
--backup-description=BACKUP_DESCRIPTION /
--expiry-time=DATE-AND-TIME-STAMP | --ttl-days=NUMBER-OF-DAYS
```
Obtém o BACKUP_NAME a partir da saída da execução do comando gcloud sql backups list. O BACKUP_NAME tem o seguinte formato: projects/PROJECT_ID/backups/BACKUP_ID.

Para as flags --expiry-time e --ttl-days, use as seguintes diretrizes:
- Para a flag --expiry-time, especifique uma data/hora em que o Cloud SQL elimina automaticamente a cópia de segurança final.
- Para a flag --ttl-days, especifique o período de retenção da cópia de segurança final (de 1 a 365 dias). Isto é conhecido como tempo de vida (TTL). O período de retenção começa a partir da data e hora atuais, e o período de retenção máximo permitido pelo Cloud SQL é de 1 ano (ou 365 dias).
Use a sinalização --expiry-time ou a sinalização --ttl-days, mas não ambas.

REST v1

Aceda a uma lista das cópias de segurança finais

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

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?filter=type=FINAL"

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?filter=type=FINAL" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "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": "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
}

Atualize o período de retenção

Pode atualizar o período de retenção de uma cópia de segurança final de uma das seguintes formas:

Dias de retenção: modifique o número de dias durante os quais o Cloud SQL retém a cópia de segurança.
Hora de expiração: indique uma data/hora atualizada para quando o Cloud SQL elimina automaticamente a cópia de segurança.

Atualize os dias de retenção

Use este exemplo para atualizar o número de dias durante os quais o Cloud SQL retém a cópia de segurança final. Para ver uma lista completa dos parâmetros desta chamada, consulte a página Backups.UpdateBackup.

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.
TTL_DAYS: o período de retenção da cópia de segurança final (de 1 a 365 dias). Isto é conhecido como tempo de vida (TTL). O período de retenção começa a partir da data e hora atuais, e o período de retenção máximo permitido pelo Cloud SQL é de 1 ano (ou 365 dias).

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

Corpo JSON do pedido:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

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 PATCH \
     -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/backups/BACKUP_ID?update_mask=ttl_days"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

Atualize a hora de validade

Use este exemplo para fornecer uma data/hora atualizada para quando o Cloud SQL elimina a cópia de segurança. Para ver uma lista completa dos parâmetros desta chamada, consulte a página Backups.UpdateBackup.

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.
DATE_AND_TIME_STAMP: uma data/hora da eliminação automática da cópia de segurança final pelo Cloud SQL.

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

Corpo JSON do pedido:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

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 PATCH \
     -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/backups/BACKUP_ID?update_mask=expiry_time"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

Atualize a descrição

Use este exemplo para atualizar a descrição da cópia de segurança final. Para ver uma lista completa dos parâmetros desta chamada, consulte a página Backups.UpdateBackup.

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.
DESCRIPTION: a descrição atualizada da cópia de segurança final.

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Corpo JSON do pedido:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

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 PATCH \
     -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/backups/BACKUP_ID?update_mask=description"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "kind": "sql#operation",
      "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

REST v1beta4

Aceda a uma lista das cópias de segurança finais

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

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?filter=type=FINAL"

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?filter=type=FINAL" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "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": "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
}

Atualize o período de retenção

Pode atualizar o período de retenção de uma cópia de segurança final de uma das seguintes formas:

Dias de retenção: modifique o número de dias durante os quais o Cloud SQL retém a cópia de segurança
Hora de expiração: indique uma data/hora atualizada para quando o Cloud SQL elimina automaticamente a cópia de segurança.

Atualize os dias de retenção

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.
TTL_DAYS: o período de retenção da cópia de segurança final (de 1 a 365 dias). Isto é conhecido como tempo de vida (TTL). O período de retenção começa a partir da data e hora atuais, e o período de retenção máximo permitido pelo Cloud SQL é de 1 ano (ou 365 dias).

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days

Corpo JSON do pedido:

{
        "backup": {
            expiration: {
            "ttl_days": TTL_DAYS,
            }
         },
}

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 PATCH \
     -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/backups/BACKUP_ID?update_mask=ttl_days"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=ttl_days" | 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/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

Atualize a hora de validade

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.
DATE_AND_TIME_STAMP: uma data/hora da eliminação automática da cópia de segurança final pelo Cloud SQL.

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time

Corpo JSON do pedido:

{
        "backup": {
            expiration: {
            "expiry_time": DATE_AND_TIME_STAMP,
            }
         },
}

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 PATCH \
     -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/backups/BACKUP_ID?update_mask=expiry_time"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=expiry_time" | 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/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

Atualize a descrição

Use este exemplo para atualizar a descrição da cópia de segurança final. Para ver uma lista completa dos parâmetros desta chamada, consulte a página Backups.UpdateBackup.

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.
DESCRIPTION: a descrição atualizada da cópia de segurança final.

Método HTTP e URL:

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description

Corpo JSON do pedido:

{
        "backup": {
            "description": DESCRIPTION,
         },
}

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 PATCH \
     -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/backups/BACKUP_ID?update_mask=description"

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 PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID?update_mask=description" | 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/backups/BACKUP_ID",
      "status": "DONE",
      "user": "user@example.com",
      "insertTime": "2024-02-15T00:10:22.078Z",
      "operationType": "UPDATE_BACKUP",
      "name": "OPERATION_ID",
      "targetId": "BACKUP_ID",
      "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
      "targetProject": "PROJECT_ID"
}

Elimine uma cópia de segurança final

Pode eliminar uma cópia de segurança final através da Trusted Cloud consola, da CLI gcloud ou da API Cloud SQL.

A eliminação de uma cópia de segurança pode não libertar tanto espaço quanto o tamanho da cópia de segurança. Isto acontece porque as cópias de segurança são incrementais. Por isso, a eliminação de uma cópia de segurança mais antiga pode transferir alguns dos respetivos conteúdos para uma cópia de segurança mais recente para preservar a integridade da cópia de segurança mais recente.

Consola

Na Trusted 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 Trusted Cloud projeto.
Para a cópia de segurança final que quer eliminar, clique em mais ações e, de seguida, selecione Eliminar.
Na janela Eliminar cópia de segurança final?, introduza o nome da instância que usou para criar a cópia de segurança final e, de seguida, clique em Eliminar.

gcloud

Para obter uma lista de todas as cópias de segurança finais associadas a um Trusted Cloud projeto, use o comando gcloud sql backups list:
```
gcloud sql backups list \
--filter="type=FINAL"
```
Nota: ao usar este comando, pode obter informações sobre as cópias de segurança, incluindo os respetivos IDs. Precisa de um ID de cópia de segurança para eliminar uma cópia de segurança final.

Além disso, pode filtrar e controlar os resultados da execução deste comando através de parâmetros de lista padrão. Para ver uma lista completa, consulte a página de referência de comandos gcloud sql backups list.
Para eliminar uma cópia de segurança final, use o comando gcloud sql backups delete:
```
gcloud sql backups delete \
BACKUP_NAME
```
Obtém o BACKUP_NAME a partir da saída da execução do comando gcloud sql backups list. O BACKUP_NAME tem o seguinte formato: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Aceda a uma lista das cópias de segurança finais

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

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?filter=type=FINAL"

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?filter=type=FINAL" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "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": "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
}

Elimine uma cópia de segurança final

Use este exemplo para eliminar uma cópia de segurança final. Para ver uma lista completa de parâmetros para esta chamada, consulte a página Backups.DeleteBackup.

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.

Método HTTP e URL:

DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_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/backups/BACKUP_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/backups/BACKUP_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/backups/BACKUP_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE_BACKUP",
  "name": "OPERATION_ID",
  "targetId": "BACKUP_ID",
  "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta4

Aceda a uma lista das cópias de segurança finais

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

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?filter=type=FINAL"

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?filter=type=FINAL" | Select-Object -Expand Content

Deve receber uma resposta JSON semelhante à seguinte:

Resposta

{
      "name": "projects/PROJECT_ID/backups/BACKUP_ID",
      "kind": "sql#backup",
      "status": "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": "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
}

Elimine uma cópia de segurança final

Use este exemplo para eliminar uma cópia de segurança final. Para ver uma lista completa de parâmetros para esta chamada, consulte a página Backups.DeleteBackup.

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

PROJECT_ID: o ID do projeto.
BACKUP_ID: o ID da cópia de segurança. Obtém este ID a partir do resultado da execução da chamada anterior.

Método HTTP e URL:

DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_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/backups/BACKUP_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/backups/BACKUP_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/backups/BACKUP_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-21T22:43:37.981Z",
  "operationType": "DELETE_BACKUP",
  "name": "OPERATION_ID",
  "targetId": "BACKUP_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}