Gérer les programmations d'instantanés pour des disques

Console

1. Dans Google Cloud Console, accédez à la page Instantanés.

   Accéder à la page Instantanés

2. Sélectionnez l'onglet Programmations d'instantanés.
3. Utilisez le champ filter_list Filtre pour affiner la liste des programmations d'instantanés.
4. Cliquez sur le nom d'une programmation d'instantanés pour afficher ses détails.

gcloud

Pour afficher la liste des programmations d'instantanés, utilisez la commande resource-policies list.

 gcloud compute resource-policies list

Pour consulter la description d'une programmation d'instantanés spécifique, utilisez la commande resource-policies describe.

gcloud compute resource-policies describe SCHEDULE_NAME

Remplacez SCHEDULE_NAME par le nom de la programmation d'instantanés.

REST

Envoyez une requête GET à resourcePolicies.aggregatedList pour afficher la liste des programmations d'instantanés figurant dans un projet.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/aggregated/resourcePolicies

Remplacez PROJECT_ID par le nom du projet.

Console

1. Dans Google Cloud Console, accédez à la page Instantanés.

   Accéder à la page Instantanés

2. Sélectionnez l'onglet Programmations d'instantanés.
3. Utilisez le champ filter_list Filtre pour répertorier les programmations d'instantanés d'une région spécifique.

gcloud

Pour afficher les programmations d'instantanés d'un projet dans une région spécifique, utilisez la commande resource-policies list.

gcloud compute resource-policies list PROJECT_ID --filter REGION

Remplacez les éléments suivants :

• PROJECT_ID : nom du projet
• REGION : région, par exemple us-west1

REST

Envoyez une requête GET à la méthode resourcePolicies.list pour récupérer les programmations d'instantanés créées dans une région.

GET https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies

Remplacez les éléments suivants :

• PROJECT_ID : nom du projet
• REGION : région, par exemple us-west1

Console

1. Dans Google Cloud Console, accédez à la page Instantanés.

   Accéder à la page Instantanés

2. Sélectionnez Programmations d'instantanés pour afficher la liste de vos programmations.
3. Cliquez sur le nom de la programmation d'instantanés que vous souhaitez modifier.
4. Sur la page d'informations de la programmation d'instantanés, cliquez sur le bouton edit Modifier la programmation.

gcloud

Utilisez la commande compute resource-policies update pour mettre à jour une description, une programmation, une règle de conservation ou les libellés d'une programmation d'instantanés.

gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \
   --region=REGION \
   --description="DESCRIPTION" \
   --snapshot-labels="KEY=VALUE" \
   --max-retention-days=DAYS \
   --on-source-disk-delete=DELETE_OPTION \
   --start-time=START_TIME \
   SCHEDULE_FLAG

Remplacez les éléments suivants :

• SCHEDULE_NAME : nom de la programmation d'instantanés.
• REGION : région où se trouve votre programmation d'instantanés.
• DESCRIPTION : description de la programmation d'instantanés. Utilisez des guillemets autour de votre description.
• KEY et VALUE : paire clé-valeur pouvant être utilisée pour regrouper des ressources liées ou associées.
• DAYS : nombre maximal de jours de conservation de l'instantané avant sa suppression.
• DELETE_OPTION : comportement de conservation des instantanés automatiques après la suppression du disque d'origine. La valeur doit être l'une des suivantes :
  • apply-retention-policy : lorsque le disque source est supprimé, continuez à appliquer la durée de conservation pour tous les instantanés créés par la programmation d'instantanés.
  • keep-auto-snapshots : (par défaut) si le disque source est supprimé, conservez tous les instantanés créés par la programmation d'instantanés, quelle que soit la durée de conservation.
• START_TIME : heure de début (UTC). L'heure ne doit pas inclure de minutes. Exemple :
  • 14h PST correspond à 22:00.
  • Si vous définissez une heure de début ayant la valeur 22:13, une erreur sera renvoyée.

