Modelos de substituição

Você pode usar um modelo de substituição para aumentar os dados JSON retornados quando uma regra é acionada e AWS IoT executa uma ação. A sintaxe de um modelo de substituição é ${ expressão}, em que expressão pode ser qualquer expressão suportada AWS IoT nas cláusulas SELECT, nas cláusulas WHERE e. AWS IoT ações de regras Essa expressão pode ser conectada a um campo de ação em uma regra, permitindo que você configure dinamicamente uma ação. Na verdade, esse recurso substitui uma informação em uma ação. Isso inclui funções, operadores e informações presentes na carga da mensagem original.

Importante

Como uma expressão em um modelo de substituição é avaliada separadamente da instrução "SELECT...", você não pode fazer referência a um alias criado com a cláusula AS. Você pode fazer referência somente às informações presentes na carga original, além das funções e dos operadores compatíveis.

Para obter mais informações sobre as expressões compatíveis, consulte AWS IoT Referência SQL.

As ações de regra a seguir oferecem suporte a modelos de substituição. Cada ação oferece suporte a campos diferentes que podem ser substituídos.

• Apache Kafka

• CloudWatch alarmes

• CloudWatch Registros

• CloudWatch métricas

• DynamoDB

• DynamoDBv2

• Elasticsearch

• HTTP

• IoT Analytics

• AWS IoT Events

• AWS IoT SiteWise

• Kinesis Data Streams

• Firehose

• Lambda

• Local

• OpenSearch

• Nova publicação

• S3

• SNS

• SQS

• Step Functions

• Timestream

Os modelos de substituição aparecem nos parâmetros de ação dentro de uma regra:

{
    "sql": "SELECT *, timestamp() AS timestamp FROM 'my/iot/topic'",
    "ruleDisabled": false,
    "actions": [{
        "republish": {
            "topic": "${topic()}/republish",
            "roleArn": "arn:aws:iam::123456789012:role/my-iot-role"
        }
    }]
}

Se essa regra for acionada pelo JSON a seguir publicado em my/iot/topic:

{
    "deviceid": "iot123",
    "temp": 54.98,
    "humidity": 32.43,
    "coords": {
        "latitude": 47.615694,
        "longitude": -122.3359976
    }
}

Em seguida, essa regra publica o seguinte JSON emmy/iot/topic/republish, que AWS IoT substitui de: ${topic()}/republish

{
    "deviceid": "iot123",
    "temp": 54.98,
    "humidity": 32.43,
    "coords": {
        "latitude": 47.615694,
        "longitude": -122.3359976
    },
    "timestamp": 1579637878451
}