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 ステートメントが配列として評価されると、BatchPutMessage を呼び出して AWS IoT Events に各配列要素が送信されるときにそれらの要素が個別のメッセージとして扱われます。結果の配列には 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 ターに入力を送信できるようにする IAM AWS IoT Events ロール。詳細については、「要件」を参照してください。

置換テンプレートをサポート: いいえ

例

次の 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とは