Ce document vous explique comment afficher les détails des schémas pour les sujets Pub/Sub.
Avant de commencer
- Découvrez le fonctionnement des schémas Pub/Sub.
- Créez un schéma.
Rôles et autorisations requis
Pour obtenir les autorisations nécessaires pour afficher et gérer les détails des schémas,
demandez à votre administrateur de vous accorder 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 page Gérer l'accès aux projets, aux dossiers et aux organisations.
Ce rôle prédéfini contient les autorisations requises pour afficher les détails du 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 afficher et gérer les détails des schémas:
-
Créer un schéma :
pubsub.schemas.create
-
Associez le schéma au sujet:
pubsub.schemas.attach
-
Effectuez un commit d'une révision du schéma:
pubsub.schemas.commit
-
Supprimez un schéma ou une révision de schéma :
pubsub.schemas.delete
-
Obtenir un schéma ou des révisions de schéma :
pubsub.schemas.get
-
Répertorier les schémas:
pubsub.schemas.list
-
Répertoriez les révisions de schéma:
pubsub.schemas.listRevisions
-
Effectuez le rollback d'un schéma:
pubsub.schemas.rollback
-
Pour valider 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 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.
Afficher les détails du schéma
Vous pouvez obtenir les détails d'un schéma à l'aide de la méthode la console Google Cloud, la gcloud CLI, l'API Pub/Sub, ou les bibliothèques clientes Cloud. Les résultats renvoient les détails ID de révision.
Console
Dans la console Google Cloud, accédez à la page Schémas Pub/Sub.
Cliquez sur le nom du schéma que vous souhaitez afficher.
La page Détails du schéma s'ouvre.
gcloud
Pour afficher la dernière révision d'un schéma :
gcloud pubsub schemas describe SCHEMA_NAME
Pour afficher une révision spécifique d'un schéma, procédez comme suit:
gcloud pubsub schemas describe SCHEMA_ID@REVISION_ID
Où :
- REVISION_ID correspond à la révision vers laquelle vous souhaitez effectuer le rollback.
REST
Pour obtenir les détails de la dernière révision d'un schéma, envoyez une requête GET telle que les éléments suivants:
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID
Par exemple, pour un schéma avec l'ID de schéma schema-inventory
, envoyez la requête suivante : https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory
Pour obtenir les détails d'une révision spécifique d'un schéma, envoyez une requête GET telle que les éléments suivants:
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID@REVISION_ID
Par exemple, pour un schéma avec l'ID de schéma schema-inventory
et l'ID de révision fa567a3e
, envoyez la requête suivante : https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory@fa567a3e
Où :
- PROJECT_ID est l'ID de votre projet.
- SCHEMA_ID est votre ID de schéma.
- REVISION_ID est l'ID de la révision du schéma spécifique.
Si la requête aboutit, le corps de la réponse contient une instance de la classe Schema.
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
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.
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.
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 sur 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
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 sur l'API Pub/Sub pour Ruby.
Étape suivante
- Supprimer une révision de schéma
- Supprimer un schéma
- List schemas
- Lister les révisions d'un schéma
- S'abonner à un sujet avec un schéma