Création d'un EventBridge schéma Amazon - Amazon EventBridge

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Création d'un EventBridge schéma Amazon

Vous créez des schémas en utilisant des fichiers JSON avec la spécification OpenAPI ou la spécification JSONSchema Draft4. Vous pouvez créer ou télécharger vos propres schémas en EventBridge utilisant un modèle ou en générant un schéma basé sur le JSON d'un événement. Vous pouvez également inférer le schéma à partir d’événements sur un bus d’événements. Pour créer un schéma à l'aide de l'API EventBridge Schema Registry, utilisez l'action CreateSchemaAPI.

Lorsque vous choisissez entre les formats OpenAPI 3 et JSONSchema Draft4, tenez compte des différences suivantes :

  • Le format JSONSchema prend en charge les mots-clés supplémentaires qui ne sont pas pris en charge dans OpenAPI, tels que $schema, additionalItems.

  • Il existe des différences mineures dans la façon dont les mots-clés sont traités, telles que le type et le format.

  • OpenAPI ne prend pas en charge les liens hypertexte JSONSchema Hyper-Schema dans les documents JSON.

  • Les outils pour OpenAPI ont tendance à se concentrer sur le moment de la construction, tandis que les outils pour JSONSchema ont tendance à se concentrer sur les opérations d’exécution, tels que les outils clients pour la validation des schémas.

Nous recommandons d'utiliser le format JSONSchema pour implémenter la validation côté client afin que les événements envoyés EventBridge soient conformes au schéma. Vous pouvez utiliser JSONSchema pour définir un contrat pour les documents JSON valides, puis utiliser un outil de validation de schéma JSON avant d’envoyer les événements associés.

Une fois que vous disposez d’un nouveau schéma, vous pouvez télécharger des liaisons de code afin de créer des applications pour les événements utilisant ce schéma.