Gestire i backup finali

Questa pagina descrive come gestire i backup finali per la tua istanza Cloud SQL. Prima di eliminare un'istanza, puoi eseguire un backup finale dell'istanza. A questo punto, puoi ripristinare il backup finale in un'istanza nuova o esistente. In questo modo, puoi ricreare le istanze eliminate per errore o utilizzarle per qualsiasi scenario di ripristino di emergenza.

A differenza dei backup automatici e on demand, associati a un'istanza, puoi eseguire un backup finale prima di eliminare l'istanza. Cloud SQL archivia questo backup oltre il ciclo di vita dell'istanza.

Puoi utilizzare i comandi gcloud CLI esistenti per elencare, descrivere, aggiornare ed eliminare un backup finale. Se utilizzi ruoli personalizzati, aggiungi le seguenti autorizzazioni ai ruoli:

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

Per ulteriori informazioni su queste autorizzazioni, vedi Autorizzazioni richieste. Inoltre, per ulteriori informazioni sul funzionamento dei backup, consulta Informazioni sui backup di Cloud SQL.

Autorizzazioni obbligatorie

Console Google Cloud

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

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

Interfaccia a riga di comando gcloud

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

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

REST

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

Azione Metodo Autorizzazioni obbligatorie
Elenco dei backup finali backups.list cloudsql.backupRuns.list
Descrivi un backup finale backups.describe cloudsql.backupRuns.get
Aggiornare un backup finale backups.patch cloudsql.backupRuns.update
Eliminare un backup finale backups.delete cloudsql.backupRuns.delete

Visualizza un elenco di backup finali

Puoi visualizzare un elenco dei backup finali e i dettagli di un backup utilizzando la console Google Cloud, gcloud CLI o l'API Cloud SQL.

La console Google Cloud non mostra i backup saltati o non riusciti nella cronologia dei backup. Per visualizzare questi tipi di backup, utilizza gcloud o l'API Cloud SQL.

Console

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

    Vai a Backup Cloud SQL

    Questa pagina elenca tutti i backup, inclusi i backup finali, associati a un progetto Google Cloud.

  2. Per visualizzare i dettagli di un backup finale, fai clic sul backup. Viene visualizzata la finestra di dialogo Backup finale. Questa finestra di dialogo mostra le seguenti informazioni:

    • La data e l'ora in cui l'istanza utilizzata per creare il backup finale è stata eliminata
    • Il nome e la versione dell'istanza eliminata
    • Un timestamp che indica per quanto tempo Cloud SQL conserva il backup finale
    • Una descrizione del backup finale

gcloud

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

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Per visualizzare i dettagli di un backup finale, utilizza il comando gcloud sql backups describe:

    gcloud sql backups describe \
    BACKUP_NAME

    Puoi ottenere BACKUP_NAME dall'output dell'esecuzione del comando gcloud sql backups list. BACKUP_NAME ha il seguente formato: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Visualizzare un elenco di backup finali

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

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizzare i dettagli di un backup finale

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

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

Visualizzare un elenco di backup finali

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

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizzare i dettagli di un backup finale

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

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 un backup finale

Puoi aggiornare il periodo di conservazione di un backup finale per un'istanza e la descrizione del backup 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

    Questa pagina elenca tutti i backup, inclusi i backup finali, associati a un progetto Google Cloud.

  2. Per aggiornare un backup finale, fai clic sul backup. Viene visualizzata la finestra di dialogo Backup finale.
  3. Per aggiornare il periodo di conservazione del backup finale da parte di Cloud SQL, completa le seguenti azioni:
    1. Fai clic sull'icona Modifica conservazione accanto al campo Backup conservato fino al giorno.
    2. Fai clic sull'icona Seleziona data accanto al campo Mantieni il backup fino a.
    3. Nel calendario, seleziona la nuova data che indica per quanto tempo Cloud SQL conserva il backup finale.
    4. Fai clic su Aggiorna. Torni alla pagina Backup di Cloud SQL.
  4. Per aggiornare la descrizione del backup finale:
    1. Fai clic sul backup finale.
    2. Fai clic sull'icona Modifica descrizione accanto al campo Descrizione.
    3. Nel campo Descrivi questo backup, inserisci la descrizione aggiornata del backup finale.
    4. Fai clic su Aggiorna. Torni alla pagina Backup di Cloud SQL.

