Republish - AWS IoT Core
要件パラメータ例

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

Republish

再発行 (republish) アクションは、MQTTメッセージを別のMQTTトピックに再発行します。

要件

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

  • iot:Publish オペレーションの実行を引き受け AWS IoT ることができるIAMロール。詳細については、「必要なアクセスを AWS IoT ルールに付与する」を参照してください。

    AWS IoT コンソールで、 AWS IoT このルールアクションを実行するためのロールを選択または作成できます。

パラメータ

このアクションで AWS IoT ルールを作成するときは、次の情報を指定する必要があります。

headers

MQTT バージョン 5.0 ヘッダー情報。

詳細については、 リファレンス MqttHeaders のRepublishAction「」および「」を参照してください。 AWS API

topic

メッセージを再発行するMQTTトピック。

$ で始まる予約済みトピックに再発行するには、代わりに $$ を使用します。例えば、デバイスシャドウトピック $aws/things/MyThing/shadow/update に再発行する場合は、トピックを $$aws/things/MyThing/shadow/update として指定します。

注記

予約済みのジョブトピックへの再発行はサポートされていません。

AWS IoT Device Defender 予約トピックはHTTPパブリッシュをサポートしていません。

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

qos

(オプション) メッセージを再発行するときに使用する Quality of Service (QoS) レベル。有効な値: 0、1。デフォルト値は 0 です。QoS の詳細については、MQTT「」を参照してくださいMQTT。 QoS

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

roleArn

がMQTTトピック AWS IoT に発行できるようにするIAMロール。詳細については、「要件」を参照してください。

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

例

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

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "republish": {
                    "topic": "another/topic",
                    "qos": 1,
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_republish"
                }
            }
        ]
    }
}

次のJSON例では、 AWS IoT ルール内の置換テンプレートを使用した再発行アクションを定義します。

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "republish": {
                    "topic": "${topic()}/republish",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_republish"
                }
            }
        ]
    }
}

次のJSON例では、 ルールheadersで AWS IoT を使用して再発行アクションを定義します。

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "republish": {
                    "topic": "${topic()}/republish",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_republish",
                    "headers": {
                        "payloadFormatIndicator": "UTF8_DATA",
                        "contentType": "rule/contentType",
                        "correlationData": "cnVsZSBjb3JyZWxhdGlvbiBkYXRh",
                        "userProperties": [
                            {
                                "key": "ruleKey1",
                                "value": "ruleValue1"
                            },
                            {
                                "key": "ruleKey2",
                                "value": "ruleValue2"
                            }
                        ]
                    }
                }
            }
        ]
    }
}
注記

元の送信元 IP は Republish アクションには渡されません。