Gestire i backup standard

I backup standard di Cloud SQL consentono di pianificare backup automatici, creare backup on demand e visualizzare i backup esistenti per l'istanza di database. I backup regolari ti aiutano a proteggere i dati da perdite o danneggiamenti accidentali e supportano il ripristino di emergenza. Se la tua istanza utilizza i backup avanzati, consulta Gestisci i backup avanzati.

Le istanze create prima della disponibilità dell'opzione di backup avanzati utilizzano i backup standard per impostazione predefinita. Per eseguire l'upgrade dell'istanza in modo da utilizzare i backup avanzati, consulta Abilita i backup avanzati. Per saperne di più sul funzionamento dei backup e sulle opzioni di backup disponibili, consulta la panoramica dei backup di Cloud SQL e Scegli l'opzione di backup.

Crea un backup on demand

Per creare un backup on demand:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Seleziona Backup dal menu di navigazione SQL.
  4. Fai clic su Crea backup.
  5. Nella pagina Crea backup, aggiungi una descrizione, se necessario, e fai clic su Crea.

gcloud

Crea il backup:

gcloud sql backups create \
--async \
--instance=INSTANCE_NAME

Puoi fornire una descrizione del backup utilizzando il parametro --description.

Per creare un backup in una posizione personalizzata:

gcloud sql backups create \
--async \
--instance=INSTANCE_NAME \
--location=BACKUP_LOCATION

REST v1

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Configura i backup automatici

I backup automatici vengono eseguiti con una cadenza pianificata mentre l'istanza è in esecuzione. Puoi anche impostare il periodo di conservazione per i backup automatici. Per saperne di più su come funzionano i backup automatici, consulta Backup automatici.

Pianifica i backup automatici

Per pianificare i backup automatici per un'istanza:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Seleziona Backup dal menu di navigazione SQL.
  4. Fai clic su Modifica accanto a Impostazioni.
  5. Scegli un intervallo di tempo per il backup automatico dei tuoi dati.
  6. Fai clic su Salva.

gcloud

  1. Modifica l'istanza per specificare un'ora di inizio del backup: 
    gcloud sql instances patch INSTANCE_NAME --backup-start-time=HH:MM
     Il parametro backup-start-time è specificato in un formato orario di 24 ore, nel fuso orario UTC±00, e indica l'inizio di un periodo di backup di 4 ore. I backup possono iniziare in qualsiasi momento durante la finestra di backup.
  2. Conferma le modifiche: 
    gcloud sql instances describe INSTANCE_NAME
     Nella sezione backupConfiguration, verifica che siano visualizzati enabled: true e l'ora che hai specificato.

Terraform

Per creare un backup per un database, utilizza una risorsa Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-backup"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled    = true
      start_time = "20:55"
    }
  }
}

Applica le modifiche

Per applicare la configurazione Terraform in un progetto Google Cloud , completa i passaggi descritti nelle sezioni seguenti.

Prepara Cloud Shell

  1. Avvia Cloud Shell.

  2. Imposta il progetto Google Cloud predefinito in cui vuoi applicare le configurazioni Terraform.

    Devi eseguire questo comando una sola volta per progetto e puoi eseguirlo in qualsiasi directory.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Le variabili di ambiente vengono sostituite se imposti valori espliciti nel file di configurazione Terraform.

Prepara la directory

Ogni file di configurazione Terraform deve avere la propria directory (chiamata anche modulo principale).

  1. In Cloud Shell, crea una directory e un nuovo file al suo interno. Il nome file deve avere l'estensione .tf, ad esempio main.tf. In questo tutorial, il file è denominato main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Se stai seguendo un tutorial, puoi copiare il codice campione in ogni sezione o passaggio.

    Copia il codice campione nel file main.tf appena creato.

    Facoltativamente, copia il codice da GitHub. Questa opzione è consigliata quando lo snippet Terraform fa parte di una soluzione end-to-end.

  3. Esamina e modifica i parametri di esempio da applicare al tuo ambiente.
  4. Salva le modifiche.
  5. Inizializza Terraform. Devi eseguire questa operazione una sola volta per directory. 
    terraform init

    Facoltativamente, per utilizzare l'ultima versione del provider Google, includi l'opzione -upgrade: 

    terraform init -upgrade

