Gérer les sauvegardes finales

Console

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

   Accéder aux sauvegardes Cloud SQL

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

2. Pour afficher les détails d'une sauvegarde finale, cliquez sur la sauvegarde. 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
   • Date et heure de la dernière sauvegarde conservée par Cloud SQL
   • Description de la sauvegarde finale

gcloud

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

   gcloud sql backups list \
   --filter="type=FINAL"

2. Pour afficher des informations sur une sauvegarde finale, utilisez la commande gcloud sql backups describe :

   gcloud sql backups describe \
   BACKUP_NAME

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

REST v1

Obtenir la liste des sauvegardes finales

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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

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

{
      "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 Backups.GetBackup.

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID"

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

{
      "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
    }

REST v1beta4

Obtenir la liste des sauvegardes finales

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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

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

{
      "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 Backups.GetBackup.

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID"

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

{
      "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
    }

Console

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

   Accéder aux sauvegardes Cloud SQL

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

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

gcloud

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

   gcloud sql backups list \
   --filter="type=FINAL"

2. Pour mettre à jour 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 du résultat 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, suivez les consignes suivantes :

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

REST v1

Obtenir la liste des sauvegardes finales

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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

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

{
      "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
}

Modifier la durée de conservation

Vous pouvez modifier 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 une date et une heure mises à jour pour la suppression automatique de la sauvegarde par Cloud SQL.

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 Backups.UpdateBackup.

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 : période de conservation de la sauvegarde finale (de 1 à 365 jours). C'est ce qu'on appelle la valeur TTL (Time To Live). La période de conservation commence à la date et à l'heure actuelles. La période 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 -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"

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

{
      "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"
}

Modifier le délai d'expiration

Utilisez cet exemple pour fournir un nouvel horodatage indiquant la date et l'heure auxquelles Cloud SQL supprime la sauvegarde. Pour obtenir la liste complète des paramètres de cet appel, consultez la page Backups.UpdateBackup.

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 : date et heure auxquelles Cloud SQL supprime automatiquement la dernière sauvegarde.

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 -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"

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

{
      "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 modifier la description de la sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page Backups.UpdateBackup.

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 -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"

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

{
      "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"
}

REST v1beta4

Obtenir la liste des sauvegardes finales

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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

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

{
      "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
}

Modifier la durée de conservation

Vous pouvez modifier 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 une date et une heure mises à jour pour la suppression automatique de la sauvegarde par Cloud SQL.

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 Backups.UpdateBackup.

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 : période de conservation de la sauvegarde finale (de 1 à 365 jours). C'est ce qu'on appelle la valeur TTL (Time To Live). La période de conservation commence à la date et à l'heure actuelles. La période 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 -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"

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

{
      "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"
}

Modifier le délai d'expiration

Utilisez cet exemple pour fournir un nouvel horodatage indiquant la date et l'heure auxquelles Cloud SQL supprime la sauvegarde. Pour obtenir la liste complète des paramètres de cet appel, consultez la page Backups.UpdateBackup.

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 : date et heure auxquelles Cloud SQL supprime automatiquement la dernière sauvegarde.

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 -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"

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

{
      "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 modifier la description de la sauvegarde finale. Pour obtenir la liste complète des paramètres de cet appel, consultez la page Backups.UpdateBackup.

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 -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"

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

{
      "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"
}

Console

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

   Accéder aux sauvegardes Cloud SQL

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

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

gcloud

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

   gcloud sql backups list \
   --filter="type=FINAL"

2. Pour supprimer une sauvegarde finale, utilisez la commande gcloud sql backups delete :

   gcloud sql backups delete \
   BACKUP_NAME

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

REST v1

Obtenir la liste des sauvegardes finales

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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups?filter=type=FINAL"

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

{
      "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 Backups.DeleteBackup.

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 -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/v1/projects/PROJECT_ID/backups/BACKUP_ID"

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

{
  "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"
}

REST v1beta4

Obtenir la liste des sauvegardes finales

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

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 -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups?filter=type=FINAL"

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

{
      "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 Backups.DeleteBackup.

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 -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://sqladmin.googleapis.com/sql/v1beta4/projects/PROJECT_ID/backups/BACKUP_ID"

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

{
  "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"
}