• SCHEDULE_FLAG : l'une des options suivantes :

  • --hourly-schedule=HOURLY_INTERVAL : nombre d'heures entre chaque instantané. Le paramètre HOURLY_INTERVAL doit être un nombre entier compris entre 1 et 23 Par exemple, si vous définissez --hourly-schedule sur 12, l'instantané est généré toutes les 12 heures.
  • --daily-schedule : effectue un instantané quotidiennement, à l'heure définie sur START_TIME.

  • --weekly-schedule=WEEKLY_INTERVAL : définit les jours auxquels vous souhaitez que la création d'instantanés ait lieu. Vous devez rédiger en entier le jour de la semaine. Les valeurs ne sont pas sensibles à la casse.

  • --weekly-schedule-from-file=FILE_NAME : spécifie un fichier contenant la programmation d'instantanés à fréquence hebdomadaire. Vous pouvez spécifier des programmations hebdomadaires à différents jours et à différentes heures à l'aide d'un fichier. Par exemple, votre fichier peut spécifier une programmation d'instantanés les lundis et mercredis : none [{"day": "MONDAY", "startTime": "04:00"}, {"day": "WEDNESDAY", "startTime": "02:00"}]. Si vous incluez une heure de début dans votre fichier, vous n'avez pas besoin de définir l'option --start-time. La programmation utilise le fuseau horaire UTC standard. L'heure ne doit pas inclure de minutes. Exemple :

    • 14h PST correspond à 22:00.
    • Si vous définissez une heure de début ayant la valeur 22:13, une erreur sera renvoyée.

  Les options de fréquence d'instantanés hourly-schedule, daily-schedule, weekly-schedule et weekly-schedule-from-file s'excluent mutuellement. Vous ne pouvez en utiliser qu'une seule pour la programmation d'instantanés.

Exemples :

Pour remplacer une programmation d'instantanés par une programmation à fréquence quotidienne, procédez comme suit :

gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \
    --region=REGION --daily-schedule --start-time=START_TIME

Pour remplacer un instantané par une programmation à fréquence horaire, et mettre à jour la description et le libellé de l'instantané, procédez comme suit :

gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \
    --region=REGION --description="DESCRIPTION" \
    --hourly-schedule=HOURLY_INTERVAL --start-time=START_TIME \
    --snapshot-labels="KEY=VALUE"

Pour modifier les règles de conservation des instantanés et de suppression des disques sources pour une programmation d'instantanés, procédez comme suit :

gcloud compute resource-policies update snapshot-schedule SCHEDULE_NAME \
    --region=REGION --max-retention-days=DAYS \
    --on-source-disk-delete=DELETE_OPTION

REST

Créez une requête PATCH à la méthode resourcePolicies pour mettre à jour la description, la programmation, la règle de conservation, la règle de suppression du disque source ou les libellés d'une programmation d'instantanés. Dans le corps de la requête, il vous suffit de spécifier le champ name et les champs que vous souhaitez mettre à jour.

• Modifiez la description et le libellé :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
  {
      "name": "SCHEDULE_NAME",
      "description": "DESCRIPTION",
      "snapshotProperties": {
          "labels": {"KEY": "VALUE"}
      }
  }
  

• Définissez la programmation d'instantanés sur une fréquence horaire :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
  {
      "name": "SCHEDULE_NAME",
      "snapshotSchedulePolicy": {
          "schedule": {
            "hourlySchedule": {
                "hoursInCycle": HOURLY_INTERVAL,
                "startTime": START_TIME
             }
          }
      }
  }
  

• Définissez la programmation d'instantanés sur une fréquence quotidienne :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
  {
      "name": "SCHEDULE_NAME",
      "snapshotSchedulePolicy": {
          "schedule": {
            "dailySchedule": {
                "daysInCycle": DAILY_INTERVAL,
                "startTime": START_TIME
             }
          }
      }
  }
  

