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。

要件

このルールアクションには、以下の要件があります。

iotevents:BatchPutMessage オペレーションを実行するためにが引き受け AWS IoT ることができる IAMロール。詳細については、「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 に入力を送信 AWS IoT Events できるようにするIAMロール。詳細については、「要件」を参照してください。

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

例

次のJSON例では、ルールで IoT Events AWS IoT アクションを定義します。


{
    "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

重要

要件

パラメータ

例

関連情報