Restaurer une instance

Cette page explique comment restaurer une instance à partir d'une sauvegarde.

Pour en savoir plus sur les opérations de restauration, ainsi que pour connaître les bonnes pratiques et les conditions requises les concernant, consultez la page Présentation de la restauration d'une instance.

Restaurer à partir d'une sauvegarde à la demande ou automatique

Vous pouvez utiliser une sauvegarde à la demande ou automatique dans les scénarios suivants :

  • Restaurer sur une autre instance du même projet
  • Restaurer sur la même instance à partir de laquelle la sauvegarde a été effectuée
  • Restaurer sur une autre instance dans un autre projet ou une autre région

Si la récupération à un moment précis (PITR) est activée, vous pouvez récupérer votre instance à un moment spécifique, en fonction des paramètres de conservation des journaux de votre instance.

Pour restaurer une instance à partir d'une sauvegarde, les instances de sauvegarde et cible doivent se trouver dans le même fuseau horaire.

Effectuer une restauration sur une autre instance

Lorsque vous restaurez des données à partir d'une sauvegarde sur une autre instance, les données de l'instance cible sont mises à jour selon l'état de l'instance source au moment de la sauvegarde. Pour en savoir plus, consultez les sections Conseils généraux pour effectuer une restauration et Conseils et prérequis pour restaurer sur une autre instance.

Si vous avez besoin d'une liste de sauvegardes pour le projet et que vous ne pouvez pas les consulter sur la page de présentation de l'instance en raison d'une panne, vous pouvez utiliser l'API backupRuns.list avec un caractère générique (-). Cette option permet de récupérer la liste de toutes les sauvegardes de toutes les instances du projet. Pour en savoir plus, consultez Afficher les sauvegardes en cas de panne.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Si l'instance cible comporte des instances dupliquées avec accès en lecture, supprimez-les depuis le menu "Autres actions" Icône Plus.
  3. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  4. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  5. Recherchez la sauvegarde à partir de laquelle vous souhaitez effectuer la restauration, puis cliquez sur Restaurer.
  6. Sur la page Restaurer une instance à partir d'une sauvegarde, vérifiez que vous avez sélectionné la bonne sauvegarde dans la section Vérifier les détails de la sauvegarde.
  7. Dans Choisir la destination de la restauration, sélectionnez Écraser une instance existante.
  8. Dans le menu Instance à écraser, sélectionnez l'instance à utiliser pour la restauration. L'instance que vous sélectionnez et toutes ses données sont écrasées.
  9. Pour confirmer votre sélection, saisissez le nom de l'instance à écraser dans le champ ID de l'instance de destination.
  10. Pour démarrer le processus de restauration, cliquez sur Restaurer.
  11. Pour vérifier l'état de l'opération de restauration, accédez à la page Opérations de l'instance.
  12. Une fois l'opération de restauration terminée, recréez les instances dupliquées que vous avez supprimées lors de cette procédure.

gcloud

  1. Pour déterminer si l'instance cible possède des instances répliquées avec accès en lecture, utilisez la commande gcloud sql instances describe : 
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Notez toutes les instances listées dans la colonne replicaNames.

  2. Pour supprimer tous les réplicas, utilisez la commande gcloud sql instances delete : 
    gcloud sql instances delete REPLICA_NAME

    Répétez l'opération pour chaque instance dupliquée.

  3. Pour lister les sauvegardes de l'instance source, utilisez la commande gcloud sql backups list : 
    gcloud sql backups list \
--instance SOURCE_INSTANCE_NAME
  4. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur ID.
  5. Pour restaurer l'instance cible à partir de la sauvegarde, utilisez la commande gcloud sql backups restore : 
    gcloud sql backups restore BACKUP_ID \
--restore-instance=TARGET_INSTANCE_NAME \
--backup-instance=SOURCE_INSTANCE_NAME
  6. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

REST v1

  1. Pour déterminer si l'instance comporte des instances répliquées avec accès en lecture et obtenir leurs ID, listez toutes les instances répliquées de l'instance cible.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Supprimez toutes les instances dupliquées.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • REPLICA_ID : ID de l'instance répliquée

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

    Répétez l'opération pour chaque instance dupliquée.

  3. Pour obtenir l'identifiant de la sauvegarde que vous souhaitez utiliser, listez les sauvegardes de l'instance source.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

    -OU-

    Si votre instance se trouve dans une région ayant subi une panne, répertoriez toutes les sauvegardes d'un projet.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID d'instance, ou - pour obtenir la liste de toutes les sauvegardes du projet.

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

    Recherchez la sauvegarde de l'instance à restaurer.

  4. Restaurez l'instance cible à partir de la sauvegarde.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • target-instance-id : ID de l'instance cible
    • source-instance-id : ID de l'instance source
    • backup-id : ID de la sauvegarde

    Méthode HTTP et URL :

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

    Corps JSON de la requête :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  5. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

REST v1beta4

  1. Pour déterminer si l'instance comporte des instances répliquées avec accès en lecture et obtenir leurs ID, listez toutes les instances répliquées de l'instance cible.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Supprimez toutes les instances dupliquées.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • REPLICA_ID : ID de l'instance répliquée

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

    Répétez l'opération pour chaque instance dupliquée.

  3. Pour obtenir l'identifiant de la sauvegarde que vous souhaitez utiliser, listez les sauvegardes de l'instance source.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  4. Restaurez l'instance cible à partir de la sauvegarde.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • target-instance-id : ID de l'instance cible
    • source-instance-id : ID de l'instance source
    • backup-id : ID de la sauvegarde

    Méthode HTTP et URL :

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

    Corps JSON de la requête :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  5. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

