SNS - 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.

SNS

L'action SNS (sns) envoie les données d'un MQTT message sous forme de notification push Amazon Simple Notification Service (AmazonSNS).

Vous pouvez suivre un didacticiel qui explique comment créer et tester une règle à l'aide d'une SNS action. Pour de plus amples informations, veuillez consulter Tutoriel : Envoi d'une SNS notification Amazon.

Note

L'SNSaction ne prend pas en charge les rubriques Amazon SNS 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'SNSaction est invoquée.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • IAMRôle qui AWS IoT peut assumer la réalisation de l'sns:Publishopé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 service géré par le client AWS KMS key pour chiffrer des données au repos sur AmazonSNS, le service doit être autorisé à l'utiliser au nom de l'appelant. AWS KMS key Pour en savoir plus, veuillez consulter Key management dans le Guide du développeur Amazon Simple Notification Service.

Paramètres

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

targetArn

SNSSujet ou appareil individuel auquel la notification push est envoyée.

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

messageFormat

(Facultatif) Format du message. Amazon SNS utilise ce paramètre pour déterminer si la charge utile doit être analysée et si les parties pertinentes de la charge utile spécifiques à la plate-forme doivent être extraites. Valeurs valides : JSON, RAW. La valeur par défaut est RAW.

Prend en charge les modèles de substitution : Non

roleArn

Le IAM rôle qui permet d'accéder àSNS. 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 SNS action dans une AWS IoT règle.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "sns": {
                    "targetArn": "arn:aws:sns:us-east-2:123456789012:my_sns_topic", 
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns"
                }
            }
        ]
    }
}

L'JSONexemple suivant définit une SNS 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": [
            {
                "sns": {
                    "targetArn": "arn:aws:sns:us-east-1:123456789012:${topic()}",
                    "messageFormat": "JSON",
                    "roleArn": "arn:aws:iam::123456789012:role/aws_iot_sns"
                }
            }
        ]
    }
}

Consultez aussi