

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Création de règles pour envoyer des événements Amazon Quick Sight à AWS Lambda
<a name="events-send-lambda"></a>

Dans ce didacticiel, vous allez créer une AWS Lambda fonction qui enregistre les événements relatifs aux actifs dans le compte Amazon Quick Sight. Vous créez ensuite une règle qui exécute la fonction chaque fois qu’il y a un changement d’actif. Ce didacticiel part du principe que vous êtes déjà inscrit à Amazon Quick Sight.

**Étape 1 : Création d'une Lambda fonction**

Créez une fonction Lambda pour enregistrer les événements de changement d’état. Vous spécifiez cette fonction lors de la création de votre règle.

1. Connectez-vous à la AWS Lambda console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).

1. Si vous utilisez Lambda pour la première fois, une page de bienvenue s’affiche. Sélectionnez **Pour commencer**. Sinon, choisissez **Créer la fonction**.

1. Choisissez **Créer à partir de scratch**.

1. Sur la page de création de la fonction, saisissez un nom et une description pour la fonction Lambda. Par exemple, nommez la fonction `QuickSightAssetChangeFn`.

1. Dans **Runtime (exécution)**, sélectionnez **Node.js 18x**.

1. Pour **Architecture**, choisissez **x86\$164**.

1. Pour **le rôle d’exécution**, choisissez soit **Créer un nouveau rôle avec des autorisations Lambda de base**, soit **Utiliser un rôle existant** et choisissez le rôle que vous souhaitez.

1. Choisissez **Créer une fonction**.

1. Sur la **QuickSightAssetChange**page, choisissez **index.js**.

1. Dans le panneau **index.js**, supprimez le code existant.

1. Saisissez le code snippet suivant.

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

1. Choisissez **Deploy** (Déployer).

**Étape 2 : création d’une règle**

Créez une règle pour exécuter votre fonction Lambda chaque fois que vous êtes une ressource create/update/delete Amazon Quick Sight.

1. Connectez-vous à la EventBridge console Amazon AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).

1. Dans le panneau de navigation, choisissez **Rules**.

1. Choisissez **Créer une règle**.

1. Saisissez un nom et une description pour la règle. Par exemple, entrez `QuickSightAssetChangeRule`.

1. Sélectionnez le bus d’événements **par défaut**.

1. Sélectionnez **Rule with an event pattern** (Règle avec un modèle d’événement), puis sélectionnez **Next** (Suivant).

1. Dans **Source de l'événement**, sélectionnez **AWS événements ou événements EventBridge partenaires**.

1. Dans la section **Méthode de création**, pour Méthode, choisissez **Modèle personnalisé (éditeur JSON)**.

1. Dans la zone de texte **Modèle d’événement**, entrez l’extrait suivant et choisissez **Next (Suivant)**.

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

   Vous pouvez également créer la règle qui s'abonne uniquement à un sous-ensemble de types d'événements dans Amazon Quick Sight. Par exemple, la règle suivante ne sera déclenchée que lorsqu’une ressource est ajoutée ou supprimée d’un dossier portant un identifiant `77e307e8-b41b-472a-90e8-fe3f471537be`.

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

1. Pour les **types de cible**, choisissez le **AWS service** et la **fonction Lambda**.

1. Dans **Function** (Fonction), choisissez la fonction Lambda que vous avez créée. Ensuite, sélectionnez **Suivant**.

1. Dans la rubrique **Configure tags** (Configurer les balises), sélectionnez **Next** (Suivant).

1. Passez en revue les étapes de votre règle. Puis, choisissez **Create rule** (Créer une règle).

**Étape 3 : test de la règle**

Pour tester votre règle, créez une analyse. Après avoir attendu quelques minutes que l’instance s’arrête, vous pouvez vérifier que votre fonction Lambda a été invoquée.

1. Ouvrez la console Amazon Quick Sight à l'[https://quicksight---aws.amazon.com.rproxy.goskope.comadresse/](https://quicksight.aws.amazon.com/).

1. Créez une nouvelle analyse.

1. Dans le panneau de navigation, cliquez sur **Rules** (Règles), puis sur le nom de la règle que vous avez créée.

1. Dans **Détails des règles**, choisissez **Surveillance**.

1. Vous serez redirigé vers la CloudWatch console Amazon. Si vous n'êtes pas redirigé, choisissez **Afficher les statistiques dans CloudWatch**.

1. Dans **All metrics** (Toutes les métriques), cliquez sur le nom de la règle que vous avez créée. Le graphique doit indiquer que la règle a été invoquée.

1. Dans le panneau de navigation, choisissez **Groupes de journaux**.

1. Choisissez le nom du groupe de journaux de votre fonction Lambda. Par exemple, `/aws/lambda/function-name`.

1. Choisissez le nom du flux de journaux pour afficher les données fournies par la fonction concernant l’instance que vous avez lancée. Vous devez voir un événement reçu semblable à ce qui suit :

   ```
   {
     "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"
     }
   }
   ```

Pour un exemple d'événement Amazon Quick Sight au format JSON, consultez [Présentation des événements pour Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/developerguide/events.html).