Creazione di un ruolo IAM e della regola IoT per la destinazione

Creazione del ruolo di esecuzione e della policy

Crea il ruolo IAM che concede alla funzione l'autorizzazione per accedere alle risorse AWS. È inoltre possibile definire la policy di affidabilità per il ruolo utilizzando un file JSON.

aws iam create-role --role-name lambda-ex \ 
    --assume-role-policy-document file://lambda-trust-policy.json

Nell'esempio seguente viene mostrato il contenuto del file JSON.

Contenuto di lambda-trust-policy.json

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "lambda.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Creazione e verifica della funzione Lambda

Esegui la procedura seguente per creare una funzione AWS Lambda che esegue la decodifica base64 dei dati del payload.

1. Scrivi il codice per decodificare i dati del payload. Ad esempio, puoi utilizzare il seguente codice Python di esempio. Specifica un nome per lo script, ad esempio base64_decode.py.

   Contenuto di base64_decode.py

   // -----------------------------------------------------------
   // ----- Python script to decode incoming binary payload -----
   // -----------------------------------------------------------
   import json
   import base64
   
   def lambda_handler(event, context):
   
       message = json.dumps(event)
       print (message)
   
       payload_data = base64.b64decode(event["PayloadData"])
       print(payload_data)
       print(int(payload_data,16))

2. Crea un pacchetto di implementazione come un file zip contenente il file Python e assegna un nome come base64_decode.zip. Utilizza l'API CreateFunction o il comando dell'interfaccia a riga di comando create-function per creare una funzione Lambda per il codice di esempio, base64_decode.py.

3. aws lambda create-function --function-name my-function \
   --zip-file fileb://base64_decode.zip --handler index.handler \ 
   --runtime python3.9 --role arn:aws:iam::123456789012:role/lambda-ex

   Vedrai il seguente output. Durante la creazione della regola dell'argomento, utilizzerai il valore nome della risorsa Amazon (ARN) dell'output, FunctionArn.

   {
       "FunctionName": "my-function",
       "FunctionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function",
       "Runtime": "python3.9",
       "Role": "arn:aws:iam::123456789012:role/lambda-ex",
       "Handler": "index.handler",
       "CodeSha256": "FpFMvUhayLkOoVBpNuNiIVML/tuGv2iJQ7t0yWVTU8c=",
       "Version": "$LATEST",
       "TracingConfig": {
           "Mode": "PassThrough"
       },
       "RevisionId": "88ebe1e1-bfdf-4dc3-84de-3017268fa1ff",
       ...
   }

4. Per ottenere i log per una chiamata dalla riga di comando, utilizza l'opzione --log-type con il comando invoke. La risposta include un campo LogResult contenente fino a 4 KB di log con codifica base64 dalla chiamata.

   aws lambda invoke --function-name my-function out --log-type Tail

   La risposta ricevuta deve contenere un StatusCode di 200. Per ulteriori informazioni sulla creazione e l'utilizzo di funzioni Lambda da AWS CLI, consultare Utilizzo di Lambda con AWS CLI.

Creazione di una regola dell'argomento

Utilizza l'API CreateTopicRule o il comando dell'interfaccia a riga di comando create-topic-rule per creare una regola dell'argomento che invia un messaggio a questa funzione Lambda. Puoi anche aggiungere una seconda operazione della regola che ripubblica su un argomento AWS IoT. Assegna a questa regola dell'argomento un nome come Sidewalkrule.

aws iot create-topic-rule --rule-name Sidewalkrule \ 
    --topic-rule-payload file://myrule.json

Puoi utilizzare il file myrule.json per specificare ulteriori dettagli relativi alla regola. Ad esempio, il seguente file JSON mostra come ripubblicare su un argomento AWS IoT e inviare un messaggio a una funzione Lambda.

{
    "sql": "SELECT * ",
    "actions": [
       {
            // You obtained this functionArn when creating the Lambda function using the 
            // create-function command.
            "lambda": {
                "functionArn": "arn:aws:lambda:us-east-1:123456789012:function:my-function"
             }
        },
        {
            // This topic can be used to observe messages exchanged between the device and 
            // AWS IoT Core for Amazon Sidewalk after the device is connected.
             "republish": {
                 "roleArn": "arn:aws:iam::123456789012:role/service-role/SidewalkRepublishRole",
                 "topic": "project/sensor/observed"
             }
        }
    ],
}