Creación de archivos de eventos en Amazon EventBridge - Amazon EventBridge
Definición del archivoGeneración del patrón de eventos (opcional)

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 archivos de eventos en Amazon EventBridge

Al crear un archivo en EventBridge, puede determinar qué eventos se envían al archivo especificando un patrón de eventos. EventBridge envía los eventos que coinciden con el patrón de eventos al archivo. También se establece el período de retención para almacenar los eventos en el archivo antes de descartarlos.

También puede crear archivos al crear un bus de eventos. Estos archivos tienen una política de retención indefinida y no tienen filtros de eventos, aunque se pueden actualizar una vez creado el archivo.

Definición del archivo

En primer lugar, introduzca un nombre y una descripción para el archivo y especifique el bus de eventos desde el que recibe los eventos. Si lo desea, también puede especificar el tiempo que desea conservar los eventos en el archivo.

Cómo definir el archivo

  1. Abra la consola de Amazon EventBridge en https://console.aws.amazon.com/events/.

  2. Navegue al bus de eventos de origen o cree el archivo directamente:

    • En el panel de navegación, seleccione Buses de eventos.

      En la página de detalles del bus de eventos, seleccione la pestaña Archivos.

    • En el panel de navegación, elija Archivos.

  3. Elija Crear archivo.

  4. En Detalles de archivo, especifique un nombre y, opcionalmente, una descripción del archivo.

    El nombre debe ser único para la cuenta de la región seleccionada. No se puede cambiar el nombre después de crear el archivo.

  5. En Origen, seleccione el bus de eventos que quiere que envíe los eventos al archivo.

    Si ha navegado desde una página de detalles del bus de eventos existente, el nombre de ese bus de eventos aparece de forma predeterminada.

    No puede cambiar el bus de eventos de origen una vez creado el archivo.

  6. En Período de retención, especifique cuánto tiempo se van a retener los eventos en el archivo:

    • Elija Indefinido para retener los eventos en el archivo y no eliminarlos nunca.

    • Para un periodo de retención definido, introduzca el número de días tras los cuales EventBridge debe eliminar los eventos del archivo.

  7. En Cifrado, elija la clave de KMS para EventBridge que se debe utilizar al cifrar los eventos almacenados en el archivo.

    importante

    Si ha especificado que EventBridge utilice una clave administrada por el cliente para cifrar el bus de eventos de origen, le recomendamos encarecidamente que también especifique una clave administrada por el cliente para cualquier archivo del bus de eventos.

    • Elija Usar la Clave propiedad de AWS para que EventBridge cifre los datos mediante una Clave propiedad de AWS.

      Esta Clave propiedad de AWS es una clave de KMS que EventBridge posee y administra para su uso en varias cuentas de AWS. En general, a menos que se le pida que audite o controle la clave de cifrado que protege sus recursos, una Clave propiedad de AWS es una buena opción.

      Esta es la opción predeterminada.

    • Elija Utilizar la clave administrada por el cliente para EventBridge para cifrar los datos con la clave administrada por el cliente que especifique o cree.

      Las claves administradas por el cliente son claves de KMS en su cuenta de AWS, que usted ha creado, posee y administra. Usted tiene el control total sobre estas claves KMS.

      1. Especifique una clave administrada por el cliente existente o elija Crear una nueva clave de KMS />.

        EventBridge muestra el estado de la clave y cualquier alias de clave que se haya asociado a la clave administrada por el cliente especificada.

  8. Elija Siguiente.

Generación del patrón de eventos (opcional)

A continuación, como paso opcional, puede generar un patrón de eventos para filtrar los eventos que EventBridge envía al archivo. Para ello, especifique el origen del evento, elija la base del patrón de eventos y defina los atributos y valores con los que debe coincidir. También puede generar el patrón de eventos en JSON y probarlo con un evento de muestra.

Para obtener más información acerca de los patrones de eventos, consulte .