• Définissez la programmation d'instantanés sur une fréquence hebdomadaire :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
  {
      "name": "SCHEDULE_NAME",
      "snapshotSchedulePolicy": {
          "schedule": {
             "weeklySchedule": {
                "dayOfWeeks": [
                   {
                      "day": WEEKLY_INTERVAL,
                      "startTime": START_TIME
                   }
                ]
             }
          }
      }
  }
  

• Modifiez la règle de conservation des instantanés :

  PATCH https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME
  {
      "name": "SCHEDULE_NAME",
      "snapshotSchedulePolicy": {
          "retentionPolicy": {
              "maxRetentionDays": DAYS,
              "onSourceDiskDelete":"DELETE_OPTION"
          }
     }
  }
  

Remplacez les éléments suivants :

• PROJECT_ID : nom du projet
• REGION : région où se trouve la programmation d'instantanés.
• SCHEDULE_NAME : nom de la programmation d'instantanés.
• DESCRIPTION : description de la programmation d'instantanés. Utilisez des guillemets autour de votre description.
• KEY et VALUE : paire clé-valeur pouvant être utilisées pour regrouper des ressources liées ou associées.
• HOURLY_INTERVAL : définit l'intervalle auquel vous souhaitez que la création d'instantanés ait lieu. Définissez la programmation à fréquence horaire à l'aide d'un entier compris entre 1 et 23. Pour que les instantanés soient créés en même temps chaque jour, choisissez un nombre qui se divise uniformément en 24 (1, 2, 3, 4, 6, 8 ou 12). Par exemple, si vous définissez --hourly-schedule sur 12, l'instantané est généré toutes les 12 heures.
• DAILY_INTERVAL : définit le nombre de jours entre chaque instantané. Pour créer un instantané chaque jour, utilisez la valeur 1.
• WEEKLY_INTERVAL : définit une programmation qui s'exécute certains jours de la semaine. Indiquez un ou plusieurs jours. Les options suivantes sont disponibles : MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY et SUNDAY. Vous devez rédiger en entier les jours de la semaine. Ils ne sont pas sensibles à la casse. Vous pouvez définir jusqu'à 7 intervalles pour dayOfWeeks, un pour chaque jour de la semaine.
• START_TIME : heure de début (UTC). L'heure ne doit pas inclure de minutes. Exemple :
  • 14h PST correspond à 22:00 UTC.
  • Si vous définissez une heure de début ayant la valeur 22:13, une erreur sera renvoyée.
• DAYS : nombre maximal de jours de conservation de l'instantané avant sa suppression.
• DELETE_OPTION : comportement de conservation des instantanés automatiques après la suppression du disque d'origine. La valeur doit être l'une des suivantes :
  • APPLY_RETENTION_POLICY : lorsque le disque source est supprimé, continuez à appliquer la durée de conservation pour tous les instantanés créés par la programmation d'instantanés.
  • KEEP_AUTO_SNAPSHOTS : (par défaut) si le disque source est supprimé, conservez tous les instantanés créés par la programmation d'instantanés, quelle que soit la durée de conservation.

Console

1. Dans Google Cloud Console, accédez à la page Disques.

   Accéder à la page Disques

2. Sélectionnez le disque contenant la programmation que vous souhaitez dissocier.
3. Sur la page Gérer le disque, cliquez sur edit Modifier. Vous devrez peut-être d'abord cliquer sur le menu more_vertAutres actions.
4. Ouvrez le menu déroulant Programmation des instantanés.
5. Cliquez sur Pas de programmation pour dissocier la programmation du disque.
6. Vous pouvez alors créer une autre programmation, ou l'échanger lorsque vous modifiez les options du disque.
7. Cliquez sur Enregistrer pour terminer la tâche.

gcloud

