Gérer les sauvegardes finales

Cette page explique comment gérer les sauvegardes finales de votre instance Cloud SQL. Avant de supprimer une instance, vous pouvez effectuer une dernière sauvegarde de l'instance. Vous pouvez ensuite restaurer la sauvegarde finale sur une instance nouvelle ou existante. Vous pourrez ainsi recréer les instances que vous avez supprimées par erreur ou les utiliser pour des scénarios de reprise après sinistre.

Contrairement aux sauvegardes automatiques et à la demande, qui sont associées à une instance, vous pouvez effectuer une dernière sauvegarde avant de supprimer l'instance. Cloud SQL stocke cette sauvegarde au-delà de la durée de vie de l'instance.

Vous pouvez utiliser les commandes existantes de la CLI gcloud pour lister, décrire, mettre à jour et supprimer une sauvegarde finale. Si vous utilisez des rôles personnalisés, ajoutez-leur les autorisations suivantes:

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

Pour en savoir plus sur ces autorisations, consultez la section Autorisations requises. Pour en savoir plus sur le fonctionnement des sauvegardes, consultez la section À propos des sauvegardes Cloud SQL.

Autorisations requises

Console Google Cloud

Pour gérer les sauvegardes finales dans un projet Google Cloud, vous devez disposer des autorisations suivantes:

Tâche Autorisations requises
Répertorier les sauvegardes finales cloudsql.backupRuns.list
Décrire une sauvegarde finale cloudsql.backupRuns.get
Mettre à jour une sauvegarde finale cloudsql.backupRuns.update
Supprimer une sauvegarde finale cloudsql.backupRuns.delete

CLI gcloud

Pour gérer les sauvegardes finales dans un projet Google Cloud, vous devez disposer des autorisations suivantes:

Action Commande Autorisations requises
Répertorier les sauvegardes finales gcloud sql backups list cloudsql.backupRuns.list
Décrire une sauvegarde finale gcloud sql backups describe cloudsql.backupRuns.get
Mettre à jour une sauvegarde finale gcloud sql backups patch cloudsql.backupRuns.update
Supprimer une sauvegarde finale gcloud sql backups delete cloudsql.backupRuns.delete

REST

Pour gérer les sauvegardes finales dans un projet Google Cloud, vous devez disposer des autorisations suivantes:

Action Méthode Autorisations requises
Répertorier les sauvegardes finales backups.list cloudsql.backupRuns.list
Décrire une sauvegarde finale backups.describe cloudsql.backupRuns.get
Mettre à jour une sauvegarde finale backups.patch cloudsql.backupRuns.update
Supprimer une sauvegarde finale backups.delete cloudsql.backupRuns.delete

Afficher la liste des sauvegardes finales

Vous pouvez afficher la liste des sauvegardes finales et des informations sur une sauvegarde à l'aide de la console Google Cloud, de gcloud CLI ou de l'API Cloud SQL.

La console Google Cloud n'affiche pas les sauvegardes ignorées ni échouées dans l'historique des sauvegardes. Pour afficher ces types de sauvegardes, utilisez gcloud ou l'API Cloud SQL.

Console

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

    Accéder à "Sauvegardes Cloud SQL"

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

  2. Pour afficher les détails d'une sauvegarde finale, cliquez dessus. La boîte de dialogue Sauvegarde finale s'affiche. Cette boîte de dialogue affiche les informations suivantes:

    • Date et heure de suppression de l'instance utilisée pour créer la sauvegarde finale
    • Nom et version de l'instance supprimée
    • Un code temporel indiquant la durée pendant laquelle Cloud SQL conserve la sauvegarde finale
    • Description de la sauvegarde finale

gcloud

  1. Pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud, utilisez la commande gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Pour afficher les détails d'une sauvegarde finale, utilisez la commande gcloud sql backups describe:

    gcloud sql backups describe \
    BACKUP_NAME

    Vous obtenez le BACKUP_NAME à partir de la sortie de l'exécution de la commande gcloud sql backups list. BACKUP_NAME a le format suivant: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Obtenir la liste des sauvegardes finales

Utilisez cet exemple pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.list.

Avant d'utiliser les données de requête ci-dessous, 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

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

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

Afficher les détails d'une sauvegarde finale

Utilisez cet exemple pour afficher les détails d'une sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.get.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.

Méthode HTTP et URL :

