View a markdown version of this page

Publikasikan ulang - AWS IoT Core
PersyaratanParameterContoh

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Publikasikan ulang

Tindakan republish (republish) meneruskan pesan MQTT ke topik MQTT lain.

Persyaratan

Tindakan aturan ini memiliki persyaratan sebagai berikut:

  • Peran IAM yang AWS IoT dapat diasumsikan untuk melakukan iot:Publish operasi. Untuk informasi selengkapnya, lihat Pemberian AWS IoT mengatur akses yang dibutuhkannya.

    Di AWS IoT konsol, Anda dapat memilih atau membuat peran AWS IoT untuk memungkinkan melakukan tindakan aturan ini.

Parameter

Saat Anda membuat AWS IoT aturan dengan tindakan ini, Anda harus menentukan informasi berikut:

headers

Informasi header MQTT Versi 5.0.

Untuk informasi selengkapnya, lihat RepublishAction dan MqttHeaders di Refer AWS ensi API.

topic

Topik MQTT untuk menerbitkan ulang pesan.

Untuk menerbitkan ulang ke topik yang dicadangkan, yang dimulai dengan$, gunakan sebagai $$ gantinya. Misalnya, untuk menerbitkan ulang ke topik bayangan perangkat$aws/things/MyThing/shadow/update, tentukan topik sebagai$$aws/things/MyThing/shadow/update.

catatan

Penerbitan ulang ke topik pekerjaan yang dipesan tidak didukung.

AWS IoT Device Defender topik cadangan tidak mendukung publikasi HTTP.

Mendukung template substitusi: Ya

qos

(Opsional) Tingkat Kualitas Layanan (QoS) yang digunakan saat menerbitkan ulang pesan. Nilai-nilai yang valid: 0, 1. Nilai default-nya adalah 0. Untuk informasi lebih lanjut tentang QoS MQTT, lihat. MQTT

Mendukung template substitusi: Tidak

roleArn

Peran IAM yang memungkinkan AWS IoT untuk mempublikasikan ke topik MQTT. Untuk informasi selengkapnya, lihat Persyaratan.

Mendukung template substitusi: Tidak

Contoh

Contoh JSON berikut mendefinisikan tindakan penerbitan ulang dalam AWS IoT aturan.

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

Contoh JSON berikut mendefinisikan tindakan penerbitan ulang dengan template substitusi dalam AWS IoT aturan.

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

Contoh JSON berikut mendefinisikan tindakan penerbitan ulang headers dengan AWS IoT aturan.

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

IP sumber asli tidak akan diteruskan melalui tindakan Publikasikan ulang Publish Ulang.