Ripristino di un'istanza

Questa pagina descrive come ripristinare l'istanza da un backup ed eseguire un recupero point-in-time di un'istanza.

Per informazioni, best practice e requisiti per le operazioni di ripristino o per il recupero in un determinato momento, consulta la Panoramica del ripristino di un'istanza.

Ripristino da un backup on demand o automatico

Puoi utilizzare un backup on demand o automatico per i seguenti scenari:

  • Ripristino in un'altra istanza dello stesso progetto
  • Ripristina nella stessa istanza da cui è stato eseguito il backup
  • Ripristino in un'altra istanza in un progetto o una regione diversi

Se hai attivato il recupero point-in-time (PITR), puoi ripristinare lo stato dell'istanza in un punto temporale specifico in base alle impostazioni di conservazione dei log per l'istanza.

Ripristino in un'altra istanza

Quando ripristini i dati da un backup in un'altra istanza, i dati dell'istanza di destinazione vengono aggiornati allo stato dell'istanza di origine al momento del backup. Per ulteriori informazioni, consulta suggerimenti generali sull'esecuzione di un ripristino e suggerimenti e requisiti per il ripristino in un'istanza diversa.

Se hai bisogno di un elenco di backup per il progetto e non riesci a visualizzarli nella pagina di panoramica dell'istanza a causa di un'interruzione del servizio, puoi utilizzare l'API backupRuns.list con un carattere jolly (-). L'opzione di carattere jolly recupera un elenco di tutti i backup di tutte le istanze del progetto. Per ulteriori informazioni, consulta la sezione Visualizzare i backup durante un'interruzione.

Console

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

    Vai a Istanze Cloud SQL

  2. Se l'istanza di destinazione ha repliche di lettura, utilizza il menu Altre azioni Icona Altre azioni. per eliminarle.
  3. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  4. Nel menu di navigazione SQL, seleziona Backup.
  5. Individua il backup da cui vuoi eseguire il ripristino e fai clic su Ripristina.
  6. Nella pagina Ripristina un'istanza da un backup, verifica di aver selezionato il backup corretto in Esamina i dettagli del backup.
  7. In Scegli la destinazione del ripristino, seleziona Sovrapponi un'istanza esistente.
  8. Dal menu Istanza da sovrascrivere, seleziona l'istanza che vuoi utilizzare per il ripristino. L'istanza selezionata e tutti i relativi dati vengono sovrascritti.
  9. Per confermare la selezione, inserisci il nome dell'istanza da sovrascrivere nel campo ID istanza di destinazione.
  10. Per avviare il processo di ripristino, fai clic su Ripristina.
  11. Per controllare lo stato dell'operazione di ripristino, vai alla pagina Operazioni dell'istanza.
  12. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

gcloud

  1. Per determinare se l'istanza target ha repliche di lettura, utilizza il comando gcloud sql instances describe:
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Prendi nota di eventuali istanze elencate nella colonna replicaNames.

  2. Per eliminare tutte le repliche, utilizza il comando gcloud sql instances delete:
    gcloud sql instances delete REPLICA_NAME

    Ripeti l'operazione per ogni replica.

  3. Per elencare i backup per l'istanza di origine, utilizza il comando gcloud sql backups list:
    gcloud sql backups list \
    --instance SOURCE_INSTANCE_NAME
  4. Trova il backup che vuoi utilizzare e registra il relativo valore ID.
  5. Per ripristinare l'istanza di destinazione dal backup, utilizza il comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_ID \
    --restore-instance=TARGET_INSTANCE_NAME \
    --backup-instance=SOURCE_INSTANCE_NAME
  6. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

REST v1

  1. Per determinare se l'istanza ha repliche di lettura e per ottenere gli ID di queste repliche, elenca tutte le repliche per l'istanza di destinazione.

    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/instances/INSTANCE_ID?fields=replicaNames

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina tutte le repliche.

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

    • PROJECT_ID: l'ID progetto
    • REPLICA_ID: l'ID replica

    Metodo HTTP e URL:

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Ripeti l'operazione per ogni replica.

  3. Per ottenere l'ID del backup che vuoi utilizzare, elenca i backup per l'istanza di origine.

    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/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    -o-

    Se la tua istanza si trova in una regione in cui si è verificata un'interruzione del servizio, elenca tutti i backup in un progetto

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

    • 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:

    Individua il backup dell'istanza che devi ripristinare.
  4. Ripristina l'istanza di destinazione dal backup.

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

    • project-id: l'ID progetto
    • target-instance-id: l'ID istanza di destinazione
    • source-instance-id: l'ID istanza dell'origine
    • backup-id L'ID backup

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

    {
      "restoreBackupContext":
      {
        "backupRunId": backup-id,
        "instanceId": "source-instance-id"
      }
    }
    

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  5. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