GET https://sqladmin.googleapis.com/v1/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

Obtenir la liste des sauvegardes finales

Utilisez cet exemple pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.list.

Avant d'utiliser les données de requête ci-dessous, 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

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

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

Afficher les détails d'une sauvegarde finale

Utilisez cet exemple pour afficher les détails d'une sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.get.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.

Méthode HTTP et URL :

GET https://sqladmin.googleapis.com/sql/v1beta4/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 :

Mettre à jour une sauvegarde finale

Vous pouvez modifier la durée de conservation d'une sauvegarde finale par Cloud SQL pour une instance et la description de la sauvegarde à l'aide de la console Google Cloud, de la gcloud CLI ou de l'API Cloud SQL.

Console

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

    Accéder à "Sauvegardes Cloud SQL"

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

  2. Pour mettre à jour une sauvegarde finale, cliquez dessus. La boîte de dialogue Sauvegarde finale s'affiche.
  3. Pour modifier la durée de conservation de la sauvegarde finale par Cloud SQL, procédez comme suit :
    1. Cliquez sur l'icône Modifier la durée de conservation à côté du champ Sauvegarde conservée jusqu'au.
    2. Cliquez sur l'icône Sélectionner une date à côté du champ Conserver la sauvegarde jusqu'au.
    3. Dans le calendrier, sélectionnez la nouvelle date qui indique la durée pendant laquelle Cloud SQL conserve la sauvegarde finale.
    4. Cliquez sur Mettre à jour. Vous êtes redirigé vers la page Sauvegardes Cloud SQL.
  4. Pour mettre à jour la description de la sauvegarde finale, procédez comme suit :
    1. Cliquez sur la sauvegarde finale.
    2. Cliquez sur l'icône Modifier la description à côté du champ Description.
    3. Dans le champ Décrire cette sauvegarde, saisissez la description mise à jour de la sauvegarde finale.
    4. Cliquez sur Mettre à jour. Vous êtes redirigé vers la page Sauvegardes Cloud SQL.

gcloud

  1. Pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud, utilisez la commande gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Pour modifier la description et la période de conservation d'une sauvegarde finale, utilisez la commande gcloud sql backups patch:

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

    Vous obtenez le BACKUP_NAME à partir de la sortie de l'exécution de la commande gcloud sql backups list. BACKUP_NAME a le format suivant: projects/PROJECT_ID/backups/BACKUP_ID.

    Pour les options --expiry-time et --ttl-days, respectez les consignes suivantes:

    • Pour l'indicateur --expiry-time, spécifiez un code temporel indiquant la date et l'heure auxquelles Cloud SQL supprime automatiquement la sauvegarde finale.
    • Pour l'indicateur --ttl-days, spécifiez la durée de conservation de la sauvegarde finale (de 1 à 365 jours). C'est ce que l'on appelle la valeur TTL (Time To Live). La durée de conservation commence à partir de la date et de l'heure actuelles. La durée de conservation maximale autorisée par Cloud SQL est d'un an (ou 365 jours).

REST v1

Obtenir la liste des sauvegardes finales

Utilisez cet exemple pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.list.

Avant d'utiliser les données de requête ci-dessous, 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

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

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

Mettre à jour la durée de conservation

Vous pouvez mettre à jour la durée de conservation d'une sauvegarde finale de l'une des manières suivantes:

  • Jours de conservation: modifiez le nombre de jours pendant lesquels Cloud SQL conserve la sauvegarde.
  • Heure d'expiration: indiquez la date et l'heure à laquelle Cloud SQL supprimera automatiquement la sauvegarde.
Modifier le nombre de jours de conservation

Utilisez cet exemple pour modifier le nombre de jours pendant lesquels Cloud SQL conserve la sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.update.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.
  • TTL_DAYS: durée de conservation de la sauvegarde finale (de 1 à 365 jours). Cette valeur est appelée TTL (Time To Live). La durée de conservation commence à partir de la date et de l'heure actuelles. La durée de conservation maximale autorisée par Cloud SQL est d'un an (ou 365 jours).

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

Mettre à jour le délai d'expiration

Utilisez cet exemple pour fournir un code temporel mis à jour pour la date et l'heure à laquelle Cloud SQL supprime la sauvegarde. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.update.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.
  • DATE_AND_TIME_STAMP: code temporel indiquant la date et l'heure auxquelles Cloud SQL supprime automatiquement la sauvegarde finale.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

