Gerenciar backups finais

Esta página descreve como gerenciar backups finais para sua instância do Cloud SQL. Antes de excluir uma instância, você pode fazer um backup final dela. Depois, é possível restaurar o backup final em uma instância nova ou atual. Assim, você pode recriar instâncias excluídas acidentalmente ou usá-las em cenários de recuperação de desastres.

Ao contrário dos backups automáticos e sob demanda, que são associados a uma instância, você pode fazer um backup final antes de excluir a instância. O Cloud SQL armazena esse backup além da vida útil da instância.

É possível usar os comandos da CLI gcloud para listar, descrever, atualizar e excluir um backup final. Se você estiver usando papéis personalizados, adicione as seguintes permissões a eles:

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

Para mais informações sobre essas permissões, consulte Permissões necessárias. Para mais informações sobre como os backups funcionam, consulte Sobre os backups do Cloud SQL.

Permissões necessárias

Console do Google Cloud

Para gerenciar backups finais em um projeto do Google Cloud, você precisa das seguintes permissões:

Tarefa Permissões necessárias
Listar backups finais cloudsql.backupRuns.list
Descrever um backup final cloudsql.backupRuns.get
Atualizar um backup final cloudsql.backupRuns.update
Excluir um backup final cloudsql.backupRuns.delete

CLI gcloud

Para gerenciar backups finais em um projeto do Google Cloud, você precisa das seguintes permissões:

Ação Comando Permissões necessárias
Listar backups finais gcloud sql backups list cloudsql.backupRuns.list
Descrever um backup final gcloud sql backups describe cloudsql.backupRuns.get
Atualizar um backup final gcloud sql backups patch cloudsql.backupRuns.update
Excluir um backup final gcloud sql backups delete cloudsql.backupRuns.delete

REST

Para gerenciar backups finais em um projeto do Google Cloud, você precisa das seguintes permissões:

Ação Método Permissões necessárias
Listar backups finais backups.list cloudsql.backupRuns.list
Descrever um backup final backups.describe cloudsql.backupRuns.get
Atualizar um backup final backups.patch cloudsql.backupRuns.update
Excluir um backup final backups.delete cloudsql.backupRuns.delete

Conferir uma lista de backups finais

Para conferir uma lista de backups finais e detalhes sobre um backup, use o console do Google Cloud, a gcloud CLI ou a API Cloud SQL.

O console do Google Cloud não exibe backups ignorados ou com falha no histórico de backup. Para conferir esses tipos de backup, use gcloud ou a API Cloud SQL.

Console

  1. No console do Google Cloud, acesse a página Backups do Cloud SQL.

    Acessar os backups do Cloud SQL

    Esta página lista todos os backups, incluindo os finais, associados a um projeto do Google Cloud.

  2. Para conferir os detalhes de um backup final, clique nele. A caixa de diálogo Backup final vai aparecer. Essa caixa de diálogo mostra as seguintes informações:

    • A data e a hora em que a instância, usada para criar o backup final, foi excluída
    • O nome e a versão da instância excluída
    • Um carimbo de data/hora de quanto tempo o Cloud SQL retém o backup final
    • Uma descrição do backup final

gcloud

  1. Para conferir uma lista de todos os backups finais associados a um projeto do Google Cloud, use o comando gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Para conferir detalhes sobre um backup final, use o comando gcloud sql backups describe:

    gcloud sql backups describe \
    BACKUP_NAME

    Você vai receber o BACKUP_NAME 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

Conferir uma lista de backups finais

Use este exemplo para conferir uma lista de todos os backups finais associados a um projeto do Google Cloud. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

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

Você receberá uma resposta JSON semelhante a esta:

Conferir detalhes sobre um backup final

Use este exemplo para conferir os detalhes de um backup final. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.get.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída 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 a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

REST v1beta4

Conferir uma lista de backups finais

Use este exemplo para receber uma lista de todos os backups finais associados a um projeto do Google Cloud. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

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

