Ce document explique comment répertorier un sujet Pub/Sub. Pour répertorier un sujet, vous pouvez utiliser la Cloud de Confiance console, la gcloud CLI, la bibliothèque cliente, ou l'API Pub/Sub.
Avant de commencer
- Découvrez les sujets et le workflow de publication de messages.
- Créez un sujet.
Rôles et autorisations requis
Pour obtenir les autorisations nécessaires pour répertorier et gérer des sujets,
demandez à votre administrateur de vous accorder le
rôle IAM Éditeur Pub/Sub(roles/pubsub.editor)
sur votre sujet ou votre 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 répertorier et gérer des sujets. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Vous devez disposer des autorisations suivantes pour répertorier et gérer des sujets :
-
Créer un sujet :
pubsub.topics.create -
Supprimer un sujet :
pubsub.topics.delete -
Dissocier un abonnement d'un sujet :
pubsub.topics.detachSubscription -
Obtenir un sujet :
pubsub.topics.get -
Répertorier un sujet :
pubsub.topics.list -
Publier dans un sujet :
pubsub.topics.publish -
Mettre à jour un sujet :
pubsub.topics.update -
Obtenir la stratégie IAM pour un sujet :
pubsub.topics.getIamPolicy -
Configurer la stratégie IAM pour un sujet :
pubsub.topics.setIamPolicy
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Vous pouvez configurer le contrôle des accès au niveau du projet et au niveau de ressources individuelles. Vous pouvez créer un abonnement dans un projet et l'associer à un sujet situé dans un autre projet. Assurez-vous de disposer des autorisations requises pour chaque projet.
Répertorier un sujet
Console
Dans la Cloud de Confiance console, accédez à la page Sujets de Pub/Sub.
La page Sujets répertorie tous les sujets disponibles.
Par défaut, la console renvoie 50 sujets. Vous pouvez augmenter cette valeur pour renvoyer un maximum de 200 sujets à l'aide du bouton bascule du menu déroulant Lignes par page. Ce bouton bascule n'apparaît dans la console que si vous avez plus de 20 sujets dans un projet.
gcloud
-
Dans la Cloud de Confiance console, activez Cloud Shell.
En bas de la Cloud de Confiance console, 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 répertorier les sujets, utilisez la
gcloud pubsub topics listcommande :gcloud pubsub topics list
Par défaut, 100 résultats au maximum sont renvoyés par requête.
Vous pouvez spécifier une autre valeur allant jusqu'à 1 000 à l'aide du paramètre de taille des pages.
Par exemple, à l'aide de Google Cloud CLI, spécifiez --page-size=1000.
REST
Pour répertorier les sujets, utilisez la
projects.topics.list
méthode :
Requête :
La demande doit être authentifiée à l'aide d'un jeton d'accès dans l'
Authorization en-tête. Pour obtenir un jeton d'accès pour les identifiants par défaut actuels de l'application, exécutez la commande suivante : gcloud auth application-default print-access-token.
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics Authorization: Bearer ACCESS_TOKEN
Où :
Réponse :
{
"topics": [
{
"name": "projects/PROJECT_ID/topics/mytopic1",
...
},
{
"name": "projects/PROJECT_ID/topics/mytopic2",
...
}
]
}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 sur l'API Pub/Sub pour 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 sur l'API Pub/Sub pour C#.
Go
L'exemple suivant utilise la version principale 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 afficher la liste des exemples de code v1, consultez les exemples de code obsolètes.
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Go 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 pour 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 pour 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 pour 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 sur l'API Pub/Sub pour 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 pour 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 sur l'API Pub/Sub pour 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 afficher la liste des exemples de code Ruby v2, consultez les exemples de code obsolètes.
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Ruby 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 pour Ruby.
Étape suivante
Choisissez le type d'abonnement pour votre sujet.
Créez un abonnement pour votre sujet : pull, push, ou BigQuery.
Créez ou modifiez un sujet avec la gcloud CLI.
Créez ou modifiez un sujet avec les API REST.