Nova publicação - AWS IoT Core
RequisitosParâmetrosExemplos

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Nova publicação

A ação republicar (republish) republica uma MQTT mensagem em outro tópico. MQTT

Requisitos

Esta ação de regra tem os seguintes requisitos:

  • Uma IAM função que AWS IoT pode ser assumida para realizar a iot:Publish operação. Para obter mais informações, consulte Conceder a uma AWS IoT regra o acesso que ela exige.

    No AWS IoT console, você pode escolher ou criar uma função para permitir AWS IoT a execução dessa ação de regra.

Parâmetros

Ao criar uma AWS IoT regra com essa ação, você deve especificar as seguintes informações:

headers

MQTTInformações de cabeçalhos da versão 5.0.

Para obter mais informações, consulte RepublishActione MqttHeadersna AWS APIReferência.

topic

O MQTT tópico no qual republicar a mensagem.

Para publicar novamente em um tópico reservado, que começa com $, use $$ em vez disso. Por exemplo, para publicar novamente em um tópico de sombra do dispositivo $aws/things/MyThing/shadow/update, especifique o tópico como $$aws/things/MyThing/shadow/update.

nota

A nova publicação em tópicos de trabalho reservados não é compatível.

AWS IoT Device Defender tópicos de reserva não suportam HTTP publicação.

Compatível com modelos de substituição: Sim

qos

(Opcional) O nível Quality of Service (QoS - Qualidade de serviço) a ser usado ao republicar mensagens. Valores válidos: 0, 1. O valor padrão é 0. Para obter mais informações sobre MQTT QoS, consulte. MQTT

Compatível com modelos de substituição: Não

roleArn

A IAM função que AWS IoT permite publicar no MQTT tópico. Para obter mais informações, consulte Requisitos.

Compatível com modelos de substituição: Não

Exemplos

O JSON exemplo a seguir define uma ação de republicação em uma AWS IoT regra.

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

O JSON exemplo a seguir define uma ação de republicação com modelos de substituição em uma AWS IoT regra.

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

O JSON exemplo a seguir define uma ação de republicação com headers uma AWS IoT regra.

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

O IP de origem original não será transmitido pela ação Publicar novamente.