Você receberá uma resposta JSON semelhante a esta:

Conferir detalhes sobre um backup final

Use este exemplo para conferir os detalhes de um backup final. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.get.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída 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 a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

Atualizar um backup final

É possível atualizar por quanto tempo o Cloud SQL retém um backup final de uma instância e a descrição do backup usando o console do Google Cloud, a gcloud CLI ou a API Cloud SQL.

Console

  1. No console do Google Cloud, acesse a página Backups do Cloud SQL.

    Acessar os backups do Cloud SQL

    Esta página lista todos os backups, incluindo os finais, associados a um projeto do Google Cloud.

  2. Para atualizar um backup final, clique nele. A caixa de diálogo Backup final vai aparecer.
  3. Para atualizar o período de retenção do backup final do Cloud SQL, siga estas etapas:
    1. Clique no ícone Editar retenção ao lado do campo Backup mantido até.
    2. Clique no ícone Selecionar data ao lado do campo Manter backup até.
    3. No calendário, selecione a nova data que indica por quanto tempo o Cloud SQL retém o backup final.
    4. Clique em Atualizar. Você volta à página Backups do Cloud SQL.
  4. Para atualizar a descrição do backup final, faça o seguinte:
    1. Clique no backup final.
    2. Clique no ícone Editar descrição ao lado do campo Descrição.
    3. No campo Descreva este backup, insira a descrição atualizada do backup final.
    4. Clique em Atualizar. Você volta à página Backups do Cloud SQL.

gcloud

  1. Para conferir uma lista de todos os backups finais associados a um projeto do Google Cloud, use o comando gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Para atualizar a descrição e o período de retenção de um backup final, use o comando gcloud sql backups patch:

    gcloud sql backups patch \
    BACKUP_NAME  \
    --description=DESCRIPTION /
    --expiry-time=DATE-AND-TIME-STAMP | --ttl-days=NUMBER-OF-DAYS

    Você vai receber o BACKUP_NAME 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 estas diretrizes:

    • Para a flag --expiry-time, especifique um carimbo de data/hora de quando o Cloud SQL exclui o backup final automaticamente.
    • Para a flag --ttl-days, especifique o período de retenção do backup final (de 1 a 365 dias). Isso é conhecido como time to live (TTL). O período de retenção começa na data e hora atuais, e o período máximo de retenção permitido pelo Cloud SQL é de 1 ano (ou 365 dias).

REST v1

Conferir uma lista de backups finais

Use este exemplo para conferir uma lista de todos os backups finais associados a um projeto do Google Cloud. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

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

Você receberá uma resposta JSON semelhante a esta:

Atualizar o período de retenção

É possível atualizar o período de armazenamento de um backup final de uma das seguintes maneiras:

  • Dias de retenção: modifique o número de dias em que o Cloud SQL retém o backup.
  • Tempo de expiração: forneça uma marcação de data e hora atualizada para quando o Cloud SQL excluir o backup automaticamente.
Atualizar os dias de retenção

Use este exemplo para atualizar o número de dias em que o Cloud SQL retém o backup final. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.update.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída da execução da chamada anterior.
  • TTL_DAYS: o período de retenção do backup final (de 1 a 365 dias). Isso é conhecido como time to live (TTL). O período de retenção começa na data e hora atuais, e o período máximo de retenção 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 da solicitação:

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

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

Você receberá uma resposta JSON semelhante a esta:

Atualizar o prazo de validade

Use este exemplo para fornecer um carimbo de data/hora atualizado para quando o Cloud SQL excluir o backup. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.update.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída da execução da chamada anterior.
  • DATE_AND_TIME_STAMP: um carimbo de data/hora de quando o Cloud SQL exclui o backup final automaticamente.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

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

Você receberá uma resposta JSON semelhante a esta:

Atualizar a descrição

Use este exemplo para atualizar a descrição do backup final. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.update.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída da execução da chamada anterior.
  • DESCRIPTION: a descrição atualizada do backup final.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

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

