Tutorial: uso di Lambda con Amazon API Gateway

Come creare la policy

1. Apri la pagina Policies (Policy) nella console IAM.

2. Scegliere Create Policy (Crea policy).

3. Scegliere la scheda JSON e quindi incollare la seguente policy personalizzata nell'editor JSON.

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Sid": "Stmt1428341300017",
         "Action": [
           "dynamodb:DeleteItem",
           "dynamodb:GetItem",
           "dynamodb:PutItem",
           "dynamodb:Query",
           "dynamodb:Scan",
           "dynamodb:UpdateItem"
         ],
         "Effect": "Allow",
         "Resource": "*"
       },
       {
         "Sid": "",
         "Resource": "*",
         "Action": [
           "logs:CreateLogGroup",
           "logs:CreateLogStream",
           "logs:PutLogEvents"
         ],
         "Effect": "Allow"
       }
     ]
   }

4. Scegliere Next: Tags (Successivo: Tag).

5. Scegliere Next:Review (Successivo: Rivedi).

6. In Rivedi policy, per Nome della policy inserisci lambda-apigateway-policy.

7. Scegli Create Policy (Crea policy).

Creazione di un ruolo di esecuzione e collegamento di una policy di autorizzazione personalizzata

1. Aprire la pagina Roles (Ruoli) della console IAM.

2. Scegliere Create role (Crea ruolo).

3. Per il tipo di entità attendibile, scegli Servizio AWS , quindi per il caso d'uso seleziona Lambda.

4. Scegli Next (Successivo).

5. Nella casella di ricerca delle policy, immettere lambda-apigateway-policy.

6. Nei risultati della ricerca, seleziona la policy creata (lambda-apigateway-policy), quindi scegli Next (Successivo).

7. In Role details (Dettagli del ruolo), per Role name (Nome del ruolo), specifica lambda-apigateway-role, quindi scegli Create role (Crea ruolo).

Per richiamare la funzione Lambda con AWS CLI

1. Salva il seguente JSON come un file denominato input.txt.

   {
       "operation": "echo",
       "payload": {
           "somekey1": "somevalue1",
           "somekey2": "somevalue2"
       }
   }

2. Eseguire il seguente comando invoke AWS CLI .

   aws lambda invoke \
   --function-name LambdaFunctionOverHttps \
   --payload file://input.txt outputfile.txt \
   --cli-binary-format raw-in-base64-out

   L'cli-binary-formatopzione è obbligatoria se si utilizza la AWS CLI versione 2. Per rendere questa impostazione come predefinita, esegui aws configure set cli-binary-format raw-in-base64-out. Per ulteriori informazioni, consulta la pagina AWS CLI supported global command line options nella Guida per l'utente di AWS Command Line Interface versione 2.

   Dovrebbe essere visualizzata la seguente risposta:

   {
       "StatusCode": 200,
       "ExecutedVersion": "LATEST"
   }

3. Verifica che la tua funzione abbia eseguito l'operazione echo specificata nell'evento di test JSON. Analizza il file outputfile.txt e verifica che contenga quanto segue:

   {"somekey1": "somevalue1", "somekey2": "somevalue2"}

Per creare l'API

1. Apri la console API Gateway.

2. Seleziona Create API (Crea API).

3. Nella casella REST API, scegliere Build.

4. In Dettagli API, lasciare selezionata Nuova API e per Nome API, inserire DynamoDBOperations.

5. Seleziona Create API (Crea API).

Per creare la risorsa

1. Nella console API Gateway, nella pagina Risorse dell'API, scegliere Crea risorsa.

2. In Dettagli risorsa, per Nome risorsa, inserire DynamoDBManager.

3. Scegliere Create Resource (Crea risorsa).

Creazione del metodo POST

1. Nella pagina Risorse dell'API, assicurarsi che la risorsa /DynamoDBManager sia evidenziata. Quindi, nel riquadro Metodi, scegliere Crea metodo.

2. Per Metodo HTTP scegliere POST.

3. Per Tipo di integrazione lasciare selezionato Funzione Lambda.

4. Per la funzione Lambda, scegliere nome della risorsa Amazon (ARN) per la funzione (LambdaFunctionOverHttps).

5. Scegli Crea metodo.