Applica le modifiche

  1. Esamina la configurazione e verifica che le risorse che Terraform creerà o aggiornerà corrispondano alle tue aspettative: 
    terraform plan

    Apporta le correzioni necessarie alla configurazione.

  2. Applica la configurazione Terraform eseguendo il comando seguente e inserendo yes al prompt: 
    terraform apply

    Attendi che Terraform visualizzi il messaggio "Apply complete!".

  3. Apri il tuo progetto Google Cloud per visualizzare i risultati. Nella console Google Cloud , vai alle risorse nell'interfaccia utente per assicurarti che Terraform le abbia create o aggiornate.

Elimina le modifiche

Per eliminare le modifiche:

  1. Per disattivare la protezione da eliminazione, imposta l'argomento deletion_protection su false nel file di configurazione Terraform. 
    deletion_protection =  "false"
  2. Applica la configurazione Terraform aggiornata eseguendo il comando seguente e inserendo yes al prompt: 
    terraform apply

  1. Rimuovi le risorse applicate in precedenza con la configurazione Terraform eseguendo il seguente comando e inserendo yes al prompt:

    terraform destroy

REST v1

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza principale o di replica di lettura che stai configurando per l'alta affidabilità
  • START_TIME: l'ora (in ore e minuti)

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME

Corpo JSON della richiesta: 

{
  "settings":
  {
    "backupConfiguration":
    {
      "startTime": "START_TIME",
      "enabled": true,
      "binaryLogEnabled": true
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Imposta la conservazione dei backup automatici

Per impostare il numero di backup automatici da conservare:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Seleziona Backup dal menu di navigazione SQL.
  4. Fai clic su Modifica.
  5. Nella sezione Backup automatici, espandi Opzioni avanzate.
  6. Inserisci il numero di backup da archiviare alla volta.

    Il numero non può essere inferiore ai giorni di conservazione dei log PITR.

  7. Fai clic su Salva.

gcloud

Modifica l'istanza per impostare il numero di backup automatici da conservare. Il numero non può essere inferiore a quello predefinito (sette). 

gcloud sql instances patch INSTANCE_NAME \
--retained-backups-count=NUM_TO_RETAIN

Terraform

Per specificare il numero di backup automatici da conservare per un'istanza di database, utilizza una risorsa Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-backup-retention"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled = true
      backup_retention_settings {
        retained_backups = 365
        retention_unit   = "COUNT"
      }
    }
  }
}

REST v1beta4

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

  • unit: (Facoltativo) l'unità di conservazione può essere un numero intero o una stringa. I valori attualmente supportati (e predefiniti) sono 1 o "COUNT".
  • num-to-retain: il numero di backup automatici da conservare. Il numero non può essere inferiore al valore predefinito (7).
  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON della richiesta: 

