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
<a name="eb-archive-event"></a>

Al crear un archivo en EventBridge, puede determinar qué eventos se envían al archivo especificando un [patrón de eventos](eb-event-patterns.md). 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](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html). Estos archivos tienen una política de retención indefinida y no tienen filtros de eventos, aunque se pueden [actualizar](https://docs.aws.amazon.com/eventbridge/latest/userguide/event-bus-update-archive.html) una vez creado el archivo.

**Topics**
+ [Definición del archivo](#eb-create-archive-define)
+ [Generación del patrón de eventos (opcional)](#eb-create-archive-event-pattern)

## Definición del archivo
<a name="eb-create-archive-define"></a>

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/](https://console.aws.amazon.com/events/).

1. 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**.

1. Elija **Crear archivo**.

1. 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.

1. 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.

1. 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.

1. 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.

1. Elija **Siguiente**.

## Generación del patrón de eventos (opcional)
<a name="eb-create-archive-event-pattern"></a>

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 [](eb-event-patterns.md).

**Crear el patrón de eventos**

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

1. (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**.

     1. 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.

     1. Seleccione **Copiar**.

     1. Seleccione **Escribir el mío** para el **tipo de evento.**

     1. 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.

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

1. 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**.

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

   1. 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.

   1. 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.

   1. 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**.

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

   1. (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**.

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

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

   1. 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**.

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

   1. (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)**.

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

   1. (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.

------

1. Elija **Crear archivo**.

Para confirmar que los eventos se envían correctamente al archivo, puede usar la operación [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html) 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.