Gerenciar backups finais,Gerenciar backups finais,Gerenciar backups finais,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. Em seguida, você pode restaurar o backup final para uma instância nova ou existente. Dessa forma, você pode recriar quaisquer instâncias excluídas acidentalmente ou usá-las para cenários de recuperação de desastres.

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

Você pode usar os comandos CLI do gcloud existentes para listar, descrever, atualizar e excluir um backup final. Se estiver usando funções personalizadas, adicione as seguintes permissões às funções:

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

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

Permissões necessárias

Google Cloud console

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

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

gcloud CLI

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

Ação Comando Permissões necessárias
Listar backups finais gcloud sql backups list cloudsql.backupRuns.list
Descreva 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

DESCANSAR

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

Ação Método Permissões necessárias
Listar backups finais Backups.ListBackups cloudsql.backupRuns.list
Descreva um backup final Backups.GetBackup cloudsql.backupRuns.get
Atualizar um backup final Backups.UpdateBackup cloudsql.backupRuns.update
Excluir um backup final Backups.DeleteBackup cloudsql.backupRuns.delete

Ver uma lista de backups finais

Você pode visualizar uma lista de backups finais e detalhes sobre um backup usando o Google Cloud console, gcloud CLI ou a API do Cloud SQL.

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

Console

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

    Acesse Backups do Cloud SQL

    Esta página lista todos os backups, incluindo backups finais, que estão associados a um Google Cloud projeto.

  2. Para visualizar detalhes sobre um backup final, clique no backup. Uma caixa de diálogo de backup final será exibida. Esta caixa de diálogo exibe 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 registro de data e hora de quanto tempo o Cloud SQL retém o backup final
    • Uma descrição do backup final

gcloud

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

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

    gcloud sql backups describe \
    BACKUP_NAME

    Você 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

Obtenha uma lista de backups finais

Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .

Antes de usar qualquer um dos dados solicitados, 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Ver detalhes sobre um backup final

Use este exemplo para visualizar os detalhes de um backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.GetBackup .

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Obtenha uma lista de backups finais

Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .

Antes de usar qualquer um dos dados solicitados, 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Ver detalhes sobre um backup final

Use este exemplo para visualizar os detalhes de um backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.GetBackup .

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Atualizar um backup final

Você pode atualizar por quanto tempo o Cloud SQL retém um backup final para uma instância e a descrição do backup usando o Google Cloud console, gcloud CLI ou a API do Cloud SQL.

Console

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

    Acesse Backups do Cloud SQL

    Esta página lista todos os backups, incluindo backups finais, que estão associados a um Google Cloud projeto.

  2. Para atualizar um backup final, clique no backup. Uma caixa de diálogo de backup final será exibida.
  3. Para atualizar por quanto tempo o Cloud SQL retém o backup final, conclua as seguintes ações:
    1. Clique no ícone Editar retenção ao lado do campo Backup retido 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ê retornará à página Backups do Cloud SQL .
  4. Para atualizar a descrição do backup final, conclua as seguintes ações:
    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 para o backup final.
    4. Clique em Atualizar . Você retornará à página Backups do Cloud SQL .

gcloud

  1. Para obter uma lista de todos os backups finais associados a um Google Cloud projeto, 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ê 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 os sinalizadores --expiry-time e --ttl-days , use as seguintes diretrizes:

    • Para o sinalizador --expiry-time , especifique um registro de data e hora de quando o Cloud SQL excluirá o backup final automaticamente.
    • Para o sinalizador --ttl-days , especifique o período de retenção do backup final (de 1 a 365 dias). Isso é conhecido como tempo de vida (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

Obtenha uma lista de backups finais

Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .

Antes de usar qualquer um dos dados solicitados, 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Atualizar o período de retenção

Você pode atualizar o período de retenção de um backup final de uma das seguintes maneiras:

  • Dias de retenção : modifique o número de dias que o Cloud SQL retém o backup.
  • Hora de expiração : forneça um registro de data e hora atualizado 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 que o Cloud SQL retém o backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da 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 tempo de vida (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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Atualizar o tempo de expiração

Use este exemplo para fornecer um registro de data e hora atualizado para quando o Cloud SQL excluir o backup. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
  • DATE_AND_TIME_STAMP : um registro de data e 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Atualizar a descrição

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

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
  • DESCRIPTION : a descrição atualizada para o 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Obtenha uma lista de backups finais

Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .

Antes de usar qualquer um dos dados solicitados, 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Atualizar o período de retenção

Você pode atualizar o período de retenção de um backup final de uma das seguintes maneiras:

  • Dias de retenção : modifique o número de dias que o Cloud SQL retém o backup
  • Hora de expiração : forneça um registro de data e hora atualizado 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 que o Cloud SQL retém o backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da 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 tempo de vida (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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Atualizar o tempo de expiração

Use este exemplo para fornecer um registro de data e hora atualizado para quando o Cloud SQL excluir o backup. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.UpdateBackup .

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
  • DATE_AND_TIME_STAMP : um registro de data e 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Atualizar a descrição

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

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da saída da execução da chamada anterior.
  • DESCRIPTION : a descrição atualizada para o 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Excluir um backup final

Você pode excluir um backup final usando o Google Cloud console, gcloud CLI ou a API do Cloud SQL.

Excluir um backup pode não liberar tanto espaço quanto o tamanho do backup. Isso ocorre porque os backups são incrementais, portanto, excluir um backup mais antigo pode transferir parte do seu conteúdo para um backup mais recente, preservando a integridade do backup mais recente.

Console

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

    Acesse Backups do Cloud SQL

    Esta página lista todos os backups, incluindo backups finais, que estão associados a um Google Cloud projeto.

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

gcloud

  1. Para obter uma lista de todos os backups finais associados a um Google Cloud projeto, 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ê 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

Obtenha uma lista de backups finais

Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .

Antes de usar qualquer um dos dados solicitados, 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Excluir um backup final

Use este exemplo para excluir um backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.DeleteBackup .

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

REST v1beta4

Obtenha uma lista de backups finais

Use este exemplo para obter uma lista de todos os backups finais associados a um Google Cloud projeto. Para uma lista completa de parâmetros para esta chamada, consulte a página Backups.ListBackups .

Antes de usar qualquer um dos dados solicitados, 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

Excluir um backup final

Use este exemplo para excluir um backup final. Para obter uma lista completa de parâmetros para esta chamada, consulte a página Backups.DeleteBackup .

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

  • PROJECT_ID : o ID do projeto.
  • BACKUP_ID : o ID do backup. Você obtém esse ID a partir da 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 sua solicitação, expanda uma destas opções:

Você deve receber uma resposta JSON semelhante à seguinte:

O que vem a seguir