Effectuer une restauration sur la même instance

Lorsque vous restaurez des données à partir d'une sauvegarde sur la même instance, les données de cette instance sont rétablies à l'état existant au moment de la sauvegarde. Pour en savoir plus sur la restauration d'une instance, consultez la section Conseils généraux pour effectuer une restauration.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Si l'instance cible comporte des instances dupliquées avec accès en lecture, supprimez-les depuis le menu "Autres actions" Icône Plus.
  3. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  4. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  5. Recherchez la sauvegarde que vous souhaitez utiliser, puis cliquez sur Restaurer.
  6. Sur la page Restaurer une instance à partir d'une sauvegarde, vérifiez que vous avez sélectionné la bonne sauvegarde dans la section Vérifier les détails de la sauvegarde.
  7. Dans Choisir la destination de la restauration, sélectionnez Écraser l'instance source.

    Vérifiez que le nom de l'instance source est spécifié entre parenthèses.

  8. Pour confirmer votre sélection, saisissez le nom de l'instance dans le champ ID de l'instance de destination.
  9. Pour démarrer le processus de restauration, cliquez sur Restaurer.
  10. Pour vérifier l'état de l'opération de restauration, accédez à la page Opérations de l'instance.
  11. Une fois l'opération de restauration terminée, recréez les instances dupliquées que vous avez supprimées lors de cette procédure.

gcloud

  1. Pour déterminer si l'instance comporte des répliques en lecture, utilisez la commande gcloud sql instances describe : 
    gcloud sql instances describe INSTANCE_NAME

    Notez toutes les instances listées dans la colonne replicaNames.

  2. Pour supprimer tous les réplicas, utilisez la commande gcloud sql instances delete : 
    gcloud sql instances delete REPLICA_NAME

    Répétez l'opération pour chaque instance dupliquée.

  3. Pour lister les sauvegardes de l'instance, utilisez la commande gcloud sql backups list : 
    gcloud sql backups list --instance INSTANCE_NAME
  4. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur ID.
  5. Pour restaurer l'instance à partir de la sauvegarde spécifiée, utilisez la commande gcloud sql backups restore : 
    gcloud sql backups restore BACKUP_ID \
--restore-instance=INSTANCE_NAME
  6. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

REST v1

  1. Pour obtenir l'ID de la sauvegarde que vous souhaitez utiliser, listez les sauvegardes de l'instance.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Restaurez l'instance à partir de la sauvegarde spécifiée.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance
    • BACKUP_ID : ID de la sauvegarde

    Méthode HTTP et URL : 

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

    Corps JSON de la requête :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  3. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

REST v1beta4

  1. Pour obtenir l'ID de la sauvegarde que vous souhaitez utiliser, listez les sauvegardes de l'instance.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • project-id : ID du projet
    • instance-id : ID de l'instance.

    Méthode HTTP et URL :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Restaurez l'instance à partir de la sauvegarde spécifiée.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance
    • BACKUP_RUN_ID : code temporel indiquant la date et l'heure auxquelles Cloud SQL restaure l'instance à partir de la sauvegarde

    Méthode HTTP et URL : 

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

    Corps JSON de la requête :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  3. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

Effectuer une restauration sur une instance d'un autre projet

Le paramètre project vous permet de restaurer des données sur une instance d'un autre projet que celui où la sauvegarde a été effectuée. Lorsque vous utilisez le paramètre project, appelez restoreBackup dans le projet et sur l'instance sur laquelle vous souhaitez restaurer les données. Lorsque vous effectuez une restauration à partir d'une sauvegarde sur une autre instance, les données de l'instance cible sont mises à jour selon l'état de l'instance source au moment de la sauvegarde.

Autorisations

L'utilisateur qui restaure sur un autre projet doit disposer de l'autorisation cloudsql.instances.restoreBackup pour le projet cible et de l'autorisation cloudsql.backupRuns.get pour l'instance source. Ces autorisations sont incluses dans le rôle Cloud SQL Admin.

Pour restaurer les données sur une instance d'un autre projet :

gcloud

  1. Répertoriez les sauvegardes de l'instance. 

    gcloud sql backups list --instance INSTANCE_NAME

    Remplacez INSTANCE_NAME par le nom de l'instance.

  2. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur ID.

  3. Restaurez les données sur une instance d'un autre projet. 

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

    Effectuez les remplacements suivants :

    • BACKUP_ID : ID de la sauvegarde. Vous avez obtenu cet ID plus tôt dans cette procédure.
    • TARGET_INSTANCE_NAME : instance du projet de destination vers laquelle vous restaurez les données.
    • SOURCE_INSTANCE_NAME : instance du projet source contenant les données que vous souhaitez restaurer dans l'instance du projet de destination.
    • SOURCE_INSTANCE_PROJECT : projet contenant l'instance source.

REST v1

Pour obtenir l'identifiant backupId, exécutez la commande suivante.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • project-id : ID du projet
  • instance-id : ID de l'instance.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurez la sauvegarde sur une instance dans un autre projet :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • source-project-id : ID du projet source
  • target-project-id : ID du projet cible
  • target-instance-id : ID de l'instance cible
  • source-instance-id : ID de l'instance source
  • backup-id : ID de la sauvegarde

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Pour en savoir plus sur la propriété project, consultez la section sur restoreBackup

REST v1beta4

