Gestire i backup conservati

Questa pagina descrive come attivare, disattivare e gestire i backup conservati per le tue istanze Cloud SQL.

I backup conservati sono quelli che vengono conservati dopo l'eliminazione di un'istanza. Questi backup includono i backup automatici e on demand creati quando un'istanza era attiva. Per ulteriori informazioni sul funzionamento dei backup conservati, consulta Backup conservati.

Puoi attivare i backup conservati in qualsiasi momento per un'istanza modificando l'istanza. Puoi anche ripristinare un backup mantenuto in un'istanza nuova o esistente.

Prima di iniziare

Per gestire i backup conservati in un progetto Google Cloud, devi disporre delle seguenti autorizzazioni:

Attività Autorizzazioni obbligatorie
Elenco dei backup cloudsql.backupRuns.list
Descrivere un backup cloudsql.backupRuns.get
Aggiornare un backup cloudsql.backupRuns.update
Eliminare un backup cloudsql.backupRuns.delete

Interfaccia a riga di comando gcloud

Per gestire i backup conservati in un progetto Google Cloud, devi disporre delle seguenti autorizzazioni:

Azione Comando Autorizzazioni obbligatorie
Elenco dei backup gcloud sql backups list cloudsql.backupRuns.list
Descrivere un backup gcloud sql backups describe cloudsql.backupRuns.get
Aggiornare un backup gcloud sql backups patch cloudsql.backupRuns.update
Eliminare un backup gcloud sql backups delete cloudsql.backupRuns.delete

REST

Per gestire i backup conservati in un progetto Google Cloud, devi disporre delle seguenti autorizzazioni:

Azione Metodo Autorizzazioni obbligatorie
Elenco dei backup backups.listBackup cloudsql.backupRuns.list
Descrivere un backup backups.getBackup cloudsql.backupRuns.get
Aggiornare un backup backups.updateBackup cloudsql.backupRuns.update
Eliminare un backup backups.deleteBackup cloudsql.backupRuns.delete

Attivare i backup conservati per un'istanza

Puoi attivare i backup conservati nelle opzioni di configurazione della Protezione dei dati per un'istanza quando crei un'istanza o modifichi un'istanza esistente.

Visualizza un elenco di tutti i backup conservati

Puoi visualizzare un elenco di tutti i backup conservati per il tuo progetto Google Cloud utilizzando la console Google Cloud, gcloud CLI o l'API Cloud SQL. I backup includeranno dettagli quali il nome del backup, l'istanza a cui appartiene, il tipo di backup e l'ora dell'eliminazione dell'istanza. Poiché il nome di un'istanza eliminata può essere riutilizzato, ti consigliamo di utilizzare il campo instance deletion time per distinguere a quale istanza appartiene un determinato backup. Per un'istanza attiva, questo campo è vuoto.

Console

  1. Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.

    Vai a Backup Cloud SQL

  2. Fai clic sul nome dell'istanza eliminata di cui vuoi visualizzare i backup.

    Vedrai un elenco di tutti i backup conservati e finali e i relativi dettagli per l'istanza eliminata.

gcloud

  1. Per ottenere un elenco di tutti i backup associati a un progetto Google Cloud, utilizza il comando gcloud sql backups list:

    gcloud sql backups list
    --project=PROJECT_ID
    

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del tuo progetto Google Cloud.
  2. Per visualizzare i dettagli di un backup conservato specifico, utilizza il comando gcloud sql backups describe:

    gcloud sql backups describe BACKUP_NAME
    --project=PROJECT_ID
    

    Sostituisci quanto segue:

    • BACKUP_NAME: il nome del backup conservato.
    • PROJECT_ID: l'ID del tuo progetto Google Cloud.

REST v1

Ottenere un elenco di tutti i backup conservati

Utilizza questo esempio per ottenere un elenco di tutti i backup conservati associati a un progetto Google Cloud. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.listBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizzare i dettagli di un backup mantenuto

Utilizza questo esempio per visualizzare i dettagli di un backup mantenuto. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backup.getBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • BACKUP_ID: l'ID backup. Puoi ottenere questo ID dall'output dell'esecuzione della chiamata precedente.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Ottenere un elenco di tutti i backup conservati

Utilizza questo esempio per ottenere un elenco di tutti i backup conservati associati a un progetto Google Cloud. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.listBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizzare i dettagli di un backup mantenuto

