View a markdown version of this page

SQS - AWS IoT Core
ExigencesParametersExemplesConsultez 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 ()First-In-First-Out. 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.

Exigences

Cette action réglementaire est assortie des exigences suivantes :

  • Un rôle IAM que AWS IoT vous pouvez assumer pour effectuer l'sqs:SendMessageopération. Pour de plus amples informations, veuillez consulter Octroi d'un AWS IoT réglez l'accès dont il a besoin.

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

  • Si vous utilisez un AWS KMS client qui a réussi AWS KMS key à chiffrer les données au repos dans Amazon SQS, le service doit être autorisé à les 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.

Parameters

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 de cette URL n'a pas besoin d'être identique à celle de votre Région AWS AWS IoT règle.

Note

Des frais supplémentaires peuvent être facturés en cas de transfert de données croisé Régions AWS à l'aide de l'action de règle SQS. Pour plus d'informations, consultez la rubrique Tarification https://aws.amazon.com/sqs/pricing/ 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 de plus amples informations, veuillez consulter Exigences.

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