Crear el patrón de eventos

  1. En Origen del evento, seleccione Eventos de AWS o eventos de socios de EventBridge.

  2. (Opcional) En la sección Eventos de muestra, seleccione un tipo de evento de muestra con el que quiera probar su patrón de eventos.

    Están disponibles los siguientes eventos de muestra:

    • Eventos de AWS: seleccione uno de los eventos emitidos desde Servicios de AWS compatibles.

    • Eventos de socios de EventBridge: seleccione entre los eventos emitidos por servicios de terceros que admiten EventBridge, como Salesforce.

    • Escribir el mío: introduzca su propio evento en texto JSON.

      También puede usar un evento de AWS o un evento de socios como punto de partida para crear su propio evento personalizado.

      1. Seleccione eventos de AWS o eventos de socios de EventBridge.

      2. Use el menú desplegable Eventos de muestra para seleccionar el evento que desea usar como punto de partida para su evento personalizado.

        EventBridge muestra el evento de muestra.

      3. Seleccione Copiar.

      4. Seleccione Escribir el mío para el tipo de evento.

      5. Elimine la estructura del evento de muestra en el panel de edición de JSON y pegue el evento de AWS o el evento de socios en su lugar.

      6. Edite la JSON del evento para crear su propio evento de muestra.

  3. Seleccione un método de creación. Puede crear un patrón de eventos a partir de un esquema o plantilla de EventBridge, o puede crear un patrón de eventos personalizado.

    Existing schema

    Para utilizar un esquema de EventBridge existente con el objetivo de crear el patrón de eventos, haga lo siguiente:

    1. En la sección Método de creación, en Método, seleccione Usar esquema.

    2. En la sección Patrón de eventos, para Tipo de esquema, seleccione Seleccione el esquema del registro de esquemas.

    3. Para el Registro de esquemas, seleccione el cuadro desplegable e indique el nombre de un registro de esquemas, por ejemplo, aws.events. También puede seleccionar una opción de la lista desplegable que aparece.

    4. En Esquema, seleccione el cuadro desplegable e indique el nombre del esquema que se va a usar. Por ejemplo, aws.s3@ObjectDeleted. También puede seleccionar una opción de la lista desplegable que aparece.

    5. En la sección Modelos, seleccione el botón Editar situado junto a cualquier atributo para abrir sus propiedades. Configure los campos Relación y Valor según sea necesario y, a continuación, seleccione Configurar para guardar el atributo.

      nota

      Para obtener información sobre la definición de un atributo, selecciona el icono de información situado junto al nombre del atributo. Para obtener información sobre cómo configurar las propiedades de los atributos en su evento, abra la sección Nota del cuadro de diálogo de propiedades de los atributos.

      Para eliminar las propiedades de un atributo, seleccione el botón Editar de ese atributo y, a continuación, seleccione Borrar.

    6. Seleccione Generar patrón de eventos en JSON para generar y validar el patrón de eventos como texto JSON.

    7. (Opcional) Para probar el evento de muestra con su patrón de prueba, seleccione Patrón de prueba.

      EventBridge muestra un cuadro de mensaje que indica si el evento de muestra coincide con el patrón de eventos.

      Puede elegir una de las siguientes opciones:

      • Copiar: copia el patrón de eventos en el portapapeles de su dispositivo.

      • Prettify: facilita la lectura del texto JSON al añadir saltos de línea, tabulaciones y espacios.

    Custom schema

    Para escribir un esquema personalizado y convertirlo en un patrón de eventos, haga lo siguiente:

    1. En la sección Método de creación, en Método, seleccione Usar esquema.

    2. En la sección Patrón de eventos, en Tipo de esquema, seleccione Introducir esquema.

    3. Introduzca el esquema en el cuadro de texto. Debe formatear el esquema como texto JSON válido.

    4. En la sección Modelos, seleccione el botón Editar situado junto a cualquier atributo para abrir sus propiedades. Configure los campos Relación y Valor según sea necesario y, a continuación, seleccione Configurar para guardar el atributo.

      nota

      Para obtener información sobre la definición de un atributo, selecciona el icono de información situado junto al nombre del atributo. Para obtener información sobre cómo configurar las propiedades de los atributos en su evento, abra la sección Nota del cuadro de diálogo de propiedades de los atributos.

      Para eliminar las propiedades de un atributo, seleccione el botón Editar de ese atributo y, a continuación, seleccione Borrar.

    5. Seleccione Generar patrón de eventos en JSON para generar y validar el patrón de eventos como texto JSON.

    6. (Opcional) Para probar el evento de muestra con su patrón de prueba, seleccione Patrón de prueba.

      EventBridge muestra un cuadro de mensaje que indica si el evento de muestra coincide con el patrón de eventos.

      Puede elegir una de las siguientes opciones:

      • Copiar: copia el patrón de eventos en el portapapeles de su dispositivo.

      • Prettify: facilita la lectura del texto JSON al añadir saltos de línea, tabulaciones y espacios.

    Event pattern

    Para escribir un patrón de eventos personalizado en formato JSON, haga lo siguiente:

    1. En la sección Método de creación, en Método, seleccione Patrón personalizado (editor JSON).

    2. En Patrón de eventos, introduzca el patrón de eventos personalizado en texto con formato JSON.

    3. (Opcional) Para probar el evento de muestra con su patrón de prueba, seleccione Patrón de prueba.

      EventBridge muestra un cuadro de mensaje que indica si el evento de muestra coincide con el patrón de eventos.

      Puede elegir una de las siguientes opciones:

      • Copiar: copia el patrón de eventos en el portapapeles de su dispositivo.

      • Prettify: facilita la lectura del texto JSON al añadir saltos de línea, tabulaciones y espacios.

      • Formulario de patrón de eventos: abre el patrón de eventos en Pattern Builder. Si el patrón no se puede representar en Pattern Builder tal cual, EventBridge le avisa antes de abrir Pattern Builder.

  4. Elija Crear archivo.

Para confirmar que los eventos se envían correctamente al archivo, puede usar la operación DescribeArchive de la API de EventBridge para comprobar si el EventCount refleja el número de eventos del archivo. Si es 0, no hay eventos en el archivo.