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.
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.
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
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"
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
.
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
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.
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.
- Pour mettre à jour une sauvegarde finale, cliquez dessus. La boîte de dialogue Sauvegarde finale s'affiche.
- Pour modifier la durée de conservation de la sauvegarde finale par Cloud SQL, procédez comme suit :
- Cliquez sur l'icône Modifier la durée de conservation à côté du champ Sauvegarde conservée jusqu'au.
- Cliquez sur l'icône Sélectionner une date à côté du champ Conserver la sauvegarde jusqu'au.
- Dans le calendrier, sélectionnez la nouvelle date qui indique la durée pendant laquelle Cloud SQL conserve la sauvegarde finale.
- Cliquez sur Mettre à jour. Vous êtes redirigé vers la page Sauvegardes Cloud SQL.
- Pour mettre à jour la description de la sauvegarde finale, procédez comme suit :
- Cliquez sur la sauvegarde finale.
- Cliquez sur l'icône Modifier la description à côté du champ Description.
- Dans le champ Décrire cette sauvegarde, saisissez la description mise à jour de la sauvegarde finale.
- Cliquez sur Mettre à jour. Vous êtes redirigé vers la page Sauvegardes Cloud SQL.
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"
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).
- Pour l'indicateur
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
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 :
curl (Linux, macOS ou Cloud Shell)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days"
PowerShell (Windows)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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 :
curl (Linux, macOS ou Cloud Shell)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time"
PowerShell (Windows)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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 :
curl (Linux, macOS ou Cloud Shell)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description"
PowerShell (Windows)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
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 :
curl (Linux, macOS ou Cloud Shell)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days"
PowerShell (Windows)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=ttl_days" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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 :
curl (Linux, macOS ou Cloud Shell)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time"
PowerShell (Windows)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=expiry_time" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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 :
curl (Linux, macOS ou Cloud Shell)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json; charset=utf-8" \
-d @request.json \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description"
PowerShell (Windows)
Enregistrez le corps de la requête dans un fichier nommé request.json
, puis exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method PATCH `
-Headers $headers `
-ContentType: "application/json; charset=utf-8" `
-InFile request.json `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ?update_mask=description" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "DONE", "user": "user@example.com", "insertTime": "2024-02-15T00:10:22.078Z", "operationType": "UPDATE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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.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.
- Pour la dernière sauvegarde que vous souhaitez supprimer, cliquez sur Plus d'actions
, puis sélectionnez Supprimer.
- 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.
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"
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
.
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-21T22:43:37.981Z", "operationType": "DELETE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL"
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method GET `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups?filter=type=FINAL" | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "name": "projects/PROJECT_ID /backups/BACKUP_ID ", "kind": "sql#backup", "status": "SUCCESSFUL", "backupInterval": { "startTime": "2020-01-21T11:25:33.858Z", "endTime": "2020-01-21T11:26:18.663Z", } "type": "FINAL", "instance": "INSTANCE_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "location": "us" "description": "final backup", "backupKind": "SNAPSHOT", "dataDiskSizeGB": "10", "expiryTime": "2020-01-30T11:26:18.663Z", "backup_run": "projects/PROJECT_ID /instances/INSTANCE_ID /backupRuns/BACKUP_RUN_ID ", "satisfies_pzs": false, "satisfies_pzi": false }
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 :
curl (Linux, macOS ou Cloud Shell)
Exécutez la commande suivante :
curl -X DELETE \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
"https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID "
PowerShell (Windows)
Exécutez la commande suivante :
$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }
Invoke-WebRequest `
-Method DELETE `
-Headers $headers `
-Uri "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID " | Select-Object -Expand Content
Vous devriez recevoir une réponse JSON de ce type :
Réponse
{ "kind": "sql#operation", "targetLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /backups/BACKUP_ID ", "status": "PENDING", "user": "user@example.com", "insertTime": "2020-01-21T22:43:37.981Z", "operationType": "DELETE_BACKUP", "name": "OPERATION_ID ", "targetId": "BACKUP_ID ", "selfLink": "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID /operations/OPERATION_ID ", "targetProject": "PROJECT_ID " }
Étape suivante
- Obtenez plus d'informations sur la sauvegarde de données.
- Obtenez plus d'informations sur la restauration de données.
- Apprenez à restaurer vos données à partir d'une sauvegarde.