Ce document vous explique comment créer des schémas pour les sujets Pub/Sub.
Avant de commencer
Avant de créer un schéma, procédez comme suit :
- Découvrez les sujets et le processus de publication.
- Comprenez le fonctionnement des schémas Pub/Sub.
- Créez un sujet.
Rôles et autorisations requis
Pour obtenir les autorisations nécessaires pour créer et gérer des schémas, demandez à votre administrateur de vous accorder le rôle IAM Éditeur Pub/Sub (roles/pubsub.editor) dans 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 créer et gérer des schémas. Pour connaître les autorisations exactes requises, développez la section Autorisations requises :
Autorisations requises
Vous devez disposer des autorisations suivantes pour créer et gérer des schémas :
-
Créer un schéma :
pubsub.schemas.create -
Associer un schéma à un sujet :
pubsub.schemas.attach -
Valider une révision de schéma :
pubsub.schemas.commit -
Supprimer 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 -
Lister les schémas :
pubsub.schemas.list -
Lister les révisions de schéma :
pubsub.schemas.listRevisions -
Restaurer un schéma :
pubsub.schemas.rollback -
Valider un message :
pubsub.schemas.validate -
Obtenir la stratégie IAM pour un schéma :
pubsub.schemas.getIamPolicy -
Configurer 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 accorder des rôles et des autorisations à des 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.
Créer un schéma
Vous pouvez créer un schéma à l'aide de la Google Cloud console, de gcloud CLI, de l'API Pub/Sub ou des bibliothèques clientes Cloud.
Avant de créer un schéma, consultez ces informations importantes sur les schémas.
Console
Pour créer un schéma, procédez comme suit :
Dans la Google Cloud console, accédez à la page Schémas Pub/Sub.
Cliquez sur Créer un schéma.
Dans le champ ID de schéma, saisissez un ID pour votre schéma.
Pour obtenir des consignes sur la dénomination d'un schéma, consultez Consignes de dénomination d'un sujet, d'un abonnement ou d'un instantané.
Dans le champ Type de schéma, sélectionnez Avro ou Protocol Buffer.
En savoir plus sur les types de schéma.
Dans le champ