REST v1beta4

  1. Per determinare se l'istanza ha repliche di lettura e per ottenere gli ID di queste repliche, elenca tutte le repliche per l'istanza di destinazione.

    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/instances/INSTANCE_ID?fields=replicaNames

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina tutte le repliche.

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

    • PROJECT_ID: l'ID progetto
    • REPLICA_ID: l'ID replica

    Metodo HTTP e URL:

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Ripeti l'operazione per ogni replica.

  3. Per ottenere l'ID del backup che vuoi utilizzare, elenca i backup per l'istanza di origine.

    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/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  4. Ripristina l'istanza di destinazione dal backup.

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

    • project-id: l'ID progetto
    • target-instance-id: l'ID istanza di destinazione
    • source-instance-id: l'ID istanza dell'origine
    • backup-id L'ID backup

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

    {
      "restoreBackupContext":
      {
        "backupRunId": backup-id,
        "instanceId": "source-instance-id"
      }
    }
    

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  5. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

Ripristino nella stessa istanza

Quando esegui il ripristino dei dati da un backup nella stessa istanza, i dati dell'istanza tornano allo stato in cui erano al momento del backup. Per informazioni sul recupero di un'istanza, consulta Suggerimenti generali sull'esecuzione di un ripristino.

Console

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

    Vai a Istanze Cloud SQL

  2. Se l'istanza di destinazione ha repliche di lettura, utilizza il menu Altre azioni Icona Altre azioni. per eliminarle.
  3. Per aprire la pagina Panoramica di un'istanza, fai clic sul nome dell'istanza.
  4. Nel menu di navigazione SQL, seleziona Backup.
  5. Individua il backup che vuoi utilizzare e fai clic su Ripristina.
  6. Nella pagina Ripristina un'istanza da un backup, verifica di aver selezionato il backup corretto in Esamina i dettagli del backup.
  7. In Scegli la destinazione del ripristino, seleziona Sostituisci l'istanza di origine.

    Verifica che il nome dell'istanza di origine sia specificato tra parentesi.

  8. Per confermare la selezione, inserisci il nome dell'istanza nel campo ID istanza di destinazione.
  9. Per avviare il processo di ripristino, fai clic su Ripristina.
  10. Per controllare lo stato dell'operazione di ripristino, vai alla pagina Operazioni dell'istanza.
  11. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

gcloud

  1. Per determinare se l'istanza ha repliche di lettura, utilizza il comando gcloud sql instances describe:
    gcloud sql instances describe INSTANCE_NAME

    Prendi nota di eventuali istanze elencate nella colonna replicaNames.

  2. Per eliminare tutte le repliche, utilizza il comando gcloud sql instances delete:
    gcloud sql instances delete REPLICA_NAME

    Ripeti l'operazione per ogni replica.

  3. Per elencare i backup dell'istanza, utilizza il comando gcloud sql backups list:
    gcloud sql backups list --instance INSTANCE_NAME
  4. Trova il backup che vuoi utilizzare e registra il relativo valore ID.
  5. Per ripristinare l'istanza dal backup specificato, utilizza il comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_ID \
    --restore-instance=INSTANCE_NAME
  6. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

REST v1

  1. Per determinare se l'istanza ha repliche di lettura e per ottenere gli ID di queste repliche, elenca tutte le repliche per l'istanza.

    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/instances/INSTANCE_ID?fields=replicaNames

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina tutte le repliche.

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

    • PROJECT_ID: l'ID progetto
    • REPLICA_ID: l'ID replica

    Metodo HTTP e URL:

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Ripeti l'operazione per ogni replica.

  3. Per ottenere l'ID del backup che vuoi utilizzare, elenca i backup per l'istanza.

    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/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  4. Ripristina l'istanza dal backup specificato.

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

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

    Metodo HTTP e URL:

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID/restoreBackup

    Corpo JSON della richiesta:

    {
      "restoreBackupContext":
      {
        "backupRunId": "BACKUP_ID",
      }
    }
    

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  5. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

