Republish - AWS IoT Core
RequisitiParametriEsempi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Republish

L'azione republish (republish) ripubblica un messaggio su un MQTT altro argomento. MQTT

Requisiti

Questa operazione della regola presenta i seguenti requisiti:

  • Un IAM ruolo che AWS IoT può assumere per eseguire l'operazione. iot:Publish Per ulteriori informazioni, consulta Concedere a qualsiasi AWS IoT regola l'accesso richiesto.

    Nella AWS IoT console, è possibile scegliere o creare un ruolo per consentire l'esecuzione di questa azione relativa AWS IoT alla regola.

Parametri

Quando si crea una AWS IoT regola con questa azione, è necessario specificare le seguenti informazioni:

headers

MQTTInformazioni sulle intestazioni della versione 5.0.

Per ulteriori informazioni, vedere RepublishActione MqttHeadersnella Guida di AWS APIriferimento.

topic

L'MQTTargomento su cui ripubblicare il messaggio.

Per ripubblicare in un argomento riservato, che inizia con $, usa $$. Ad esempio, se stai ripubblicando in un argomento Device Shadow $aws/things/MyThing/shadow/update, specifica l'argomento come $$aws/things/MyThing/shadow/update.

Nota

La ripubblicazione in Argomenti di processi riservati non è supportata.

AWS IoT Device Defender gli argomenti di riserva non supportano la HTTP pubblicazione.

Supporta modelli di sostituzione: sì

qos

(Facoltativo) Il livello di qualità del servizio (QoS) da usare per la ripubblicazione dei messaggi. Valori validi: 0, 1. Il valore predefinito è 0. Per ulteriori informazioni su MQTT QoS, vedere. MQTT

Supporta modelli di sostituzione: no

roleArn

Il IAM ruolo che consente AWS IoT di pubblicare sull'MQTTargomento. Per ulteriori informazioni, consulta Requisiti.

Supporta modelli di sostituzione: no

Esempi

L'JSONesempio seguente definisce un'azione di ripubblicazione in una AWS IoT regola.

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

L'JSONesempio seguente definisce un'azione di ripubblicazione con modelli sostitutivi in una regola. 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"
                }
            }
        ]
    }
}

L'JSONesempio seguente definisce un'azione di ripubblicazione con headers in una regola. 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"
                            }
                        ]
                    }
                }
            }
        ]
    }
}
Nota

L'IP di origine originale non verrà passato tramite l'operazione Republish.