Pour obtenir l'identifiant backupId, exécutez la commande suivante.

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • project-id : ID du projet
  • instance-id : ID de l'instance.

Méthode HTTP et URL :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurez la sauvegarde sur une instance dans un autre projet :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • source-project-id : ID du projet source
  • target-project-id : ID du projet cible
  • target-instance-id : ID de l'instance cible
  • source-instance-id : ID de l'instance source
  • backup-id : ID de la sauvegarde

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Pour en savoir plus sur la propriété project, consultez la section sur restoreBackup

Restaurer à partir d'une sauvegarde finale

Vous pouvez utiliser une sauvegarde finale dans les scénarios suivants :

  • Restaurer la sauvegarde finale sur une nouvelle instance
  • Restaurer sur une nouvelle instance dans un autre projet ou une autre région

Étant donné que vous utilisez une sauvegarde finale d'une instance supprimée pour restaurer votre instance, vous pouvez également utiliser la sauvegarde pour créer une instance avec la configuration de l'instance supprimée et récupérer vos données.

Restaurer dans une nouvelle instance

Lorsque vous créez une instance à partir d'une sauvegarde finale, Cloud SQL utilise les paramètres de configuration de l'instance à partir de laquelle la sauvegarde finale est effectuée. Une fois l'instance créée, Cloud SQL restaure les données à l'état où elles se trouvaient lors de la dernière sauvegarde.

Console

  1. Dans la console Google Cloud , accédez à la page Sauvegardes Cloud SQL.

    Accéder aux sauvegardes Cloud SQL

    Cette page liste toutes les sauvegardes, y compris les sauvegardes finales, associées à un projet Google Cloud .

  2. Cliquez sur la sauvegarde finale contenant les données que vous souhaitez restaurer sur une nouvelle instance.
  3. Dans la boîte de dialogue Sauvegarde finale, cliquez sur Restaurer.
  4. Sur la page Restaurer une instance à partir d'une sauvegarde, vérifiez que vous avez sélectionné la bonne sauvegarde dans la section Vérifier les détails de la sauvegarde.
  5. Dans Choisir la destination de la restauration, sélectionnez Restaurer sur une nouvelle instance.
  6. Dans le menu Région, sélectionnez la région de la nouvelle instance.
  7. Dans le champ ID d'instance, saisissez un ID pour la nouvelle instance.
  8. Pour démarrer le processus de restauration, cliquez sur Restaurer.
  9. Pour vérifier l'état de l'opération de restauration, accédez à la page Opérations de l'instance.

gcloud

  1. Pour lister les sauvegardes finales de l'instance source, utilisez la commande gcloud sql backups list : 
    gcloud sql backups list \
--filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  2. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur NAME.
  3. Pour restaurer une nouvelle instance à partir de la sauvegarde finale spécifiée, utilisez la commande gcloud sql backups restore : 
    gcloud sql backups restore BACKUP_NAME \
--restore-instance=TARGET_INSTANCE_NAME

REST v1

  1. Pour obtenir l'identifiant de la sauvegarde que vous souhaitez utiliser, listez les sauvegardes finales de l'instance source.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Restaurez une nouvelle instance à partir de la sauvegarde finale spécifiée.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • TARGET_INSTANCE_ID : ID de l'instance cible
    • BACKUP_ID : ID de la sauvegarde

    Méthode HTTP et URL : 

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

    Corps JSON de la requête :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

  1. Pour obtenir l'identifiant de la sauvegarde que vous souhaitez utiliser, listez les sauvegardes finales de l'instance source.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Restaurez une nouvelle instance à partir de la sauvegarde finale spécifiée.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • TARGET_INSTANCE_ID : ID de l'instance cible
    • BACKUP_ID : ID de la sauvegarde

    Méthode HTTP et URL : 

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

    Corps JSON de la requête :

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

Restaurer sur une instance existante

Lorsque vous restaurez des données à partir d'une sauvegarde finale sur une instance existante, les données de l'instance cible sont mises à jour selon l'état de l'instance source au moment de la sauvegarde. Pour en savoir plus, consultez les sections Conseils généraux pour effectuer une restauration et Conseils et prérequis pour restaurer sur une autre instance.

Si vous avez besoin d'une liste de sauvegardes pour le projet et que vous ne pouvez pas les consulter sur la page de présentation de l'instance en raison d'une panne, vous pouvez utiliser l'API backupRuns.list.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Si l'instance cible comporte des instances dupliquées avec accès en lecture, supprimez-les depuis le menu "Autres actions" Icône Plus.

  3. Dans la console Google Cloud , accédez à la page Sauvegardes Cloud SQL.

    Accéder aux sauvegardes Cloud SQL

    Cette page liste toutes les sauvegardes, y compris les sauvegardes finales, associées à un projet Google Cloud .

  4. Cliquez sur la sauvegarde finale contenant les données que vous souhaitez restaurer sur une autre instance.
  5. Dans la boîte de dialogue Dernière sauvegarde, cliquez sur Restaurer.
  6. Sur la page Restaurer une instance à partir d'une sauvegarde, vérifiez que vous avez sélectionné la bonne sauvegarde dans la section Vérifier les détails de la sauvegarde.
  7. Dans Choisir la destination de la restauration, sélectionnez Écraser une instance existante.

  8. Dans le menu Instance à écraser, sélectionnez l'instance à utiliser pour la restauration. L'instance que vous sélectionnez et toutes ses données sont écrasées.

  9. Pour confirmer votre sélection, saisissez le nom de l'instance à écraser dans le champ ID de l'instance de destination.
  10. Pour démarrer le processus de restauration, cliquez sur Restaurer.
  11. Pour vérifier l'état de l'opération de restauration, accédez à la page Opérations de l'instance.
  12. Une fois l'opération de restauration terminée, recréez les instances dupliquées que vous avez supprimées lors de cette procédure.