REST v1beta4

  1. Per determinare se l'istanza ha repliche di lettura e per ottenere gli ID di queste repliche, elenca tutte le repliche per l'istanza.

    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/instances/INSTANCE_ID?fields=replicaNames

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina tutte le repliche.

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

    • PROJECT_ID: l'ID progetto
    • REPLICA_ID: l'ID replica

    Metodo HTTP e URL:

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Ripeti l'operazione per ogni replica.

  3. Per ottenere l'ID del backup che vuoi utilizzare, elenca i backup per l'istanza.

    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/instances/instance-id/backupRuns

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  4. Ripristina l'istanza dal backup specificato.

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

    • PROJECT_ID: l'ID progetto
    • INSTANCE_ID: l'ID istanza
    • BACKUP_RUN_ID: un timestamp della data e dell'ora in cui Cloud SQL ripristina l'istanza dal backup

    Metodo HTTP e URL:

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

    Corpo JSON della richiesta:

    {
      "restoreBackupContext":
      {
        "backupRunId": "BACKUP_RUN_ID",
      }
    }
    

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  5. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

Ripristino in un'istanza di un altro progetto

Puoi utilizzare il parametro project per ripristinare i dati in un'istanza di un progetto diverso da quello in cui è stato eseguito il backup. Quando utilizzi il parametro project, chiama restoreBackup nel progetto e nell'istanza in cui vuoi ripristinare i dati. Quando esegui il ripristino da un backup in un'altra istanza, i dati dell'istanza di destinazione vengono aggiornati allo stato dell'istanza di origine al momento del backup.

Autorizzazioni

L'utente che esegue il ripristino in un progetto diverso deve disporre dell'autorizzazione cloudsql.instances.restoreBackup per il progetto di destinazione e dell'autorizzazione cloudsql.backupRuns.get per l'istanza di origine. Queste autorizzazioni sono incluse nel ruolo Cloud SQL Admin.

Per ripristinare i dati in un'istanza di un altro progetto:

gcloud

  1. Elenca i backup per l'istanza.

    gcloud sql backups list --instance INSTANCE_NAME

    Sostituisci INSTANCE_NAME con il nome dell'istanza.

  2. Trova il backup che vuoi utilizzare e registra il relativo valore ID.
  3. Ripristina i dati in un'istanza di un altro progetto.

    gcloud sql backups restore BACKUP_ID \
    --restore-instance=TARGET_INSTANCE_NAME \
    --backup-instance=SOURCE_INSTANCE_NAME \
    --backup-project=SOURCE_INSTANCE_PROJECT

    Esegui le seguenti sostituzioni:

    • BACKUP_ID: l'ID del backup. Hai ottenuto questo ID in precedenza in questa procedura.
    • TARGET_INSTANCE_NAME: l'istanza nel progetto di destinazione in cui stai ripristinando i dati.
    • SOURCE_INSTANCE_NAME: l'istanza nel progetto di origine che contiene i dati da ripristinare nell'istanza nel progetto di destinazione.
    • SOURCE_INSTANCE_PROJECT: il progetto che contiene l'istanza di origine.

REST v1

Per ottenere backupId, esegui il seguente comando.

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/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ripristina il backup in un'istanza di un altro progetto:

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

  • source-project-id: l'ID progetto di origine
  • target-project-id: l'ID progetto di destinazione
  • target-instance-id: l'ID istanza di destinazione
  • source-instance-id: l'ID istanza dell'origine
  • backup-id L'ID backup

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "project": "source-project-id",
    "instanceId": "source-instance-id"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Per ulteriori informazioni sulla proprietà project, consulta restoreBackup

REST v1beta4

Per ottenere backupId, esegui il seguente comando.

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/instances/instance-id/backupRuns

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ripristina il backup in un'istanza di un altro progetto:

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

  • source-project-id: l'ID progetto di origine
  • target-project-id: l'ID progetto di destinazione
  • target-instance-id: l'ID istanza di destinazione
  • source-instance-id: l'ID istanza dell'origine
  • backup-id L'ID backup

