Gérer les sauvegardes standards

Cette page explique comment gérer les sauvegardes de votre instance qui utilise l'option Sauvegardes standards. Vous découvrirez comment planifier et désactiver les sauvegardes automatiques, créer et gérer des sauvegardes à la demande, et afficher les sauvegardes de votre instance Cloud SQL. Si votre instance utilise des sauvegardes améliorées, consultez Gérer les sauvegardes améliorées.

Pour en savoir plus sur le fonctionnement des sauvegardes, consultez Présentation des sauvegardes Cloud SQL. Pour en savoir plus sur les options de sauvegarde disponibles pour vos instances Cloud SQL, consultez Choisir votre option de sauvegarde.

Créer une sauvegarde à la demande

Pour créer une sauvegarde à la demande, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  4. Cliquez sur Créer une sauvegarde.
  5. Sur la page Créer une sauvegarde, ajoutez une description si nécessaire, puis cliquez sur Créer.

gcloud

Créez la sauvegarde :

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

Vous pouvez fournir une description de la sauvegarde à l'aide du paramètre --description.

Pour créer une sauvegarde dans un emplacement personnalisé, procédez comme suit :

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

REST v1

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 :

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

REST v1beta4

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 :

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

Configurer les sauvegardes automatiques

Des sauvegardes automatiques sont effectuées à intervalles réguliers pendant l'exécution de votre instance. Vous pouvez également définir la durée de conservation de vos sauvegardes automatiques. Pour en savoir plus sur le fonctionnement des sauvegardes automatiques, consultez Sauvegardes automatiques.

Planifier des sauvegardes automatiques

Pour planifier des sauvegardes automatiques pour une instance, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  4. Cliquez sur Modifier à côté de Paramètres.
  5. Choisissez une période de sauvegarde automatique de vos données.
  6. Cliquez sur Enregistrer.

gcloud

  1. Modifiez l'instance pour spécifier une heure de début de sauvegarde : 
    gcloud sql instances patch INSTANCE_NAME --backup-start-time=HH:MM
     Le paramètre backup-start-time est indiqué au format 24 heures dans le fuseau horaire UTC ± 00 et spécifie le début d'un intervalle de sauvegarde de quatre heures. Les sauvegardes peuvent commencer à tout moment pendant l'intervalle de sauvegarde.
  2. Confirmez les modifications : 
    gcloud sql instances describe INSTANCE_NAME
     Dans la section backupConfiguration, vérifiez que vous voyez enabled: true et l'heure que vous avez spécifiée.

Terraform

Pour créer une sauvegarde d'une base de données, utilisez une ressource Terraform. 

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

Appliquer les modifications

Pour appliquer votre configuration Terraform dans un projet Google Cloud , suivez les procédures des sections suivantes.

Préparer Cloud Shell

  1. Lancez Cloud Shell.

  2. Définissez le projet Google Cloud par défaut dans lequel vous souhaitez appliquer vos configurations Terraform.

    Vous n'avez besoin d'exécuter cette commande qu'une seule fois par projet et vous pouvez l'exécuter dans n'importe quel répertoire.

    export GOOGLE_CLOUD_PROJECT=PROJECT_ID

    Les variables d'environnement sont remplacées si vous définissez des valeurs explicites dans le fichier de configuration Terraform.

Préparer le répertoire

Chaque fichier de configuration Terraform doit avoir son propre répertoire (également appelé module racine).

  1. Dans Cloud Shell, créez un répertoire et un nouveau fichier dans ce répertoire. Le nom du fichier doit comporter l'extension .tf, par exemple main.tf. Dans ce tutoriel, le fichier est appelé main.tf. 
    mkdir DIRECTORY && cd DIRECTORY && touch main.tf

  2. Si vous suivez un tutoriel, vous pouvez copier l'exemple de code dans chaque section ou étape.

    Copiez l'exemple de code dans le fichier main.tf que vous venez de créer.

    Vous pouvez également copier le code depuis GitHub. Cela est recommandé lorsque l'extrait Terraform fait partie d'une solution de bout en bout.

  3. Examinez et modifiez les exemples de paramètres à appliquer à votre environnement.
  4. Enregistrez les modifications.
  5. Initialisez Terraform. Cette opération n'est à effectuer qu'une seule fois par répertoire. 
    terraform init

    Vous pouvez également utiliser la dernière version du fournisseur Google en incluant l'option -upgrade : 

    terraform init -upgrade

