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 una EventBridge regla para una fuente de Amazon S3 (consola)
<a name="create-cloudtrail-S3-source-console"></a>

Antes de configurar una regla EventBridge, debe crear una AWS CloudTrail ruta. Para obtener más información, consulte [Creación de un registro de seguimiento en la consola](https://docs.aws.amazon.com/awscloudtrail/latest/userguide/cloudtrail-create-a-trail-using-the-console-first-time.html).

**importante**  
Si utilizas la consola para crear o editar tu canalización, la EventBridge regla y la AWS CloudTrail ruta se crearán automáticamente.

**Creación de un registro de seguimiento**

1. Abre la AWS CloudTrail consola.

1. En el panel de navegación, seleccione **Trails**.

1. Elija **Create Trail** (Crear registro de seguimiento). En **Trail name (Nombre de registro de seguimiento)**, escriba un nombre para el registro de seguimiento.

1. En **Storage location** (Ubicación de almacenamiento), cree o especifique el bucket que se utilizará para almacenar los archivos de log. De forma predeterminada, los buckets y los objetos de Amazon S3 son privados. Solo el propietario del recurso (la AWS cuenta que creó el depósito) puede acceder al depósito y a sus objetos. El depósito debe tener una política de recursos que permita AWS CloudTrail obtener permisos para acceder a los objetos del depósito.

1. En **Bucket y carpeta de registro de seguimiento**, especifique un bucket de Amazon S3 y el prefijo del objeto (nombre de la carpeta) para registrar los eventos de datos de todos los objetos de la carpeta. Puede agregar hasta 250 objetos de Amazon S3 a cada registro de seguimiento. Complete la información de la clave de cifrado requerida y seleccione **Siguiente**.

1. En **Tipo de evento**, elija **Eventos de administración**.

1. En **Eventos de administración**, elija **Escribir**. El registro de seguimiento consigna la actividad de la API para cada objeto de Amazon S3 (por ejemplo, `GetObject` y `PutObject`) con el bucket y el prefijo especificados.

1. Elija **Write (Escribir)**. 

1. Si está satisfecho con el registro de seguimiento, elija **Crear registro de seguimiento**.

**Para crear una EventBridge regla que se dirija a su canalización con una fuente de Amazon S3**

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, seleccione **Reglas**. Deje el bus predeterminado seleccionado o elija un bus de eventos. Elija **Crear regla**.

1. En **Nombre**, introduzca un nombre para la regla.

1. En **Tipo de regla**, elija **Regla con un patrón de evento**. Elija **Siguiente**.

1. En **Fuente del evento**, selecciona **AWS eventos o eventos EventBridge asociados**.

1. En **Ejemplo de tipo de evento**, seleccione **Eventos de AWS **.

1. En **Ejemplos de eventos**, escriba S3 como palabra clave para filtrar. Elige **AWS API call via CloudTrail**.

1. En **Método de creación**, elija **Patrón de cliente (JSON editor)**.

   Pegue el patrón de eventos que se muestra a continuación. Asegúrese de agregar el nombre del bucket y la clave de objeto S3 (o el nombre de clave) que identifica de forma única al objeto en el bucket como `requestParameters`. En este ejemplo, se crea una regla para un bucket denominado `amzn-s3-demo-source-bucket` y una clave de objeto de `my-files.zip`. Cuando se utiliza la ventana **Edit** (Editar) para especificar los recursos, la regla se actualiza para utilizar un patrón de eventos personalizado.

   A continuación se muestra un patrón de eventos de muestra para copiar y pegar:

   ```
   {
       "source": [
           "aws.s3"
       ],
       "detail-type": [
           "AWS API Call via CloudTrail"
       ],
       "detail": {
           "eventSource": [
               "s3.amazonaws.com"
           ],
           "eventName": [
               "CopyObject",
               "CompleteMultipartUpload",
               "PutObject"
           ],
           "requestParameters": {
               "bucketName": [
                   "amzn-s3-demo-source-bucket"
               ],
               "key": [
                   "my-files.zip"
               ]
           }
       }
   }
   ```

1. Elija **Siguiente**.

1. En **Tipos de destino**, elija **Servicio de AWS **.

1. En **Seleccione un objetivo**, elija **CodePipeline**. En **ARN de canalización**, Introduzca el ARN de la canalización que se iniciará cuando la active esta regla.
**nota**  
Para obtener el ARN de la canalización, ejecute el comando **get-pipeline**. El ARN de la canalización aparece en la salida. Se crea con el siguiente formato:   
arn:aws:codepipeline::: *region* *account* *pipeline-name*  
ARN de canalización de muestra:  
arn:aws:codepipeline:us-east- 2:80398 EJEMPLO: MyFirstPipeline 

1. Para crear o especificar una función de servicio de IAM que conceda EventBridge permisos para invocar el destino asociado a la regla (en este caso, el objetivo es): EventBridge CodePipeline 
   + Seleccione **Crear una nueva función para este recurso específico** a fin de crear una función de servicio que le dé EventBridge permisos para iniciar las ejecuciones de su canalización.
   + Selecciona **Usar el rol existente** para introducir un rol de servicio que te dé EventBridge permisos para iniciar las ejecuciones de tu canalización.

1. (Opcional) Para especificar las anulaciones de origen con un ID de imagen específico, use el transformador de entrada para pasar los datos como parámetros en JSON. También puede usar el transformador de entrada para pasar variables de canalización.
   + Amplíe **Configuración adicional**.

     En **Configurar entrada de destino**, elija **Configurar transformador de entrada**.

     En la ventana de cuadro de diálogo, elija **Escribir el mío**. En el cuadro **Ruta de entrada**, escriba los siguientes pares clave-valor.

     ```
     {"revisionValue": "$.detail.object.version-id"}
     ```
   + En el cuadro **Plantilla**, escriba los siguientes pares clave-valor.

     ```
                                     
                                     {
         "sourceRevisions": [
             {
                 "actionName": "Source",
                 "revisionType": "S3_OBJECT_VERSION_ID",
                 "revisionValue": "<revisionValue>"
             }
         ],
          "variables": [
             {
                 "name": "Variable_Name",
                 "value": "Variable_Value"
             }
         ]
     }
     ```
   + Seleccione **Confirmar**.

1. Elija **Siguiente**.

1. En la página **Etiquetas**, elija **Siguiente:**

1. En la página **Revisar y crear**, revise la configuración de la regla. Si está satisfecho con la regla, elija **Create rule (Crear regla)**.