View a markdown version of this page

Lambda - AWS IoT Core
PrérequisParametersExemplesConsultez 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.

Lambda

Une action Lambda (lambda) invoque une AWS Lambda fonction en transmettant un message MQTT. AWS IoT invoque les fonctions Lambda de manière asynchrone.

Vous pouvez suivre un didacticiel qui vous montre comment créer et tester une règle avec une action Lambda. Pour de plus amples informations, veuillez consulter Tutoriel : Formater une notification à l'aide d'un AWS Lambda fonction.

Prérequis

Cette action réglementaire est assortie des exigences suivantes :

  • AWS IoT Pour invoquer une fonction Lambda, vous devez configurer une politique qui accorde l'lambda:InvokeFunctionautorisation à. AWS IoT Vous ne pouvez invoquer qu'une fonction Lambda définie dans la même zone Région AWS où votre politique Lambda existe. Les fonctions Lambda utilisent des politiques basées sur les ressources, vous devez donc attacher la politique à la fonction Lambda elle-même.

    Utilisez la AWS CLI commande suivante pour joindre une politique qui accorde l'lambda:InvokeFunctionautorisation. Dans cette commande, remplacez :

    • function_nameavec le nom de la fonction Lambda. Vous ajoutez une nouvelle autorisation pour mettre à jour la politique de ressources de la fonction.

    • regionavec Région AWS la fonction of.

    • account-idavec le Compte AWS numéro où la règle est définie.

    • rule-nameavec le nom de la AWS IoT règle pour laquelle vous définissez l'action Lambda.

    • unique_idavec un identifiant de relevé unique.

    Important

    Si vous ajoutez une autorisation pour un AWS IoT principal sans fournir le source-arn ousource-account, toute personne Compte AWS qui crée une règle avec votre action Lambda peut activer des règles pour invoquer votre fonction Lambda. AWS IoT

    Pour plus d’informations, consultez Autorisations AWS Lambda.

    aws lambda add-permission \ 
    --function-name function_name \ 
    --region region \ 
    --principal iot.amazonaws.com \
    --source-arn arn:aws:iot:region:account-id:rule/rule_name \
    --source-account account-id 
    --statement-id unique_id 
    --action "lambda:InvokeFunction"

  • Si vous utilisez la AWS IoT console pour créer une règle pour l'action de règle Lambda, la fonction Lambda est déclenchée automatiquement. Si vous utilisez AWS CloudFormation plutôt avec le AWS::IoT::TopicRule LambdaAction, vous devez ajouter une AWS::lambda::Permission ressource. La ressource vous autorise ensuite à déclencher la fonction Lambda.

    Le code suivant montre un exemple d'ajout de cette ressource. Dans cet exemple, remplacez :

    • function_nameavec le nom de la fonction Lambda.

    • regionavec Région AWS la fonction of.

    • account-idavec le Compte AWS numéro où la règle est définie.

    • rule-nameavec le nom de la AWS IoT règle pour laquelle vous définissez l'action Lambda.

    Type: AWS::Lambda::Permission
Properties:
  Action: lambda:InvokeFunction
  FunctionName: !Ref function_name
  Principal: "iot.amazonaws.com"
  SourceAccount: account-id
  SourceArn: arn:aws:iot:region:account-id:rule/rule_name

  • Si vous utilisez un AWS KMS client qui a réussi AWS KMS key à chiffrer les données au repos dans Lambda, le service doit être autorisé à les utiliser au AWS KMS key nom de l'appelant. Pour plus d'informations, veuillez consulter la rubrique Chiffrement au repos dans le Guide du développeur AWS Lambda .

Parameters

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

functionArn

L'ARN de la fonction Lambda à invoquer. AWS IoT doit être autorisé à invoquer la fonction. Pour de plus amples informations, veuillez consulter Prérequis.

Si vous ne spécifiez pas de version ou d'alias pour votre fonction Lambda, c'est la version la plus récente de la fonction qui est arrêtée. Vous pouvez spécifier une version ou un alias si vous souhaitez arrêter une version spécifique de votre fonction Lambda. Pour spécifier une version ou un alias, ajoutez la version ou l'alias à l'ARN de la fonction Lambda.

arn:aws:lambda:us-east-2:123456789012:function:myLambdaFunction:someAlias

Pour plus d'informations sur le versionnage et les alias, consultez AWS Lambda la fonction versionnage et alias.

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

Exemples

L'exemple JSON suivant définit une action Lambda dans une AWS IoT règle.

{
    "topicRulePayload": {
        "sql": "SELECT * FROM 'some/topic'", 
        "ruleDisabled": false, 
        "awsIotSqlVersion": "2016-03-23",
        "actions": [
            {
                "lambda": {
                    "functionArn": "arn:aws:lambda:us-east-2:123456789012:function:myLambdaFunction"
                 }
            }
        ]
    }
}

L'exemple JSON suivant définit une action Lambda 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": [
            {
                "lambda": {
                    "functionArn": "arn:aws:lambda:us-east-1:123456789012:function:${topic()}"
                }
            }
        ]
    }
}

Consultez aussi