SQS - AWS IoT Core
RequisitosParámetrosEjemplosVéase también

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

SQS

La acción SQS (sqs) envía datos de un mensaje MQTT a una cola de Amazon Simple Queue Service (Amazon SQS).

nota

La acción SQS no es compatible con las colas FIFO (First-In-First-Out) de Amazon SQS.. Dado que el motor de reglas es un servicio totalmente distribuido, no se garantiza el orden de los mensajes cuando se activa la acción de SQS.

Requisitos

Esta regla tiene los siguientes requisitos:

  • Un rol de IAM que AWS IoT puede asumir para realizar la operación. sqs:SendMessage Para obtener más información, consulte Otorgar a una AWS IoT regla el acceso que requiere.

    En la AWS IoT consola, puede elegir o crear un rol que permita AWS IoT realizar esta acción de regla.

  • Si utiliza un sistema gestionado por el AWS KMS cliente AWS KMS key para cifrar datos en reposo en Amazon SQS, el servicio debe tener permiso para utilizarlos en nombre de AWS KMS key la persona que llama. Para obtener más información, consulte Gestión de claves en la Guía para desarrolladores de Amazon Simple Queue Service.

Parámetros

Al crear una AWS IoT regla con esta acción, debe especificar la siguiente información:

queueUrl

La dirección URL de la cola Amazon SQS en la que se escriben los datos. No es necesario que la región de esta URL sea la misma que la de tu Región de AWS AWS IoT regla.

nota

Puede haber cargos adicionales por la transferencia de datos cruzada si se Regiones de AWS utiliza la acción de la regla SQS. Para obtener más información, consulte precios de Amazon SQS.

Admite plantillas de sustitución: API y únicamente AWS CLI

useBase64

Establezca este parámetro en true para configurar la acción de la regla para codificar en base64 los datos del mensaje antes de escribirlos en la cola de Amazon SQS. El valor predeterminado es false.

Admite plantillas de sustitución: No

roleArn

El rol de &IAM que permite tener acceso a la cola Amazon SQS. Para obtener más información, consulte Requisitos.

Admite plantillas de sustitución: No

Ejemplos

El siguiente ejemplo de JSON define una acción de SQS en una AWS IoT regla.

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

El siguiente ejemplo de JSON define una acción de SQS con plantillas de sustitución en una AWS IoT regla.

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

Véase también