Metodo HTTP e URL:

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

Corpo JSON della richiesta:

{
  "restoreBackupContext":
  {
    "backupRunId": backup-id,
    "project": "source-project-id",
    "instanceId": "source-instance-id"
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Per ulteriori informazioni sulla proprietà project, consulta restoreBackup

Ripristino da un backup finale

Puoi utilizzare un backup finale per i seguenti scenari:

  • Ripristina il backup finale in una nuova istanza
  • Ripristina in una nuova istanza in un progetto o una regione diversi

Poiché utilizzi un backup finale di un'istanza eliminata per ripristinarla, puoi utilizzare il backup anche per creare un'istanza con la configurazione dell'istanza eliminata e recuperare i dati.

Ripristina in una nuova istanza

Quando crei un'istanza da un backup finale, Cloud SQL utilizza le impostazioni di configurazione dell'istanza da cui viene eseguito il backup finale. Dopo aver creato l'istanza, Cloud SQL ripristina i dati allo stato al momento dell'esecuzione del backup finale.

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. Fai clic sul backup finale contenente i dati che vuoi ripristinare in una nuova istanza.
  3. Nella finestra di dialogo Backup finale, fai clic su Ripristina.
  4. Nella pagina Ripristina un'istanza da un backup, verifica di aver selezionato il backup corretto in Esamina i dettagli del backup.
  5. In Scegli la destinazione del ripristino, seleziona Ripristina in una nuova istanza.
  6. Nel menu Regione, seleziona la regione per la nuova istanza.
  7. Nel campo ID istanza, inserisci un ID per la nuova istanza.
  8. Per avviare il processo di ripristino, fai clic su Ripristina.
  9. Per controllare lo stato dell'operazione di ripristino, vai alla pagina Operazioni dell'istanza.

gcloud

  1. Per elencare i backup finali per l'istanza source, utilizza il comando gcloud sql backups list:
    gcloud sql backups list \
    --filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  2. Trova il backup che vuoi utilizzare e registra il relativo valore NAME.
  3. Per ripristinare una nuova istanza dal backup finale specificato, utilizza il comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_NAME \
    --restore-instance=TARGET_INSTANCE_NAME 

REST v1

  1. Per ottenere l'ID del backup che vuoi utilizzare, elenca i backup finali per l'istanza di origine.

    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 AND instance:INSTANCE_ID'

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Ripristina una nuova istanza dal backup finale specificato.

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

    • PROJECT_ID: l'ID progetto
    • TARGET_INSTANCE_ID: l'ID istanza di destinazione
    • BACKUP_ID: l'ID backup

    Metodo HTTP e URL:

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Corpo JSON della richiesta:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
      restore_instance_settings: {}
    }
    

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

REST v1beta4

  1. Per ottenere l'ID del backup che vuoi utilizzare, elenca i backup finali per l'istanza di origine.

    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 AND instance:INSTANCE_ID'

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Ripristina una nuova istanza dal backup finale specificato.

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

    • PROJECT_ID: l'ID progetto
    • TARGET_INSTANCE_ID: l'ID istanza di destinazione
    • BACKUP_ID: l'ID backup

    Metodo HTTP e URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Corpo JSON della richiesta:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
      restore_instance_settings: {}
    }
    

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

Ripristino in un'istanza esistente

Quando esegui il ripristino dei dati da un backup finale in un'istanza esistente, i dati dell'istanza di destinazione vengono aggiornati allo stato dell'istanza di origine al momento del backup. Per ulteriori informazioni, consulta suggerimenti generali sull'esecuzione di un ripristino e suggerimenti e requisiti per il ripristino in un'istanza diversa.

Se hai bisogno di un elenco dei backup per il progetto e non riesci a visualizzarli nella pagina Panoramica dell'istanza a causa di un'interruzione del servizio, puoi utilizzare l'API backupRuns.list.

