Cette page explique comment configurer votre bucket pour qu'il envoie des notifications de modification d'objet à un sujet Pub/Sub. Pour en savoir plus sur l'abonnement à un sujet Pub/Sub recevant des notifications, consultez Choisir un type d'abonnement.
Avant de commencer
Avant d'utiliser cette fonctionnalité, suivez les instructions ci-dessous :
Activer l'API Pub/Sub
Activez l'API Pub/Sub pour le projet qui recevra les notifications.
Obtenir les rôles requis
Pour obtenir les autorisations nécessaires pour configurer et afficher les notifications Pub/Sub concernant un bucket, demandez à votre administrateur de vous accorder les rôles suivants. Ces rôles prédéfinis contiennent les autorisations nécessaires pour configurer et afficher les notifications Pub/Sub.
Rôle Administrateur Storage (
roles/storage.admin) sur le bucket pour lequel vous souhaitez configurer les notifications Pub/SubRôle Administrateur Pub/Sub (
roles/pubsub.admin) sur le projet dans lequel vous souhaitez recevoir des notifications Pub/Sub
Vous pouvez également obtenir ces autorisations avec d'autres rôles prédéfinis ou rôles personnalisés.
Pour savoir comment attribuer des rôles sur des buckets, consultez Définir et gérer des stratégies IAM sur des buckets. Consultez Contrôler les accès pour savoir comment attribuer des rôles sur des projets et définir des contrôles d'accès pour les sujets et les abonnements.
Vérifier que vous disposez d'un sujet Pub/Sub existant
Si vous ne l'avez pas déjà fait, créez le sujet Pub/Sub auquel vous souhaitez envoyer des notifications. Cette étape n'est pas nécessaire si vous prévoyez d'utiliser la Google Cloud CLI ou Terraform pour exécuter les instructions de cette page.
Attribuer le rôle requis à l'agent de service de votre projet
Les étapes suivantes ne sont pas nécessaires si vous prévoyez d'utiliser la Google Cloud CLI ou Terraform pour exécuter les instructions de cette page.
Récupérez l'adresse e-mail de l'agent de service associé au projet contenant votre bucket Cloud Storage.
Attribuez à l'agent de service le rôle Diffuseur Pub/Sub (
roles/pubsub.publisher) pour le sujet Pub/Sub concerné. Consultez Contrôler les accès pour obtenir des instructions sur l'attribution de rôles pour des sujets.
Appliquer une configuration de notification
Les étapes suivantes permettent d'ajouter une configuration de notification au bucket qui envoie les notifications pour tous les événements compatibles.