SQS

A ação SQS (sqs) envia dados de uma MQTT mensagem para uma fila do Amazon Simple Queue Service (AmazonSQS).

nota

A SQS ação não é compatível com filas da Amazon SQS FIFO (First-In-First-Out). Como o mecanismo de regras é um serviço totalmente distribuído, não há garantia da ordem das mensagens quando a SQS ação é acionada.

Requisitos

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

• Uma IAM função que AWS IoT pode ser assumida para realizar a sqs:SendMessage 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.

• Se você usa um AWS KMS cliente AWS KMS key que conseguiu criptografar dados em repouso na AmazonSQS, o serviço deve ter permissão para usá-los AWS KMS key em nome do chamador. Para obter mais informações, consulte Gerenciamento de chaves no Guia do desenvolvedor do Amazon Simple Queue Service.

Parâmetros

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

queueUrl

A URL da SQS fila da Amazon na qual gravar os dados. A região aqui URL não precisa ser a mesma da sua Região da AWS AWS IoT regra.

nota

Pode haver cobranças adicionais pela transferência cruzada de dados Regiões da AWS usando a ação de SQS regra. Para obter mais informações, consulte os SQSpreços da Amazon.

Suporta modelos de substituição: API e somente AWS CLI

useBase64

Defina esse parâmetro true para configurar a ação da regra para codificar em base64 os dados da mensagem antes de gravar os dados na fila da Amazon. SQS Padronizado como false.

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

roleArn

A IAM função que permite o acesso à SQS fila da Amazon. Para obter mais informações, consulte Requisitos.

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

Exemplos

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

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sqs": {
                    "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/my_sqs_queue", 
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs"
                }
            }
        ]
    }
}

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

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'",
        "ruleDisabled": false,
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sqs": {
                    "queueUrl": "https://sqs.us-east-2.amazonaws.com/123456789012/${topic()}",
                    "useBase64": true,
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sqs"
                }
            }
        ]
    }
}

Consulte também

• O que é o Amazon Simple Queue Service? no Guia do desenvolvedor do Amazon Simple Queue Service