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.
# Intégration des événements Amazon Quick Sight
Avec Amazon EventBridge, vous pouvez répondre automatiquement aux événements d'Amazon Quick Sight, tels que la création ou les mises à jour de nouveaux tableaux de bord. Ces événements sont diffusés EventBridge en temps quasi réel. En tant que développeur, vous pouvez écrire des règles simples pour indiquer quels événements sont intéressants et les actions à effectuer quand un événement correspond à une règle. En utilisant des événements, vous pouvez réaliser des cas d’utilisation tels que la sauvegarde et le déploiement continus.
**Topics**
+ [Événements pris en charge](#events-supported)
+ [Exemple de données utiles des événements](#sample-events-payload)
+ [Création de règles pour envoyer des événements Amazon Quick Sight à Amazon CloudWatch](events-send-cloudwatch.md)
+ [Création de règles pour envoyer des événements Amazon Quick Sight à AWS Lambda](events-send-lambda.md)
## Événements pris en charge
Amazon Quick Sight prend actuellement en charge les événements suivants.
| Type de ressource | Action | Type de détail d’événement | Détails de l’événement |
| --- | --- | --- | --- |
| Tableau de bord | Créer | Création réussie du tableau de bord Amazon Quick Sight | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Tableau de bord | Créer | La création du tableau de bord Amazon Quick Sight a échoué | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1,
"errors": [
{
"Type": "PARAMETER_NOT_FOUND",
"Message": "Missing property abc"
},
{
"Type": "DATA_SET_NOT_FOUND",
"Message": "Cannot find dataset with id abc"
}
]
} |
| Tableau de bord | Créer | Mise à jour des autorisations du tableau de bord Amazon Quick Sight | {"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Tableau de bord | Mettre à jour | Mise à jour du tableau de bord Amazon Quick Sight réussie | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Tableau de bord | Mettre à jour | La mise à jour du tableau de bord Amazon Quick Sight a échoué | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1,
"errors": [
{
"Type": "PARAMETER_NOT_FOUND",
"Message": "Missing property abc"
},
{
"Type": "DATA_SET_NOT_FOUND",
"Message": "Cannot find dataset with id abc"
}
]
} |
| Tableau de bord | Mettre à jour | Mise à jour des autorisations du tableau de bord Amazon Quick Sight | {"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"} |
| Tableau de bord | Publication | Mise à jour de la version publiée du tableau de bord Amazon Quick Sight | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Tableau de bord | Suppression | Le tableau de bord Amazon Quick Sight a été supprimé | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"
} |
| Analyse | Créer | Création réussie de l'analyse Amazon Quick Sight | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Analyse | Créer | Échec de la création de l'analyse Amazon Quick Sight | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5",
"errors": [
{
"Type": "PARAMETER_NOT_FOUND",
"Message": "Missing property abc"
},
{
"Type": "DATA_SET_NOT_FOUND",
"Message": "Cannot find dataset with id abc"
}
]
} |
| Analyse | Créer | Mise à jour des autorisations d'analyse Amazon Quick Sight | {"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } |
| Analyse | Suppression | Amazon Quick Sight Analysis supprimée | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Analyse | Mettre à jour | Mise à jour d'Amazon Quick Sight Analysis réussie | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Analyse | Mettre à jour | Échec de la mise à jour d'Amazon Quick Sight Analysis | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5",
"errors": [
{
"Type": "PARAMETER_NOT_FOUND",
"Message": "Missing property abc"
},
{
"Type": "DATA_SET_NOT_FOUND",
"Message": "Cannot find dataset with id abc"
}
]
} |
| Analyse | Mettre à jour | Mise à jour des autorisations d'analyse Amazon Quick Sight | {"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } |
| Connexion VPC | Créer | Création réussie de la connexion VPC Amazon Quick Sight | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "CREATION_SUCCESSFUL"
} |
| Connexion VPC | Créer | Échec de la création de la connexion VPC Amazon Quick Sight | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "CREATION_FAILED"
} |
| Connexion VPC | Mettre à jour | Mise à jour de la connexion VPC Amazon Quick Sight réussie | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "UPDATE_SUCCESSFUL"
} |
| Connexion VPC | Mettre à jour | Échec de la mise à jour de la connexion VPC Amazon Quick Sight | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "UPDATE_FAILED"
} |
| Connexion VPC | Suppression | Suppression de la connexion VPC Amazon Quick Sight réussie | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "DELETED"
} |
| Connexion VPC | Suppression | Échec de suppression de la connexion VPC Amazon Quick Sight | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "DELETION_FAILED"
} |
| Dossier | Créer | Dossier Amazon Quick Sight créé | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",
"parentFolderArn": "arn:aws:quicksight:us-east-1:123456789012:folder/098765432134"
} |
| Dossier | Créer | Permissions des dossiers Amazon Quick Sight mises à jour | {"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } |
| Dossier | Mettre à jour | Mise à jour du dossier Amazon Quick Sight | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
} |
| Dossier | Mettre à jour | Permissions des dossiers Amazon Quick Sight mises à jour | {"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } |
| Dossier | Suppression | Le dossier Amazon Quick Sight a été supprimé | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
} |
| Dossier | Mise à jour de l’abonnement | Abonnement au dossier Amazon Quick Sight mis à jour | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",
"membersAdded": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],
"membersRemoved": []
} |
| Jeu de données | Créer | Création d'un ensemble de données Amazon Quick Sight | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| Jeu de données | Créer | Permissions du jeu de données Amazon Quick Sight mises à jour | {"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" } |
| Jeu de données | Mettre à jour | Mise à jour du jeu de données Amazon Quick Sight | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| Jeu de données | Mettre à jour | Permissions du jeu de données Amazon Quick Sight mises à jour | {"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" } |
| Jeu de données | Suppression | Le jeu de données Amazon Quick Sight a été supprimé | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| DataSource | Créer | DataSource Création réussie d'Amazon Quick Sight | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| DataSource | Créer | Échec de DataSource création d'Amazon Quick Sight | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824",
"error": {
"message": "AMAZON_ELASTICSEARCH engine version 7.4 is lower than minimum supported version 7.7",
"type": "ENGINE_VERSION_NOT_SUPPORTED"
}
} |
| DataSource | Créer | DataSource Permissions Amazon Quick Sight mises à jour | {"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" } |
| DataSource | Mettre à jour | Mise à DataSource jour réussie d'Amazon Quick Sight | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| DataSource | Mettre à jour | Échec de la DataSource mise à jour d'Amazon Quick Sight | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824",
"error": {
"message": "AMAZON_ELASTICSEARCH engine version 7.4 is lower than minimum supported version 7.7",
"type": "ENGINE_VERSION_NOT_SUPPORTED"
}
} |
| DataSource | Mettre à jour | DataSource Permissions Amazon Quick Sight mises à jour | {"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" } |
| DataSource | Suppression | Amazon Quick Sight DataSource supprimé | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| Thème | Créer | Création du thème Amazon Quick Sight réussie | {
""themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1"
} |
| Thème | Créer | La création du thème Amazon Quick Sight a échoué | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Thème | Créer | Permissions du thème Amazon Quick Sight mises à jour | {"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Thème | Mettre à jour | Mise à jour du thème Amazon Quick Sight réussie | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Thème | Mettre à jour | Échec de la mise à jour du thème Amazon Quick Sight | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Thème | Mettre à jour | Permissions du thème Amazon Quick Sight mises à jour | {"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Thème | Suppression | Thème Amazon Quick Sight supprimé | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83"
} |
| Thème | Créer un alias | Alias du thème Amazon Quick Sight créé | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 2
} |
| Thème | Mise à jour des alias | Alias Amazon Quick Sight mis à jour | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 4
} |
| Thème | Supprimer un alias | Alias du thème Amazon Quick Sight supprimé | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 2
} |
## Exemple de données utiles des événements
Tous les événements suivent la [structure EventBridge d'objet](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) standard. Le champ de détails contient un objet JSON avec plus d’informations sur l’événement.
```
{
"version": "0",
"id": "3acb26c8-397c-4c89-a80a-ce672a864c55",
"detail-type": "QuickSight Dashboard 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:dashboard/6fdbc328-ebbd-457f-aa02-9780173afc83"],
"detail": {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
}
}
```
# Création de règles pour envoyer des événements Amazon Quick Sight à Amazon CloudWatch
Vous pouvez rédiger des règles simples pour indiquer les événements Amazon Quick Sight qui vous intéressent et les actions automatisées à effectuer lorsqu'un événement correspond à une règle. Par exemple, vous pouvez configurer Amazon Quick Sight pour envoyer des événements à Amazon CloudWatch chaque fois qu'une ressource Amazon Quick Sight est placée dans un dossier. Pour plus d'informations, consultez le [guide de EventBridge l'utilisateur Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html).
1. Connectez-vous à la CloudWatch console AWS Management Console et ouvrez-la à l'adresse [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. Sous **Événements** dans le panneau de navigation, choisissez **Règles**.
1. Choisissez **Créer une règle**.
1. Saisissez un nom et une description pour la règle. Le nom de la règle doit être unique au sein de cette région. Par exemple, saisissez `QuickSightAssetChangeRuleCloudWatch`.
1. Choisissez 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 **Targets**, choisissez **AWS service** > **groupe de CloudWatch journaux.**
1. Choisissez à partir d’un groupe de journaux existant ou créez-en un nouveau en entrant un nouveau nom de groupe de journaux.
1. Le cas échéant, vous pouvez ajouter une autre cible pour cette règle.
1. Dans la rubrique **Configure tags** (Configurer les balises), sélectionnez **Next** (Suivant).
1. Choisissez **Créer une règle**.
Pour plus d'informations, consultez la section [Création d'une EventBridge règle Amazon réagissant aux événements](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) dans le guide de EventBridge l'utilisateur Amazon.
# Création de règles pour envoyer des événements Amazon Quick Sight à AWS Lambda
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.govskope.caadresse/](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).