AWS IoT Events - AWS IoT Core
要件パラメータ例関連情報

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

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"
                }
            }
        ]
    }
}

関連情報