Utilizza questo esempio per visualizzare i dettagli di un backup mantenuto. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.getBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • BACKUP_ID: l'ID backup. Puoi ottenere questo ID dall'output dell'esecuzione della chiamata precedente.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiornare la descrizione di un backup mantenuto

Puoi aggiornare la descrizione di un backup mantenuto in qualsiasi momento per identificare più facilmente i backup.

Console

  1. Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.

    Vai a Backup Cloud SQL

  2. Fai clic sul nome dell'istanza eliminata di cui vuoi visualizzare i backup.

    Vedrai un elenco di tutti i backup conservati e finali e i relativi dettagli per l'istanza eliminata.

  3. Per il backup conservato che vuoi aggiornare, fai clic su Altre azioni Icona Altre azioni. e poi seleziona Modifica descrizione.

  4. Nella finestra Modifica descrizione del backup, aggiorna la descrizione del backup.

  5. Fai clic su Aggiorna.

gcloud

Per aggiornare la descrizione del backup conservato, utilizza il comando gcloud sql backups patch:

gcloud sql backups patch BACKUP_NAME
--description=BACKUP_DESCRIPTION

Sostituisci quanto segue:

  • BACKUP_NAME: il nome del backup conservato.
  • BACKUP_DESCRIPTION: la nuova descrizione da aggiungere al backup conservato.

REST v1

Ottenere un elenco di tutti i backup conservati

Utilizza questo esempio per ottenere un elenco di tutti i backup conservati associati a un progetto Google Cloud. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.listBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiornare la descrizione

Utilizza questo esempio per aggiornare la descrizione del backup mantenuto. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.updateBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • BACKUP_ID: l'ID backup. Puoi ottenere questo ID dall'output dell'esecuzione della chiamata precedente.
  • DESCRIPTION: la descrizione aggiornata del backup finale.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Ottenere un elenco di tutti i backup conservati

Utilizza questo esempio per ottenere un elenco di tutti i backup conservati associati a un progetto Google Cloud. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.listBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiornare la descrizione

Utilizza questo esempio per aggiornare la descrizione del backup mantenuto. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.updateBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • BACKUP_ID: l'ID backup. Puoi ottenere questo ID dall'output dell'esecuzione della chiamata precedente.
  • DESCRIPTION: la descrizione aggiornata del backup finale.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Eliminare un backup mantenuto

Puoi eliminare un backup conservato utilizzando la console Google Cloud, gcloud CLI o l'API Cloud SQL.

Console

  1. Nella console Google Cloud, vai alla pagina Backup di Cloud SQL.

    Vai a Backup Cloud SQL

  2. Fai clic sul nome dell'istanza eliminata di cui vuoi visualizzare i backup.

    Vedrai un elenco di tutti i backup conservati e finali e i relativi dettagli per l'istanza eliminata.

  3. Per il backup conservato che vuoi eliminare, fai clic su Altre azioni Icona Altre azioni., quindi seleziona Elimina.

  4. Nella finestra Elimina backup, inserisci il nome dell'istanza eliminata e fai clic su Elimina.

gcloud

Per eliminare un backup conservato, utilizza il comando gcloud sql backups delete:

gcloud sql backups delete BACKUP_NAME

Sostituisci quanto segue:

  • BACKUP_NAME: il nome del backup conservato.

REST v1

Ottenere un elenco di tutti i backup conservati

Utilizza questo esempio per ottenere un elenco di tutti i backup conservati associati a un progetto Google Cloud. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.listBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Eliminare un backup mantenuto

Utilizza questo esempio per eliminare un backup mantenuto. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.deleteBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • BACKUP_ID: l'ID backup. Puoi ottenere questo ID dall'output dell'esecuzione della chiamata precedente.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Ottenere un elenco di tutti i backup conservati

Utilizza questo esempio per ottenere un elenco di tutti i backup conservati associati a un progetto Google Cloud. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.listBackups.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Eliminare un backup mantenuto

Utilizza questo esempio per eliminare un backup mantenuto. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backups.deleteBackup.

Prima di utilizzare i dati della richiesta, apporta le seguenti sostituzioni:

  • PROJECT_ID: l'ID progetto.
  • BACKUP_ID: l'ID backup. Puoi ottenere questo ID dall'output dell'esecuzione della chiamata precedente.

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Passaggi successivi