Creación de un esquema de eventos de Amazon EventBridge - Amazon EventBridge

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Creación de un esquema de eventos de Amazon EventBridge

Los esquemas se crean mediante archivos JSON con la especificación OpenAPI o la especificación JSONSchema Draft4. Puede crear o subir sus propios esquemas en EventBridge mediante una plantilla o generando un esquema basado en el formato JSON de un evento. También puede inferir el esquema a partir de los eventos de un bus de eventos. Para crear un esquema mediante la API del registro de esquemas de EventBridge, utilice la acción CreateSchema de la API.

Cuando seleccione entre los formatos OpenAPI 3 y JSONSchema Draft4, tenga en cuenta las siguientes diferencias:

  • El formato JSONSchema admite palabras clave adicionales que no son compatibles con OpenAPI, como $schema, additionalItems.

  • Existen pequeñas diferencias en la forma en que se gestionan las palabras clave, como type y format.

  • OpenAPI no admite hipervínculos de hiperesquema JSONSchema en documentos JSON.

  • Las herramientas para OpenAPI tienden a centrarse en el tiempo de compilación, mientras que las herramientas para JSONSchema tienden a centrarse en las operaciones de tiempo de ejecución, como las herramientas de cliente para la validación de esquemas.

Recomendamos utilizar el formato JSONSchema para implementar la validación del lado del cliente, de modo que los eventos enviados a EventBridge se ajusten al esquema. Puede usar JSONSchema para definir un contrato para documentos JSON válidos y, a continuación, usar un validador de esquemas JSON antes de enviar los eventos asociados.

Cuando tenga un esquema nuevo, podrá descargar los enlaces de código que te ayudarán a crear aplicaciones para eventos con ese esquema.