{
  "settings":
  {
    "backupConfiguration":
    {
      "backupRetentionSettings":
      {
        "retentionUnit": unit,
        "retainedBackups": "num-to-retain"
      }
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Disabilita i backup automatici

Per disattivare i backup automatici per un'istanza:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Seleziona Backup dal menu di navigazione SQL.
  4. Fai clic su Gestisci i backup automatici.
  5. Deseleziona Backup automatici.
  6. Fai clic su Salva.

gcloud

Modifica l'istanza per disattivare i backup:

gcloud sql instances patch INSTANCE_NAME \
--no-backup

REST v1

REST v1beta4

Elimina un backup

Puoi eliminare i backup automatici e on demand.

L'eliminazione di un backup potrebbe non liberare spazio pari alle dimensioni del backup. Questo perché i backup sono incrementali, quindi l'eliminazione di un backup precedente potrebbe trasferire parte dei suoi contenuti a un backup più recente per preservare l'integrità di quest'ultimo.

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Seleziona Backup dal menu di navigazione SQL.
  4. Fai clic su Altre azioni Icona Altre azioni. per il backup che vuoi eliminare.
  5. Seleziona Elimina.
  6. Nella finestra Elimina backup, digita Delete nel campo e fai clic su Elimina.

gcloud

Elimina un backup di un'istanza Cloud SQL:

gcloud beta sql backups delete BACKUP_ID \
--instance INSTANCE_NAME

Per un elenco completo dei parametri, consulta la pagina di riferimento del comando gcloud beta sql backups delete.

REST v1

  1. Elenca i backup per ottenere l'ID del backup che vuoi eliminare:

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

    • project-id: l'ID progetto
    • instance-id: l'ID istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina il backup:

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

    • project-id: l'ID progetto
    • instance-id: l'ID istanza
    • backup-id: l'ID del backup

    Metodo HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

  1. Elenca i backup per ottenere l'ID del backup che vuoi eliminare:

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

    • project-id: l'ID progetto
    • instance-id: l'ID istanza

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina il backup:

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

    • project-id: l'ID progetto
    • instance-id: l'ID istanza
    • backup-id: l'ID del backup

    Metodo HTTP e URL: 

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns/backup-id

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

Imposta una località personalizzata per i backup

Utilizza una località di backup personalizzata solo se richiesto dalle normative. Se non è richiesta, utilizza la località di backup multiregionale predefinita.

Puoi utilizzare una località personalizzata per i backup on demand e automatici. Per un elenco completo dei valori di località validi, consulta Località delle istanze.

Per aggiornare un'istanza con una località personalizzata:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Dal menu di navigazione SQL, seleziona Backup.
  4. Accanto a Impostazioni, fai clic su Modifica.
  5. Nella sezione Backup automatici, espandi Opzioni avanzate.
  6. Fai clic su Multiregione (predefinito) o Regione.
  7. Seleziona la località dal menu a discesa Località.
  8. Fai clic su Salva.

gcloud

Per informazioni di riferimento, consulta gcloud sql instances patch. 

gcloud sql instances patch INSTANCE_NAME \
--backup-location=BACKUP_LOCATION

Terraform

Per specificare una località personalizzata per il backup di un'istanza di database, utilizza una risorsa Terraform. 

resource "google_sql_database_instance" "default" {
  name             = "sqlserver-instance-with-backup-location"
  region           = "us-central1"
  database_version = "SQLSERVER_2019_STANDARD"
  root_password    = "INSERT-PASSWORD-HERE"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled  = true
      location = "us-central1"
    }
  }
}

REST v1

Utilizza il parametro settings.backupConfiguration.location dell'istanza per la località di backup.

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

  • region: la regione del progetto
  • backup-region: la regione di backup
  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id

Corpo JSON della richiesta: 

{
  "region": "region"
  "settings":
  {
    "backupConfiguration":
    {
      "location": "backup-region",
      "enabled": true,
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Utilizza il parametro settings.backupConfiguration.location dell'istanza per la località di backup.

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

  • region: la regione del progetto
  • backup-region: la regione di backup
  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id

Corpo JSON della richiesta: 

{
  "region": "region"
  "settings":
  {
    "backupConfiguration":
    {
      "location": "backup-region",
      "enabled": true,
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizza un elenco di backup

Per visualizzare un elenco di backup e i dettagli di un backup, utilizza le seguenti opzioni.

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

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Seleziona Backup dal menu di navigazione SQL per visualizzare i backup recenti, insieme alla data/ora di creazione e al tipo di backup.

gcloud

  • Elenca i backup dell'istanza: 
    gcloud sql backups list \
--instance INSTANCE_NAME

    Puoi filtrare e controllare i risultati utilizzando i parametri di elenco standard. Per un elenco completo, consulta la pagina di riferimento del comando gcloud sql backups list.

  • Visualizza i dettagli di un backup specificando il backup ID dall'output del comando backups list. 
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

Puoi anche utilizzare Explorer API nella pagina BackupRuns:list per inviare la richiesta API REST.

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

Puoi anche utilizzare Explorer API nella pagina BackupRuns:list per inviare la richiesta API REST.

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizza un elenco di backup durante un'interruzione

Quando un'istanza si trova in una regione in cui si sta verificando un'interruzione, puoi visualizzare i backup di quell'istanza solo utilizzando un carattere jolly (-) con l'API backupRuns.list. Il carattere jolly restituisce tutti i backup nel progetto. Consulta Ripristino in un'altra istanza.

In caso di interruzione in una regione in cui un'istanza ha abilitato le chiavi di crittografia gestite dal cliente (CMEK), non puoi ripristinare i backup di quell'istanza in un'altra regione. Questo perché Cloud SQL utilizza chiavi Cloud KMS regionali per la crittografia quando CMEK è abilitato nell'istanza. Per ripristinare i backup di un'istanza CMEK, Cloud SQL deve avere accesso alla chiave CMEK. In caso di interruzione a livello di regione, non è possibile accedere alle chiavi Cloud KMS in quella regione.

gcloud

  1. Elenca i backup per ogni istanza di un progetto: 
    gcloud sql backups list --instance -

    Il comando restituisce informazioni simili alle seguenti:

    {
      "kind": "sql#backupRun",
      "status": "SUCCESSFUL",
      "enqueuedTime": "2020-01-21T11:25:33.818Z",
      "id": "backup-id",
      "startTime": "2020-01-21T11:25:33.858Z",
      "endTime": "2020-01-21T11:26:18.663Z",
      "type": "AUTOMATED",
      "windowStartTime": "2020-01-21T10:00:00.479Z",
      "instance": "instance-id",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",
      "location": "us"
      "backupKind": "SNAPSHOT"
    }
  2. Trova il backup dell'istanza che ti interessa. Per ripristinare questo backup, consulta Ripristino in un'altra istanza.

REST v1

  1. Elenca tutti i backup in un progetto:

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

    • PROJECT_ID: l'ID progetto
    • INSTANCE_ID: l'ID istanza o - per un elenco di tutti i backup nel progetto

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/-/backupRuns

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Trova il backup dell'istanza che ti interessa. Per ripristinare questo backup, consulta Ripristino in un'altra istanza.

REST v1beta4

  1. Elenca tutti i backup in un progetto:

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

    • project-id: l'ID progetto
    • instance-id: l'ID istanza o - per un elenco di tutti i backup nel progetto

    Metodo HTTP e URL: 

    GET https://sqladmin.googleapis.com/v1beta4/projects/project-id/instances/-/backupRuns

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Trova il backup dell'istanza che ti interessa. Per ripristinare questo backup, consulta Ripristino in un'altra istanza.

Visualizza le località di backup

Per visualizzare le località dei backup eseguiti per un'istanza, utilizza backupRuns:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  3. Seleziona Backup dal menu di navigazione SQL.
  4. Nell'elenco dei backup, la colonna Località elenca il tipo di località (multiregionale o singola regione) e la regione o le regioni specifiche per ogni backup.

gcloud

Per informazioni di riferimento, consulta gcloud sql instances describe.

  1. Elenca i backup dell'istanza: 
    gcloud sql backups list \
--instance INSTANCE_NAME

    Puoi filtrare e controllare i risultati utilizzando i parametri di elenco standard. Per un elenco completo, consulta la pagina di riferimento del comando gcloud sql backups list.

  2. Per elencare i dettagli di un backup, utilizza ID dall'output del comando backups list. 
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Negli esempi precedenti:
  • REGION è la regione dell'istanza originale.
  • BACKUP_LOCATION è la località in cui vuoi che Cloud SQL archivi il backup.

REST v1beta4

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

  • project-id: l'ID progetto
  • instance-id: l'ID istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/sql/v1beta4/projects/project-id/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Negli esempi precedenti:
  • REGION è la regione dell'istanza originale.
  • BACKUP_LOCATION è la località in cui vuoi che Cloud SQL archivi il backup.

Visualizza le dimensioni del backup

Puoi visualizzare le dimensioni di un backup per un'istanza Cloud SQL utilizzando gcloud CLI o l'API.

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

  2. Per visualizzare le dimensioni di un backup, utilizza il comando gcloud sql backups describe:

    gcloud sql backups describe BACKUP_ID \
--instance=INSTANCE_NAME \
--project=PROJECT_ID

    Effettua le seguenti sostituzioni:

    • BACKUP_ID: l'ID del backup. Puoi ottenere questo ID dall'output dell'esecuzione del comando gcloud sql backups list.
    • INSTANCE_NAME: il nome dell'istanza
    • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.

    Nell'output, il parametro maxChargeableBytes mostra le dimensioni del backup (in byte).

REST

Visualizza un elenco dei backup

Utilizza questo esempio per ottenere un elenco di tutti i backup 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 sostituzioni seguenti:

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza
  • INSTANCE_NAME: il nome dell'istanza

Metodo HTTP e URL: 

GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_NAME/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Visualizza i dettagli di un backup

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

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

  • PROJECT_ID: l'ID o il numero di progetto del progetto Google Cloud che contiene l'istanza.
  • INSTANCE_NAME: il nome dell'istanza
  • 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/instances/INSTANCE_NAME/backupRuns/BACKUP_ID

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Configura i backup finali

Puoi impostare l'istanza in modo che esegua automaticamente un backup attivando l'impostazione dell'istanza di backup finale e impostando il periodo di conservazione del backup finale. Se non attivi il backup finale per l'istanza prima dell'eliminazione, puoi anche eseguire un backup finale quando elimini l'istanza. Per saperne di più sul funzionamento dei backup finali, consulta Backup finale.

Per gestire un backup finale dopo l'eliminazione dell'istanza, consulta Gestisci i backup per le istanze eliminate.

Abilita backup finale

Per abilitare i backup finali per un'istanza, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Trova l'istanza per cui vuoi attivare il backup finale. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.

  3. Fai clic su Modifica.

  4. In Personalizza la tua istanza, espandi Protezione dei dati.

  5. Per attivare il backup finale, seleziona la casella Backup finale durante l'eliminazione dell'istanza in Protezione da eliminazione dell'istanza.

    Il periodo di conservazione predefinito è di 30 giorni. Per modificare questa impostazione, inserisci un numero compreso tra 1 e 365 nella casella Giorni di conservazione.

  6. Fai clic su Salva.

gcloud

Utilizza il comando gcloud sql instances per abilitare il backup finale.

  gcloud sql instances patch INSTANCE_NAME \
  --final-backup \
  --final-backup-retention-days=RETENTION_DAYS

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza Cloud SQL.
  • RETENTION_DAYS: il numero di giorni per conservare il backup finale. Può variare da 1 a 365 giorni e il valore predefinito è 30 giorni.

REST v1

Per attivare i backup finali:

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza
  • RETENTION_DAYS: il numero di giorni di conservazione dei backup finali

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": true,
      "retentionDays: RETENTION_DAYS
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Per attivare i backup finali:

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza
  • RETENTION_DAYS: il numero di giorni di conservazione dei backup finali

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": true,
      "retentionDays: RETENTION_DAYS
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Imposta la conservazione del backup finale

Per impostare il periodo di conservazione del backup finale per un'istanza, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Trova l'istanza per cui vuoi attivare il backup finale. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.

  3. Fai clic su Modifica.

  4. In Personalizza la tua istanza, espandi Protezione dei dati.

  5. Per modificare il periodo di conservazione del backup finale, inserisci un numero compreso tra 1 e 365 nella casella Giorni di conservazione nell'impostazione Backup finale dopo l'eliminazione dell'istanza.

    Il periodo di conservazione predefinito è di 30 giorni.

  6. Fai clic su Salva.

gcloud

Utilizza il comando gcloud sql instances per aggiornare l'impostazione dei giorni di conservazione del backup finale.

  gcloud sql instances patch INSTANCE_NAME \
  --final-backup-retention-days=RETENTION_DAYS

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza Cloud SQL.
  • RETENTION_DAYS: il numero di giorni per conservare il backup finale. Può variare da 1 a 365 giorni e il valore predefinito è 30 giorni.

REST v1

Per aggiornare l'impostazione dei giorni di conservazione del backup finale, segui questi passaggi:

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza
  • RETENTION_DAYS: il numero di giorni di conservazione dei backup finali

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "FinalBackupConfig": {
      "retentionDays: RETENTION_DAYS
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Per aggiornare l'impostazione dei giorni di conservazione del backup finale, segui questi passaggi:

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

  • PROJECT_ID: l'ID progetto
  • INSTANCE_ID: l'ID istanza
  • RETENTION_DAYS: il numero di giorni di conservazione dei backup finali

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "FinalBackupConfig": {
      "retentionDays: RETENTION_DAYS
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Disattiva il backup finale

Per disattivare i backup finali per un'istanza, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Trova l'istanza per cui vuoi attivare il backup finale. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.

  3. Fai clic su Modifica.

  4. In Personalizza la tua istanza, espandi Protezione dei dati.

  5. Per disattivare il backup finale, deseleziona la casella Backup finale durante l'eliminazione dell'istanza in Protezione da eliminazione dell'istanza.

  6. Fai clic su Salva.

gcloud

Utilizza il comando gcloud sql instances per disattivare il backup finale.

  gcloud sql instances patch INSTANCE_NAME \
  --no-final-backup

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza Cloud SQL.

REST v1

Per disattivare i backup finali:

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

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

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": false
    }
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Per disattivare i backup finali:

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

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

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "FinalBackupConfig": {
      "enabled": false
    }
  }s
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Configura i backup conservati

Puoi impostare l'istanza in modo che conservi automaticamente tutti i backup automatici e on demand quando la elimini. Questi backup vengono conservati in base al periodo di conservazione del backup al momento dell'eliminazione. Per saperne di più sul funzionamento dei backup finali, consulta Backup finale.

Per gestire i backup conservati dopo l'eliminazione dell'istanza, consulta Gestisci i backup per le istanze eliminate.

Abilita i backup conservati

Per attivare i backup conservati per un'istanza, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Trova l'istanza per cui vuoi attivare i backup conservati. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.

  3. Fai clic su Modifica.

  4. In Personalizza la tua istanza, espandi Protezione dei dati.

  5. Per abilitare i backup conservati, seleziona la casella Conserva i backup dopo l'eliminazione dell'istanza in Protezione da eliminazione dell'istanza.

  6. Fai clic su Salva.

gcloud

Utilizza il comando gcloud sql instances per attivare i backup conservati.

  gcloud sql instances patch INSTANCE_NAME \
  --retain-backups-on-delete

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza Cloud SQL.

REST v1

Per abilitare i backup conservati:

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

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

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Per abilitare i backup conservati:

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

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

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Disattiva i backup conservati

Per disattivare i backup conservati per un'istanza, segui questi passaggi:

Console

  1. Nella console Google Cloud , vai alla pagina Istanze Cloud SQL.

    Vai a Istanze Cloud SQL

  2. Trova l'istanza per cui vuoi attivare i backup conservati. Per aprire la pagina Panoramica dell'istanza, fai clic sul nome dell'istanza.

  3. Fai clic su Modifica.

  4. In Personalizza la tua istanza, espandi Protezione dei dati.

  5. Per disattivare i backup conservati, deseleziona la casella Conserva i backup dopo l'eliminazione dell'istanza in Protezione da eliminazione dell'istanza.

  6. Fai clic su Salva.

gcloud

Utilizza il comando gcloud sql instances per disattivare i backup conservati.

  gcloud sql instances patch INSTANCE_NAME \
  --no-retain-backups-on-delete

Sostituisci quanto segue:

  • INSTANCE_NAME: il nome dell'istanza Cloud SQL.

REST v1

Per disattivare i backup conservati:

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

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

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "retainBackupsOnDelete": false
    }
  }

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

REST v1beta

Per disattivare i backup conservati:

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

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

Metodo HTTP e URL: 

PATCH https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID

Corpo JSON della richiesta: 

{
  "settings": {
    "retainBackupsOnDelete": true
    }
  }

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

{
  "kind": "sql#operation",
  "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID",
  "status": "PENDING",
  "user": "user@example.com",
  "insertTime": "2020-01-16T02:32:12.281Z",
  "operationType": "UPDATE",
  "name": "OPERATION_ID",
  "targetId": "INSTANCE_ID",
  "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/operations/OPERATION_ID",
  "targetProject": "PROJECT_ID"
}

Passaggi successivi