Creare la tabella DynamoDB

1. Aprire la pagina Tables (Tabelle) della console DynamoDB.

2. Scegliere Create table (Crea tabella).

3. In Table details (Dettagli tabella), effettuare le seguenti operazioni:

   1. Nel campo Table name (Nome tabella) immetti lambda-apigateway.

   2. Per Partition key (Chiave di partizione), immettere id e mantenere il tipo di dati impostato come String (Stringa).

4. In Table settings (Impostazioni tabella), mantieni le impostazioni predefinite.

5. Scegliere Create table (Crea tabella).

Test 1: creazione di un nuovo elemento nella tabella DynamoDB

1. Nella console di Gateway API, scegli l'API (DynamoDBOperations).

2. Scegli il metodo POST sotto la risorsa DynamoDBManager.

   

3. Seleziona la scheda Test. Potrebbe essere necessario scegliere il pulsante freccia destra per visualizzare la scheda.

4. In Metodo di prova, lasciare vuote le stringhe di query e le intestazioni. Per Corpo della richiesta, incollare il file JSON seguente:

   {
     "operation": "create",
     "payload": {
       "Item": {
         "id": "1234ABCD",
         "number": 5
       }
     }
   }

5. Scegli Test (Esegui test).

   I risultati visualizzati al termine del test devono mostrare lo stato 200. Questo codice di stato indica che l'operazione create è riuscita.

   Come verifica, controlla che la tabella DynamoDB contenga il nuovo elemento.

6. Apri la pagina Tables (Tabelle) della console DynamoDB e scegli la tabella lambda-apigateway.

7. Scegli Explore table items (Esplora elementi della tabella). Nel riquadro Items returned (Elementi restituiti), dovresti vedere un elemento con l'id 1234ABCD e il numero 5. Esempio:

   

Test 2: aggiornamento dell'elemento nella tabella DynamoDB

1. Nella Console API Gateway, tornare alla scheda Test del metodo POST.

2. In Metodo di prova, lasciare vuote le stringhe di query e le intestazioni. Per Corpo della richiesta, incollare il file JSON seguente:

   {
       "operation": "update",
       "payload": {
           "Key": {
               "id": "1234ABCD"
           },
           "UpdateExpression": "SET #num = :newNum",
           "ExpressionAttributeNames": {
               "#num": "number"
           },
           "ExpressionAttributeValues": {
               ":newNum": 10
           }
       }
   }

3. Scegli Test (Esegui test).

   I risultati visualizzati al termine del test devono mostrare lo stato 200. Questo codice di stato indica che l'operazione update è riuscita.

   Per confermare, controlla che l'elemento nella tua tabella DynamoDB sia stato modificato.

4. Apri la pagina Tables (Tabelle) della console DynamoDB e scegli la tabella lambda-apigateway.

5. Scegli Explore table items (Esplora elementi della tabella). Nel riquadro Items returned (Elementi restituiti), dovresti vedere un elemento con l'id 1234ABCD e il numero 10.

   

Per distribuire l'API

1. Apri la APIspagina della console API Gateway e scegli l'DynamoDBOperationsAPI.

2. Nella pagina Risorse per la tua API, scegliere Distribuzione dell'API.

3. Per Fase, scegliere *Nuova fase* quindi per Nome fase specificare test.

4. Seleziona Deploy (Implementa).

5. Nel riquadro Editor fase (Editor fasi) del test, copia l'URL di richiamo. Questo verrà utilizzato nella fase successiva per richiamare la tua funzione utilizzando una richiesta HTTP.

Per creare un elemento nella tabella DynamoDB utilizzando curl

1. Esegui il comando curl riportato utilizzando l'URL di richiamo che hai copiato nel passaggio precedente. Quando si utilizza curl con l'opzione -d (dati), viene utilizzato automaticamente il metodo HTTP POST.

   curl https://l8togsqxd8.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "create", "payload": {"Item": {"id": "5678EFGH", "number": 15}}}'

   Se l'operazione ha avuto esito positivo, dovrebbe essere restituita una risposta con un codice di stato HTTP di 200.