1. Utilisez la commande gcloud disks remove-resource-policies pour dissocier la programmation d'instantanés du disque contenant la programmation que vous souhaitez modifier.

   gcloud compute disks remove-resource-policies DISK_NAME \
       --resource-policies SCHEDULE_NAME \
       --region REGION \
       --zone ZONE
   

   Remplacez les éléments suivants :

   • DISK_NAME : nom du disque auquel la programmation d'instantanés est associée
   • SCHEDULE_NAME : nom de la programmation d'instantanés que vous souhaitez dissocier de ce disque
   • REGION : région où se trouve votre programmation d'instantanés
   • ZONE : zone où réside votre disque zonal

2. Exécutez la commande gcloud disks add-resource-policies pour ajouter la nouvelle programmation d'instantanés sur le disque.

   gcloud compute disks add-resource-policies DISK_NAME \
        --resource-policies SCHEDULE_NAME \
        --zone ZONE
   

   Remplacez les éléments suivants :

   • DISK_NAME : nom du disque avec la règle de ressource de la programmation d'instantanés
   • SCHEDULE_NAME : nom de la programmation d'instantanés que vous souhaitez ajouter à ce disque
   • ZONE : zone où se trouve votre disque

REST

1. Dissociez la programmation d'instantanés actuelle d'un disque en envoyant une requête POST à disks.removeResourcePolicies.

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/removeResourcePolicies
   
   {
     "resourcePolicies": [
        "regions/REGION/resourcePolicies/SCHEDULE_NAME"
     ]
   }
   

   Remplacez les éléments suivants :

   • PROJECT_ID : nom du projet
   • ZONE : zone où se trouve le disque
   • DISK_NAME : nom du disque avec la programmation d'instantanés associée
   • REGION : emplacement de la programmation d'instantanés
   • SCHEDULE_NAME : nom de la programmation d'instantanés que vous supprimez de ce disque

2. Associez la nouvelle programmation d'instantanés au disque en envoyant une requête POST à la méthode disks.addResourcePolicies.

   POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/disks/DISK_NAME/addResourcePolicies
   
   {
     "resourcePolicies": [
       "regions/REGION/resourcePolicies/SCHEDULE_NAME"
     ]
   }
   

   Remplacez les éléments suivants :

   • PROJECT_ID : nom du projet
   • ZONE : emplacement du disque.
   • DISK_NAME : le nom du disque
   • REGION : emplacement de la programmation d'instantanés
   • SCHEDULE_NAME : nom de la programmation d'instantanés que vous appliquez à ce disque

Console

1. Dans Google Cloud Console, accédez à la page Instantanés.

   Accéder à la page Instantanés

2. Sélectionnez Programmations d'instantanés pour afficher la liste de vos programmations.
3. Sélectionnez une programmation non associée à un disque.

4. Cliquez sur delete Supprimer.

gcloud

Pour supprimer une programmation d'instantanés, utilisez la commande resource-policies delete.

gcloud compute resource-policies delete SCHEDULE_NAME \
    --region REGION

Remplacez les éléments suivants :

• SCHEDULE_NAME : nom de la programmation d'instantanés
• REGION : emplacement de la programmation d'instantanés

REST

Pour supprimer une programmation d'instantanés, envoyez une requête DELETE à la méthode resourcePolicies.delete. Si la programmation d'instantanés est déjà associée à un disque, une erreur sera renvoyée.

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/regions/REGION/resourcePolicies/SCHEDULE_NAME

Remplacez les éléments suivants :

• PROJECT_ID : nom du projet
• REGION : emplacement de la programmation d'instantanés
• SCHEDULE_NAME : nom de la programmation d'instantanés

Console

1. Dans Google Cloud Console, accédez à la page Explorateur de journaux.

   Accéder à la page "Explorateur de journaux"

2. Dans la liste déroulante Audited resource (Ressource auditée), placez le curseur sur Disk (Disque) et sélectionnez All disk_id (Tous les ID de disque).

3. Dans la liste déroulante All logs (Tous les journaux), sélectionnez cloudaudit.googleapis.com/system_event et cliquez sur OK.

4. Dans la liste déroulante Any log level (Tous les niveaux de journalisation), sélectionnez le type de journal.