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 reglas con el generador mejorado
<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 relación con los eventos recibidos EventBridge, puede crear reglas. Cuando un evento coincide con el patrón de eventos definido en su regla, lo EventBridge envía 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 implica cuatro pasos principales:

1. Elige los eventos que quieres procesar

1. Configure el filtrado y las pruebas de eventos

1. Seleccione y configure los objetivos

1. Configure los ajustes de la regla

## Elige 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, elija **Rules** (Reglas) y, a continuación, elija **Create rule** (Crear regla).

1. En la página de selección del generador de reglas, elija ** Enhanced Builder**.

   El generador mejorado proporciona un lienzo visual para crear reglas y objetivos arrastrando y soltando eventos y objetivos. Para usar los patrones y la configuración de JSON en su lugar, consulte [ Creación de reglas (Advanced Builder). ](eb-create-rule-wizard.md)

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

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

   1. Utilice el cuadro de búsqueda o navegue por la lista de eventos para encontrar los eventos que desea 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**, que muestra el evento que ha elegido.
   + **Esquema**, que muestra el esquema del evento seleccionado, si está disponible.

     ****El esquema contiene tres pestañas:
     + **Árbol**: una vista en árbol del esquema del evento.
     + **Código**: el esquema de eventos en formato JSON o especificación 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 has elegido.

## Filtra los eventos para enviar solo lo que quieras
<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 de eventos (opcional)
<a name="eb-create-rule-event-pattern-steps"></a>

En el ** panel ** Activación de 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 en á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 desea agregar 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 desea que coincida.

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

   EventBridge agrega el filtro que ha creado al JSON en el ** panel de patrones de ** eventos.

1. Añade filtros adicionales hasta que hayas creado un patrón de eventos que coincida con todos los atributos de eventos que desees.

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

Después de crear un patrón de eventos que coincida con todos los atributos de eventos que desea, 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 evento de muestra para probarlo o usa el tuyo propio.
   + **Usa los eventos de muestra que se proporcionan **

     1. Selecciona ** Utilizar los eventos de muestra proporcionados**.

     1. En ** Ejemplo de evento desencadenante**, selecciona el evento que quieres usar 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. Selecciona ** 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 un objetivo (y hasta cinco) al ** lienzo de ** creación y suéltalo en ** Targets ** para recibir los eventos que coincidan con el patrón de eventos especificado. Los objetivos pueden incluir:
+ Otros buses de EventBridge eventos, en el mismo o en uno diferente Cuenta de AWS
+ EventBridge Destinos de API, incluidos los socios de SaaS, como Salesforce
+ Una variedad de recursos de AWS servicio, como las colas de Amazon SQS o los temas de Amazon SNS

**Para seleccionar destinos**

1. Seleccione el tipo de objetivo en el ** panel de ** objetivos y colóquelo en la ** forma de ** objetivos del lienzo de creación.

   EventBridge muestra la ** sección ** Objetivo en la construcció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 de su tipo de objetivo. Para ver los pasos de configuración detallados, consulte [ EventBridge Objetivos](eb-targets.md).

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

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

#### 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 ** de transformación de entrada.

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

1. Seleccione el método de transformación para elegir cómo desea personalizar el texto enviado al destino para que coincida con los eventos:
   + **Parte de los eventos coincidentes**: EventBridge solo envía al destino la parte especificada del evento de origen original.
   + **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**: configure un transformador de entrada para personalizar el texto que EventBridge desea enviar al destino. 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 bus de eventos Región de AWS y en el mismo.

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 alguien Servicio de AWS de tu cuenta envía un evento, este siempre va al bus de eventos predeterminado de tu cuenta.

1. Para activar 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, puedes:
+ [Supervisar el rendimiento de las reglas mediante métricas ](eb-monitoring.md)
+ [Pon a prueba tu regla con eventos de muestra ](eb-event-pattern-sandbox.md)
+ [Modifique los patrones de eventos según sea necesario ](eb-event-patterns.md)
+ [Agregue 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)