SQS - AWS IoT Core
PrérequisParamètresExemplesConsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

SQS

L'action SQS (sqs) envoie les données d'un MQTT message à une file d'attente Amazon Simple Queue Service (AmazonSQS).

Note

L'SQSaction ne prend pas en charge les files d'attente Amazon SQS FIFO (premier entré, premier sorti). Le moteur de règles étant un service entièrement distribué, il n'existe aucune garantie quant à l'ordre des messages lorsque l'SQSaction est déclenchée.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • IAMRôle qui AWS IoT peut assumer la réalisation de l'sqs:SendMessageopération. Pour de plus amples informations, veuillez consulter Accorder à une AWS IoT règle l'accès dont elle a besoin.

    Dans la AWS IoT console, vous pouvez choisir ou créer un rôle pour autoriser l'exécution AWS IoT de cette action de règle.

  • Si vous utilisez un AWS KMS client géré AWS KMS key pour chiffrer des données au repos sur AmazonSQS, le service doit être autorisé à l'utiliser au AWS KMS key nom de l'appelant. Pour de plus amples informations, veuillez consulter Key management dans le Guide du développeur Amazon Simple Storage Service.

Paramètres

Lorsque vous créez une AWS IoT règle avec cette action, vous devez spécifier les informations suivantes :

queueUrl

Le URL nom de la SQS file d'attente Amazon dans laquelle les données doivent être écrites. Il URL n'est pas nécessaire que la région indiquée soit Région AWS identique à votre AWS IoT règle.

Note

Des frais supplémentaires peuvent être facturés pour le transfert de données croisé Régions AWS à l'aide de l'action de la SQS règle. Pour plus d'informations, consultez les SQStarifs Amazon.

Supporte les modèles de substitution : API et AWS CLI uniquement

useBase64

Définissez ce paramètre sur true pour configurer l'action de la règle visant à coder les données du message en base64 avant de les écrire dans la file d'attente Amazon. SQS La valeur par défaut est false.

Prend en charge les modèles de substitution : Non

roleArn

Le IAM rôle qui permet d'accéder à la SQS file d'attente Amazon. Pour de plus amples informations, veuillez consulter Prérequis.

Prend en charge les modèles de substitution : Non

Exemples

L'JSONexemple suivant définit une SQS action dans une AWS IoT règle.

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

L'JSONexemple suivant définit une SQS action avec des modèles de substitution dans une AWS IoT règle.

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

Consultez aussi