Appliquer les modifications

  1. Examinez la configuration et vérifiez que les ressources que Terraform va créer ou mettre à jour correspondent à vos attentes : 
    terraform plan

    Corrigez les modifications de la configuration si nécessaire.

  2. Appliquez la configuration Terraform en exécutant la commande suivante et en saisissant yes lorsque vous y êtes invité : 
    terraform apply

    Attendez que Terraform affiche le message "Apply completed!" (Application terminée).

  3. Ouvrez votre projet Google Cloud pour afficher les résultats. Dans la console Google Cloud , accédez à vos ressources dans l'interface utilisateur pour vous assurer que Terraform les a créées ou mises à jour.

Supprimer les modifications

Pour supprimer vos modifications, procédez comme suit :

  1. Pour désactiver la protection contre la suppression, définissez l'argument deletion_protection sur false dans le fichier de configuration Terraform. 
    deletion_protection =  "false"
  2. Appliquez la configuration Terraform mise à jour en exécutant la commande suivante et en saisissant yes lorsque vous y êtes invité : 
    terraform apply

  1. Supprimez les ressources précédemment appliquées à votre configuration Terraform en exécutant la commande suivante et en saisissant yes à la requête :

    terraform destroy

REST v1

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

  • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance
  • INSTANCE_NAME : nom de l'instance principale ou de l'instance répliquée avec accès en lecture que vous configurez pour la haute disponibilité.
  • START_TIME : heure (en heures et en minutes).

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

REST v1beta4

Configurer la conservation des sauvegardes automatiques

Pour définir le nombre de sauvegardes automatiques à conserver, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  4. Cliquez sur Modifier.
  5. Dans la section Automatiser les sauvegardes, développez Options avancées.
  6. Saisissez le nombre de sauvegardes à stocker à la fois.

    Le nombre ne peut pas être inférieur au nombre de jours de conservation des journaux PITR.

  7. Cliquez sur Enregistrer.

gcloud

Modifiez l'instance pour définir le nombre de sauvegardes automatiques à conserver : Le nombre ne peut pas être inférieur à la valeur par défaut (sept). 

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

Terraform

Pour spécifier le nombre de sauvegardes automatiques à conserver pour une instance de base de données, utilisez une ressource Terraform. 

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

REST v1beta4

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

  • unit (facultatif) : l'unité de conservation peut être un entier ou une chaîne. Les valeurs actuellement acceptées (et par défaut) sont les valeurs 1 ou "COUNT".
  • num-to-retain : Nombre de sauvegardes automatiques à conserver. Le nombre ne peut pas être inférieur à la valeur par défaut (7).
  • project-id : ID du projet
  • instance-id : ID de l'instance.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

Désactiver les sauvegardes automatiques

Pour désactiver les sauvegardes automatiques pour une instance, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  4. Cliquez sur Gérer les sauvegardes automatiques.
  5. Désactivez l'option Automatiser les sauvegardes.
  6. Cliquez sur Enregistrer.

gcloud

Modifiez l'instance pour désactiver les sauvegardes :

gcloud sql instances patch INSTANCE_NAME \
--no-backup

REST v1

REST v1beta4

Supprimer une sauvegarde

Vous pouvez supprimer des sauvegardes automatiques et à la demande.

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 Instances Cloud SQL.

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  4. Cliquez sur l'icône Plus d'actions Icône Plus de la sauvegarde que vous souhaitez supprimer.
  5. Sélectionnez Supprimer.
  6. Dans la fenêtre "Supprimer une sauvegarde", saisissez Delete dans le champ, puis cliquez sur Supprimer.