2. È inoltre possibile utilizzare la console DynamoDB per verificare che il nuovo elemento sia nella tabella effettuando le operazioni seguenti:

   1. Apri la pagina Tables (Tabelle) della console DynamoDB e scegli la tabella lambda-apigateway.

   2. Scegli Explore table items (Esplora elementi della tabella). Nel riquadro Items returned (Elementi restituiti), dovresti vedere un elemento con l'id 5678EFGH e il numero 15.

Per leggere l'elemento nella tabella DynamoDB utilizzando curl

• Esegui il comando curl seguente per leggere il valore dell'elemento appena creato. Utilizzo dei propri URL di richiamo

  curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager -d \
  '{"operation": "read", "payload": {"Key": {"id": "5678EFGH"}}}'

  Dovresti vedere un output simile a uno dei seguenti a seconda che tu abbia scelto il codice della funzione Node.js o Python:

  Node.js

  {"$metadata":{"httpStatusCode":200,"requestId":"7BP3G5Q0C0O1E50FBQI9NS099JVV4KQNSO5AEMVJF66Q9ASUAAJG",
  "attempts":1,"totalRetryDelay":0},"Item":{"id":"5678EFGH","number":15}}

  Python

  {"Item":{"id":"5678EFGH","number":15},"ResponseMetadata":{"RequestId":"QNDJICE52E86B82VETR6RKBE5BVV4KQNSO5AEMVJF66Q9ASUAAJG",
  "HTTPStatusCode":200,"HTTPHeaders":{"server":"Server","date":"Wed, 31 Jul 2024 00:37:01 GMT","content-type":"application/x-amz-json-1.0",
  "content-length":"52","connection":"keep-alive","x-amzn-requestid":"QNDJICE52E86B82VETR6RKBE5BVV4KQNSO5AEMVJF66Q9ASUAAJG","x-amz-crc32":"2589610852"},
  "RetryAttempts":0}}

Per aggiornare l'elemento nella tabella DynamoDB utilizzando curl

1. Esegui il comando curl seguente per aggiornare l'elemento appena creato modificando il valore number. Utilizzo dei propri URL di richiamo

   curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "update", "payload": {"Key": {"id": "5678EFGH"}, "UpdateExpression": "SET #num = :new_value", "ExpressionAttributeNames": {"#num": "number"}, "ExpressionAttributeValues": {":new_value": 42}}}'

2. Per verificare che il valore di number per l'elemento sia stato aggiornato, esegui un altro comando di lettura:

   curl https://avos4dr2rk.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "read", "payload": {"Key": {"id": "5678EFGH"}}}'

Per eliminare l'elemento nella tabella DynamoDB utilizzando curl

1. Esegui il comando curl riportato per eliminare l'elemento appena creato. Utilizzo dei propri URL di richiamo

   curl https://l8togsqxd8.execute-api.us-east-2.amazonaws.com/test/DynamoDBManager \
   -d '{"operation": "delete", "payload": {"Key": {"id": "5678EFGH"}}}'

2. Verifica che l'operazione di eliminazione è andata a buon fine. Nel riquadro Items returned (Elementi restituiti) della pagina Explore items (Esplora elementi) della console DynamoDB, verifica che l'elemento con id 5678EFGH non sia più presente nella tabella.

Per eliminare la funzione Lambda

1. Aprire la pagina Functions (Funzioni) della console Lambda.

2. Selezionare la funzione creata.

3. Scegliere Operazioni, Elimina.

4. Inserisci confirm nel campo di immissione del testo, quindi scegli Elimina.

Come eliminare il ruolo di esecuzione

1. Aprire la pagina Ruoli della console IAM.

2. Selezionare il ruolo di esecuzione creato.

3. Scegliere Elimina.

4. Inserisci il nome del ruolo nel campo di immissione testo e seleziona Delete (Elimina).

Per eliminare l'API

1. Apri la APIs pagina della console API Gateway.

2. Selezionare l'API creata.

3. Scegliere Actions (Operazioni), Delete (Elimina).

4. Scegliere Delete (Elimina).

Per eliminare la tabella DynamoDB

1. Aprire la pagina Tables (Tabelle) della console DynamoDB.

2. Selezionare la tabella creata.

3. Scegliere Delete (Elimina).

4. Immettere delete nella casella di testo.

5. Seleziona Delete Table (Elimina tabella).