gcloud

  1. Pour déterminer si l'instance cible possède des instances répliquées avec accès en lecture, utilisez la commande gcloud sql instances describe : 
    gcloud sql instances describe TARGET_INSTANCE_NAME

    Notez toutes les instances listées dans la colonne replicaNames.

  2. Pour supprimer tous les réplicas, utilisez la commande gcloud sql instances delete : 
    gcloud sql instances delete REPLICA_NAME

    Répétez l'opération pour chaque instance dupliquée.

  3. Pour lister les sauvegardes finales de l'instance source, utilisez la commande gcloud sql backups list : 
    gcloud sql backups list \
--filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  4. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur NAME.
  5. Pour restaurer l'instance cible à partir de la sauvegarde, utilisez la commande gcloud sql backups restore : 
    gcloud sql backups restore BACKUP_NAME \
--restore-instance=TARGET_INSTANCE_NAME
  6. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

REST v1

  1. Pour déterminer si l'instance comporte des instances répliquées avec accès en lecture et obtenir leurs ID, listez toutes les instances répliquées de l'instance cible.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

    GET https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Supprimez toutes les instances dupliquées.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • REPLICA_ID : ID de l'instance répliquée

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

    Répétez l'opération pour chaque instance dupliquée.

  3. Pour obtenir l'ID de la sauvegarde finale que vous souhaitez utiliser, listez les sauvegardes de l'instance source.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

    Recherchez la sauvegarde de l'instance à restaurer.

  4. Restaurez l'instance cible à partir de la sauvegarde.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • TARGET_INSTANCE_ID : ID de l'instance cible
    • BACKUP_ID : ID de la sauvegarde

    Méthode HTTP et URL : 

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

    Corps JSON de la requête :

    {
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  5. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

REST v1beta4

  1. Pour déterminer si l'instance comporte des instances répliquées avec accès en lecture et obtenir leurs ID, listez toutes les instances répliquées de l'instance cible.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Supprimez toutes les instances dupliquées.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • REPLICA_ID : ID de l'instance répliquée

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

    Répétez l'opération pour chaque instance dupliquée.

  3. Pour obtenir l'ID de la sauvegarde finale que vous souhaitez utiliser, listez les sauvegardes de l'instance source.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

    Recherchez la sauvegarde de l'instance à restaurer.
  4. Restaurez l'instance cible à partir de la sauvegarde.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • TARGET_INSTANCE_ID : ID de l'instance cible
    • BACKUP_ID : ID de la sauvegarde

    Méthode HTTP et URL : 

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

    Corps JSON de la requête :

    {
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  5. Une fois l'opération de restauration terminée, recréez les instances répliquées que vous avez supprimées lors de cette procédure.

Effectuer une restauration sur une instance d'un autre projet

L'utilisateur qui restaure des données sur une instance d'un autre projet doit disposer des autorisations cloudsql.instances.restoreBackup, cloudsql.instances.create pour le projet cible et cloudsql.backupRuns.get pour l'instance source. Ces autorisations sont incluses dans le rôle Cloud SQL Admin.

Pour restaurer les données sur une instance d'un autre projet :

REST v1

Pour obtenir l'identifiant backupId de la sauvegarde finale, exécutez la commande suivante :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • INSTANCE_ID : ID de l'instance

Méthode HTTP et URL : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurez la sauvegarde sur une instance dans un autre projet :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde

Méthode HTTP et URL : 

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

Corps JSON de la requête :

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Pour en savoir plus sur la propriété project, consultez la section sur restoreBackup

REST v1beta4

Pour obtenir l'identifiant backupId de la sauvegarde finale, exécutez la commande suivante :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • INSTANCE_ID : ID de l'instance

Méthode HTTP et URL : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurez la sauvegarde sur une instance dans un autre projet :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde

Méthode HTTP et URL : 

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

Corps JSON de la requête :

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Pour en savoir plus sur la propriété project, consultez la section sur restoreBackup

Restaurer sur une nouvelle instance dans une autre région

L'utilisateur qui restaure des données sur une nouvelle instance dans une autre région doit disposer de l'autorisation cloudsql.instances.restoreBackup pour le projet cible et de l'autorisation cloudsql.backupRuns.get pour l'instance source. Ces autorisations sont incluses dans le rôle Cloud SQL Admin.

De plus, pour créer une instance dans une autre région, vous devez respecter les critères des règles d'administration pour cette région.

Pour restaurer des données sur une nouvelle instance dans une autre région :

gcloud

  1. Pour lister les sauvegardes finales de l'instance source, utilisez la commande gcloud sql backups list : 
    gcloud sql backups list \
--filter='type:FINAL instance: SOURCE_INSTANCE_NAME'
  2. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur NAME.
  3. Pour utiliser la sauvegarde finale afin de restaurer les données sur une nouvelle instance dans une autre région, utilisez la commande gcloud sql backups restore : 
    gcloud sql backups restore BACKUP_NAME \
--restore-instance=TARGET_INSTANCE_NAME \
--region=TARGET_REGION

REST v1

Pour obtenir l'identifiant backupId de la sauvegarde finale, exécutez la commande suivante :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • INSTANCE_ID : ID de l'instance

Méthode HTTP et URL : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurez la sauvegarde sur une nouvelle instance dans une autre région :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde
  • REGION : région de l'instance cible (par exemple, us-central1)

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Pour en savoir plus sur la propriété project, consultez la section sur restoreBackup

REST v1beta4

Pour obtenir l'identifiant backupId de la sauvegarde finale, exécutez la commande suivante :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • INSTANCE_ID : ID de l'instance

Méthode HTTP et URL : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurez la sauvegarde sur une nouvelle instance dans une autre région :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde
  • REGION : région de l'instance cible (par exemple, us-central1)

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Pour en savoir plus sur la propriété project, consultez la section sur restoreBackup

Restaurer à partir d'une sauvegarde conservée

Vous pouvez utiliser une sauvegarde conservée dans les scénarios suivants :

  • Restaurer la sauvegarde conservée sur une nouvelle instance
  • Restaurez la sauvegarde conservée sur une instance existante
  • Restaurer sur une instance nouvelle ou existante dans un autre projet ou une autre région

Étant donné que vous utilisez une sauvegarde conservée d'une instance supprimée pour restaurer votre instance, vous pouvez également utiliser la sauvegarde pour créer une instance avec la configuration de l'instance supprimée et récupérer vos données.

Restaurer une sauvegarde conservée sur une nouvelle instance

Lorsque vous créez une instance à partir d'une sauvegarde conservée, Cloud SQL utilise les paramètres de configuration de l'instance à partir de laquelle la sauvegarde conservée a été effectuée.

Pour restaurer des données à partir d'une sauvegarde conservée vers une nouvelle instance, vous devez disposer de l'autorisation cloudsql.instances.create.

Console

  1. Dans la console Google Cloud , accédez à la page Sauvegardes Cloud SQL.

    Accéder aux sauvegardes Cloud SQL

  2. Cliquez sur le nom de l'instance supprimée contenant la sauvegarde que vous souhaitez restaurer.

  3. Recherchez le nom de la sauvegarde que vous souhaitez restaurer, puis cliquez sur Restaurer.

  4. Sur la page Restaurer une instance à partir d'une sauvegarde, vérifiez que vous avez sélectionné la bonne sauvegarde dans la section Vérifier les détails de la sauvegarde.

  5. Dans Choisir la destination de la restauration, sélectionnez Restaurer sur une nouvelle instance.

  6. Dans le menu Région, sélectionnez la région de la nouvelle instance.

  7. Dans le champ ID d'instance, saisissez un ID pour la nouvelle instance.

  8. Cliquez sur Restaurer.

    Cloud SQL restaurera la sauvegarde sur une nouvelle instance. Pour vérifier l'état de l'opération de restauration, accédez à la page Opérations de l'instance.

gcloud

  1. Utilisez gcloud sql backups list pour trouver la sauvegarde que vous souhaitez stocker dans une nouvelle instance.

    gcloud sql backups list
--project=PROJECT_ID

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud .

  2. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur BACKUP_NAME.

  3. Pour restaurer une sauvegarde dans une nouvelle instance, utilisez la commande gcloud sql backups restore :

    gcloud sql backups restore BACKUP_NAME
--restore-instance=TARGET_INSTANCE_NAME

    Remplacez les éléments suivants :

    • BACKUP_NAME : nom de la sauvegarde conservée que vous souhaitez restaurer.

    • TARGET_INSTANCE_NAME : nom de la nouvelle instance sur laquelle vous souhaitez restaurer la sauvegarde.

REST v1

Restaurer une nouvelle instance à partir de la sauvegarde conservée spécifiée

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

Restaurer une nouvelle instance à partir de la sauvegarde conservée spécifiée

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurer une sauvegarde conservée sur une instance existante

Lorsque vous restaurez des données à partir d'une sauvegarde conservée sur une instance existante, les données de l'instance cible sont mises à jour selon l'état de l'instance source au moment de la sauvegarde.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Si l'instance cible comporte des instances répliquées avec accès en lecture, supprimez-les à l'aide du menu "Autres actions" Icône Plus. Toutes les répliques doivent être supprimées avant de pouvoir restaurer la sauvegarde conservée sur l'instance existante.

  3. Dans la console Google Cloud , accédez à la page Sauvegardes Cloud SQL.

    Accéder aux sauvegardes Cloud SQL

  4. Cliquez sur le nom de l'instance supprimée contenant la sauvegarde que vous souhaitez restaurer.

  5. Recherchez le nom de la sauvegarde que vous souhaitez restaurer, puis cliquez sur Restaurer.

  6. Sur la page Restaurer une instance à partir d'une sauvegarde, vérifiez que vous avez sélectionné la bonne sauvegarde dans la section Vérifier les détails de la sauvegarde.

  7. Dans Choisir la destination de la restauration, sélectionnez Écraser une instance existante.

  8. Dans le menu Instance à écraser, sélectionnez l'instance à utiliser pour la restauration. L'instance que vous sélectionnez et toutes ses données seront écrasées.

  9. Pour confirmer votre sélection, saisissez le nom de l'instance à écraser dans le champ ID de l'instance de destination.

  10. Cliquez sur Restaurer.

    Cloud SQL restaure la sauvegarde sur l'instance existante. Pour vérifier l'état de l'opération de restauration, accédez à la page Opérations de l'instance.

    Vous pouvez créer des répliques une fois l'opération de restauration terminée.

gcloud

  1. Déterminez si l'instance cible possède des instances répliquées avec accès en lecture à l'aide de la commande gcloud sql instances describe :

    gcloud sql instance describe TARGET_INSTANCE_NAME

    Remplacez les éléments suivants :

    • TARGET_INSTANCE_NAME : nom de l'instance cible sur laquelle vous souhaitez restaurer votre sauvegarde.

  2. Supprimez toutes les instances dupliquées de votre instance cible à l'aide de la commande gcloud sql instances delete :

    gcloud sql instance delete REPLICA_NAME

    Remplacez les éléments suivants :

    • REPLICA_NAME : nom de la réplique de l'instance cible que vous souhaitez supprimer.

    Vous devez supprimer toutes les répliques avant de pouvoir restaurer une instance existante.

  3. Utilisez gcloud sql backups list pour trouver la sauvegarde que vous souhaitez restaurer sur l'instance existante.

    gcloud sql backups list
--project=PROJECT_ID

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud .

  4. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur BACKUP_NAME.

  5. Pour restaurer une instance existante, utilisez la commande gcloud sql backups restore :

    gcloud sql backups restore BACKUP_NAME
--restore-instance=TARGET_INSTANCE_NAME

    Remplacez les éléments suivants :

    • BACKUP_NAME : nom de la sauvegarde conservée que vous souhaitez restaurer.

    • TARGET_INSTANCE_NAME : nom de l'instance existante sur laquelle vous souhaitez restaurer la sauvegarde.

    Une fois l'opération de restauration terminée, recréez les instances répliquées qui ont été supprimées.

REST v1

  1. Pour déterminer si l'instance possède des instances répliquées avec accès en lecture et obtenir les ID de ces instances, listez toutes les instances répliquées de l'instance cible.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Supprimez toutes les instances répliquées de l'instance cible.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • REPLICA_ID : ID de l'instance répliquée

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  3. Obtenez l'ID de la sauvegarde conservée que vous souhaitez restaurer.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  4. Restaurez l'instance cible à partir de la sauvegarde conservée.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • TARGET_INSTANCE_ID : ID de l'instance cible
    • BACKUP_ID : ID de la sauvegarde

    Méthode HTTP et URL : 

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

    Corps JSON de la requête :

    {
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

  1. Pour déterminer si l'instance possède des instances répliquées avec accès en lecture et obtenir les ID de ces instances, listez toutes les instances répliquées de l'instance cible.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • INSTANCE_ID : ID de l'instance

    Méthode HTTP et URL : 

    GET https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_ID?fields=replicaNames

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  2. Supprimez toutes les instances répliquées de l'instance cible.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • REPLICA_ID : ID de l'instance répliquée

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  3. Obtenez l'ID de la sauvegarde conservée que vous souhaitez restaurer.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet

    Méthode HTTP et URL : 

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

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

  4. Restaurez l'instance cible à partir de la sauvegarde conservée.

    Avant d'utiliser les données de requête, effectuez les remplacements suivants :

    • PROJECT_ID : ID du projet
    • TARGET_INSTANCE_ID : ID de l'instance cible
    • BACKUP_ID : ID de la sauvegarde

    Méthode HTTP et URL : 

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

    Corps JSON de la requête :

    {
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

    Pour envoyer votre requête, développez l'une des options suivantes :

    Vous devriez recevoir une réponse JSON de ce type :

Effectuer une restauration sur une instance d'un autre projet

Pour restaurer une instance à l'aide d'une sauvegarde conservée dans un autre projet, vous devez disposer des autorisations suivantes :

Vous ne pouvez effectuer une restauration vers un autre projet qu'à l'aide de la gcloud CLI ou de l'API Cloud SQL.

gcloud

  1. Utilisez gcloud sql backups list pour trouver la sauvegarde que vous souhaitez stocker dans une nouvelle instance.

    gcloud sql backups list
--project=PROJECT_ID

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud .

  2. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur BACKUP_NAME.

  3. Pour restaurer une sauvegarde dans une nouvelle instance, utilisez la commande gcloud sql backups restore :

    gcloud sql backups restore BACKUP_NAME
--restore-instance=TARGET_INSTANCE_NAME

    Remplacez les éléments suivants :

    • BACKUP_NAME : nom de la sauvegarde conservée que vous souhaitez restaurer.

    • TARGET_INSTANCE_NAME : nom de la nouvelle instance située dans le projet cible sur lequel vous souhaitez restaurer la sauvegarde.

REST v1

Pour obtenir le backupID de la sauvegarde conservée, exécutez la commande suivante :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet

Méthode HTTP et URL : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurer dans un autre projet

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde

Méthode HTTP et URL : 

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

Corps JSON de la requête :

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

Pour obtenir le backupID de la sauvegarde conservée, exécutez la commande suivante :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet

Méthode HTTP et URL : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurer dans un autre projet

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde

Méthode HTTP et URL : 

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

Corps JSON de la requête :

{
  backup: projects/PROJECT_ID/backups/BACKUP_ID
}

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Effectuer une restauration sur une instance d'une autre région

Pour restaurer une instance à l'aide d'une sauvegarde conservée dans une autre région, vous devez disposer des autorisations suivantes :

Vous ne pouvez effectuer une restauration dans une autre région qu'à l'aide de gcloud CLI ou de l'API Cloud SQL. Votre région cible doit respecter les règles d'administration de la région.

gcloud

  1. Utilisez gcloud sql backups list pour trouver la sauvegarde que vous souhaitez stocker dans une nouvelle instance.

    gcloud sql backups list
--project=PROJECT_ID

    Remplacez les éléments suivants :

    • PROJECT_ID : ID de votre projet Google Cloud .

  2. Recherchez la sauvegarde que vous souhaitez utiliser, puis enregistrez sa valeur NAME.

  3. Pour restaurer une sauvegarde dans une nouvelle instance, utilisez la commande gcloud sql backups restore :

    gcloud sql backups restore BACKUP_NAME
--restore-instance=TARGET_INSTANCE_NAME
--region=TARGET_REGION

    Remplacez les éléments suivants :

    • BACKUP_NAME : nom de la sauvegarde conservée que vous souhaitez restaurer.

    • TARGET_INSTANCE_NAME : nom de la nouvelle instance située dans le projet cible sur lequel vous souhaitez restaurer la sauvegarde.

    • TARGET_REGION : nouvelle région dans laquelle vous souhaitez restaurer la sauvegarde.

REST v1

Pour obtenir le backupID de la sauvegarde conservée, exécutez la commande suivante :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet

Méthode HTTP et URL : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurer dans un autre projet

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde
  • REGION : région de l'instance cible (par exemple, us-central1)

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

REST v1beta4

Pour obtenir le backupID de la sauvegarde conservée, exécutez la commande suivante :

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet

Méthode HTTP et URL : 

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurer dans un autre projet

Avant d'utiliser les données de requête, effectuez les remplacements suivants :

  • PROJECT_ID : ID du projet
  • TARGET_INSTANCE_ID : ID de l'instance cible
  • BACKUP_ID : ID de la sauvegarde
  • REGION : région de l'instance cible (par exemple, us-central1)

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

Pour envoyer votre requête, développez l'une des options suivantes :

Vous devriez recevoir une réponse JSON de ce type :

Restaurer à partir d'une sauvegarde dans le coffre-fort de sauvegarde

Si votre instance Cloud SQL est configurée pour utiliser les sauvegardes améliorées, vous pouvez la restaurer à partir d'une sauvegarde dans le coffre-fort de sauvegarde. Vous pouvez restaurer votre instance dans les cas suivants :

  • Restaurer dans une nouvelle instance
  • Restaurer sur une instance existante
  • Restaurer sur une instance nouvelle ou existante dans un autre projet

Restaurer une sauvegarde du coffre de sauvegarde sur une nouvelle instance

Lorsque vous restaurez des données à partir d'une sauvegarde sur une nouvelle instance, les données de l'instance cible sont mises à jour selon l'état de l'instance source au moment de la sauvegarde.

Console

  1. Dans la console Google Cloud , accédez à la page Sauvegardes Cloud SQL.

    Accéder aux sauvegardes Cloud SQL

  2. Dans le menu déroulant Niveau de sauvegarde, sélectionnez Niveau avancé, puis sélectionnez le coffre-fort de sauvegarde contenant la sauvegarde que vous souhaitez utiliser.

    Toutes les sauvegardes disponibles dans le coffre de sauvegarde pour l'instance sélectionnée s'affichent.

  3. Recherchez le nom de la sauvegarde que vous souhaitez restaurer, puis cliquez sur Restaurer.

  4. Sur la page Restaurer une instance à partir d'une sauvegarde, vérifiez que vous avez sélectionné la bonne sauvegarde dans la section Vérifier les détails de la sauvegarde.

  5. Dans Choisir la destination de la restauration, sélectionnez Restaurer vers une nouvelle instance, puis modifiez les éléments suivants :

    • Sous Projet, sélectionnez le projet pour votre nouvelle instance. Le projet doit se trouver dans la même région que votre coffre de sauvegarde et vous devez y avoir accès.

    • Sous Région, vérifiez la région. La région doit correspondre à celle de la nouvelle instance.

    • Dans le champ ID de l'instance, attribuez un nom à votre nouvelle instance. Ce nom est définitif et ne peut pas être modifié.

  6. Cliquez sur Restaurer.

    Cloud SQL restaure la sauvegarde sur une nouvelle instance. Pour vérifier l'état de l'opération de restauration, accédez à la page Opérations de l'instance.

    La nouvelle instance est configurée par défaut avec l'option de sauvegarde standard. Pour passer aux sauvegardes améliorées, consultez Activer les sauvegardes améliorées.

    Vous pouvez créer des répliques une fois l'opération de restauration terminée.

gcloud

Pour restaurer une sauvegarde dans une nouvelle instance, utilisez la commande gcloud sql backups restore :

gcloud sql backups restore BACKUP_ID
--restore-instance=TARGET_INSTANCE_NAME

Remplacez les éléments suivants :

  • BACKUP_ID : ID de la sauvegarde dans le coffre-fort de sauvegardes. Vous devrez inclure le chemin complet de la sauvegarde dans ce champ. Pour trouver le chemin d'accès complet, consultez Lister toutes les sauvegardes du coffre de sauvegarde pour une instance.

  • TARGET_INSTANCE_NAME : nom de la nouvelle instance sur laquelle vous souhaitez restaurer la sauvegarde.

REST v1

REST v1beta4

Restaurer une sauvegarde à partir du coffre-fort de sauvegardes sur une instance existante

Lorsque vous restaurez des données à partir d'une sauvegarde sur une instance existante, les données de l'instance cible sont mises à jour selon l'état de l'instance source au moment de la sauvegarde.

Console

  1. Dans la console Google Cloud , accédez à la page Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Si l'instance cible comporte des instances répliquées avec accès en lecture, supprimez-les à l'aide du menu "Autres actions" Icône Plus. Toutes les répliques doivent être supprimées avant de pouvoir restaurer la sauvegarde conservée sur l'instance existante.

  3. Dans la console Google Cloud , accédez à la page Sauvegardes Cloud SQL.

    Accéder aux sauvegardes Cloud SQL

  4. Dans le menu déroulant Niveau de sauvegarde, sélectionnez Niveau avancé, puis sélectionnez le coffre-fort de sauvegarde contenant la sauvegarde que vous souhaitez utiliser.

    Toutes les sauvegardes disponibles dans le coffre de sauvegarde pour l'instance sélectionnée s'affichent.

  5. Recherchez le nom de la sauvegarde que vous souhaitez restaurer, puis cliquez sur Restaurer.

  6. Sur la page Restaurer une instance à partir d'une sauvegarde, vérifiez que vous avez sélectionné la bonne sauvegarde dans la section Vérifier les détails de la sauvegarde.

  7. Dans Choisir la destination de la restauration, sélectionnez Écraser une instance existante.

  8. Dans le menu Instance à écraser, sélectionnez l'instance à utiliser pour la restauration. L'instance que vous sélectionnez et toutes ses données seront écrasées.

  9. Pour confirmer votre sélection, saisissez le nom de l'instance à écraser dans le champ ID de l'instance de destination.

  10. Cliquez sur Restaurer.

    Cloud SQL restaure la sauvegarde sur l'instance existante. Pour vérifier l'état de l'opération de restauration, accédez à la page Opérations de l'instance.

    Vous pouvez créer des répliques une fois l'opération de restauration terminée.

gcloud

Pour restaurer une sauvegarde à partir d'un coffre de sauvegarde sur une instance existante, procédez comme suit :

  1. Déterminez si l'instance cible possède des instances répliquées avec accès en lecture à l'aide de la commande gcloud sql instances describe :

    gcloud sql instance describe TARGET_INSTANCE_NAME

    Remplacez les éléments suivants :

    • TARGET_INSTANCE_NAME : nom de l'instance cible.

  2. Supprimez toutes les instances dupliquées de votre instance cible à l'aide de la commande gcloud sql instances delete :

    gcloud sql instance delete REPLICA_NAME

    Remplacez les éléments suivants :

    • REPLICA_NAME : nom de la réplique de l'instance cible.

    Vous devez supprimer toutes les répliques avant de pouvoir restaurer une instance existante.

  3. Recherchez la sauvegarde que vous souhaitez utiliser à l'aide de la commande list all the backups in the backup vault for an instance (lister toutes les sauvegardes du backup vault pour une instance). Vous aurez besoin du chemin d'accès complet à la sauvegarde pour la restaurer.

  4. Pour restaurer une instance existante, utilisez la commande gcloud sql backups restore :

    gcloud sql backups restore BACKUP_ID
--restore-instance=TARGET_INSTANCE_NAME

    Remplacez les éléments suivants :

    Une fois l'opération de restauration terminée, recréez les instances répliquées qui ont été supprimées.

REST v1

REST v1beta4

Restaurer une sauvegarde du coffre-fort de sauvegardes sur une instance nouvelle ou existante dans un autre projet

Lorsque vous restaurez des données à partir d'une sauvegarde sur une instance nouvelle ou existante dans un autre projet, les données de l'instance cible sont mises à jour selon l'état de l'instance source au moment de la sauvegarde. Vous ne pouvez restaurer une instance dans un autre projet qu'à l'aide de la gcloud CLI ou de l'API Cloud SQL.

gcloud

Pour restaurer une sauvegarde à partir d'un coffre de sauvegarde sur une instance existante, procédez comme suit :

  1. Si vous effectuez la restauration vers une instance existante, déterminez si l'instance cible possède des instances répliquées avec accès en lecture à l'aide de la commande gcloud sql instances describe :

    gcloud sql instance describe TARGET_INSTANCE_NAME

    Remplacez les éléments suivants :

    • TARGET_INSTANCE_NAME : nom de l'instance cible sur laquelle vous souhaitez restaurer votre sauvegarde.

    Supprimez toutes les instances dupliquées de votre instance cible à l'aide de la commande gcloud sql instances delete :

    gcloud sql instance delete REPLICA_NAME

    Remplacez les éléments suivants :

    • REPLICA_NAME : nom de la réplique de l'instance cible.

    Vous devez supprimer toutes les répliques avant de pouvoir restaurer une instance existante.

  2. Recherchez la sauvegarde que vous souhaitez restaurer à l'aide de la commande list all the backups in the backup vault for an instance. Vous aurez besoin du chemin d'accès complet à la sauvegarde pour la restaurer.

  3. Pour restaurer une instance nouvelle ou existante dans un nouveau projet, utilisez la commande gcloud sql backups restore :

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

    Remplacez les éléments suivants :

    • BACKUP_ID : ID de la sauvegarde dans le coffre-fort de sauvegardes. Vous devrez inclure le chemin d'accès complet de la sauvegarde dans ce champ.

    • TARGET_INSTANCE_NAME : instance du projet de destination dans laquelle vous restaurez les données.

    • SOURCE_INSTANCE_NAME : nom de l'instance dans le projet source où se trouvent les données.

    • SOURCE_INSTANCE_PROJECT : projet contenant l'instance source.

REST v1

REST v1beta4

Effectuer une récupération à un moment précis

Pour effectuer une récupération à un moment précis, consultez la section Récupération à un moment précis.

Étapes suivantes