翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon Quick Sight イベント統合
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)
## サポートされるイベント
Amazon Quick Sight は現在、次のイベントをサポートしています。
| アセットタイプ | Action | イベントの詳細のタイプ | イベントの詳細 |
| --- | --- | --- | --- |
| ダッシュボード | 作成 | Amazon Quick Sight ダッシュボードの作成に成功しました | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| ダッシュボード | 作成 | 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"
}
]
} |
| ダッシュボード | 作成 | Amazon Quick Sight ダッシュボードの許可が更新されました | {"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| ダッシュボード | 更新 | Amazon Quick Sight ダッシュボードの更新に成功しました | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| ダッシュボード | 更新 | 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"
}
]
} |
| ダッシュボード | 更新 | Amazon Quick Sight ダッシュボードの許可が更新されました | {"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"} |
| ダッシュボード | 発行 | Amazon Quick Sight ダッシュボードの公開バージョンが更新されました | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| ダッシュボード | Delete | Amazon Quick Sight ダッシュボードの削除 | {
"dashboardId": "6fdbc328-ebbd-457f-aa02-9780173afc83"
} |
| 分析 | 作成 | Amazon Quick Sight 分析の作成に成功しました | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| 分析 | 作成 | 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"
}
]
} |
| 分析 | 作成 | Amazon Quick Sight 分析の許可が更新されました | {"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } |
| 分析 | Delete | Amazon Quick Sight 分析が削除されました | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| 分析 | 更新 | Amazon Quick Sight Analysis の更新に成功しました | {
"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5"
} |
| 分析 | 更新 | 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"
}
]
} |
| 分析 | 更新 | Amazon Quick Sight 分析の許可が更新されました | {"analysisId": "e5f37119-e24c-4874-901a-af9032b729b5" } |
| VPC 接続 | 作成 | Amazon Quick Sight VPC 接続の作成に成功しました | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "CREATION_SUCCESSFUL"
} |
| VPC 接続 | 作成 | Amazon Quick Sight VPC 接続の作成に失敗しました | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "CREATION_FAILED"
} |
| VPC 接続 | 更新 | Amazon Quick Sight VPC 接続の更新に成功しました | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "UPDATE_SUCCESSFUL"
} |
| VPC 接続 | 更新 | Amazon Quick Sight VPC 接続の更新に失敗しました | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "UPDATE_FAILED"
} |
| VPC 接続 | Delete | Amazon Quick Sight VPC 接続の削除に成功しました | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "DELETED"
} |
| VPC 接続 | Delete | Amazon Quick Sight VPC 接続の削除に失敗しました | {
"vpcConnectionId": "53d34238-57e7-488d-b99a-a0037d275a4e",
"availabilityStatus": "DELETION_FAILED"
} |
| Folder | 作成 | Amazon Quick Sight フォルダが作成されました | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",
"parentFolderArn": "arn:aws:quicksight:us-east-1:123456789012:folder/098765432134"
} |
| Folder | 作成 | Amazon Quick Sight フォルダのアクセス許可が更新されました | {"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } |
| Folder | 更新 | Amazon Quick Sight フォルダが更新されました | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
} |
| Folder | 更新 | Amazon Quick Sight フォルダのアクセス許可が更新されました | {"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be" } |
| Folder | Delete | Amazon Quick Sight フォルダが削除されました | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
} |
| Folder | メンバーシップの更新 | Amazon Quick Sight フォルダメンバーシップが更新されました | {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be",
"membersAdded": ["arn:aws:quicksight:us-east-1:123456789012:analysis/e5f37119-e24c-4874-901a-af9032b729b5"],
"membersRemoved": []
} |
| データセット | 作成 | Amazon Quick Sight データセットが作成されました | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| データセット | 作成 | Amazon Quick Sight データセットのアクセス許可が更新されました | {"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" } |
| データセット | 更新 | Amazon Quick Sight データセットが更新されました | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| データセット | 更新 | Amazon Quick Sight データセットのアクセス許可が更新されました | {"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa" } |
| データセット | Delete | Amazon Quick Sight データセットの削除 | {
"datasetId": "a6553a81-f97e-4ffa-a860-baea63196efa"
} |
| DataSource | 作成 | Amazon Quick Sight DataSourceの作成に成功しました | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| DataSource | 作成 | Amazon Quick Sight DataSourceの作成に失敗しました | {
"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 | 作成 | Amazon Quick Sight DataSourceのアクセス許可が更新されました | {"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" } |
| DataSource | 更新 | Amazon Quick Sight DataSourceの更新に成功しました | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| DataSource | 更新 | Amazon Quick Sight DataSourceの更新に失敗しました | {
"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 | 更新 | Amazon Quick Sight DataSourceのアクセス許可が更新されました | {"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824" } |
| DataSource | Delete | Amazon Quick Sight DataSourceの削除 | {
"datasourceId": "230caa6e-dc87-406b-91fb-037f29c32824"
} |
| Theme | 作成 | Amazon Quick Sight テーマの作成に成功しました | {
""themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1"
} |
| Theme | 作成 | Amazon Quick Sight テーマの作成に失敗しました | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 1
} |
| Theme | 作成 | Amazon Quick Sight テーマのアクセス許可が更新されました | {"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Theme | 更新 | Amazon Quick Sight テーマの更新に成功しました | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Theme | 更新 | Amazon Quick Sight テーマの更新に失敗しました | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"versionNumber": 2
} |
| Theme | 更新 | Amazon Quick Sight テーマのアクセス許可が更新されました | {"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83" } |
| Theme | Delete | Amazon Quick Sight テーマを削除しました | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83"
} |
| Theme | エイリアスの作成 | Amazon Quick Sight テーマエイリアスの作成 | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 2
} |
| Theme | エイリアスの更新 | Amazon Quick Sight エイリアスが更新されました | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 4
} |
| Theme | エイリアスの削除 | Amazon Quick Sight テーマエイリアスの削除 | {
"themeId": "6fdbc328-ebbd-457f-aa02-9780173afc83",
"aliasName": "MyThemeAlias"
"versionNumber": 2
} |
## イベントペイロードの例
すべてのイベントは、標準の 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
}
}
```
# Amazon Quick Sight イベントを Amazon CloudWatch に送信するルールの作成
シンプルなルールを作成して、関心のある Amazon Quick Sight イベントと、イベントがルールに一致するときに実行する自動アクションを指定できます。例えば、Amazon Quick Sight アセットがフォルダに配置されるたびに Amazon CloudWatch にイベントを送信するように Amazon Quick Sight を設定できます。詳細については、「[Amazon EventBridge ユーザーガイド](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)」を参照してください。
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/) で CloudWatch コンソールを開きます。
1. ナビゲーションペインの [**イベント**] で、[**ルール**] を選択します。
1. [**ルールの作成**] を選択します。
1. ルールの名前と説明を入力します。ルール名はこのリージョン内で一意である必要があります。たとえば、`QuickSightAssetChangeRuleCloudWatch` と入力します。
1. **デフォルト**のイベントバスを選択します。
1. **[Rule with an event pattern]** (イベントパターンを持つルール) を選択してから、**[Next]** (次へ) を選択します。
1. **[イベントソース]** で、**[AWS イベントまたは EventBridge パートナーイベント]** を選択してください。
1. **[作成方法]** セクションで、**[カスタムパターン (JSON エディタ)]** を選択します。
1. **[イベントパターン]** テキストボックスに次のスニペットを入力し、**[次へ]** を選択します。
```
{
"source": ["aws.quicksight"]
}
```
または、Amazon Quick Sight のイベントタイプのサブセットのみをサブスクライブするルールを作成することもできます。例えば、次のルールは、ID `77e307e8-b41b-472a-90e8-fe3f471537be` のフォルダにアセットが追加されたり、そこから削除されたりした場合にのみトリガーされます。
```
{
"source": ["aws.quicksight"],
"detail-type": ["QuickSight Folder Membership Updated"],
"detail": {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
}
}
```
1. **[ターゲット]** で、**[AWS サービス]** > **[CloudWatch ロググループ]** を選択します。
1. 既存のロググループから選択するか、または新しいロググループ名を入力して新しいロググループを作成します。
1. オプションで、このルールに別のターゲットを追加できます。
1. **[Configure Tags]** (タグの設定) で、**[Next]** (次へ) を選択します。
1. **[ルールを作成]** を選択します。
EventBridge ルールの作成の詳細については、「Amazon EventBridge ユーザーガイド」の「[イベントに反応する Amazon EventBridge ルールの作成](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)」を参照してください。
# Amazon Quick Sight イベントを に送信するルールの作成 AWS Lambda
このチュートリアルでは、Amazon Quick Sight アカウントのアセットイベントをログに記録する AWS Lambda 関数を作成します。その後、アセットが変更されるたびに関数を実行するルールを作成します。このチュートリアルでは、Amazon Quick Sight にサインアップ済みであることを前提としています。
**ステップ 1: Lambda 関数を作成する**
状態変更イベントのログを記録する Lambda 関数を作成します。ルールを作成するときに、この関数を指定します。
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/lambda/](https://console.aws.amazon.com/lambda/) で AWS Lambda コンソールを開きます。
1. Lambda を初めて使用する場合は、ウェルカムページを参照してください。[**今すぐ始める**] を選択します。それ以外の場合は、[**関数の作成**] を選択します。
1. [**Author from scratch**] を選択します。
1. [関数を作成] ページで、Lambda 関数の名前と説明を入力します。例えば、関数名を `QuickSightAssetChangeFn` とします。
1. **[ランタイム]** では、**[Node.js 18.x]** を選択します。
1. **[アーキテクチャ]** で **[x86\$164]** を選択します。
1. **[実行ロール]** で、**[基本的な Lambda 許可を持つ新しいロールを作成]** または **[既存のロールを使用]** を選択し、必要なロールを選択します。
1. [**関数の作成**] を選択してください。
1. **[QuickSightAssetChange]** ページで、**[index.js]** を選択します。
1. で、[**index.js**] ウィンドウで、既存のコードを削除します。
1. 次のコードスニペットを入力します。
```
console.log('Loading function');
exports.handler = async (event, context) => {
console.log('Received QuickSight event:', JSON.stringify(event));
};
```
1. [**Deploy**] (デプロイ) をクリックします。
**ステップ 2: ルールを作成する**
Amazon Quick Sight アセットcreate/update/deleteたびに Lambda 関数を実行するルールを作成します。
1. にサインイン AWS マネジメントコンソール し、[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) で Amazon EventBridge コンソールを開きます。
1. ナビゲーションペインで **[ルール]** を選択します。
1. **[ルールの作成]** を選択します。
1. ルールの名前と説明を入力します。例えば、「`QuickSightAssetChangeRule`」と入力します。
1. **デフォルト**のイベントバスを選択します。
1. **[Rule with an event pattern]** (イベントパターンを持つルール) を選択してから、**[Next]** (次へ) を選択します。
1. **[イベントソース]** で、**[AWS イベントまたは EventBridge パートナーイベント]** を選択してください。
1. **[作成方法]** セクションで、**[カスタムパターン (JSON エディタ)]** を選択します。
1. **[イベントパターン]** テキストボックスに次のスニペットを入力し、**[次へ]** を選択します。
```
{
"source": ["aws.quicksight"]
}
```
または、Amazon Quick Sight のイベントタイプのサブセットのみをサブスクライブするルールを作成することもできます。例えば、次のルールは、ID `77e307e8-b41b-472a-90e8-fe3f471537be` のフォルダにアセットが追加されたり、そこから削除されたりした場合にのみトリガーされます。
```
{
"source": ["aws.quicksight"],
"detail-type": ["QuickSight Folder Membership Updated"],
"detail": {
"folderId": "77e307e8-b41b-472a-90e8-fe3f471537be"
}
}
```
1. **[ターゲットの種類]** で、**[AWS サービス]** と **[Lambda 関数]** を選択します。
1. **[Function]** (関数) では、作成した Lambda 関数を選択します。次いで、**[次へ]** を選択します。
1. **[Configure Tags]** (タグの設定) で、**[Next]** (次へ) を選択します。
1. ルール内の手順を確認します。次に、**[Create rule]** (ルールの作成) を選択します。
**ステップ 3: ルールをテストする**
ルールをテストするには、分析を作成します。1 分待った後、Lambda 関数が呼び出されたことを確認します。
1. [https://quicksight.aws.amazon.com/](https://quicksight.aws.amazon.com/) で Amazon Quick Sight コンソールを開きます。
1. 新しい分析を作成します。
1. ナビゲーションペインで、[**ルール**] を選択し、作成したルールの名前を選択します。
1. **[ルールの詳細]** で、**[モニタリング]** を選択します。
1. Amazon CloudWatch コンソールにリダイレクトされます。リダイレクトされない場合は、**[CloudWatch でメトリクスを表示]** を選択します。
1. [**すべてのメトリクス**] で、作成したルールの名前を選択します。グラフは、ルールが呼び出されたことを示しています。
1. ナビゲーションペインで、[**ロググループ**] を選択します。
1. Lambda 関数のロググループの名前を選択します。例えば、`/aws/lambda/function-name`。
1. 起動したインスタンスの関数によって提供されるデータを表示するログのストリーミング名を選択します。次のような受信イベントが表示されます。
```
{
"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"
}
}
```
JSON 形式の Amazon Quick Sight イベントの例については、[「Amazon Quick Sight のイベントの概要](https://docs.aws.amazon.com/quicksight/latest/developerguide/events.html)」を参照してください。