SQS - AWS IoT Core
RequisitosParâmetrosExemplosConsulte também

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á.

SQS

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

nota

A ação do SQS não é compatível com as filas do 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 ação do SQS é acionada.

Requisitos

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

  • Uma função do IAM que AWS IoT você pode assumir para realizar a sqs:SendMessage operação. Para ter 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 gerenciado AWS KMS key para criptografar dados em repouso no Amazon SQS, o serviço deve ter permissão para usar AWS KMS key o 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

O URL da fila do Amazon SQS na qual os dados serão gravados. A região nesse 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 regra SQS. Para obter mais informações, consulte Preços do Amazon SQS.

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

useBase64

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

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

roleArn

O perfil do IAM que permite o acesso à fila do Amazon SQS. Para obter mais informações, consulte Requisitos.

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

Exemplos

O exemplo de JSON a seguir define uma ação SQS 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 exemplo de JSON a seguir define uma ação SQS com modelos de substituição em uma regra. AWS IoT 

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