gcloud

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

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Per aggiornare la descrizione e il periodo di conservazione di un backup finale, utilizza il comando gcloud sql backups patch:

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

    Puoi ottenere BACKUP_NAME dall'output dell'esecuzione del comando gcloud sql backups list. BACKUP_NAME ha il seguente formato: projects/PROJECT_ID/backups/BACKUP_ID.

    Per i flag --expiry-time e --ttl-days, segui le seguenti linee guida:

    • Per il flag --expiry-time, specifica un timestamp della data e dell'ora in cui Cloud SQL elimina automaticamente il backup finale.
    • Per il flag --ttl-days, specifica il periodo di conservazione del backup finale (da 1 a 365 giorni). Questo valore è noto come TTL (time to live). Il periodo di conservazione inizia dalla data e dall'ora correnti e il periodo di conservazione massimo consentito da Cloud SQL è di 1 anno (o 365 giorni).

REST v1

Visualizzare un elenco di backup finali

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

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiorna il periodo di conservazione

Puoi aggiornare il periodo di conservazione di un backup finale in uno dei seguenti modi:

  • Giorni di conservazione: modifica il numero di giorni per cui Cloud SQL conserva il backup.
  • Data e ora di scadenza: fornisci un timestamp aggiornato della data e dell'ora in cui Cloud SQL elimina automaticamente il backup.
Aggiorna i giorni di conservazione

Utilizza questo esempio per aggiornare il numero di giorni per cui Cloud SQL conserva il backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backupRuns.update.

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.
  • TTL_DAYS: il periodo di conservazione del backup finale (da 1 a 365 giorni). Questo valore è noto come TTL (time to live). Il periodo di conservazione inizia dalla data e dall'ora correnti e il periodo di conservazione massimo consentito da Cloud SQL è di 1 anno (o 365 giorni).

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiorna la data e l'ora di scadenza

Utilizza questo esempio per fornire un timestamp aggiornato della data e dell'ora in cui Cloud SQL elimina il backup. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backupRuns.update.

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.
  • DATE_AND_TIME_STAMP: un timestamp della data e dell'ora in cui Cloud SQL elimina automaticamente il backup finale.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiorna la descrizione

Utilizza questo esempio per aggiornare la descrizione del backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backupRuns.update.

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

Visualizzare un elenco di backup finali

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

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiorna il periodo di conservazione

Puoi aggiornare il periodo di conservazione di un backup finale in uno dei seguenti modi:

  • Giorni di conservazione: modifica il numero di giorni durante i quali Cloud SQL conserva il backup
  • Data e ora di scadenza: fornisci un timestamp aggiornato della data e dell'ora in cui Cloud SQL elimina automaticamente il backup.
Aggiorna i giorni di conservazione

Utilizza questo esempio per aggiornare il numero di giorni per cui Cloud SQL conserva il backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backupRuns.update.

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.
  • TTL_DAYS: il periodo di conservazione del backup finale (da 1 a 365 giorni). Questo valore è noto come TTL (time to live). Il periodo di conservazione inizia dalla data e dall'ora correnti e il periodo di conservazione massimo consentito da Cloud SQL è di 1 anno (o 365 giorni).

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiorna la data e l'ora di scadenza

Utilizza questo esempio per fornire un timestamp aggiornato della data e dell'ora in cui Cloud SQL elimina il backup. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backupRuns.update.

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.
  • DATE_AND_TIME_STAMP: un timestamp della data e dell'ora in cui Cloud SQL elimina automaticamente il backup finale.

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Aggiorna la descrizione

Utilizza questo esempio per aggiornare la descrizione del backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backupRuns.update.

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 finale

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

L'eliminazione di un backup potrebbe non liberare tanto spazio quanto le dimensioni del backup. Questo perché i backup sono incrementali, quindi l'eliminazione di un backup precedente potrebbe trasferire alcuni dei relativi contenuti a un backup più recente per preservarne l'integrità.

Console

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

    Vai a Backup Cloud SQL

    Questa pagina elenca tutti i backup, inclusi quelli finali, associati a un progetto Google Cloud.

  2. Per il backup finale che vuoi eliminare, fai clic su Altre azioni Icona Altre azioni. e poi seleziona Elimina.
  3. Nella finestra Eliminare il backup finale?, inserisci il nome dell'istanza utilizzata per creare il backup finale e fai clic su Elimina.

gcloud

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

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Per eliminare un backup finale, utilizza il comando gcloud sql backups delete:

    gcloud sql backups delete \
    BACKUP_NAME

    Puoi ottenere BACKUP_NAME dall'output dell'esecuzione del comando gcloud sql backups list. BACKUP_NAME ha il seguente formato: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Visualizzare un elenco di backup finali

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

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Eliminare un backup finale

Utilizza questo esempio per eliminare un backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backupRuns.delete.

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

Visualizzare un elenco di backup finali

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

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza

Metodo HTTP e URL:

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

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Eliminare un backup finale

Utilizza questo esempio per eliminare un backup finale. Per un elenco completo dei parametri per questa chiamata, consulta la pagina backupRuns.delete.

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