gcloud

Supprimez une sauvegarde d'instance Cloud SQL :

gcloud beta sql backups delete BACKUP_ID \
--instance INSTANCE_NAME

Pour obtenir la liste complète des paramètres, consultez la page de référence de la commande gcloud beta sql backups delete.

REST v1

  1. Répertoriez les sauvegardes pour obtenir l'ID de la sauvegarde que vous souhaitez supprimer :

    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. Supprimez la sauvegarde :

    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 :

    DELETE https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/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. Répertoriez les sauvegardes pour obtenir l'ID de la sauvegarde que vous souhaitez supprimer :

    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. Supprimez la sauvegarde :

    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 :

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

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

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

Définir un emplacement personnalisé pour les sauvegardes

N'utilisez un emplacement de sauvegarde personnalisé que si la réglementation l'exige. Si ce n'est pas le cas, utilisez l'emplacement de sauvegarde multirégional par défaut.

Vous pouvez utiliser un emplacement personnalisé aussi bien pour les sauvegardes à la demande que les sauvegardes automatiques. Pour obtenir la liste complète des valeurs d'emplacement valides, consultez la section Emplacements des instances.

Pour mettre à jour une instance avec un emplacement personnalisé :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  4. À côté de Paramètres, cliquez sur Modifier.
  5. Dans la section Sauvegardes automatiques, développez Options avancées.
  6. Cliquez sur Multirégional (par défaut) ou Régional.
  7. Sélectionnez l'emplacement dans le menu déroulant Emplacement.
  8. Cliquez sur Enregistrer.

gcloud

Pour plus d'informations, reportez-vous à la commande gcloud sql instances patch. 

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

Terraform

Pour spécifier un emplacement personnalisé pour une sauvegarde d'instance de base de données, utilisez une ressource Terraform. 

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

REST v1

Utilisez le paramètre settings.backupConfiguration.location de l'instance pour l'emplacement de sauvegarde.

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

  • region : région du projet
  • backup-region : région de la sauvegarde
  • project-id : ID du projet
  • instance-id : ID de l'instance.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

REST v1beta4

Utilisez le paramètre settings.backupConfiguration.location de l'instance pour l'emplacement de sauvegarde.

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

  • region : région du projet
  • backup-region : région de la sauvegarde
  • project-id : ID du projet
  • instance-id : ID de l'instance.

Méthode HTTP et URL :

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

Corps JSON de la requête :

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

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

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

Afficher la liste des sauvegardes

Pour afficher une liste des sauvegardes et des informations sur une sauvegarde, utilisez les options suivantes.

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

Console

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

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Sélectionnez Sauvegardes dans le menu de navigation SQL pour afficher les sauvegardes récentes, la date et l'heure de création, ainsi que le type de sauvegarde.

gcloud

  • Répertoriez les sauvegardes de l'instance : 
    gcloud sql backups list \
--instance INSTANCE_NAME

    Vous pouvez filtrer et contrôler les résultats à l'aide des paramètres de liste standards. Pour obtenir une liste complète, consultez la page de référence de la commande gcloud sql backups list.

  • Affichez les détails d'une sauvegarde en spécifiant la sauvegarde ID à partir du résultat de la commande backups list. 
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

Vous pouvez également utiliser APIs Explorer sur la page de la commande "BackupRuns:list" pour envoyer la requête de l'API REST.

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 :

REST v1beta4

Vous pouvez également utiliser APIs Explorer sur la page de la commande "BackupRuns:list" pour envoyer la requête de l'API REST.

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 :

Afficher la liste des sauvegardes en cas de panne

Lorsqu'une instance se trouve dans une région en panne, vous ne pouvez afficher les sauvegardes de cette instance qu'à l'aide d'un caractère générique (-) avec l'API backupRuns.list. Le caractère générique renvoie toutes les sauvegardes du projet. Consultez la section Restaurer sur une autre instance.

