Gerenciar backups de instâncias excluídas

É possível gerenciar backups após a exclusão de uma instância se você tiver escolhido reter backups após a exclusão da instância ou feito um backup final antes de excluir a instância. Os backups retidos incluem backups automatizados e sob demanda que foram feitos quando a instância estava ativa. Quando você exclui a instância, esses backups se tornam independentes dela e são armazenados no nível do projeto. Para mais informações sobre como os backups funcionam e quais backups são retidos, consulte Visão geral dos backups do Cloud SQL.

É possível usar esses backups para restaurar uma instância depois que ela for excluída.

Antes de começar

Para gerenciar backups retidos em um projeto Cloud de Confiance , você precisa das seguintes permissões:

Console

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

gcloud

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

REST

Ação Método Permissões necessárias
Listar backups backups.listBackup cloudsql.backupRuns.list
Descrever um backup backups.getBackup cloudsql.backupRuns.get
Atualizar um backup backups.updateBackup cloudsql.backupRuns.update
Excluir um backup backups.deleteBackup cloudsql.backupRuns.delete

Listar todos os backups de uma instância excluída

É possível conferir uma lista de todos os backups finais e retidos de uma instância excluída no projeto do console Cloud de Confiance . Os backups incluem detalhes como o nome do backup, a instância a que ele pertencia, o tipo de backup e a hora em que a instância foi excluída. Como o nome de uma instância excluída pode ser reutilizado após a exclusão, recomendamos usar o campo instance deletion time para diferenciar a qual instância um backup específico pertence. Para uma instância ativa, esse campo fica em branco.

Console

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

    Acessar "Backups do Cloud SQL"

  2. Selecione a opção de backup da instância: nível padrão ou nível aprimorado.

  3. Clique em Filtrar, depois em Status da instância e selecione Instância excluída.

    Esta página lista todas as instâncias excluídas no projeto do consoleCloud de Confiance .

  4. Clique no nome da instância excluída para conferir os backups.

    Esta página lista todos os backups automed e sob demanda retidos, além do backup final, se disponível, da instância excluída.

gcloud

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

    gcloud sql backups list
--project=PROJECT_ID

    Substitua:

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

  2. Para ver detalhes sobre um backup retido específico, use o comando gcloud sql backups describe:

    gcloud sql backups describe BACKUP_NAME
--project=PROJECT_ID

    Substitua:

    • BACKUP_NAME: o nome do backup retido.
    • PROJECT_ID: o ID do seu projeto Cloud de Confiance .

REST v1

Receber uma lista de todos os backups

Use este exemplo para receber uma lista de todos os backups finais e retidos associados a um projeto Cloud de Confiance . Para uma lista completa de parâmetros dessa chamada, consulte a página backups.listBackups.

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

  • PROJECT_ID: o ID do projeto;

Método HTTP e URL: 

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

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

Você receberá uma resposta JSON semelhante a esta:

Ver detalhes de um backup

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

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

Receber uma lista de todos os backups retidos

Use este exemplo para receber uma lista de todos os backups finais e retidos associados ao Cloud de Confiance project. Para uma lista completa de parâmetros dessa chamada, consulte a página backups.listBackups.

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

  • PROJECT_ID: o ID do projeto;

Método HTTP e URL: 

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

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

Você receberá uma resposta JSON semelhante a esta:

Ver detalhes de um backup retido

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

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 retido ou final após a exclusão da instância

Depois de excluir uma instância, é possível atualizar as configurações de todos os backups finais ou retidos associados a ela e armazenados no nível do projeto. Dependendo do tipo de backup, os detalhes que você pode atualizar podem ser diferentes.

É possível atualizar a descrição e as configurações de retenção de um backup final feito antes de excluir a instância. No entanto, para backups sob demanda ou automatizados que são mantidos após a exclusão da instância, só é possível atualizar a descrição deles. Para backups retidos, as configurações de retenção são definidas com base nas configurações de retenção dos backups quando a instância estava ativa. Para mais informações, consulte Reter backups após a exclusão da instância.

Atualizar um backup final

É possível atualizar as configurações de retenção e a descrição de um backup final feito antes da exclusão de uma instância. Para atualizar o backup, faça o seguinte:

Console

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

    Acessar "Backups do Cloud SQL"

  2. Clique no nome da instância excluída para conferir os backups.

    Você vai ver uma lista de todos os backups finais e retidos, além dos detalhes da instância excluída.

  3. No último backup que você quer atualizar, clique em Mais ações Ícone mais ações. e faça o seguinte:

    • Se quiser editar a descrição do backup final, clique em Editar descrição.

      Insira a descrição no campo Descreva este backup e clique em Atualizar.

    • Se quiser editar o período de armazenamento do backup final, clique em Editar período de retenção.

      Selecione a data no campo Manter backup até. O período de retenção pode variar de 1 a 365 dias após a exclusão da instância. Depois de selecionar a data até quando o backup será mantido, clique em Atualizar.

gcloud

Você vai precisar do backup-name do backup final que quer atualizar. Para receber o backup-name, consulte Listar backups de uma instância excluída.

Para atualizar o período de armazenamento ou a descrição de um backup final, use o comando gcloud sql backups patch e especifique expiry-time ou ttl-days para o backup:

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

