Republish - AWS IoT Core
PrérequisParamètresExemples

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Republish

L'action republish (republish) republie un MQTT message dans un autre MQTT sujet.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • IAMRôle qui AWS IoT peut assumer la réalisation de l'iot:Publishopération. Pour de plus amples informations, veuillez consulter Accorder à une AWS IoT règle l'accès dont elle a besoin.

    Dans la AWS IoT console, vous pouvez choisir ou créer un rôle pour autoriser l'exécution AWS IoT de cette action de règle.

Paramètres

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

headers

MQTTInformations sur les en-têtes de la version 5.0.

Pour plus d'informations, voir RepublishActionet MqttHeadersdans la AWS APIréférence.

topic

MQTTRubrique dans laquelle le message doit être republié.

Pour republier dans un sujet réservé, qui commence par$, utilisez $$ plutôt. Par exemple, si vous republiez sur un device shadow une rubrique du type $aws/things/MyThing/shadow/update, spécifiez la rubrique comme $$aws/things/MyThing/shadow/update.

Note

La republication vers des thèmes de la tâche réservés n'est pas prise en charge.

AWS IoT Device Defender les sujets réservés ne sont pas compatibles avec la HTTP publication.

Prend en charge les modèles de substitution : Oui

qos

(facultatif) Le niveau de qualité de service (QoS) à utiliser pour republier des messages. Valeurs valides : 0, 1. La valeur par défaut est 0. Pour plus d'informations sur la MQTT QoS, consultez. MQTT

Prend en charge les modèles de substitution : Non

roleArn

IAMRôle qui permet AWS IoT de publier sur le MQTT sujet. Pour de plus amples informations, veuillez consulter Prérequis.

Prend en charge les modèles de substitution : Non

Exemples

L'JSONexemple suivant définit une action de republication dans une AWS IoT règle.

{
    "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'JSONexemple suivant définit une action de republication avec des modèles de substitution dans une AWS IoT règle.

{
    "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'JSONexemple suivant définit une action de republication headers dans une AWS IoT règle.

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

L'adresse IP source d'origine ne sera pas transmise par le biais de Republier l’action.