En cas de panne dans une région où les clés de chiffrement gérées par le client (CMEK) sont activées pour une instance, vous ne pouvez pas restaurer les sauvegardes de cette instance dans une autre région. En effet, Cloud SQL utilise des clés Cloud KMS régionales pour le chiffrement lorsque le chiffrement CMEK est activé sur l'instance. Pour restaurer les sauvegardes d'une instance avec CMEK, Cloud SQL doit avoir accès à la clé CMEK. En cas de panne régionale, il n'y a pas d'accès aux clés Cloud KMS dans cette région.

gcloud

  1. Répertoriez les sauvegardes de chaque instance d'un projet : 
    gcloud sql backups list --instance -

    La commande renvoie des informations semblables à ce qui suit :

    {
      "kind": "sql#backupRun",
      "status": "SUCCESSFUL",
      "enqueuedTime": "2020-01-21T11:25:33.818Z",
      "id": "backup-id",
      "startTime": "2020-01-21T11:25:33.858Z",
      "endTime": "2020-01-21T11:26:18.663Z",
      "type": "AUTOMATED",
      "windowStartTime": "2020-01-21T10:00:00.479Z",
      "instance": "instance-id",
      "selfLink": "https://sqladmin.googleapis.com/v1/projects/project-id/instances/instance-id/backupRuns/backup-id",
      "location": "us"
      "backupKind": "SNAPSHOT"
    }
  2. Recherchez la sauvegarde de l'instance dont vous avez besoin. Pour restaurer cette sauvegarde, consultez la section Restaurer sur une autre instance.

REST v1

  1. 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 :

  2. Recherchez la sauvegarde de l'instance dont vous avez besoin. Pour restaurer cette sauvegarde, consultez la section Restaurer sur une autre instance.

REST v1beta4

  1. 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/v1beta4/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 :

  2. Recherchez la sauvegarde de l'instance dont vous avez besoin. Pour restaurer cette sauvegarde, consultez la section Restaurer sur une autre instance.

Afficher les emplacements de sauvegarde

Pour connaître l'emplacement des sauvegardes effectuées pour une instance, utilisez backupRuns :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.
  3. Dans le menu de navigation SQL, sélectionnez Sauvegardes.
  4. Dans la liste des sauvegardes, la colonne Emplacement indique le type d'emplacement (multirégional ou régional) ainsi que la zone multirégionale ou régionale spécifique à chaque sauvegarde.

gcloud

Pour obtenir des informations de référence, reportez-vous à la commande gcloud sql instances describe.

  1. Répertoriez les sauvegardes de l'instance : 
    gcloud sql backups list \
--instance INSTANCE_NAME

    Vous pouvez filtrer et contrôler les résultats à l'aide des paramètres de liste standards. Pour obtenir une liste complète, consultez la page de référence de la commande gcloud sql backups list.

  2. Pour répertorier les détails d'une sauvegarde, utilisez la valeur ID du résultat de la commande backups list.
    gcloud sql backups describe BACKUP_ID \
--instance INSTANCE_NAME

REST v1

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

Dans les exemples précédents :
  • REGION est la région de l'instance d'origine.
  • BACKUP_LOCATION est l'emplacement dans lequel vous souhaitez que Cloud SQL stocke la sauvegarde.

REST v1beta4

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

Dans les exemples précédents :
  • REGION est la région de l'instance d'origine.
  • BACKUP_LOCATION est l'emplacement dans lequel vous souhaitez que Cloud SQL stocke la sauvegarde.

Afficher la taille de la sauvegarde

Vous pouvez afficher la taille d'une sauvegarde pour une instance Cloud SQL à l'aide de gcloud CLI ou de l'API.

gcloud

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

    gcloud sql backups list

  2. Pour afficher la taille d'une sauvegarde, utilisez la commande gcloud sql backups describe :

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

    Effectuez les remplacements suivants :

    • BACKUP_ID : ID de la sauvegarde. Vous obtenez cet ID à partir du résultat de l'exécution de la commande gcloud sql backups list.
    • INSTANCE_NAME : nom de l'instance.
    • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance.

    Dans le résultat, le paramètre maxChargeableBytes affiche la taille de la sauvegarde (en octets).