Você receberá uma resposta JSON semelhante a esta:

REST v1beta4

Conferir uma lista de backups finais

Use este exemplo para receber uma lista de todos os backups finais associados a um projeto do Google Cloud. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

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

Você receberá uma resposta JSON semelhante a esta:

Atualizar o período de retenção

É possível atualizar o período de armazenamento de um backup final de uma das seguintes maneiras:

  • Dias de retenção: modifique o número de dias em que o Cloud SQL retém o backup.
  • Tempo de expiração: forneça uma marcação de data e hora atualizada para quando o Cloud SQL excluir o backup automaticamente.
Atualizar os dias de retenção

Use este exemplo para atualizar o número de dias em que o Cloud SQL retém o backup final. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.update.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída da execução da chamada anterior.
  • TTL_DAYS: o período de retenção do backup final (de 1 a 365 dias). Isso é conhecido como time to live (TTL). O período de retenção começa na data e hora atuais, e o período máximo de retenção 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 da solicitação:

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

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

Você receberá uma resposta JSON semelhante a esta:

Atualizar o prazo de validade

Use este exemplo para fornecer um carimbo de data/hora atualizado para quando o Cloud SQL excluir o backup. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.update.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída da execução da chamada anterior.
  • DATE_AND_TIME_STAMP: um carimbo de data/hora de quando o Cloud SQL exclui o backup final automaticamente.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

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

Você receberá uma resposta JSON semelhante a esta:

Atualizar a descrição

Use este exemplo para atualizar a descrição do backup final. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.update.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída da execução da chamada anterior.
  • DESCRIPTION: a descrição atualizada do backup final.

Método HTTP e URL:

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

Corpo JSON da solicitação:

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

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

Você receberá uma resposta JSON semelhante a esta:

Excluir um backup final

É possível excluir um backup final usando o console do Google Cloud, a gcloud CLI ou a API Cloud SQL.

A exclusão de um backup pode não liberar um espaço igual ao tamanho do backup. Isso ocorre porque os backups são incrementais. Portanto, a exclusão de um backup anterior pode transferir uma parte do conteúdo para um backup mais recente a fim de preservar a integridade do novo backup.

Console

  1. No console do Google Cloud, acesse a página Backups do Cloud SQL.

    Acessar os backups do Cloud SQL

    Esta página lista todos os backups, incluindo os finais, associados a um projeto do Google Cloud.

  2. No backup final que você quer excluir, clique em "Mais ações" Ícone mais ações. e selecione Excluir.
  3. Na janela Excluir o backup final?, insira o nome da instância usada para criar o backup final e clique em Excluir.

gcloud

  1. Para conferir uma lista de todos os backups finais associados a um projeto do Google Cloud, use o comando gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Para excluir um backup final, use o comando gcloud sql backups delete:

    gcloud sql backups delete \
    BACKUP_NAME

    Você vai receber o BACKUP_NAME 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

Conferir uma lista de backups finais

Use este exemplo para conferir uma lista de todos os backups finais associados a um projeto do Google Cloud. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL:

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL

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

Você receberá uma resposta JSON semelhante a esta:

Excluir um backup final

Use este exemplo para excluir um backup final. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.delete.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída 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 a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

REST v1beta4

Conferir uma lista de backups finais

Use este exemplo para receber uma lista de todos os backups finais associados a um projeto do Google Cloud. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.list.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

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

Método HTTP e URL:

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL

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

Você receberá uma resposta JSON semelhante a esta:

Excluir um backup final

Use este exemplo para excluir um backup final. Para uma lista completa de parâmetros dessa chamada, consulte a página backupRuns.delete.

Antes de usar os dados da solicitação abaixo, faça as substituições a seguir:

  • PROJECT_ID: o ID do projeto;
  • BACKUP_ID: o ID do backup. Você recebe esse ID na saída 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 a solicitação, expanda uma destas opções:

Você receberá uma resposta JSON semelhante a esta:

A seguir