Enregistrer des modifications d'objets

Vous trouverez sur cette page la procédure à suivre pour configurer et utiliser Cloud Pub/Sub Notifications pour Cloud Storage. Les notifications Cloud Pub/Sub vous permettent de suivre les modifications apportées à vos objets Cloud Storage. Pour en savoir plus sur Cloud Pub/Sub pour Cloud Storage, consultez la page des concepts de Notifications.

Prérequis

Avant d'utiliser cette fonctionnalité, vous devez :

  1. activer l'API Cloud Pub/Sub pour le projet qui recevra les notifications ;

    Activer l'API

  2. disposer des autorisations suffisantes sur le bucket que vous souhaitez surveiller :

  3. disposer des autorisations suffisantes sur le projet qui recevra les notifications :

    • Si vous êtes propriétaire du projet qui recevra les notifications, vous disposez probablement des autorisations nécessaires.

    • Si vous prévoyez de créer des sujets pour recevoir des notifications, vous devez disposer de l'autorisation pubsub.topics.create.

    • Selon que vous envisagez d'utiliser des sujets nouveaux ou existants, vous devez disposer de l'autorisation pubsub.topics.setIamPolicy. Si vous créez un thème, vous disposez généralement de l'autorisation pubsub.topics.setIamPolicy correspondante.

      Pour savoir comment obtenir ces autorisations Cloud Pub/Sub, consultez la section Contrôle des accès Cloud Pub/Sub.

  4. disposer d'un thème Cloud Pub/Sub existant auquel vous souhaitez envoyer des notifications ;

  5. obtenir l'adresse e-mail du compte de service associé au projet contenant votre bucket Cloud Storage ;

  6. utiliser l'adresse e-mail obtenue à l'étape précédente pour octroyer au compte de service le rôle IAM pubsub.publisher pour le sujet Cloud Pub/Sub souhaité.

Appliquer une configuration de notification

Les étapes suivantes permettent d'ajouter une configuration de notification à votre bucket qui envoie les notifications pour tous les événements compatibles. Pour envoyer des notifications pour un sous-ensemble d'événements, incluez l'indicateur -e dans votre commande gsutil ou la clé event_types dans le corps de votre requête JSON.

gsutil

Exécutez la commande gsutil notification create, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

gsutil notification create -t [TOPIC_NAME] -f json gs://[BUCKET_NAME]

Si vous utilisez un [TOPIC_NAME] qui n'existe pas dans votre projet, gsutil le crée pour vous.

API JSON

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth.
  2. Créez un fichier .json contenant les informations suivantes, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

    {
    "topic": "projects/[PROJECT_ID]/topics/[TOPIC_NAME]",
    "payload_format": "JSON_API_V1"
    }

  3. Exécutez cURL pour appeler l'API JSON avec une requête POST notificationConfigs, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

    curl -X POST --data-binary @[JSON_FILE_NAME].json 
    -H "Authorization: Bearer [OAUTH2_TOKEN]"
    -H "Content-Type: application/json"
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs"

Répertorier les configurations de notification pour un bucket

Pour répertorier les configurations de notification associées à un bucket particulier :

gsutil

Exécutez la commande gsutil notification list, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

gsutil notification list gs://[BUCKET_NAME]

API JSON

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth.
  2. Exécutez cURL pour appeler l'API JSON avec une requête GET notificationConfigs, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

    curl -X GET 
    -H "Authorization: Bearer [OAUTH2_TOKEN]"
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs"

Supprimer une configuration de notification

Pour supprimer une configuration de notification existante de votre bucket :

gsutil

Exécutez la commande gsutil notification delete, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

gsutil notification delete projects/_/buckets/[BUCKET_NAME]/notificationConfigs/[CONFIGURATION_NAME]

L'arrêt des notifications déclenchées par la configuration de notification peut prendre jusqu'à 30 secondes.

API JSON

  1. Obtenez un jeton d'accès d'autorisation sur la page OAuth 2.0 Playground. Configurez Playground de façon à utiliser vos propres identifiants OAuth.
  2. Exécutez cURL pour appeler l'API JSON avec une requête DELETE notificationConfigs, en remplaçant les éléments entre crochets ([VALUES_IN_BRACKETS]) par les valeurs appropriées :

    curl -X DELETE 
    -H "Authorization: Bearer [OAUTH2_TOKEN]"
    "https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs/[CONFIGURATION_NAME]"

L'arrêt des notifications déclenchées par la configuration de notification peut prendre jusqu'à 30 secondes.

Étapes suivantes

Cette page vous a-t-elle été utile ? Évaluez-la :

Envoyer des commentaires concernant…

Besoin d'aide ? Consultez notre page d'assistance.