翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
OpenSearch
OpenSearch (openSearch
) アクションは、MQTT メッセージから Amazon OpenSearch Service ドメインにデータを書き込みます。その後、 OpenSearch Dashboards などのツールを使用して、 OpenSearch Service でデータをクエリおよび視覚化できます。
要件
このルールアクションには、以下の要件があります。
-
es:ESHttpPut
オペレーションを実行するために が引き受け AWS IoT ることができる IAM ロール。詳細については、「必要なアクセスを AWS IoT ルールに付与する」を参照してください。AWS IoT コンソールでは、 がこのルールアクションを実行 AWS IoT することを許可するロールを選択または作成できます。
-
カスタマーマネージド を使用して AWS KMS key OpenSearch サービスで保管中のデータを暗号化する場合、サービスには発信者に代わって 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" } } ] } }
注記
置換されたフィールドは OpenSearch バージョン 1.0 でtype
機能します。1.0 以降のバージョンでは、 の値は type
である必要があります_doc
。
以下も参照してください。
Amazon OpenSearch Service デベロッパーガイドの「Amazon Service とは OpenSearch 」