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.

# Crear reglas en Amazon EventBridge
<a name="eb-create-rule-visual"></a>

## Requisitos previos
<a name="eb-create-rule-prerequisites"></a>

Antes de comenzar, asegúrese de que dispone de lo siguiente:
+ Acceso a la EventBridge consola de Amazon
+ Permisos de IAM adecuados para crear reglas EventBridge 
+ Comprensión básica de las arquitecturas basadas en eventos

## Descripción general de
<a name="eb-create-rule-overview"></a>

Para tomar medidas en función de los eventos que reciba EventBridge, puede crear reglas. Cuando un evento coincide con el patrón de eventos definido en la regla, EventBridge envía el evento al destino especificado.

En este tema se explica cómo crear una regla que se EventBridge utilice para hacer coincidir los eventos a medida que se envían al bus de eventos especificado.

La creación de EventBridge reglas consta de cuatro pasos principales:

1. Elija los eventos que desee procesar

1. Configure el filtrado y las pruebas de eventos

1. Seleccione y configure los objetivos

1. Configure los ajustes de la regla

## Elija los eventos
<a name="eb-create-rule-source"></a>

Primero, elige los eventos que quieres enviar al objetivo.

**Para seleccionar un evento**

1. Abre la EventBridge consola de Amazon en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. En el panel de navegación, selecciona **Reglas** y, a continuación, selecciona **Crear regla**.

1. En la pestaña **Eventos**, busca los eventos que deseas enviar al destino:

   1. Elige **Eventos AWS de servicio** o **Eventos personalizados**.

   1. Usa el cuadro de búsqueda o navega por la lista de eventos para encontrar los eventos que deseas enviar al objetivo.

   1. Arrastra uno o más eventos al lienzo de **creación** y suéltalos en **Triggering Events**.

   EventBridge muestra la sección **Eventos desencadenantes**. Esta sección incluye:
   + **Eventos**, en la que se muestra el evento que ha elegido.
   + **Esquema**, que muestra el esquema del evento seleccionado, si está disponible.

     El **esquema** contiene tres pestañas:
     + **Árbol**: vista en árbol del esquema de eventos.
     + **Código**: el esquema de eventos en formato JSON o con especificaciones de API abierta.
     + **Información**: información general sobre el esquema.
   + **Ejemplo de evento**, que muestra un ejemplo de un evento seleccionado, si está disponible.
   + **Patrón de eventos (filtro)**, que contiene un patrón de eventos que selecciona todos los eventos que haya elegido.

## Filtra los eventos para enviar solo lo que desees
<a name="eb-create-rule-event-pattern-visual"></a>

Probablemente no quieras enviar *todos los* eventos de un tipo específico a un objetivo. Puedes hacer que tu patrón de eventos sea más específico para que solo seleccione los eventos que contienen los atributos y valores que te interesan.

### Edita el patrón del evento (opcional)
<a name="eb-create-rule-event-pattern-steps"></a>

En el panel **Activar eventos**, puede crear el patrón de eventos de dos maneras:
+ Visualmente, mediante la vista en árbol **del esquema**
+ Editando directamente el JSON en el panel de **patrones de eventos**

**Para editar el patrón de eventos mediante la vista de árbol del esquema**

1. Seleccione la pestaña **Árbol** del panel **Esquema**.

1. Añada y edite filtros para crear el patrón de eventos.

   1. Elija el icono de filtro situado junto al atributo que desee añadir como filtro al patrón de eventos.

   1. Elija un operador de comparación de la lista desplegable.

      Para obtener más información sobre los operadores de comparación, consulte [Creación de patrones de eventos](eb-create-pattern-operators.md).

   1. Introduzca el valor que desee que coincida.

   1. Haga clic en la marca de verificación para terminar.

   EventBridge añade el filtro que ha creado al JSON en el panel de **patrones de eventos**.

1. Añada filtros adicionales hasta que haya creado un patrón de eventos que coincida con todos los atributos de eventos que desee.

### Prueba el patrón de eventos
<a name="eb-create-rule-event-pattern-test"></a>

Tras crear un patrón de eventos que coincida con todos los atributos de eventos que desee, compruebe que el patrón de eventos funciona según lo esperado.

#### Pruebe el patrón de eventos (opcional)
<a name="eb-create-rule-event-pattern-test-steps"></a>

1. Elige un ejemplo de evento para probarlo o usa el tuyo propio.
   + **Utilice los ejemplos de eventos proporcionados**

     1. Elija **Usar los eventos de muestra proporcionados**.

     1. En **Ejemplo de evento desencadenante**, seleccione el evento que desee utilizar para las pruebas en la lista desplegable.
   + **Usa tu propio evento**

     1. Elija **Usar el evento propio**.

        EventBridge muestra un evento genérico con un `details` elemento vacío.

     1. Edita el JSON del evento para crear el evento con el que quieres probar tu patrón de eventos.
