Ce document explique comment créer un abonnement pull. Vous pouvez utiliser la console Cloud de Confiance , Google Cloud CLI, la bibliothèque cliente ou l'API Pub/Sub pour créer un abonnement pull.
Avant de commencer
- En savoir plus sur les abonnements
- Évaluez si votre entreprise a besoin d'un abonnement pull.
- Comprendre le fonctionnement des abonnements pull
Rôles et autorisations nécessaires
Pour obtenir les autorisations nécessaires pour créer un abonnement par extraction, demandez à votre administrateur de vous accorder le rôle IAM Éditeur Pub/Sub (roles/pubsub.editor) sur le projet.
Pour en savoir plus sur l'attribution de rôles, consultez Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient les autorisations requises pour créer un abonnement pull. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour créer un abonnement pull :
pubsub.subscriptions.createsur le projet-
pubsub.topics.attachSubscriptionsur le thème
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Abonnements interprojets
Si vous créez un abonnement dans un projet pour un sujet dans un autre projet, vous devez disposer de l'autorisation pubsub.subscriptions.create dans le projet dans lequel vous créez l'abonnement et de l'autorisation pubsub.topics.attachSubscription sur le sujet.
Créer un abonnement pull
Console
Pour créer un abonnement pull, procédez comme suit :
Dans la console Cloud de Confiance , accédez à la page Abonnements.
Cliquez sur Créer un abonnement.
Dans le champ ID d'abonnement, saisissez un nom.
Pour savoir comment nommer un abonnement, consultez Consignes de dénomination d'un sujet ou d'un abonnement.
Dans la liste Sujet Pub/Sub, sélectionnez un sujet à partir duquel l'abonnement doit lire les messages.
Pour Type de distribution, sélectionnez Pull.
(Facultatif) Dans la section Transformations, ajoutez une ou plusieurs transformations de message unique (SMT). Pour en savoir plus, consultez Créer un abonnement avec des SMT.
Facultatif : Dans le champ Filtre, saisissez une expression de filtre pour filtrer les messages de l'abonnement. Pour en savoir plus, consultez Filtrer les messages d'un abonnement.
Pour Stratégie de nouvelle tentative, sélectionnez une option. Pour en savoir plus, consultez la Politique de relance des abonnements.
Facultatif : activez une file d'attente de lettres mortes pour recevoir les messages non distribuables.
Cochez la case Mise en file d'attente de lettres mortes.
Dans la liste Thème de messages non distribués, sélectionnez ou créez le thème de messages non distribués.
Dans le champ Nombre maximal de tentatives d'envoi, saisissez le nombre maximal de tentatives d'envoi.
Facultatif : Dans la section Propriétés de diffusion, activez ou désactivez les options de diffusion suivantes :
Facultatif : Dans la section Délai de confirmation, définissez le délai dont dispose l'abonné pour traiter et confirmer les messages. Pour en savoir plus, consultez Prolonger le délai d'accusé de réception avec la gestion des baux.
Facultatif : Dans la section Options de durée de vie, configurez la durée pendant laquelle l'abonnement conserve les messages.
Dans la section Durée de conservation des messages, spécifiez la durée de conservation des messages non reconnus.
Pour conserver les messages confirmés et non confirmés, cochez la case Conserver les messages confirmés.
Pour en savoir plus, consultez Configurer la conservation des messages pour un abonnement.
Facultatif : Pour Période d'expiration, sélectionnez une option :
Pour définir l'expiration de l'abonnement, cochez la case Expire après ce nombre de jours d'inactivité. Saisissez le nombre de jours pendant lesquels l'abonnement peut rester inactif avant que Pub/Sub ne le supprime.
Pour désactiver l'expiration de l'abonnement, cochez la case Jamais.
Pour en savoir plus, consultez Expiration de l'abonnement.
Cliquez sur Créer.
Vous pouvez également créer un abonnement à partir de la section Sujets. Ce raccourci est utile pour associer des sujets à des abonnements.
Dans la console Cloud de Confiance , accédez à la page Sujets.
Cliquez sur more_vert à côté du sujet pour lequel vous souhaitez créer un abonnement.
Dans le menu contextuel, sélectionnez Créer un abonnement.
Sur la page Ajouter un abonnement au sujet, suivez les étapes décrites dans la procédure précédente. L'ID de la chaîne est automatiquement renseigné.
gcloud
-
Dans la console Cloud de Confiance , activez Cloud Shell.
En bas de la console Cloud de Confiance , une session Cloud Shell démarre et affiche une invite de ligne de commande. Cloud Shell est un environnement shell dans lequel Google Cloud CLI est déjà installé, et dans lequel des valeurs sont déjà définies pour votre projet actuel. L'initialisation de la session peut prendre quelques secondes.
-
Pour créer un abonnement pull, exécutez la
commande
gcloud pubsub subscriptions create.gcloud pubsub subscriptions create SUBSCRIPTION_ID --topic=TOPIC_ID
Remplacez les éléments suivants :
SUBSCRIPTION_ID: nom ou ID de votre nouvel abonnement pull.TOPIC_ID: nom ou ID de votre thème.
REST
Pour créer un abonnement pull, utilisez la méthode
projects.subscriptions.create :
Requête :
La demande doit être authentifiée à l'aide d'un jeton d'accès dans l'en-tête Authorization. Pour obtenir un jeton d'accès pour les Identifiants par défaut de l'application actuelle :
gcloud auth application-default print-access-token.
PUT https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID Authorization: Bearer ACCESS_TOKEN
Corps de la requête :
{ "topic": "projects/PROJECT_ID/topics/TOPIC_ID" }
Où :
- PROJECT_ID est l'ID de votre projet.
- SUBSCRIPTION_ID est l'ID de votre abonnement.
- TOPIC_ID est l'ID de votre sujet.
Réponse :
{
"name": "projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID",
"topic": "projects/PROJECT_ID/topics/TOPIC_ID",
"pushConfig": {},
"ackDeadlineSeconds": 10,
"messageRetentionDuration": "604800s",
"expirationPolicy": {
"ttl": "2678400s"
}
}C++
Avant d'essayer cet exemple, suivez les instructions de configuration pour C++ dans le guide de démarrage rapide : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub C++.
C#
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage C# qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub C#.
Go
L'exemple suivant utilise la version majeure de la bibliothèque cliente Go Pub/Sub (v2). Si vous utilisez toujours la bibliothèque v1, consultez le guide de migration vers la v2. Pour obtenir la liste des exemples de code v1, consultez les exemples de code obsolètes.
Avant d'essayer cet exemple, suivez les instructions de configuration pour Go dans le guide de démarrage rapide : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub en langage Go.
Java
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Java se trouvant sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub en langage Java.
Node.js
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Node.js qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub en langage Node.js.
Node.ts
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Node.js qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub en langage Node.js.
PHP
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage PHP qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub en langage PHP.
Python
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Python qui se trouvent sur la page Démarrage rapide : utiliser des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub en langage Python.
Ruby
L'exemple suivant utilise la bibliothèque cliente Ruby Pub/Sub v3. Si vous utilisez toujours la bibliothèque v2, consultez le guide de migration vers la v3. Pour obtenir la liste des exemples de code Ruby v2, consultez les exemples de code obsolètes.
Avant d'essayer cet exemple, suivez les instructions de configuration pour Ruby dans le guide de démarrage rapide : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub en langage Ruby.
Rust
Avant d'essayer cet exemple, suivez les instructions de configuration pour Rust dans le guide de démarrage rapide : Utiliser les bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub Rust.
Surveiller les abonnements pull
Cloud Monitoring fournit un certain nombre de métriques pour surveiller les abonnements.
Pour obtenir la liste de toutes les métriques disponibles liées à Pub/Sub et leurs descriptions, consultez la documentation sur la surveillance de Pub/Sub.
Vous pouvez également surveiller les abonnements dans Pub/Sub.
Étapes suivantes
- Recevez des messages d'un abonnement par extraction.
- Créez ou modifiez un abonnement à l'aide des commandes
gcloud. - Créez ou modifiez un abonnement avec les API REST.