翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
AWS IoT Events
AWS IoT Events (iotEvents
) アクションは、MQTT メッセージから AWS IoT Events 入力にデータを送信します。
重要
ペイロードが AWS IoT Core なしで に送信された場合Input attribute Key
、またはキーがキーで指定された同じ JSON パスにない場合、IoT ルールはエラー で失敗しますFailed to send message to Iot Events
。
要件
このルールアクションには、以下の要件があります。
-
オペレーションを実行するために が引き受け AWS IoT ることができる IAM ロール
iotevents:BatchPutMessage
。詳細については、「必要なアクセスを AWS IoT ルールに付与する」を参照してください。AWS IoT コンソールで、このルールアクションを実行することを に許可 AWS IoT するロールを選択または作成できます。
パラメータ
このアクションで AWS IoT ルールを作成するときは、次の情報を指定する必要があります。
batchMode
-
(オプション) イベントアクションをバッチとして処理するかどうか。デフォルト値は
false
です。batchMode
がtrue
で、ルール SQL ステートメントが配列に評価される場合、各配列要素は、 を呼び出して AWS IoT イベントに送信したときに個別のメッセージとして扱われますBatchPutMessage
。結果の配列には 10 を超えるメッセージを含めることはできません。batchMode
がtrue
の場合、messageId
を指定することはできません。置換テンプレートをサポート: いいえ
inputName
-
AWS IoT Events 入力の名前。
置換テンプレートをサポート: API および AWS CLI のみ
messageId
-
(オプション) これを使用して、特定の を持つ 1 つの入力 (メッセージ)
messageId
のみがディ AWS IoT Events テクターによって処理されることを確認します。${newuuid()}
置換テンプレートを使用して、リクエストごとに一意の ID を生成できます。batchMode
がtrue
である場合、messageId
を指定することはできません。新しい UUID 値が割り当てられます。置換テンプレートをサポート: はい
roleArn
-
がディテクターに入力 AWS IoT Events を送信 AWS IoT できるようにする IAM ロール。詳細については、「要件」を参照してください。
置換テンプレートをサポート: いいえ
例
次の JSON 例では、 AWS IoT ルールで IoT Events アクションを定義します。
{ "topicRulePayload": { "sql": "SELECT * FROM 'some/topic", "ruleDisabled": false, "awsIotSqlVersion": "2016-03-23", "actions": [ { "iotEvents": { "inputName": "MyIoTEventsInput", "messageId": "${newuuid()}", "roleArn": "arn:aws:iam::123456789012:role/aws_iot_events" } } ] } }
関連情報
-
デAWS IoT Events ベロッパーガイドの「 AWS IoT Eventsとは」