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 message MQTT à une file d'attente Amazon Simple Queue Service (Amazon SQS).

Note

L'action SQS 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é, l'ordre des messages n'est pas garanti lorsque l'action SQS est déclenchée.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • Rôle IAM qui AWS IoT peut assumer la réalisation de l'sqs:SendMessageopération. Pour plus d’informations, consultez 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 les données au repos dans Amazon SQS, le service doit être autorisé à l'utiliser au nom AWS KMS key 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

URL de la file d'attente Amazon SQS dans laquelle les données doivent être écrites. La région indiquée dans cette URL ne doit pas nécessairement être identique à celle de votre Région AWS 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 règle SQS. Pour plus d'informations, consultez la tarification d'Amazon SQS.

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 afin de 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 rôle IAM qui autorise l'accès à la file d'attente Amazon SQS. Pour plus d’informations, consultez Prérequis.

Prend en charge les modèles de substitution : Non

Exemples

L'exemple JSON suivant définit une action SQS 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'exemple JSON suivant définit une action SQS 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