View a markdown version of this page

SQS - AWS IoT Core
RequisitosParametersEjemplosVé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 de SQS no admite las colas FIFO () de Amazon SQS. First-In-First-Out 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:

  • Una función de IAM que AWS IoT puede asumir para realizar la operación. sqs:SendMessage Para obtener más información, consulte Otorgar un AWS IoT reglamentar 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 AWS KMS cliente que ha conseguido AWS KMS key cifrar datos en reposo en Amazon SQS, el servicio debe tener permiso para utilizarlos AWS KMS key en nombre de 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.

Parameters

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 entre Regiones de AWS si se utiliza la acción de la regla de SQS. Para obtener más información, consulte precios de Amazon SQS.

Soporta plantillas de sustitución: AWS CLI solo con API

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