Faça a gestão das cópias de segurança de instâncias eliminadas

Consola

gcloud

REST

Consola

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

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

2. Selecione a opção de cópia de segurança da sua instância: Nível padrão ou Nível melhorado.

3. Clique em Filtrar, Estado da instância e selecione Instância eliminada.

   Esta página apresenta todas as instâncias eliminadas no seu Cloud de Confiance projeto da consola.

4. Clique no nome da instância eliminada cujas cópias de segurança quer ver.

   Esta página lista todas as cópias de segurança automáticas e a pedido retidas, e a cópia de segurança final, se disponível, para a sua instância eliminada.

gcloud

1. Para obter uma lista de todas as cópias de segurança associadas a um Cloud de Confiance projeto, use o comando gcloud sql backups list:

   gcloud sql backups list
   --project=PROJECT_ID
   

   Substitua o seguinte:

   • PROJECT_ID: o ID do seu projeto Cloud de Confiance .

2. Para ver detalhes sobre uma cópia de segurança retida específica, use o comando gcloud sql backups describe:

   gcloud sql backups describe BACKUP_NAME
   --project=PROJECT_ID
   

   Substitua o seguinte:

   • BACKUP_NAME: o nome da cópia de segurança retida.
   • PROJECT_ID: o ID do seu projeto Cloud de Confiance .

REST v1

Obtenha uma lista de todas as cópias de segurança

Use este exemplo para obter uma lista de todas as cópias de segurança retidas e finais associadas a um Cloud de Confiance projeto. Para ver uma lista completa de parâmetros para esta 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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups"

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

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

Veja os detalhes de uma cópia de segurança

Use este exemplo para ver os detalhes de uma cópia de segurança retida ou final. Para ver uma lista completa de parâmetros para esta chamada, consulte a página backup.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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID"

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

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

Obtenha uma lista de todas as cópias de segurança retidas

Use este exemplo para obter uma lista de todas as cópias de segurança retidas e finais associadas ao Cloud de Confiance projeto. Para ver uma lista completa de parâmetros para esta 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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups"

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

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

Veja os detalhes de uma cópia de segurança retida

Use este exemplo para ver os detalhes de uma cópia de segurança retida ou final. Para ver uma lista completa de parâmetros para esta 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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID"

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

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

Consola

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

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

2. Clique no nome da instância eliminada cujas cópias de segurança quer ver.

   É apresentada uma lista de todas as cópias de segurança finais e retidas, bem como os respetivos detalhes, da instância eliminada.

3. Para a cópia de segurança final que quer atualizar, clique em Mais ações e, de seguida, faça o seguinte:

   • Se quiser editar a descrição da cópia de segurança final, clique em Editar descrição.

     Introduza a descrição no campo Descreva esta cópia de segurança e, de seguida, clique em Atualizar.

   • Se quiser editar o período de retenção da cópia de segurança final, clique em Editar período de retenção.

     Selecione a data no campo Manter cópia de segurança até. O período de retenção pode variar entre 1 e 365 dias após a eliminação da instância. Depois de selecionar a data até à qual quer reter a cópia de segurança, clique em Atualizar.

gcloud

Precisa do backup-name da cópia de segurança final que quer atualizar. Para obter o backup-name, consulte o artigo Liste as cópias de segurança de uma instância eliminada.

Para atualizar o período de retenção ou a descrição de uma cópia de segurança final, use o comando gcloud sql backups patch e especifique expiry-time ou ttl-days para a cópia de segurança:

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION
--expiry-time=EXPIRY_TIME | --ttl-days=TTL_DAYS

Substitua o seguinte:

• BACKUP_NAME: o nome da cópia de segurança final.
• BACKUP_DESCRIPTION: a nova descrição que quer adicionar à cópia de segurança final.

• Uma das seguintes opções:

  • EXPIRY_TIME: a nova data e hora em que quer que a cópia de segurança final seja eliminada. O tempo máximo é de 365 dias a partir da eliminação da instância.
  • TTL_DAYS: o número de dias que quer reter a sua cópia de segurança final. Os valores podem variar entre 1 e 365 dias, sendo a predefinição de 30 dias.

REST v1

