Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Integrazione degli eventi Amazon Quick Sight
Con Amazon EventBridge, puoi rispondere automaticamente agli eventi di Amazon Quick Sight, come la creazione di nuove dashboard o gli aggiornamenti. Questi eventi vengono trasmessi quasi EventBridge in tempo reale. Come sviluppatore, puoi scrivere regole semplici che indichino quali eventi sono considerati di interesse e quali azioni automatizzate intraprendere quando un evento corrisponde a una regola. Utilizzando gli eventi, puoi completare casi d'uso come il backup continuo e l'implementazione.
**Topics**
+ [
## Eventi supportati
](#events-supported)
+ [
## Esempio di payload di evento
](#sample-events-payload)
+ [
# Creazione di regole per inviare eventi Amazon Quick Sight ad Amazon CloudWatch
](events-send-cloudwatch.md)
+ [
# Creazione di regole per inviare eventi Amazon Quick Sight a AWS Lambda
](events-send-lambda.md)
## Eventi supportati
Amazon Quick Sight attualmente supporta i seguenti eventi.
| Tipo di asset | Azione | Tipo di dettaglio dell'evento | Dettagli dell'evento |
| --- | --- | --- | --- |
| Pannello di controllo | Crea | Creazione di dashboard Amazon Quick Sight avvenuta con successo | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Pannello di controllo | Crea | Creazione del dashboard Amazon Quick Sight non riuscita | {
"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"
}
]
} |
| Pannello di controllo | Crea | Autorizzazioni Amazon Quick Sight Dashboard aggiornate | {"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Pannello di controllo | Aggiorna | Aggiornamento del pannello di controllo Amazon Quick Sight completato con successo | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Pannello di controllo | Aggiorna | Aggiornamento del dashboard di Amazon Quick Sight non riuscito | {
"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"
}
]
} |
| Pannello di controllo | Aggiorna | Autorizzazioni Amazon Quick Sight Dashboard aggiornate | {"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"} |
| Pannello di controllo | Pubblica | Aggiornamento della versione pubblicata di Amazon Quick Sight Dashboard | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Pannello di controllo | Elimina | Dashboard Amazon Quick Sight eliminato | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"
} |
| Analisi | Crea | Creazione di Amazon Quick Sight Analysis avvenuta con successo | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Analisi | Crea | Creazione di Amazon Quick Sight Analysis non riuscita | {
"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"
}
]
} |
| Analisi | Crea | Autorizzazioni Amazon Quick Sight Analysis aggiornate | {"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } |
| Analisi | Elimina | Analisi Amazon Quick Sight eliminata | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Analisi | Aggiorna | Aggiornamento di Amazon Quick Sight Analysis riuscito | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Analisi | Aggiorna | Aggiornamento di Amazon Quick Sight Analysis non riuscito | {
"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"
}
]
} |
| Analisi | Aggiorna | Autorizzazioni Amazon Quick Sight Analysis aggiornate | {"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } |
| Connessione VPC | Crea | Creazione di una connessione VPC Amazon Quick Sight avvenuta con successo | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "CREATION_SUCCESSFUL"
} |
| Connessione VPC | Crea | Creazione della connessione Amazon Quick Sight VPC non riuscita | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "CREATION_FAILED"
} |
| Connessione VPC | Aggiorna | Aggiornamento della connessione Amazon Quick Sight VPC riuscito | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "UPDATE_SUCCESSFUL"
} |
| Connessione VPC | Aggiorna | Aggiornamento della connessione Amazon Quick Sight VPC non riuscito | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "UPDATE_FAILED"
} |
| Connessione VPC | Elimina | Eliminazione della connessione VPC Amazon Quick Sight avvenuta con successo | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "DELETED"
} |
| Connessione VPC | Elimina | Eliminazione della connessione Amazon Quick Sight VPC non riuscita | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "DELETION_FAILED"
} |
| Cartella | Crea | Creazione della cartella Amazon Quick Sight | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",
"parentFolderArn": "arn:aws:quicksight:us-east-1:123456789012:folder/098765432134"
} |
| Cartella | Crea | Autorizzazioni per cartelle Amazon Quick Sight aggiornate | {"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } |
| Cartella | Aggiorna | Cartella Amazon Quick Sight aggiornata | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
} |
| Cartella | Aggiorna | Autorizzazioni per cartelle Amazon Quick Sight aggiornate | {"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } |
| Cartella | Elimina | Cartella Amazon Quick Sight eliminata | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
} |
| Cartella | Aggiornamento dell'iscrizione | Iscrizione alla cartella Amazon Quick Sight aggiornata | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",
"membersAdded": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],
"membersRemoved": []
} |
| Set di dati | Crea | Set di dati Amazon Quick Sight creato | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| Set di dati | Crea | Autorizzazioni per set di dati Amazon Quick Sight aggiornate | {"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" } |
| Set di dati | Aggiorna | Set di dati Amazon Quick Sight aggiornato | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| Set di dati | Aggiorna | Autorizzazioni per set di dati Amazon Quick Sight aggiornate | {"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" } |
| Set di dati | Elimina | Set di dati Amazon Quick Sight eliminato | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| DataSource | Crea | DataSource Creazione di Amazon Quick Sight avvenuta con successo | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| DataSource | Crea | DataSource Creazione di Amazon Quick Sight non riuscita | {
"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 | Crea | DataSource Autorizzazioni Amazon Quick Sight aggiornate | {"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" } |
| DataSource | Aggiorna | DataSource Aggiornamento Amazon Quick Sight riuscito | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| DataSource | Aggiorna | DataSource Aggiornamento Amazon Quick Sight non riuscito | {
"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 | Aggiorna | DataSource Autorizzazioni Amazon Quick Sight aggiornate | {"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" } |
| DataSource | Elimina | Amazon Quick Sight DataSource eliminato | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| Tema | Crea | Creazione del tema Amazon Quick Sight avvenuta con successo | {
""themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1"
} |
| Tema | Crea | Creazione del tema Amazon Quick Sight non riuscita | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Tema | Crea | Autorizzazioni del tema Amazon Quick Sight aggiornate | {"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Tema | Aggiorna | Aggiornamento del tema Amazon Quick Sight riuscito | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Tema | Aggiorna | Aggiornamento del tema Amazon Quick Sight non riuscito | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Tema | Aggiorna | Autorizzazioni del tema Amazon Quick Sight aggiornate | {"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Tema | Elimina | Tema Amazon Quick Sight eliminato | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83"
} |
| Tema | Creazione di un alias | Creazione dell'alias del tema Amazon Quick Sight | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 2
} |
| Tema | Aggiornamento dell'alias | Alias Amazon Quick Sight aggiornato | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 4
} |
| Tema | Eliminazione dell'alias | Alias del tema Amazon Quick Sight eliminato | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 2
} |
## Esempio di payload di evento
Tutti gli eventi seguono la [struttura a EventBridge oggetti](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) standard. Il campo dei dettagli è un oggetto JSON che contiene più informazioni sull'evento.
```
{
"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
}
}
```
# Creazione di regole per inviare eventi Amazon Quick Sight ad Amazon CloudWatch
Puoi scrivere regole semplici per indicare quali eventi Amazon Quick Sight ti interessano e quali azioni automatiche intraprendere quando un evento corrisponde a una regola. Ad esempio, puoi configurare Amazon Quick Sight per inviare eventi ad Amazon CloudWatch ogni volta che una risorsa Amazon Quick Sight viene inserita in una cartella. Per ulteriori informazioni, consulta la [guida per EventBridge l'utente di Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html).
1. Accedi a Console di gestione AWS e apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. In **Events (Eventi)** nel pannello di navigazione, scegli **Rules (Regole)**.
1. Scegli **Crea regola**.
1. Inserisci un nome e una descrizione per la regola. Il nome della regola deve essere univoco all'interno di questa regione. Ad esempio, specifica `QuickSightAssetChangeRuleCloudWatch`.
1. Scegli il router di eventi **predefinito**.
1. Scegli **Rule with an event pattern** (Regola con un modello di eventi), quindi seleziona **Next** (Successivo).
1. Per **Origine dell'evento**, scegli **AWS eventi o eventi EventBridge partner**.
1. Nella sezione **Metodo di creazione**, scegli **Modello personalizzato (editor JSON)**.
1. Nella casella di testo **Modello di eventi**, inserisci il seguente frammento e scegli **Successivo**.
```
{
"source": ["aws.quicksight"]
}
```
In alternativa, puoi creare la regola che prevede l'iscrizione solo a un sottoinsieme di tipi di eventi in Amazon Quick Sight. Ad esempio, la seguente regola viene attivata solo quando una risorsa viene aggiunta o rimossa da una cartella con id `77e307e8-b41b-472a-90e8-fe3f471537be`.
```
{
"source": ["aws.quicksight"],
"detail-type": ["QuickSight Folder Membership Updated"],
"detail": {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
}
}
```
1. Per **Targets**, scegli **AWS service** > **CloudWatch log** group.
1. Scegli un gruppo di log esistente o creane uno nuovo, specificandone il nome.
1. Facoltativamente, è possibile aggiungere un'altra destinazione per questa regola.
1. In **Configure tags** (Configura tag), scegli **Next** (Successivo).
1. Scegli **Crea regola**.
Per ulteriori informazioni, consulta [Creazione di una EventBridge regola Amazon che reagisce agli eventi](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) nella guida per l' EventBridge utente di Amazon.
# Creazione di regole per inviare eventi Amazon Quick Sight a AWS Lambda
In questo tutorial, crei una AWS Lambda funzione che registra gli eventi degli asset nell'account Amazon Quick Sight. Successivamente crei una regola che esegua la funzione ogni volta che si verifica un cambiamento di asset. Questo tutorial presuppone che tu abbia già effettuato la registrazione ad Amazon Quick Sight.
**Fase 1: Creare una funzione Lambda**
Crea una funzione Lambda per registrare gli eventi di modifica dello stato. È necessario specificare questa funzione alla creazione della regola.
1. Accedi a Console di gestione AWS e apri la AWS Lambda console all'indirizzo [https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/).
1. Se è la prima volta che utilizzi Lambda, verrà visualizzata una pagina di benvenuto. Selezionare **Get Started Now** (Inizia subito). Altrimenti, scegliere **Create function (Crea funzione)**.
1. Scegli **Author from scratch** (Crea da zero).
1. Nella pagina Crea funzione, immetti un nome e una descrizione per la funzione Lambda. Ad esempio, denomina la funzione `QuickSightAssetChangeFn`.
1. In **Runtime**, seleziona **Node.js 18x**.
1. In **Architecture** (Architettura), scegli **x86\$164**.
1. Per **Ruolo di esecuzione**, scegli **Crea un nuovo ruolo con autorizzazioni Lambda di base** o **Usa un ruolo esistente** e scegli il ruolo che desideri.
1. Scegli **Crea funzione**.
1. Nella **QuickSightAssetChange**pagina, scegli **index.js**.
1. Nel riquadro di **index.js**, elimina il codice esistente.
1. Immetti il seguente frammento di codice.
```
console.log('Loading function');
exports.handler = async (event, context) => {
console.log('Received QuickSight event:', JSON.stringify(event));
};
```
1. Selezionare **Deploy (Distribuisci)**.
**Fase 2: Creazione di una regola**
Crea una regola per eseguire la funzione Lambda ogni volta che utilizzi una risorsa create/update/delete Amazon Quick Sight.
1. Accedi a Console di gestione AWS e apri la EventBridge console Amazon all'indirizzo [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/).
1. Nel pannello di navigazione, scegli **Regole**.
1. Scegli **Crea regola**.
1. Immettere un nome e una descrizione per la regola. Ad esempio, specifica `QuickSightAssetChangeRule`.
1. Seleziona il router di eventi **predefinito**.
1. Scegli **Rule with an event pattern** (Regola con un modello di eventi), quindi seleziona **Next** (Successivo).
1. Per **Event source**, scegli **AWS eventi o eventi EventBridge partner**.
1. Nella sezione **Metodo di creazione**, scegli **Modello personalizzato (editor JSON)**.
1. Nella casella di testo **Modello di eventi**, inserisci il seguente frammento e scegli **Successivo**.
```
{
"source": ["aws.quicksight"]
}
```
In alternativa, puoi creare la regola che prevede l'iscrizione solo a un sottoinsieme di tipi di eventi in Amazon Quick Sight. Ad esempio, la seguente regola viene attivata solo quando una risorsa viene aggiunta o rimossa da una cartella con id `77e307e8-b41b-472a-90e8-fe3f471537be`.
```
{
"source": ["aws.quicksight"],
"detail-type": ["QuickSight Folder Membership Updated"],
"detail": {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
}
}
```
1. Per **Tipi di destinazione**, scegli **Servizio AWS ** e **Funzione Lambda**.
1. In **Function** (Funzione), seleziona la funzione Lambda che hai creato. Quindi scegli **Successivo**.
1. In **Configure tags** (Configura tag), scegli **Next** (Successivo).
1. Esamina i passaggi nella regola. Quindi scegli **Create rule** (Crea regola).
**Fase 3: Test della regola**
Per verificare la regola, crea un'analisi. Dopo qualche minuto, verifica che la funzione Lambda sia stata richiamata.
1. Apri la console Amazon Quick Sight all'indirizzo [https://quicksight.aws.amazon.com/](https://quicksight.aws.amazon.com/).
1. Crea di una nuova analisi.
1. Nel pannello di navigazione, seleziona **Regole**, scegli il nome della regola creata.
1. In **Dettagli della regola** scegli **Monitoraggio**.
1. Verrai reindirizzato alla CloudWatch console Amazon. Se non vieni reindirizzato, scegli **Visualizza le metriche in**. CloudWatch
1. In **Tutti i parametri**, seleziona il nome della regola creata. Il grafico indica che la regola è stata invocata.
1. Nel pannello di navigazione, selezionare **Log groups (Gruppi di log)**.
1. Scegliere il nome del gruppo di log per la funzione Lambda. Ad esempio, `/aws/lambda/function-name`.
1. Scegliere il nome del flusso di log per visualizzare i dati forniti dalla funzione per l'istanza avviata. Sarà visualizzato un evento ricevuto simile a quello seguente:
```
{
"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"
}
}
```
Per un esempio di evento Amazon Quick Sight in formato JSON, consulta [Panoramica degli eventi per Amazon Quick Sight](https://docs.aws.amazon.com/quicksight/latest/developerguide/events.html).