REST

Obtenir la liste des sauvegardes

Utilisez cet exemple pour obtenir la liste de toutes les sauvegardes 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, effectuez les remplacements suivants :

  • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance
  • INSTANCE_NAME : nom de l'instance

Méthode HTTP et URL :

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

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

Utilisez cet exemple pour afficher les détails d'une sauvegarde, y compris sa taille. 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, effectuez les remplacements suivants :

  • PROJECT_ID : ID ou numéro de projet du projet Google Cloud contenant l'instance.
  • INSTANCE_NAME : nom de l'instance.
  • 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/instances/INSTANCE_NAME/backupRuns/BACKUP_ID

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

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

Configurer les sauvegardes finales

Vous pouvez configurer votre instance pour qu'elle effectue automatiquement une sauvegarde en activant le paramètre d'instance de sauvegarde finale et en définissant la période de conservation de la sauvegarde finale. Si vous n'activez pas la sauvegarde finale pour votre instance avant de la supprimer, vous pouvez également effectuer une sauvegarde finale lorsque vous supprimez votre instance. Pour en savoir plus sur le fonctionnement des sauvegardes finales, consultez Sauvegarde finale.

Pour gérer une sauvegarde finale après la suppression de votre instance, consultez Gérer les sauvegardes des instances supprimées.

Activer la sauvegarde finale

Pour activer les sauvegardes finales pour une instance, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Recherchez l'instance pour laquelle vous souhaitez activer la sauvegarde finale. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.

  3. Cliquez sur Modifier.

  4. Sous Personnaliser votre instance, développez Protection des données.

  5. Pour activer la sauvegarde finale, cochez la case Sauvegarde finale lors de la suppression de l'instance sous Protection contre la suppression d'instance.

    La période de conservation par défaut est de 30 jours. Pour modifier cette valeur, saisissez un nombre compris entre 1 et 365 dans la zone Jours de conservation.

  6. Cliquez sur Enregistrer.

gcloud

Utilisez la commande gcloud sql instances pour activer la sauvegarde finale.

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.
  • RETENTION_DAYS : nombre de jours de conservation de la sauvegarde finale. Elle peut être comprise entre 1 et 365 jours (30 jours par défaut).

REST v1

Pour activer les sauvegardes finales, procédez comme suit :

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

  • PROJECT_ID : ID du projet
  • INSTANCE_ID : ID de l'instance
  • RETENTION_DAYS : nombre de jours de conservation des sauvegardes finales

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

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

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

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

REST v1beta

Pour activer les sauvegardes finales, procédez comme suit :

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

  • PROJECT_ID : ID du projet
  • INSTANCE_ID : ID de l'instance
  • RETENTION_DAYS : nombre de jours de conservation des sauvegardes finales

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

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

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

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

Définir la durée de conservation de la sauvegarde finale

Pour définir la durée de conservation de la sauvegarde finale d'une instance, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Recherchez l'instance pour laquelle vous souhaitez activer la sauvegarde finale. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.

  3. Cliquez sur Modifier.

  4. Sous Personnaliser votre instance, développez Protection des données.

  5. Pour modifier la durée de conservation de la sauvegarde finale, saisissez un nombre compris entre 1 et 365 dans la zone Jours de conservation sous le paramètre Sauvegarde finale après suppression de l'instance.

    La période de conservation par défaut est de 30 jours.

  6. Cliquez sur Enregistrer.

gcloud

Exécutez la commande gcloud sql instances pour mettre à jour le paramètre final du nombre de jours de conservation des sauvegardes.

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.
  • RETENTION_DAYS : nombre de jours de conservation de la sauvegarde finale. Elle peut être comprise entre 1 et 365 jours (30 jours par défaut).

REST v1