Precisa do backup-name da cópia de segurança final que quer atualizar. Para obter o backup-name, consulte o artigo Liste as cópias de segurança de uma instância eliminada.

Pode atualizar a descrição e as definições de retenção da cópia de segurança final. A definição de retenção pode ser atualizada através de um dos seguintes métodos:

• Atualize os dias de retenção da cópia de segurança final
• Atualize a hora de validade da cópia de segurança final

Atualize o período de retenção através dos dias de retenção

Use este exemplo para atualizar a definição de retenção da cópia de segurança final com o parâmetro de 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/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 -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"

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

{
      "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 o período de retenção através do tempo de validade

Use este exemplo para atualizar a definição de retenção da cópia de segurança final com o parâmetro de tempo de expiraçã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.
• 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 -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"

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

{
      "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 de parâmetros para esta 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 -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"

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

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

Precisa do backup-name da cópia de segurança final que quer atualizar. Para obter o backup-name, consulte o artigo Liste as cópias de segurança de uma instância eliminada.

Pode atualizar a descrição e as definições de retenção da cópia de segurança final. A definição de retenção pode ser atualizada através de um dos seguintes métodos:

• Atualize os dias de retenção da cópia de segurança final
• Atualize a hora de validade da cópia de segurança final

Atualize o período de retenção através dos dias de retenção

Use este exemplo para atualizar a definição de retenção da cópia de segurança final com o parâmetro de 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 -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"

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

{
      "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 o período de retenção através do tempo de validade

Use este exemplo para atualizar a definição de retenção da cópia de segurança final com o parâmetro de tempo de expiraçã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.
• 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 -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"

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

{
      "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 de parâmetros para esta 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 -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"

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

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

Consola

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

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

2. Clique no nome da instância eliminada cujas cópias de segurança quer ver.

   É apresentada uma lista de todas as cópias de segurança finais e retidas, bem como os respetivos detalhes, da instância eliminada.

3. Para a cópia de segurança retida que quer atualizar, clique em mais ações e, de seguida, selecione Editar descrição.

4. Na janela Editar descrição da cópia de segurança, atualize a descrição da cópia de segurança.

5. Clique em Atualizar.

gcloud

Para atualizar a descrição da cópia de segurança retida, use o comando gcloud sql backups patch:

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION

Substitua o seguinte:

• BACKUP_NAME: o nome da cópia de segurança retida.
• BACKUP_DESCRIPTION: a nova descrição que quer adicionar à sua cópia de segurança retida.

REST v1

Obtenha uma lista de todas as cópias de segurança retidas

Use este exemplo para obter uma lista de todas as cópias de segurança retidas associadas a umCloud de Confiance projeto. Para ver uma lista completa de parâmetros para esta 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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups"

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

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

Atualize a descrição

Use este exemplo para atualizar a descrição da cópia de segurança retida. Para ver uma lista completa de parâmetros para esta 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 -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"

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

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

Obtenha uma lista de todas as cópias de segurança retidas

Use este exemplo para obter uma lista de todas as cópias de segurança retidas associadas a umCloud de Confiance projeto. Para ver uma lista completa de parâmetros para esta 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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups"

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

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

Atualize a descrição

Use este exemplo para atualizar a descrição da cópia de segurança retida. Para ver uma lista completa de parâmetros para esta 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 -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"

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

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

Consola

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

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

2. Clique no nome da instância eliminada cujas cópias de segurança quer ver.

   É apresentada uma lista de todas as cópias de segurança finais e retidas, bem como os respetivos detalhes, da instância eliminada.

3. Para a cópia de segurança que quer eliminar, clique em mais ações e, de seguida, selecione Eliminar.

4. Na janela Eliminar cópia de segurança, introduza o nome da instância eliminada e, de seguida, clique em Eliminar.

gcloud

Para eliminar uma cópia de segurança retida, use o comando gcloud sql backups delete:

gcloud sql backups delete BACKUP_NAME

Substitua o seguinte:

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

REST v1

Use este exemplo para eliminar uma cópia de segurança final ou retida. 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 -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID"

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

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

Use este exemplo para eliminar uma cópia de segurança final ou retida. 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 -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID"

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

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