Ce document explique comment répertorier les révisions d'un schéma pour les sujets Pub/Sub.
Avant de commencer
- Comprendre le fonctionnement des schémas Pub/Sub
- Créez un schéma.
Rôles et autorisations requis
Pour obtenir les autorisations nécessaires pour répertorier les révisions de schéma et les gérer, demandez à votre administrateur de vous attribuer le rôle IAM Éditeur Pub/Sub (roles/pubsub.editor
) sur votre 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 révisions de schéma 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 révisions de schéma et les gérer:
-
Créer le schéma :
pubsub.schemas.create
-
Associer le schéma au sujet :
pubsub.schemas.attach
-
Effectuez un commit d'une révision de schéma :
pubsub.schemas.commit
-
Supprimez un schéma ou une révision de schéma :
pubsub.schemas.delete
-
Obtenez un schéma ou des révisions de schéma :
pubsub.schemas.get
-
Répertorier les schémas :
pubsub.schemas.list
-
Répertorier les révisions de schéma :
pubsub.schemas.listRevisions
-
Effectuer le rollback d'un schéma :
pubsub.schemas.rollback
-
Validez un message :
pubsub.schemas.validate
-
Obtenez la stratégie IAM d'un schéma :
pubsub.schemas.getIamPolicy
-
Configurez la stratégie IAM pour un schéma :
pubsub.schemas.setIamPolicy
Vous pouvez également obtenir ces autorisations avec des rôles personnalisés ou d'autres rôles prédéfinis.
Vous pouvez attribuer des rôles et des autorisations à des comptes principaux tels que des utilisateurs, des groupes, des domaines ou des comptes de service. Vous pouvez créer un schéma dans un projet et l'associer à un sujet situé dans un autre projet. Assurez-vous de disposer des autorisations requises pour chaque projet.
Lister les révisions d'un schéma
Vous pouvez répertorier les révisions d'un schéma dans un projet Google Cloud à l'aide de la console Google Cloud, de gcloud CLI, de l'API Pub/Sub ou des bibliothèques clientes Cloud.
Console
Dans la console Google Cloud, accédez à la page Schémas Pub/Sub.
La liste des schémas s'affiche.
Cliquez sur le nom du schéma que vous souhaitez afficher.
La page Informations sur le schéma s'ouvre.
Dans la section Révisions, vous pouvez consulter la liste des révisions disponibles pour le schéma.
gcloud
Pour afficher la dernière révision d'un schéma, procédez comme suit:
gcloud pubsub schemas list-revisions SCHEMA_ID
Utilisez la commande gcloud pubsub schemas list-revisions <var>SCHEMA_ID</var> --view=FULL
pour afficher les définitions des révisions de schéma.
REST
Pour répertorier les révisions d'un schéma, envoyez une requête GET semblable à celle-ci:
GET https://pubsub.googleapis.com/v1/projects/SCHEMA_NAME:listRevisions
Si la requête aboutit, le corps de la réponse contient un objet JSON contenant toutes les révisions du schéma.
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
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 sur l'API Pub/Sub pour Go.
Java
Avant d'essayer cet exemple, suivez les instructions d'installation dans le langage Java 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 Java.
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.
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 sur l'API Pub/Sub pour Node.js.
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 sur l'API Pub/Sub pour Node.js.
Étapes suivantes
Traiter les messages lors de l'abonnement à des sujets configurés avec un schéma