Console

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

    Vai a Istanze Cloud SQL

  2. Se l'istanza di destinazione ha repliche di lettura, utilizza il menu Altre azioni Icona Altre azioni. per eliminarle.
  3. 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.

  4. Fai clic sul backup finale contenente i dati che vuoi ripristinare in un'istanza diversa.
  5. Nella finestra di dialogo Backup finale, fai clic su Ripristina.
  6. Nella pagina Ripristina un'istanza da un backup, verifica di aver selezionato il backup corretto in Esamina i dettagli del backup.
  7. In Scegli la destinazione del ripristino, seleziona Sovrisci un'istanza esistente.
  8. Nel menu Istanza da sovrascrivere, seleziona l'istanza che vuoi utilizzare per il ripristino. L'istanza selezionata e tutti i relativi dati vengono sovrascritti.

  9. Per confermare la selezione, inserisci il nome dell'istanza da sovrascrivere nel campo ID istanza di destinazione.
  10. Per avviare il processo di ripristino, fai clic su Ripristina.
  11. Per controllare lo stato dell'operazione di ripristino, vai alla pagina Operazioni dell'istanza.
  12. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

gcloud

  1. Per determinare se l'istanza target ha repliche di lettura, utilizza il comando gcloud sql instances describe:
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Prendi nota di eventuali istanze elencate nella colonna replicaNames.

  2. Per eliminare tutte le repliche, utilizza il comando gcloud sql instances delete:
    gcloud sql instances delete REPLICA_NAME

    Ripeti l'operazione per ogni replica.

  3. Per elencare i backup finali per l'istanza di origine, utilizza il comando gcloud sql backups list:
    gcloud sql backups list \
    --filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  4. Trova il backup che vuoi utilizzare e registra il relativo valore NAME.
  5. Per ripristinare l'istanza di destinazione dal backup, utilizza il comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_NAME \
    --restore-instance=TARGET_INSTANCE_NAME
  6. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

REST v1

  1. Per determinare se l'istanza ha repliche di lettura e per ottenere gli ID di queste repliche, elenca tutte le repliche per l'istanza di destinazione.

    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/instances/INSTANCE_ID?fields=replicaNames

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina tutte le repliche.

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

    • PROJECT_ID: l'ID progetto
    • REPLICA_ID: l'ID replica

    Metodo HTTP e URL:

    DELETE https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/REPLICA_ID

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Ripeti l'operazione per ogni replica.

  3. Per ottenere l'ID del backup finale che vuoi utilizzare, elenca i backup per l'istanza di origine.

    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 AND instance:INSTANCE_ID'

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Individua il backup dell'istanza che devi ripristinare.
  4. Ripristina l'istanza di destinazione dal backup.

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

    • PROJECT_ID: l'ID progetto
    • TARGET_INSTANCE_ID: l'ID istanza di destinazione
    • BACKUP_ID: l'ID backup

    Metodo HTTP e URL:

    POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Corpo JSON della richiesta:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
    }
    

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  5. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

REST v1beta4

  1. Per determinare se l'istanza ha repliche di lettura e per ottenere gli ID di queste repliche, elenca tutte le repliche per l'istanza di destinazione.

    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/instances/INSTANCE_ID?fields=replicaNames

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  2. Elimina tutte le repliche.

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

    • PROJECT_ID: l'ID progetto
    • REPLICA_ID: l'ID replica

    Metodo HTTP e URL:

    DELETE https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/REPLICA_ID

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Ripeti l'operazione per ogni replica.

  3. Per ottenere l'ID del backup finale che vuoi utilizzare, elenca i backup per l'istanza di origine.

    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 AND instance:INSTANCE_ID'

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

    Individua il backup dell'istanza da ripristinare.
  4. Ripristina l'istanza di destinazione dal backup.

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

    • PROJECT_ID: l'ID progetto
    • TARGET_INSTANCE_ID: l'ID istanza di destinazione
    • BACKUP_ID: l'ID backup

    Metodo HTTP e URL:

    POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

    Corpo JSON della richiesta:

    {
      backup: projects/PROJECT_ID/backups/BACKUP_ID
    }
    

    Per inviare la richiesta, espandi una di queste opzioni:

    Dovresti ricevere una risposta JSON simile alla seguente:

  5. Al termine dell'operazione di ripristino, ricrea le eventuali repliche eliminate in questa procedura.

Ripristino in un'istanza di un altro progetto

