Ce document explique comment répertorier un sujet Pub/Sub. Pour répertorier un sujet, vous pouvez utiliser la console Google Cloud, 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 lister les sujets et les gérer, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur Pub/Sub(roles/pubsub.editor
) sur votre sujet ou projet.
Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.
Ce rôle prédéfini contient les autorisations requises pour répertorier les sujets et les gérer. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Les autorisations suivantes sont requises pour répertorier les sujets et les gérer:
-
Créez un sujet :
pubsub.topics.create
-
Supprimer un sujet :
pubsub.topics.delete
-
Dissocier un abonnement d'un sujet :
pubsub.topics.detachSubscription
-
Obtenir un thème :
pubsub.topics.get
-
Listez un sujet :
pubsub.topics.list
-
Publier dans un sujet :
pubsub.topics.publish
-
Mettre à jour un sujet :
pubsub.topics.update
-
Obtenez la stratégie IAM d'un sujet :
pubsub.topics.getIamPolicy
-
Configurez la stratégie IAM d'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 des 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.
Lister un sujet
Console
Dans la console Google Cloud, accédez à la page Sujets de Pub/Sub.
La page Thèmes répertorie tous les thèmes disponibles.
Par défaut, la console renvoie 50 thèmes. Vous pouvez augmenter cette valeur pour renvoyer un maximum de 200 thèmes à l'aide du menu déroulant Lignes par page. Ce bouton n'apparaît dans la console que si votre projet contient plus de 20 sujets.
gcloud
-
Dans la console Google Cloud, activez Cloud Shell.
En bas de la fenêtre de la console Google Cloud, 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 commande
gcloud pubsub topics list
: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 jusqu'à 1 000 à l'aide du paramètre de taille de page.
Par exemple, à l'aide de la Google Cloud CLI, spécifiez --page-size=1000
.
REST
Pour répertorier les sujets, utilisez la méthode projects.topics.list
:
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 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ù :
Solution :
{ "topics": [ { "name": "projects/PROJECT_ID/topics/mytopic1", ... }, { "name": "projects/PROJECT_ID/topics/mytopic2", ... } ] }
C++
Avant d'essayer cet exemple, suivez les instructions de configuration de C++ décrites dans le guide de démarrage rapide de Pub/Sub à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub C++.
Pour vous authentifier auprès de Pub/Sub, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
C#
Avant d'essayer cet exemple, suivez les instructions de configuration de C# décrites dans le guide de démarrage rapide de Pub/Sub à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub C#.
Pour vous authentifier auprès de Pub/Sub, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Go
Avant d'essayer cet exemple, suivez les instructions de configuration de Go décrites dans le guide de démarrage rapide de Pub/Sub à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub Go.
Pour vous authentifier auprès de Pub/Sub, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Avant d'essayer cet exemple, suivez les instructions de configuration de Java décrites dans le guide de démarrage rapide de Pub/Sub à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub Java.
Pour vous authentifier auprès de Pub/Sub, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Node.js
PHP
Avant d'essayer cet exemple, suivez les instructions de configuration de PHP décrites dans le guide de démarrage rapide de Pub/Sub à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub PHP.
Pour vous authentifier auprès de Pub/Sub, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Avant d'essayer cet exemple, suivez les instructions de configuration de Python décrites dans le guide de démarrage rapide de Pub/Sub à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub Python.
Pour vous authentifier auprès de Pub/Sub, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Ruby
Avant d'essayer cet exemple, suivez les instructions de configuration de Ruby décrites dans le guide de démarrage rapide de Pub/Sub à l'aide des bibliothèques clientes. Pour en savoir plus, consultez la documentation de référence de l'API Pub/Sub Ruby.
Pour vous authentifier auprès de Pub/Sub, configurez les Identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Étapes suivantes
Choisissez le type d'abonnement à votre sujet.
Créez un abonnement pour votre sujet: pull, push ou BigQuery.
Créez ou modifiez un sujet avec gcloud CLI.
Créez ou modifiez un sujet avec les API REST.