Pour modifier le paramètre "Nombre de jours de conservation de la sauvegarde finale", procédez comme suit :

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

  • PROJECT_ID : ID du projet
  • INSTANCE_ID : ID de l'instance
  • RETENTION_DAYS : nombre de jours de conservation des sauvegardes finales

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

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

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

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

REST v1beta

Pour modifier le paramètre "Nombre de jours de conservation de la sauvegarde finale", procédez comme suit :

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

  • PROJECT_ID : ID du projet
  • INSTANCE_ID : ID de l'instance
  • RETENTION_DAYS : nombre de jours de conservation des sauvegardes finales

Méthode HTTP et URL : 

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

Corps JSON de la requête :

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

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

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

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

Désactiver la sauvegarde finale

Pour désactiver les sauvegardes finales pour une instance, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Recherchez l'instance pour laquelle vous souhaitez activer la sauvegarde finale. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.

  3. Cliquez sur Modifier.

  4. Sous Personnaliser votre instance, développez Protection des données.

  5. Pour désactiver la sauvegarde finale, décochez la case Sauvegarde finale lors de la suppression de l'instance sous Protection contre la suppression d'instance.

  6. Cliquez sur Enregistrer.

gcloud

Utilisez la commande gcloud sql instances pour désactiver la sauvegarde finale.

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.

REST v1

Pour désactiver les sauvegardes finales :

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 : 

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

Corps JSON de la requête :

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

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

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

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

REST v1beta

Pour désactiver les sauvegardes finales :

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 : 

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

Corps JSON de la requête :

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

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

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

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

Configurer les sauvegardes conservées

Vous pouvez configurer votre instance pour qu'elle conserve automatiquement toutes les sauvegardes automatiques et à la demande lorsque vous la supprimez. Ces sauvegardes sont conservées en fonction de la période de conservation de la sauvegarde au moment de la suppression. Pour en savoir plus sur le fonctionnement des sauvegardes finales, consultez Sauvegarde finale.

Pour gérer les sauvegardes conservées après la suppression de votre instance, consultez Gérer les sauvegardes des instances supprimées.

Activer les sauvegardes conservées

Pour activer les sauvegardes conservées pour une instance, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Recherchez l'instance pour laquelle vous souhaitez activer les sauvegardes conservées. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.

  3. Cliquez sur Modifier.

  4. Sous Personnaliser votre instance, développez Protection des données.

  5. Pour activer la conservation des sauvegardes, cochez la case Conserver les sauvegardes après la suppression de l'instance sous Protection contre la suppression d'instance.

  6. Cliquez sur Enregistrer.

gcloud

Utilisez la commande gcloud sql instances pour activer les sauvegardes conservées.

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.

REST v1

Pour activer les sauvegardes conservées :

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 : 

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

Corps JSON de la requête :

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

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

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

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

REST v1beta

Pour activer les sauvegardes conservées :

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 : 

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

Corps JSON de la requête :

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

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

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

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

Désactiver les sauvegardes conservées

Pour désactiver les sauvegardes conservées pour une instance, procédez comme suit :

Console

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

    Accéder à la page Instances Cloud SQL

  2. Recherchez l'instance pour laquelle vous souhaitez activer les sauvegardes conservées. Pour ouvrir la page Présentation d'une instance, cliquez sur son nom.

  3. Cliquez sur Modifier.

  4. Sous Personnaliser votre instance, développez Protection des données.

  5. Pour désactiver la conservation des sauvegardes, décochez la case Conserver les sauvegardes après la suppression de l'instance sous Protection contre la suppression d'instance.

  6. Cliquez sur Enregistrer.

gcloud

Utilisez la commande gcloud sql instances pour désactiver les sauvegardes conservées.

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

Remplacez les éléments suivants :

  • INSTANCE_NAME : nom de l'instance Cloud SQL.

REST v1

Pour désactiver les sauvegardes conservées :

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 : 

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

Corps JSON de la requête :

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

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

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

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

REST v1beta

Pour désactiver les sauvegardes conservées :

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 : 

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

Corps JSON de la requête :

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

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

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

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

Étapes suivantes