翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
OpenSearch
OpenSearch (openSearch
) アクションは、MQTT メッセージから Amazon OpenSearch サービスドメインにデータを書き込みます。その後、 OpenSearch Dashboards などのツールを使用して、 OpenSearch サービス内のデータをクエリおよび視覚化できます。
要件
このルールアクションには、以下の要件があります。
-
オペレーションを実行するために が引き受け AWS IoT ることができる IAM ロール
es:ESHttpPut
。詳細については、「AWS IoT ルールに必要なアクセス許可を付与する」を参照してください。AWS IoT コンソールで、 AWS IoT がこのルールアクションを実行できるようにするロールを選択または作成できます。
-
カスタマーマネージド を使用して OpenSearch サービス内の保管中のデータを AWS KMS key 暗号化する場合、サービスには発信者に代わって KMS キーを使用するためのアクセス許可が必要です。詳細については、「Amazon OpenSearch Service デベロッパーガイド」の「Amazon Service の保管中のデータの暗号化」を参照してください。 OpenSearch
パラメータ
このアクションで AWS IoT ルールを作成するときは、次の情報を指定する必要があります。
endpoint
-
Amazon OpenSearch Service ドメインのエンドポイント。
置換テンプレートをサポート: API および AWS CLI のみ
index
-
データを保存する OpenSearch インデックス。
置換テンプレートをサポート: はい
type
-
保存するドキュメントのタイプ。
注記
1.0 以降の OpenSearch バージョンでは、
type
パラメータの値は である必要があります_doc
。詳細については、「」のOpenSearch ドキュメントを参照してください。 置換テンプレートをサポート: はい
id
-
各ドキュメントの一意の識別子。
置換テンプレートをサポート: はい
roleARN
-
OpenSearch サービスドメインへのアクセスを許可する IAM ロール。詳細については、「要件」を参照してください。
置換テンプレートをサポート: いいえ
制限事項
OpenSearch (openSearch
) アクションを使用して VPC Elasticsearch クラスターにデータを配信することはできません。
例
次の JSON 例では、 ルールで OpenSearch AWS IoT アクションを定義し、OpenSearch
アクションのフィールドを指定する方法を定義します。詳細については、「」を参照してくださいOpenSearchAction。
{ "topicRulePayload": { "sql": "SELECT *, timestamp() as timestamp FROM 'iot/test'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "openSearch": { "endpoint": "https://my-endpoint", "index": "my-index", "type": "_doc", "id": "${newuuid()}", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_os" } } ] } }
次の JSON 例では、 AWS IoT ルール内の置換テンプレートを使用して OpenSearch アクションを定義します。
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic'", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "openSearch": { "endpoint": "https://my-endpoint", "index": "${topic()}", "type": "${type}", "id": "${newuuid()}", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_os" } } ] } }
注記
置換type
フィールドは OpenSearch バージョン 1.0 で機能します。1.0 より後のバージョンでは、 の値は type
である必要があります_doc
。
以下も参照してください。
「Amazon OpenSearch Service デベロッパーガイド」の「Amazon Service とは OpenSearch 」