置換テンプレート

代替テンプレートを使用して、ルールがトリガーされ、 AWS IoT がアクションを実行したときに返される JSON データを拡張できます。代替テンプレートの構文は${式 です。式 は}、SELECT 句、WHERE 句、および AWS IoT で がサポートする任意の式ですAWS IoT ルールアクション。 この式をルールのアクションフィールドに接続して、アクションを動的に構成できます。実際には、この機能はアクションの情報の一部を置き換えます。これには、関数、演算子、および元のメッセージペイロードに存在する情報が該当します。

重要

置換テンプレート内の式は "SELECT..." ステートメントとは独立して評価されるため、AS 句を使用して作成されたエイリアスを参照することはできません。元のペイロード、関数、および演算子に存在する情報のみを参照できます。

サポートされる式の詳細については、「AWS IoT SQL リファレンス」を参照してください。

次のルールアクションは、置換テンプレートをサポートします。各アクションは、置換可能なさまざまなフィールドをサポートしています。

• Apache Kafka

• CloudWatch アラーム

• CloudWatch ログ

• CloudWatch メトリクス

• DynamoDB

• DynamoDBv2

• Elasticsearch

• HTTP

• IoT Analytics

• AWS IoT Events

• AWS IoT SiteWise

• Kinesis Data Streams

• Firehose

• Lambda

• ロケーション

• OpenSearch

• Republish

• S3

• SNS

• SQS

• Step Functions

• Timestream

置換テンプレートは、ルール内のアクションパラメータに表示されます。

{
    "sql": "SELECT *, timestamp() AS timestamp FROM 'my/iot/topic'",
    "ruleDisabled": false,
    "actions": [{
        "republish": {
            "topic": "${topic()}/republish",
            "roleArn": "arn:aws:iam::123456789012:role/my-iot-role"
        }
    }]
}

このルールが my/iot/topic に発行された次の JSON によってトリガーされた場合:

{
    "deviceid": "iot123",
    "temp": 54.98,
    "humidity": 32.43,
    "coords": {
        "latitude": 47.615694,
        "longitude": -122.3359976
    }
}

次に、このルールは、次の JSON を に発行します。これはmy/iot/topic/republish、 の を AWS IoT 置き換えます${topic()}/republish。

{
    "deviceid": "iot123",
    "temp": 54.98,
    "humidity": 32.43,
    "coords": {
        "latitude": 47.615694,
        "longitude": -122.3359976
    },
    "timestamp": 1579637878451
}