Mettre à jour la description

Utilisez cet exemple pour mettre à jour la description de la sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.update.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.
  • DESCRIPTION: description mise à jour de la sauvegarde finale.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

REST v1beta4

Obtenir la liste des sauvegardes finales

Utilisez cet exemple pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.list.

Avant d'utiliser les données de requête ci-dessous, 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

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

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

Mettre à jour la durée de conservation

Vous pouvez mettre à jour la durée de conservation d'une sauvegarde finale de l'une des manières suivantes:

  • Jours de conservation: modifiez le nombre de jours pendant lesquels Cloud SQL conserve la sauvegarde.
  • Heure d'expiration: indiquez la date et l'heure à laquelle Cloud SQL supprimera automatiquement la sauvegarde.
Modifier le nombre de jours de conservation

Utilisez cet exemple pour modifier le nombre de jours pendant lesquels Cloud SQL conserve la sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.update.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.
  • TTL_DAYS: durée de conservation de la sauvegarde finale (de 1 à 365 jours). Cette valeur est appelée TTL (Time To Live). La durée de conservation commence à partir de la date et de l'heure actuelles. La durée de conservation maximale autorisée par Cloud SQL est d'un an (ou 365 jours).

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

Mettre à jour le délai d'expiration

Utilisez cet exemple pour fournir un code temporel mis à jour pour la date et l'heure à laquelle Cloud SQL supprime la sauvegarde. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.update.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.
  • DATE_AND_TIME_STAMP: code temporel indiquant la date et l'heure auxquelles Cloud SQL supprime automatiquement la sauvegarde finale.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

Mettre à jour la description

Utilisez cet exemple pour mettre à jour la description de la sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.update.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.
  • DESCRIPTION: description mise à jour de la sauvegarde finale.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

Supprimer une sauvegarde finale

Vous pouvez supprimer une sauvegarde finale à l'aide de la console Google Cloud, de gcloud CLI ou de l'API Cloud SQL.

La suppression d'une sauvegarde ne libère pas forcément l'ensemble de l'espace de stockage qu'elle occupe, car les sauvegardes sont incrémentielles. Par conséquent, la suppression d'une sauvegarde plus ancienne peut entraîner le transfert d'une partie de son contenu vers une sauvegarde plus récente afin de préserver l'intégrité de cette dernière.

Console

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

    Accéder à "Sauvegardes Cloud SQL"

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

  2. Pour la dernière sauvegarde que vous souhaitez supprimer, cliquez sur Plus d'actions Icône Plus, puis sélectionnez Supprimer.
  3. Dans la fenêtre Supprimer la sauvegarde finale ?, saisissez le nom de l'instance que vous avez utilisée pour créer la sauvegarde finale, puis cliquez sur Supprimer.

gcloud

  1. Pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud, utilisez la commande gcloud sql backups list:

    gcloud sql backups list \
    --filter="type=FINAL"
  2. Pour supprimer une sauvegarde finale, exécutez la commande gcloud sql backups delete:

    gcloud sql backups delete \
    BACKUP_NAME

    Vous obtenez le BACKUP_NAME à partir de la sortie de l'exécution de la commande gcloud sql backups list. BACKUP_NAME a le format suivant: projects/PROJECT_ID/backups/BACKUP_ID.

REST v1

Obtenir la liste des sauvegardes finales

Utilisez cet exemple pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.list.

Avant d'utiliser les données de requête ci-dessous, 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

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

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

Supprimer une sauvegarde finale

Utilisez cet exemple pour supprimer une sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.delete.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.

Méthode HTTP et URL :

DELETE https://sqladmin.googleapis.com/v1/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

Obtenir la liste des sauvegardes finales

Utilisez cet exemple pour obtenir la liste de toutes les sauvegardes finales associées à un projet Google Cloud. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.list.

Avant d'utiliser les données de requête ci-dessous, 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

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

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

Supprimer une sauvegarde finale

Utilisez cet exemple pour supprimer une sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page backupRuns.delete.

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

  • PROJECT_ID : ID du projet.
  • BACKUP_ID: ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de l'appel précédent.

Méthode HTTP et URL :

DELETE https://sqladmin.googleapis.com/sql/v1beta4/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 :

Étape suivante