Substitua:

  • BACKUP_NAME: o nome do backup final.
  • BACKUP_DESCRIPTION: a nova descrição que você quer adicionar ao backup final.

  • Opções:

    • EXPIRY_TIME: a nova data e hora em que você quer que o backup final seja excluído. O período máximo é de 365 dias após a exclusão da instância.
    • TTL_DAYS: o número de dias que você quer manter o backup final. Esse período pode variar de 1 a 365 dias, sendo o padrão de 30 dias.

REST v1

Você vai precisar do backup-name do backup final que quer atualizar. Para receber o backup-name, consulte Listar backups de uma instância excluída.

É possível atualizar a descrição e as configurações de retenção do backup final. A configuração de retenção pode ser atualizada usando um dos seguintes métodos:

  • Atualizar os dias de retenção do backup final
  • Atualizar o prazo de validade do backup final

Atualizar o período de armazenamento usando os dias de retenção

Use este exemplo para atualizar a configuração de retenção do backup final usando o parâmetro de dias de retenção:

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 armazenamento do backup final (de 1 a 365 dias). Isso é conhecido como tempo de vida (TTL). O período de armazenamento começa na data e hora atuais, e o período de armazenamento máximo permitido pelo Cloud SQL é de um 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ê vai receber uma resposta JSON semelhante a esta:

Atualizar o período de armazenamento usando o prazo de validade

Use este exemplo para atualizar a configuração de retenção do backup final usando o parâmetro de tempo de expiração:

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 e hora de quando o Cloud SQL exclui automaticamente o backup final.

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ê vai 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 backups.updateBackup.

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ê vai receber uma resposta JSON semelhante a esta:

REST v1beta4

Você vai precisar do backup-name do backup final que quer atualizar. Para receber o backup-name, consulte Listar backups de uma instância excluída.

É possível atualizar a descrição e as configurações de retenção do backup final. A configuração de retenção pode ser atualizada usando um dos seguintes métodos:

  • Atualizar os dias de retenção do backup final
  • Atualizar o prazo de validade do backup final

Atualizar o período de armazenamento usando os dias de retenção

Use este exemplo para atualizar a configuração de retenção do backup final usando o parâmetro de dias de retenção:

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 armazenamento do backup final (de 1 a 365 dias). Isso é conhecido como tempo de vida (TTL). O período de armazenamento começa na data e hora atuais, e o período de armazenamento máximo permitido pelo Cloud SQL é de um 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ê vai receber uma resposta JSON semelhante a esta:

Atualizar o período de armazenamento usando o prazo de validade

Use este exemplo para atualizar a configuração de retenção do backup final usando o parâmetro de tempo de expiração:

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 e hora de quando o Cloud SQL exclui automaticamente o backup final.

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ê vai 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 backups.updateBackup.

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ê vai receber uma resposta JSON semelhante a esta:

Atualizar um backup retido

É possível atualizar a descrição dos backups automatizados e sob demanda retidos. Para atualizar o backup, faça o seguinte:

Console

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

    Acessar "Backups do Cloud SQL"

  2. Clique no nome da instância excluída para conferir os backups.

    Você vai ver uma lista de todos os backups finais e retidos, além dos detalhes da instância excluída.

  3. No backup retido que você quer atualizar, clique em mais ações Ícone mais ações. e selecione Editar descrição.

  4. Na janela Editar descrição do backup, atualize a descrição do backup.

  5. Clique em Atualizar.

gcloud

Para atualizar a descrição do backup retido, use o comando gcloud sql backups patch:

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION

Substitua:

  • BACKUP_NAME: o nome do backup retido.
  • BACKUP_DESCRIPTION: a nova descrição que você quer adicionar ao backup retido.

REST v1

Receber uma lista de todos os backups retidos

Use este exemplo para receber uma lista de todos os backups retidos associados a um projetoCloud de Confiance . Para uma lista completa de parâmetros dessa chamada, consulte a página backups.listBackups.

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

  • PROJECT_ID: o ID do projeto;

Método HTTP e URL: 

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

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 retido. Para uma lista completa de parâmetros dessa chamada, consulte a página backups.updateBackup.

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ê vai receber uma resposta JSON semelhante a esta:

REST v1beta4

Receber uma lista de todos os backups retidos

Use este exemplo para receber uma lista de todos os backups retidos associados a um projetoCloud de Confiance . Para uma lista completa de parâmetros dessa chamada, consulte a página backups.listBackups.

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

  • PROJECT_ID: o ID do projeto;

Método HTTP e URL: 

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

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 retido. Para uma lista completa de parâmetros dessa chamada, consulte a página backups.updateBackup.

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ê vai receber uma resposta JSON semelhante a esta:

Excluir um backup associado a uma instância excluída

É possível excluir um backup final ou retido sob demanda e automatizado de uma instância excluída a qualquer momento.

Console

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

    Acessar "Backups do Cloud SQL"

  2. Clique no nome da instância excluída para conferir os backups.

    Você vai ver uma lista de todos os backups finais e retidos, além dos detalhes da instância excluída.

  3. No backup que você quer excluir, clique em Mais ações Ícone mais ações. e selecione Excluir.

  4. Na janela Excluir backup, insira o nome da instância excluída e clique em Excluir.

gcloud

Para excluir um backup retido, use o comando gcloud sql backups delete:

gcloud sql backups delete BACKUP_NAME

Substitua:

  • BACKUP_NAME: o nome do backup retido.

REST v1

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

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

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

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