L'utente che ripristina i dati in un'istanza di un altro progetto deve disporre dell'autorizzazione cloudsql.instances.restoreBackup per il progetto di destinazione e dell'autorizzazione cloudsql.backupRuns.get per l'istanza di origine. Queste autorizzazioni sono incluse nel ruolo Cloud SQL Admin.

Per ripristinare i dati in un'istanza di un altro progetto:

REST v1

Per ottenere il file backupId per il backup finale, esegui quanto segue:

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 AND instance:INSTANCE_ID'

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ripristina il backup in un'istanza di un altro progetto:

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

  • PROJECT_ID: l'ID progetto
  • TARGET_INSTANCE_ID: l'ID istanza di destinazione
  • BACKUP_ID: l'ID backup

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Corpo JSON della richiesta:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Per ulteriori informazioni sulla proprietà project, consulta restoreBackup

REST v1beta4

Per ottenere il file backupId per il backup finale, esegui il seguente comando:

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 AND instance:INSTANCE_ID'

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ripristina il backup in un'istanza di un altro progetto:

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

  • PROJECT_ID: l'ID progetto
  • TARGET_INSTANCE_ID: l'ID istanza di destinazione
  • BACKUP_ID: l'ID backup

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Corpo JSON della richiesta:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Per ulteriori informazioni sulla proprietà project, consulta restoreBackup

Ripristina in una nuova istanza in un'altra regione

L'utente che ripristina i dati in una nuova istanza in una regione diversa deve disporre dell'autorizzazione cloudsql.instances.restoreBackup per il progetto di destinazione e dell'autorizzazione cloudsql.backupRuns.get per l'istanza di origine. Queste autorizzazioni sono incluse nel ruolo Cloud SQL Admin.

Inoltre, per creare un'istanza in un'altra regione, devi soddisfare i criteri dei criteri dell'organizzazione per quella regione.

Per ripristinare i dati in una nuova istanza in una regione diversa:

gcloud

  1. Per elencare i backup finali per l'istanza source, utilizza il comando gcloud sql backups list:
    gcloud sql backups list \
    --filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  2. Trova il backup che vuoi utilizzare e registra il relativo valore NAME.
  3. Per utilizzare il backup finale per ripristinare i dati in una nuova istanza in una regione diversa, utilizza il comando gcloud sql backups restore:
    gcloud sql backups restore BACKUP_NAME \
    --restore-instance=TARGET_INSTANCE_NAME \
    --region=TARGET_REGION 

REST v1

Per ottenere il file backupId per il backup finale, esegui quanto segue:

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 AND instance:INSTANCE_ID'

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ripristina il backup in una nuova istanza in una regione diversa:

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

  • PROJECT_ID: l'ID progetto
  • TARGET_INSTANCE_ID: l'ID istanza di destinazione
  • BACKUP_ID: l'ID backup
  • REGION: la regione dell'istanza di destinazione (ad esempio us-central1)

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Corpo JSON della richiesta:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {
    region: REGION
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Per ulteriori informazioni sulla proprietà project, consulta restoreBackup

REST v1beta4

Per ottenere il file backupId per il backup finale, esegui il seguente comando:

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 AND instance:INSTANCE_ID'

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Ripristina il backup in una nuova istanza in una regione diversa:

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

  • PROJECT_ID: l'ID progetto
  • TARGET_INSTANCE_ID: l'ID istanza di destinazione
  • BACKUP_ID: l'ID backup
  • REGION: la regione dell'istanza di destinazione (ad esempio us-central1)

Metodo HTTP e URL:

POST https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/TARGET_INSTANCE_ID/restoreBackup

Corpo JSON della richiesta:

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
  restore_instance_settings: {
    region: REGION
  }
}

Per inviare la richiesta, espandi una di queste opzioni:

Dovresti ricevere una risposta JSON simile alla seguente:

Per ulteriori informazioni sulla proprietà project, consulta restoreBackup

Esegui un recupero point-in-time

Per eseguire un recupero point-in-time, consulta Recupero point-in-time.

Identifica la posizione di recupero

Prima di poter eseguire un recupero point-in-time, devi aver identificato il nome e la posizione del file del log binario corrispondenti al punto in cui vuoi recuperare l'istanza.

Per eseguire questa operazione, vedi Identificare la posizione di recupero.

Passaggi successivi