

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 para enviar eventos de Amazon Quick Sight a AWS Lambda
<a name="events-send-lambda"></a>

En este tutorial, creará una AWS Lambda función que registre los eventos de los activos en la cuenta de Amazon Quick Sight. A continuación, podrá crear una regla que ejecute la función cuando se produzca un cambio de activo. En este tutorial se da por sentado que ya te has registrado en Amazon Quick Sight.

**Paso 1: Crea una Lambda función**

Cree una función Lambda para registrar los eventos de cambio de estado. Especifique esta función cuando cree la regla.

1. Inicie sesión en Consola de administración de AWS y abra la AWS Lambda consola en [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).

1. Si es la primera vez que utiliza Lambda, aparecerá una página de bienvenida. Seleccione **Get Started Now**. De lo contrario, seleccione **Create function (Crear función)**.

1. Elija **Author from scratch**.

1. En la página Crear función, escriba un nombre y una descripción para la función de Lambda. Por ejemplo, asigne un nombre a la función `QuickSightAssetChangeFn`.

1. En **Tiempo de ejecución**, seleccione **Node.js 18x**.

1. En **Arquitectura**, elija **x86\$164**.

1. En **Rol de ejecución**, elija **Crear un nuevo rol con permisos básicos de Lambda** o **Usar un rol existente** y elija el rol que desee.

1. Seleccione **Creación de función**.

1. En la **QuickSightAssetChange**página, selecciona **index.js**.

1. En el panel de**index.js**, elimine el código existente.

1. Escriba el siguiente fragmento de código.

   ```
   console.log('Loading function');
   exports.handler = async (event, context) => {
     console.log('Received QuickSight event:', JSON.stringify(event));
   };
   ```

1. Elija **Deploy (Implementar)**.

**Paso 2: Crear una regla**

Cree una regla para ejecutar la función Lambda siempre que utilice un activo de create/update/delete Amazon Quick Sight.

1. Inicia sesión en la EventBridge consola de Amazon Consola de administración de AWS y ábrela en [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

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

1. Elija **Creación de regla**.

1. Escriba un nombre y una descripción de la regla. Por ejemplo, escriba `QuickSightAssetChangeRule`.

1. Seleccione el bus de eventos **predeterminado**.

1. Elija **Rule with an event pattern (Regla con un patrón de evento)** y, a continuación, elija **Next (Siguiente)**.

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

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

1. En el cuadro de texto **Patrón de eventos**, ingrese el siguiente fragmento y elija **Siguiente**.

   ```
   {
     "source": ["aws.quicksight"]
   }
   ```

   Como alternativa, puede crear la regla que solo se suscriba a un subconjunto de tipos de eventos en Amazon Quick Sight. Por ejemplo, la siguiente regla solo se activará cuando se agregue o elimine un activo desde una carpeta con un identificador `77e307e8-b41b-472a-90e8-fe3f471537be`.

   ```
   {
     "source": ["aws.quicksight"],
     "detail-type": ["QuickSight Folder Membership Updated"],
     "detail": {
       "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
     }
   }
   ```

1. En **Tipos de destino**, elija **Servicio de AWS ** y **Función de Lambda**.

1. En **Function (Función)**, seleccione la función Lambda que ha creado. A continuación, elija **Siguiente**.

1. En **Configure tags (Configurar etiquetas)**, elija **Next (Siguiente)**.

1. Revise los pasos de la regla. A continuación, elija **Create rule (Crear regla)**.

**Paso 3: Probar la regla**

Para probar la regla, cree un análisis. Después de esperar un minuto, compruebe que se haya invocado la función de Lambda.

1. Abra la consola Amazon Quick Sight en [https://quicksight.aws.amazon.com/](https://quicksight.aws.amazon.com/).

1. Cree un nuevo análisis.

1. En el panel de navegación, elija **Rules (Reglas)** y elija el nombre de la regla que ha creado.

1. En **Detalles de la regla**, seleccione **Monitoreo**.

1. Se te redirigirá a la CloudWatch consola de Amazon. Si no se te redirige, selecciona **Ver las métricas en CloudWatch**.

1. En **All metrics (Todas las métricas)**, elija el nombre de la regla que creó. El gráfico indica que se ha invocado la regla.

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

1. Elija el nombre del grupo de registro para la función de Lambda. Por ejemplo, `/aws/lambda/function-name`.

1. Elija el nombre del flujo de registro para ver los datos proporcionados por la función para la instancia que ha lanzado. Debería recibir un resultado similar al siguiente:

   ```
   {
     "version": "0",
     "id": "3acb26c8-397c-4c89-a80a-ce672a864c55",
     "detail-type": "QuickSight Analysis Creation Successful",
     "source": "aws.quicksight",
     "account": "123456789012",
     "time": "2023-10-30T22:06:31Z",
     "region": "us-east-1",
     "resources": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],
     "detail": {
       "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
     }
   }
   ```

Para ver un ejemplo de un evento de Amazon Quick Sight en formato JSON, consulte [Descripción general de los eventos de Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/developerguide/events.html).