**sugerencia**  
Puede utilizar los eventos de ejemplo proporcionados como puntos de partida para crear sus eventos personalizados propios y utilizarlos en las pruebas:  
Elija **Usar los eventos de ejemplos proporcionados**, elija un evento del **Evento desencadenante de ejemplo** y, a continuación, elija **Copiar**.
Elija **Usar el evento propio**.
Seleccione el evento completo en la ventana y pegue el evento de ejemplo sobre él.
Edite el evento como desee.

1. Elige **Ejecutar prueba**.

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

## Seleccionar los destinos
<a name="eb-create-rule-target-visual"></a>

Arrastra uno (y hasta cinco) objetivos al lienzo de **construcción** y suéltalo sobre **los objetivos** para recibir los eventos que coincidan con el patrón de eventos especificado. Los objetivos pueden incluir:
+ Otros autobuses de EventBridge eventos, en el mismo autobús o en uno diferente Cuenta de AWS
+ EventBridge Destinos de API, incluidos socios de SaaS como Salesforce
+ Una gama de recursos de AWS servicio, como colas de Amazon SQS o temas de Amazon SNS

**Para seleccionar destinos**

1. Seleccione el tipo de objetivo en el panel **Objetivos** y colóquelo en la forma **Objetivos** del lienzo Construir.

   EventBridge muestra la sección **Objetivo** en la compilación, con las opciones de configuración aplicables en función del tipo de objetivo que haya seleccionado.
**sugerencia**  
Si ha especificado más de un objetivo, al seleccionar la forma del objetivo, se muestra la sección de configuración de ese objetivo.

1. Configure el objetivo en función del tipo de objetivo. Para ver los pasos de configuración detallados, consulte [EventBridge Objetivos](eb-targets.md).

### Personalice los datos del evento enviados al destino
<a name="eb-create-rule-target-transform"></a>

Si selecciona un destino que no sea un bus de EventBridge eventos o un destino de EventBridge API, tiene la opción de personalizar los datos que realmente se envían al destino.

#### Transforma o reemplaza los datos del evento enviados (opcional)
<a name="eb-create-rule-target-transform-steps"></a>

1. En el lienzo de diseño de Build, elija el icono **de transformación de entrada** en la forma **Objetivos**.

   EventBridge muestra la sección **Transformación de entrada**.

1. En **Configuración de transformación de entrada**, elija **Activar**.

1. Seleccione el método de transformación para elegir cómo desea personalizar el texto enviado al destino para los eventos coincidentes:
   + **Parte de los eventos coincidentes**: EventBridge solo envía la parte especificada del evento de origen original al destino.
   + **Constante (texto JSON)**: EventBridge envía solo el texto JSON especificado al destino. No se envía ninguna parte del evento de origen original.
   + **Transformador** de entrada: configura un transformador de entrada para personalizar el texto que deseas EventBridge enviar al objetivo. Para obtener más información, consulte [Transformar la entrada de destino](eb-transform-target-input.md).

## Configuración dee la regla de
<a name="eb-create-rule-configure"></a>

Por último, configure y cree la regla.

**Para configurar la regla (consola)**

1. Elija **Configurar**.

1. Indique un **nombre** para la regla y, opcionalmente, una **descripción**.

   Una regla no puede tener el mismo nombre que otra regla en el mismo Región de AWS y en el mismo bus de eventos.

1. En **Bus de eventos**, elija el bus de eventos que desea asociar a esta regla.

   Si desea que esta regla coincida con eventos procedentes de su cuenta, seleccione **Bus de eventos predeterminado de AWS **. Cuando un Servicio de AWS miembro de tu cuenta envía un evento, siempre va al bus de eventos predeterminado de tu cuenta.

1. Para habilitar la regla tan pronto como se cree, en **Activación**, habilita **Activa**.

1. (Opcional) Introduzca una o varias etiquetas para la regla. Para obtener más información, consulte [Recursos de etiquetado en Amazon EventBridge](eb-tagging.md).

1. Elija **Crear**.

## Siguientes pasos
<a name="eb-create-rule-next-steps"></a>

Tras crear la regla, puede:
+ [Supervise el rendimiento de las reglas mediante métricas](eb-monitoring.md)
+ [Pon a prueba tu regla con ejemplos de eventos](eb-event-pattern-sandbox.md)
+ [Modifique los patrones de eventos según sea necesario](eb-event-patterns.md)
+ [Añada objetivos adicionales a las reglas existentes](eb-targets.md)

## Recursos adicionales
<a name="eb-create-rule-additional-resources"></a>

Para obtener más información sobre EventBridge las reglas, consulte:
+ [EventBridge descripción general de las reglas](eb-rules.md)
+ [Creación de patrones de eventos](eb-event-patterns.md)
+ [EventBridge objetivos](eb-targets.md)
+ [ EventBridge Reglas de solución de problemas](eb-troubleshooting.md)