本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# Amazon Quick Sight 事件整合
<a name="events-integration"></a>

使用 Amazon EventBridge，您可以自動回應 Amazon Quick Sight 中的事件，例如建立新的儀表板或更新。這些事件會以接近即時的方式遞送到 EventBridge。作為開發人員，您可寫入簡單的規則，來指示感興趣的事件，以及當事件符合規則時採取的動作。透過使用事件，您可以完成使用案例，例如持續備份與部署。

**Topics**
+ [支援的事件](#events-supported)
+ [範例事件承載](#sample-events-payload)
+ [建立將 Amazon Quick Sight 事件傳送至 Amazon CloudWatch 的規則](events-send-cloudwatch.md)
+ [建立規則以將 Amazon Quick Sight 事件傳送至 AWS Lambda](events-send-lambda.md)

## 支援的事件
<a name="events-supported"></a>

Amazon Quick Sight 目前支援下列事件。


| 資產類型設定 | Action | 事件詳細資訊類型 | 事件詳細資訊 | 
| --- | --- | --- | --- | 
| 儀表板 | 建立 | Amazon Quick Sight 儀表板建立成功 | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 1<br />}</pre> | 
| 儀表板 | 建立 | Amazon Quick Sight 儀表板建立失敗 | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 1,<br />    "errors": [<br />      {<br />        "Type": "PARAMETER_NOT_FOUND",<br />        "Message": "Missing property abc"<br />      },<br />      {<br />        "Type": "DATA_SET_NOT_FOUND",<br />        "Message": "Cannot find dataset with id abc"<br />      }<br />    ]<br />}</pre> | 
| 儀表板 | 建立 | Amazon Quick Sight 儀表板許可已更新 | <pre>{"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83" }</pre> | 
| 儀表板 | 更新 | Amazon Quick Sight 儀表板更新成功 | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 1<br />}</pre> | 
| 儀表板 | 更新 | Amazon Quick Sight 儀表板更新失敗 | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 1,<br />    "errors": [<br />      {<br />        "Type": "PARAMETER_NOT_FOUND",<br />        "Message": "Missing property abc"<br />      },<br />      {<br />        "Type": "DATA_SET_NOT_FOUND",<br />        "Message": "Cannot find dataset with id abc"<br />      }<br />    ]<br />}</pre> | 
| 儀表板 | 更新 | Amazon Quick Sight 儀表板許可已更新 | <pre>{"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"}</pre> | 
| 儀表板 | 發布 | Amazon Quick Sight 儀表板發佈版本已更新 | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",<br />    "versionNumber": 2<br />}</pre> | 
| 儀表板 | 刪除 | 已刪除 Amazon Quick Sight 儀表板 | <pre>{<br />    "dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"<br />}</pre> | 
| 分析 | 建立 | Amazon Quick Sight 分析建立成功 | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"<br />}</pre> | 
| 分析 | 建立 | Amazon Quick Sight Analysis Creation 失敗 | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5",<br />    "errors": [<br />      {<br />        "Type": "PARAMETER_NOT_FOUND",<br />        "Message": "Missing property abc"<br />      },<br />      {<br />        "Type": "DATA_SET_NOT_FOUND",<br />        "Message": "Cannot find dataset with id abc"<br />      }<br />    ]<br />}</pre> | 
| 分析 | 建立 | Amazon Quick Sight 分析許可已更新 | <pre>{"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" }</pre> | 
| 分析 | 刪除 | 已刪除 Amazon Quick Sight 分析 | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"<br />}</pre> | 
| 分析 | 更新 | Amazon Quick Sight 分析更新成功 | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"<br />}</pre> | 
| 分析 | 更新 | Amazon Quick Sight 分析更新失敗 | <pre>{<br />    "analysisId": "e5f37119-e24c-4874-901a-af9032b729b5",    <br />    "errors": [        <br />        {            <br />            "Type": "PARAMETER_NOT_FOUND",            <br />            "Message": "Missing property abc"        <br />        },        <br />        {             <br />            "Type": "DATA_SET_NOT_FOUND",            <br />            "Message": "Cannot find dataset with id abc"        <br />        }    <br />    ]<br />}</pre> | 
| 分析 | 更新 | Amazon Quick Sight 分析許可已更新 | <pre>{"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" }</pre> | 
| VPC 連線 | 建立 | Amazon Quick Sight VPC 連線建立成功 | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "CREATION_SUCCESSFUL"<br />}</pre> | 
| VPC 連線 | 建立 | Amazon Quick Sight VPC 連線建立失敗 | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "CREATION_FAILED"<br />}</pre> | 
| VPC 連線 | 更新 | Amazon Quick Sight VPC 連線更新成功 | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "UPDATE_SUCCESSFUL"<br />}</pre> | 
| VPC 連線 | 更新 | Amazon Quick Sight VPC 連線更新失敗 | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "UPDATE_FAILED"<br />}</pre> | 
| VPC 連線 | 刪除 | Amazon Quick Sight VPC 連線刪除成功 | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "DELETED"<br />}</pre> | 
| VPC 連線 | 刪除 | Amazon Quick Sight VPC 連線刪除失敗 | <pre>{<br />    "vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",<br />    "availabilityStatus": "DELETION_FAILED"<br />}</pre> | 
| 資料夾 | 建立 | 已建立 Amazon Quick Sight 資料夾 | <pre>{<br />    "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",<br />    "parentFolderArn": "arn:aws:quicksight:us-east-1:123456789012:folder/098765432134"<br />}</pre> | 
| 資料夾 | 建立 | Amazon Quick Sight 資料夾許可已更新 | <pre>{"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" }</pre> | 
| 資料夾 | 更新 | Amazon Quick Sight 資料夾已更新 | <pre>{<br />    "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"<br />}</pre> | 
| 資料夾 | 更新 | Amazon Quick Sight 資料夾許可已更新 | <pre>{"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" }</pre> | 
| 資料夾 | 刪除 | 已刪除 Amazon Quick Sight 資料夾 | <pre>{<br />    "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"<br />}</pre> | 
| 資料夾 | 成員資格更新 | Amazon Quick Sight 資料夾成員資格已更新 | <pre>{<br />    "folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",<br />    "membersAdded": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],<br />    "membersRemoved": []<br />}</pre> | 
| 資料集 | 建立 | 已建立 Amazon Quick Sight 資料集 | <pre>{<br />    "datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"<br />}</pre> | 
| 資料集 | 建立 | Amazon Quick Sight 資料集許可已更新 | <pre>{"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" }</pre> | 
| 資料集 | 更新 | Amazon Quick Sight 資料集已更新 | <pre>{<br />    "datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"<br />}</pre> | 
| 資料集 | 更新 | Amazon Quick Sight 資料集許可已更新 | <pre>{"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" }</pre> | 
| 資料集 | 刪除 | 已刪除 Amazon Quick Sight 資料集 | <pre>{<br />    "datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"<br />}</pre> | 
| 資料來源 | 建立 | Amazon Quick Sight DataSource 建立成功 | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"<br />}</pre> | 
| 資料來源 | 建立 | Amazon Quick Sight DataSource 建立失敗 | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824",<br />    "error": {<br />        "message": "AMAZON_ELASTICSEARCH engine version 7.4 is lower than minimum supported version 7.7",<br />        "type": "ENGINE_VERSION_NOT_SUPPORTED"<br />    }<br />}</pre> | 
| 資料來源 | 建立 | Amazon Quick Sight DataSource 許可已更新 | <pre>{"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" }</pre> | 
| 資料來源 | 更新 | Amazon Quick Sight DataSource 更新成功 | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"<br />}</pre> | 
| 資料來源 | 更新 | Amazon Quick Sight DataSource 更新失敗 | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824",<br />    "error": {<br />        "message": "AMAZON_ELASTICSEARCH engine version 7.4 is lower than minimum supported version 7.7",<br />        "type": "ENGINE_VERSION_NOT_SUPPORTED"<br />    }<br />}</pre> | 
| 資料來源 | 更新 | Amazon Quick Sight DataSource 許可已更新 | <pre>{"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" }</pre> | 
| 資料來源 | 刪除 | 已刪除 Amazon Quick Sight DataSource  | <pre>{<br />    "datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"<br />}</pre> | 
| 佈景主題 | 建立 | Amazon Quick Sight 主題建立成功 | <pre>{<br />    ""themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83", <br />    "versionNumber": 1"<br />}</pre> | 
| 佈景主題 | 建立 | Amazon Quick Sight 佈景主題建立失敗 | <pre>{ <br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83", <br />    "versionNumber": 1<br />}</pre> | 
| 佈景主題 | 建立 | Amazon Quick Sight 佈景主題許可已更新 | <pre>{"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" }</pre> | 
| 佈景主題 | 更新 | Amazon Quick Sight 主題更新成功 | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "versionNumber": 2<br />}</pre> | 
| 佈景主題 | 更新 | Amazon Quick Sight 主題更新失敗 | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "versionNumber": 2<br />}</pre> | 
| 佈景主題 | 更新 | Amazon Quick Sight 佈景主題許可已更新 | <pre>{"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" }</pre> | 
| 佈景主題 | 刪除 | 已刪除 Amazon Quick Sight 主題 | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83"<br />}</pre> | 
| 佈景主題 | 別名建立 | Amazon Quick Sight 主題別名已建立 | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "aliasName": "MyThemeAlias"    <br />    "versionNumber": 2<br />}</pre> | 
| 佈景主題 | 別名更新 | Amazon Quick Sight 別名已更新 | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "aliasName": "MyThemeAlias"    <br />    "versionNumber": 4<br />}</pre> | 
| 佈景主題 | 別名刪除 | 已刪除 Amazon Quick Sight 佈景主題別名 | <pre>{<br />    "themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",    <br />    "aliasName": "MyThemeAlias"    <br />    "versionNumber": 2<br />}</pre> | 

## 範例事件承載
<a name="sample-events-payload"></a>

所有事件皆遵循標準 EventBridge [物件結構](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。詳細資訊欄位為包含更多事件相關資訊的 JSON 物件。

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