Créer et gérer des sauvegardes automatiques et à la demande

Cette page explique 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.

Pour en savoir plus sur le fonctionnement des sauvegardes, consultez la section Présentation des sauvegardes.

Créer une sauvegarde à la demande

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

Console

  1. Dans Google Cloud Console, 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 :

Planifier des sauvegardes automatiques

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

Console

  1. Dans Google Cloud Console, 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" "instance" {
  name             = "postgres-instance-backup"
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled    = true
      start_time = "20:55"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

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 ci-dessous, 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

Vous pouvez activer la récupération à un moment précis en définissant pointInTimeRecoveryEnabled sur true dans l'objet backupConfiguration.

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/sql/v1beta4/projects/PROJECT_ID/instances/INSTANCE_NAME

Corps JSON de la requête :

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

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 Google Cloud Console, 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             = "postgres-instance-with-backup-location"
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled  = true
      location = "us-central1"
    }
  }
  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

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 Google Cloud Console, 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 ci-dessous, 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 Google Cloud Console, 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 la sortie, 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 ci-dessous, 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 ci-dessous, 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 la conservation des sauvegardes automatiques

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

Console

  1. Dans Google Cloud Console, 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.
  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             = "postgres-instance-backup-retention"
  region           = "us-central1"
  database_version = "POSTGRES_14"
  settings {
    tier = "db-custom-2-7680"
    backup_configuration {
      enabled = true
      backup_retention_settings {
        retained_backups = 365
        retention_unit   = "COUNT"
      }
    }
  }

  # set `deletion_protection` to true, will ensure that one cannot accidentally delete this instance by
  # use of Terraform whereas `deletion_protection_enabled` flag protects this instance at the GCP level.
  deletion_protection = false
}

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, compris entre 1 et 365.
  • 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 :

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 Google Cloud Console, 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ésactiver les sauvegardes automatiques

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

Console

  1. Dans Google Cloud Console, 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

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 :

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

Corps JSON de la requête :

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false
    }
  }
}

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 :

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

Corps JSON de la requête :

{
  "settings":
  {
    "backupConfiguration":
    {
      "enabled": false,
      "pointInTimeRecoveryEnabled": false
    }
  }
}

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

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

Récupération à un moment précis

Apprenez-en plus sur la récupération à un moment précis.

Étape suivante