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.
# Integración de eventos de Amazon Quick Sight
Con Amazon EventBridge, puedes responder automáticamente a los eventos de Amazon Quick Sight, como la creación de un nuevo panel de control o las actualizaciones. Estos eventos se envían casi EventBridge en tiempo real. Como desarrollador, puede crear reglas sencillas para indicar qué eventos le resultan de interés, así como las acciones que deben llebarse a cabo cuando un evento cumple una de las reglas. Al utilizar los eventos, puede completar casos de uso, como la implementación y las copias de seguridad continuas.
**Topics**
+ [Eventos admitidos](#events-supported)
+ [Ejemplo de carga útil de evento](#sample-events-payload)
+ [Crear reglas para enviar eventos de Amazon Quick Sight a Amazon CloudWatch](events-send-cloudwatch.md)
+ [Crear reglas para enviar eventos de Amazon Quick Sight a AWS Lambda](events-send-lambda.md)
## Eventos admitidos
Amazon Quick Sight admite actualmente los siguientes eventos.
| Tipo de activo | Action | Tipo de detalle del evento | Detalles del evento |
| --- | --- | --- | --- |
| Panel de control | Crear | La creación del Amazon Quick Sight Dashboard se ha realizado correctamente | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Panel de control | Crear | Falló la creación del panel de Amazon Quick Sight | {
"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"
}
]
} |
| Panel de control | Crear | Se actualizaron los permisos del panel de control de Amazon Quick Sight | {"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Panel de control | Actualización | La actualización del panel de Amazon Quick Sight se ha realizado correctamente | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Panel de control | Actualización | Falló la actualización del panel de control de Amazon Quick Sight | {
"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"
}
]
} |
| Panel de control | Actualización | Se actualizaron los permisos del panel de control de Amazon Quick Sight | {"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"} |
| Panel de control | Publish | Actualización de la versión publicada de Amazon Quick Sight Dashboard | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Panel de control | Eliminar | Eliminado el panel de Amazon Quick Sight | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"
} |
| Análisis | Crear | La creación de Amazon Quick Sight Analysis se ha realizado correctamente | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Análisis | Crear | Falló la creación de 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"
}
]
} |
| Análisis | Crear | Actualización de los permisos de Amazon Quick Sight Analysis | {"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } |
| Análisis | Eliminar | Eliminado el análisis Quick Sight de Amazon | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Análisis | Actualización | La actualización de Amazon Quick Sight Analysis se ha realizado correctamente | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| Análisis | Actualización | Falló la actualización de 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"
}
]
} |
| Análisis | Actualización | Actualización de los permisos de Amazon Quick Sight Analysis | {"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } |
| Conexión a VPC | Crear | La conexión VPC de Amazon Quick Sight se ha creado correctamente | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "CREATION_SUCCESSFUL"
} |
| Conexión a VPC | Crear | Falló la creación de la conexión de VPC de Amazon Quick Sight | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "CREATION_FAILED"
} |
| Conexión a VPC | Actualización | La actualización de la conexión a la VPC de Amazon Quick Sight se ha realizado correctamente | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "UPDATE_SUCCESSFUL"
} |
| Conexión a VPC | Actualización | Falló la actualización de la conexión a la VPC de Amazon Quick Sight | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "UPDATE_FAILED"
} |
| Conexión a VPC | Eliminar | La conexión de VPC de Amazon Quick Sight se ha eliminado correctamente | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "DELETED"
} |
| Conexión a VPC | Eliminar | Falló la eliminación de la conexión de VPC de Amazon Quick Sight | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "DELETION_FAILED"
} |
| Folder | Crear | Se creó la carpeta Amazon Quick Sight | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",
"parentFolderArn": "arn:aws:quicksight:us-east-1:123456789012:folder/098765432134"
} |
| Folder | Crear | Se actualizaron los permisos de las carpetas de Amazon Quick Sight | {"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } |
| Folder | Actualización | Carpeta Amazon Quick Sight actualizada | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
} |
| Folder | Actualización | Se actualizaron los permisos de las carpetas de Amazon Quick Sight | {"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } |
| Folder | Eliminar | Carpeta Amazon Quick Sight eliminada | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
} |
| Folder | Actualización de membresía | Actualización de la membresía de Amazon Quick Sight Folder | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",
"membersAdded": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],
"membersRemoved": []
} |
| Conjunto de datos | Crear | Se creó el conjunto de datos Amazon Quick Sight | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| Conjunto de datos | Crear | Se actualizaron los permisos del conjunto de datos de Amazon Quick Sight | {"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" } |
| Conjunto de datos | Actualización | Actualización del conjunto de datos Amazon Quick Sight | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| Conjunto de datos | Actualización | Se actualizaron los permisos del conjunto de datos de Amazon Quick Sight | {"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" } |
| Conjunto de datos | Eliminar | Se ha eliminado el conjunto de datos de Amazon Quick Sight | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| DataSource | Crear | La DataSource creación de Amazon Quick Sight se ha realizado correctamente | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| DataSource | Crear | Falló la DataSource creación de 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 | Crear | DataSource Permisos de Amazon Quick Sight actualizados | {"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" } |
| DataSource | Actualización | La DataSource actualización de Amazon Quick Sight se ha realizado correctamente | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| DataSource | Actualización | Falló la DataSource actualización de 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 | Actualización | DataSource Permisos de Amazon Quick Sight actualizados | {"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" } |
| DataSource | Eliminar | Amazon Quick Sight DataSource eliminado | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| Theme | Crear | Creación exitosa del tema Amazon Quick Sight | {
""themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1"
} |
| Theme | Crear | Falló la creación del tema Amazon Quick Sight | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Theme | Crear | Se actualizaron los permisos del tema Amazon Quick Sight | {"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Theme | Actualización | La actualización del tema Amazon Quick Sight se ha realizado correctamente | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Theme | Actualización | Falló la actualización del tema Amazon Quick Sight | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Theme | Actualización | Se actualizaron los permisos del tema Amazon Quick Sight | {"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Theme | Eliminar | Tema Amazon Quick Sight eliminado | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83"
} |
| Theme | Creación de alias | Se creó el alias del tema Amazon Quick Sight | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 2
} |
| Theme | Actualización de alias | Alias de Amazon Quick Sight actualizado | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 4
} |
| Theme | Eliminación de alias | Alias del tema Amazon Quick Sight eliminado | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 2
} |
## Ejemplo de carga útil de evento
Todos los eventos siguen la [estructura de EventBridge objetos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html) estándar. El campo de detalles es un objeto JSON que contiene más información sobre el 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
}
}
```
# Crear reglas para enviar eventos de Amazon Quick Sight a Amazon CloudWatch
Puede escribir reglas sencillas para indicar qué eventos de Amazon Quick Sight le interesan y qué acciones automatizadas debe realizar cuando un evento coincide con una regla. Por ejemplo, puede configurar Amazon Quick Sight para enviar eventos a Amazon CloudWatch siempre que se coloque un activo de Amazon Quick Sight en una carpeta. Para obtener más información, consulta la [guía del EventBridge usuario de Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html).
1. Inicie sesión en Consola de administración de AWS y abra la CloudWatch consola en [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/).
1. En el panel de navegación, en **Events (Eventos)**, elija **Rules (Reglas)**.
1. Elija **Creación de regla**.
1. Escriba un nombre y una descripción para la regla. El nombre de la regla debe ser exclusivo dentro de esta región. Por ejemplo, escriba `QuickSightAssetChangeRuleCloudWatch`.
1. Elija 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 **Targets**, selecciona **AWS servicio > grupo de CloudWatch ** **registros**.
1. Elija un grupo de registro existente o cree uno nuevo. Para ello, ingrese el nombre del nuevo grupo de registro.
1. Si lo desea, puede agregar otro destino para esta regla.
1. En **Configure tags (Configurar etiquetas)**, elija **Next (Siguiente)**.
1. Seleccione **Creación de regla**.
Para obtener más información, consulta [Cómo crear una EventBridge regla de Amazon que reaccione a los eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html) en la guía del EventBridge usuario de Amazon.
# Crear reglas para enviar eventos de Amazon Quick Sight a AWS Lambda
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).