Tutorial: uso di Lambda con Amazon API Gateway

Modalità Focus

Tutorial: uso di Lambda con Amazon API Gateway - AWS Lambda

Prerequisiti Creazione di una policy di autorizzazione Creazione di un ruolo di esecuzione Creazione della funzione Richiamate la funzione utilizzando il AWS CLI Creazione di una REST API utilizzando API Gateway Creazione di una risorsa sulla REST API Creazione di un metodo HTTP POST Creazione di una tabella DynamoDB Test dell'integrazione di Gateway API, Lambda e DynamoDB Distribuzione dell'API Uso di curl per richiamare la funzione tramite le richieste HTTP Pulizia delle risorse (facoltativo)

In questo tutorial, viene creata una REST API tramite la quale viene richiamata una funzione Lambda utilizzando una richiesta HTTP. La funzione Lambda eseguirà operazioni di creazione, aggiornamento ed eliminazione (CRUD) su una tabella DynamoDB. Questa funzione viene fornita qui a scopo dimostrativo, ma imparerai a configurare una REST API di Gateway API in grado di richiamare qualsiasi funzione Lambda.

Servizi e risorse utilizzati in questo tutorial

L'utilizzo di Gateway API fornisce agli utenti un endpoint HTTP sicuro per richiamare la funzione Lambda e può aiutare a gestire grandi volumi di chiamate alla funzione limitando il traffico e convalidando e autorizzando automaticamente le chiamate API. API Gateway fornisce anche controlli di sicurezza flessibili utilizzando AWS Identity and Access Management (IAM) e Amazon Cognito. Ciò è utile nei casi d'uso in cui è richiesta un'autorizzazione preventiva per le chiamate all'applicazione.

Suggerimento

Lambda offre due modi per richiamare una funzione tramite un endpoint HTTP: API Gateway e funzione Lambda. URLs Se non sei sicuro di quale sia il metodo migliore per il tuo caso d'uso, consulta. Selezionare un metodo per richiamare la funzione Lambda tramite una richiesta HTTP

Per completare questo tutorial, saranno completate le seguenti fasi:

Crea e configura una funzione Lambda in Python o Node.js per eseguire operazioni su una tabella DynamoDB.
Crea una REST API in Gateway API per connetterti alla funzione Lambda.
Crea una tabella DynamoDB e testala con la funzione Lambda nella console.
Implementa la tua API e testa la configurazione completa usando curl in un terminale.

Completando queste fasi, imparerai come utilizzare Gateway API per creare un endpoint HTTP in grado di richiamare in modo sicuro una funzione Lambda su qualsiasi scala. Imparerai anche come distribuire la tua API e come testarla nella console e inviando una richiesta HTTP tramite un terminale.

Sections

Prerequisiti
Creazione di una policy di autorizzazione
Creazione di un ruolo di esecuzione
Creazione della funzione
Richiamate la funzione utilizzando il AWS CLI
Creazione di una REST API utilizzando API Gateway
Creazione di una risorsa sulla REST API
Creazione di un metodo HTTP POST
Creazione di una tabella DynamoDB
Test dell'integrazione di Gateway API, Lambda e DynamoDB
Distribuzione dell'API
Uso di curl per richiamare la funzione tramite le richieste HTTP
Pulizia delle risorse (facoltativo)

Prerequisiti

Se non l'hai ancora installato AWS Command Line Interface, segui i passaggi indicati in Installazione o aggiornamento della versione più recente di AWS CLI per installarlo.

Per eseguire i comandi nel tutorial, sono necessari un terminale a riga di comando o una shell (interprete di comandi). In Linux e macOS, utilizza la shell (interprete di comandi) e il gestore pacchetti preferiti.

Nota

Su Windows, alcuni comandi della CLI Bash utilizzati comunemente con Lambda (ad esempio, zip) non sono supportati dai terminali integrati del sistema operativo. Per ottenere una versione integrata su Windows di Ubuntu e Bash, installa il sottosistema Windows per Linux.

Installa il AWS Command Line Interface

Se non l'hai ancora installato AWS Command Line Interface, segui i passaggi indicati in Installazione o aggiornamento della versione più recente di AWS CLI per installarlo.

Nota

Creazione di una policy di autorizzazione

Fase 1: creazione di una policy di autorizzazioni

Prima di poter creare un ruolo di esecuzione per la tua funzione Lambda, devi prima creare una politica di autorizzazioni per concedere alla funzione il permesso di accedere alle risorse richieste. AWS Per questo tutorial, la policy consente a Lambda di eseguire operazioni CRUD su una tabella DynamoDB e scrivere su Amazon Logs. CloudWatch

Come creare la policy

Apri la pagina Policies (Policy) nella console IAM.
Scegliere Create Policy (Crea policy).

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"
    }
  ]
}

Scegliere Next: Tags (Successivo: Tag).
Scegliere Next:Review (Successivo: Rivedi).
In Rivedi policy, per Nome della policy inserisci lambda-apigateway-policy.
Scegli Create Policy (Crea policy).

Creazione di un ruolo di esecuzione

Un ruolo di esecuzione è un ruolo AWS Identity and Access Management (IAM) che concede a una funzione Lambda l'autorizzazione all' Servizi AWS accesso e alle risorse. Per consentire alla funzione di eseguire operazioni su una tabella DynamoDB, collega la policy di autorizzazione che hai creato nella fase precedente.

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

Aprire la pagina Roles (Ruoli) della console IAM.
Scegliere Create role (Crea ruolo).
Per il tipo di entità attendibile, scegli Servizio AWS , quindi per il caso d'uso seleziona Lambda.
Scegli Next (Successivo).
Nella casella di ricerca delle policy, immettere lambda-apigateway-policy.
Nei risultati della ricerca, seleziona la policy creata (lambda-apigateway-policy), quindi scegli Next (Successivo).
In Role details (Dettagli del ruolo), per Role name (Nome del ruolo), specifica lambda-apigateway-role, quindi scegli Create role (Crea ruolo).

Più avanti nel tutorial sarà necessario il nome della risorsa Amazon (ARN) del ruolo appena creato. Nella pagina Roles (Ruoli) della console IAM, scegli il nome del ruolo (lambda-apigateway-role) e copia l'ARN del ruolo visualizzato nella pagina Summary (Riepilogo).

Creazione della funzione

Il seguente esempio di codice riceve un input di evento da Gateway API che specifica un'operazione da eseguire sulla tabella DynamoDB che verrà creata e alcuni dati del payload. Se i parametri ricevuti dalla funzione sono validi, l'operazione richiesta viene eseguita sulla tabella.

Node.js

Esempio index.mjs

Prendi nota dell'impostazione region. Questo deve corrispondere al Regione AWS luogo in cui si distribuisce la funzione e si crea la tabella DynamoDB.


import { DynamoDBDocumentClient, PutCommand, GetCommand, 
         UpdateCommand, DeleteCommand} from "@aws-sdk/lib-dynamodb";
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";

const ddbClient = new DynamoDBClient({ region: "us-east-2" });
const ddbDocClient = DynamoDBDocumentClient.from(ddbClient);

// Define the name of the DDB table to perform the CRUD operations on
const tablename = "lambda-apigateway";

/**
 * Provide an event that contains the following keys:
 *
 *   - operation: one of 'create,' 'read,' 'update,' 'delete,' or 'echo'
 *   - payload: a JSON object containing the parameters for the table item
 *     to perform the operation on
 */
export const handler = async (event, context) => {
   
     const operation = event.operation;
   
     if (operation == 'echo'){
          return(event.payload);
     }
     
    else { 
        event.payload.TableName = tablename;
        let response;
        
        switch (operation) {
          case 'create':
               response = await ddbDocClient.send(new PutCommand(event.payload));
               break;
          case 'read':
               response = await ddbDocClient.send(new GetCommand(event.payload));
               break;
          case 'update':
               response = ddbDocClient.send(new UpdateCommand(event.payload));
               break;
          case 'delete':
               response = ddbDocClient.send(new DeleteCommand(event.payload));
               break;
          default:
            response = 'Unknown operation: ${operation}';
          }
        console.log(response);
        return response;
    }
};

Nota

In questo esempio, il nome della tabella DynamoDB è definito come variabile nel codice della funzione. In un'applicazione reale, la best practice consiste nell'inviare questo parametro come variabile d'ambiente ed evitare di codificare il nome della tabella. Per ulteriori informazioni, consulta Uso AWS Lambda delle variabili di ambiente.

Creazione della funzione

Salvate l'esempio di codice come file denominato index.mjs e, se necessario, modificate l' AWS area specificata nel codice. La regione specificata nel codice deve essere la stessa regione in cui verrà creata la tabella DynamoDB più avanti nel tutorial.
Crea un pacchetto di implementazione utilizzando il seguente comando zip.
```
zip function.zip index.mjs
```

Crea una funzione Lambda utilizzando il create-function AWS CLI comando. Per il parametro role, immetti il nome della risorsa Amazon (ARN) del ruolo di esecuzione copiato in precedenza.


aws lambda create-function \
--function-name LambdaFunctionOverHttps \
--zip-file fileb://function.zip \
--handler index.handler \
--runtime nodejs22.x \
--role arn:aws:iam::123456789012:role/service-role/lambda-apigateway-role

Python 3

Esempio LambdaFunctionOverHttps.py


import boto3

# Define the DynamoDB table that Lambda will connect to
table_name = "lambda-apigateway"

# Create the DynamoDB resource
dynamo = boto3.resource('dynamodb').Table(table_name)

# Define some functions to perform the CRUD operations
def create(payload):
    return dynamo.put_item(Item=payload['Item'])

def read(payload):
    return dynamo.get_item(Key=payload['Key'])

def update(payload):
    return dynamo.update_item(**{k: payload[k] for k in ['Key', 'UpdateExpression', 
    'ExpressionAttributeNames', 'ExpressionAttributeValues'] if k in payload})

def delete(payload):
    return dynamo.delete_item(Key=payload['Key'])

def echo(payload):
    return payload

operations = {
    'create': create,
    'read': read,
    'update': update,
    'delete': delete,
    'echo': echo,
}

def lambda_handler(event, context):
    '''Provide an event that contains the following keys:
      - operation: one of the operations in the operations dict below
      - payload: a JSON object containing parameters to pass to the 
        operation being performed
    '''
    
    operation = event['operation']
    payload = event['payload']
    
    if operation in operations:
        return operations[operation](payload)
        
    else:
        raise ValueError(f'Unrecognized operation "{operation}"')

Nota

In questo esempio, il nome della tabella DynamoDB è definito come variabile nel codice della funzione. In un'applicazione reale, la best practice consiste nell'inviare questo parametro come variabile d'ambiente ed evitare di codificare il nome della tabella. Per ulteriori informazioni, vedere Utilizzo delle variabili di AWS Lambda ambiente.

Creazione della funzione

Salva l'esempio di codice come un file denominato LambdaFunctionOverHttps.py.
Crea un pacchetto di implementazione utilizzando il seguente comando zip.
```
zip function.zip LambdaFunctionOverHttps.py
```

Crea una funzione Lambda utilizzando il create-function AWS CLI comando. Per il parametro role, immetti il nome della risorsa Amazon (ARN) del ruolo di esecuzione copiato in precedenza.


aws lambda create-function \
--function-name LambdaFunctionOverHttps \
--zip-file fileb://function.zip \
--handler LambdaFunctionOverHttps.lambda_handler \
--runtime python3.12 \
--role arn:aws:iam::123456789012:role/service-role/lambda-apigateway-role

anchor anchor

Esempio index.mjs

Prendi nota dell'impostazione region. Questo deve corrispondere al Regione AWS luogo in cui si distribuisce la funzione e si crea la tabella DynamoDB.


import { DynamoDBDocumentClient, PutCommand, GetCommand, 
         UpdateCommand, DeleteCommand} from "@aws-sdk/lib-dynamodb";
import { DynamoDBClient } from "@aws-sdk/client-dynamodb";

const ddbClient = new DynamoDBClient({ region: "us-east-2" });
const ddbDocClient = DynamoDBDocumentClient.from(ddbClient);

// Define the name of the DDB table to perform the CRUD operations on
const tablename = "lambda-apigateway";

/**
 * Provide an event that contains the following keys:
 *
 *   - operation: one of 'create,' 'read,' 'update,' 'delete,' or 'echo'
 *   - payload: a JSON object containing the parameters for the table item
 *     to perform the operation on
 */
export const handler = async (event, context) => {
   
     const operation = event.operation;
   
     if (operation == 'echo'){
          return(event.payload);
     }
     
    else { 
        event.payload.TableName = tablename;
        let response;
        
        switch (operation) {
          case 'create':
               response = await ddbDocClient.send(new PutCommand(event.payload));
               break;
          case 'read':
               response = await ddbDocClient.send(new GetCommand(event.payload));
               break;
          case 'update':
               response = ddbDocClient.send(new UpdateCommand(event.payload));
               break;
          case 'delete':
               response = ddbDocClient.send(new DeleteCommand(event.payload));
               break;
          default:
            response = 'Unknown operation: ${operation}';
          }
        console.log(response);
        return response;
    }
};

Nota

Creazione della funzione

Salvate l'esempio di codice come file denominato index.mjs e, se necessario, modificate l' AWS area specificata nel codice. La regione specificata nel codice deve essere la stessa regione in cui verrà creata la tabella DynamoDB più avanti nel tutorial.
Crea un pacchetto di implementazione utilizzando il seguente comando zip.
```
zip function.zip index.mjs
```

Crea una funzione Lambda utilizzando il create-function AWS CLI comando. Per il parametro role, immetti il nome della risorsa Amazon (ARN) del ruolo di esecuzione copiato in precedenza.


aws lambda create-function \
--function-name LambdaFunctionOverHttps \
--zip-file fileb://function.zip \
--handler index.handler \
--runtime nodejs22.x \
--role arn:aws:iam::123456789012:role/service-role/lambda-apigateway-role

Richiamate la funzione utilizzando il AWS CLI

Fase 4: richiamare la funzione utilizzando AWS CLI

Prima di integrare la tua funzione con Gateway API, verifica di aver implementato correttamente la funzione. Crea un evento di test contenente i parametri che l'API API Gateway invierà a Lambda e usa il AWS CLI invoke comando per eseguire la funzione.

Per richiamare la funzione Lambda con AWS CLI

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


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

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"
}
```
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"}
```

Creazione di una REST API utilizzando API Gateway

In questa fase, viene creata la REST API di Gateway API che sarà utilizzata per richiamare la funzione Lambda.

Per creare l'API

Apri la console API Gateway.
Seleziona Create API (Crea API).
Nella casella REST API, scegliere Build.
In Dettagli API, lasciare selezionata Nuova API e per Nome API, inserire DynamoDBOperations.
Seleziona Create API (Crea API).

Creazione di una risorsa sulla REST API

Per aggiungere un metodo HTTP all'API, è necessario prima creare una risorsa su cui quel metodo possa operare. Qui viene creata la risorsa per gestire la tabella DynamoDB.

Per creare la risorsa

Nella console API Gateway, nella pagina Risorse dell'API, scegliere Crea risorsa.
In Dettagli risorsa, per Nome risorsa, inserire DynamoDBManager.
Scegliere Create Resource (Crea risorsa).

Creazione di un metodo HTTP POST

In questa fase, viene creato un metodo (POST) per la risorsa DynamoDBManager. Il metodo POST viene collegato alla funzione Lambda in modo che quando il metodo riceve una richiesta HTTP, Gateway API richiama la funzione Lambda.

Nota

Ai fini di questo tutorial, viene utilizzato un metodo HTTP (POST) per richiamare una singola funzione Lambda che esegue tutte le operazioni sulla tabella DynamoDB. In un'applicazione reale, la best practice consiste nell'utilizzare una funzione Lambda e un metodo HTTP diversi per ogni operazione. Per ulteriori informazioni, consulta Il monolite Lambda in Serverless Land.

Creazione del metodo POST

Nella pagina Risorse dell'API, assicurarsi che la risorsa /DynamoDBManager sia evidenziata. Quindi, nel riquadro Metodi, scegliere Crea metodo.
Per Metodo HTTP scegliere POST.
Per Tipo di integrazione lasciare selezionato Funzione Lambda.
Per la funzione Lambda, scegliere nome della risorsa Amazon (ARN) per la funzione (LambdaFunctionOverHttps).
Scegli Crea metodo.

Creazione di una tabella DynamoDB

Crea una tabella DynamoDB vuota su cui la funzione Lambda eseguirà le operazioni CRUD.

Creare la tabella DynamoDB

Aprire la pagina Tables (Tabelle) della console DynamoDB.
Scegliere Create table (Crea tabella).
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).
In Table settings (Impostazioni tabella), mantieni le impostazioni predefinite.
Scegliere Create table (Crea tabella).

Test dell'integrazione di Gateway API, Lambda e DynamoDB

A questo punto sei pronto per testare l'integrazione del metodo API di Gateway API con la funzione Lambda e la tabella DynamoDB. Utilizzando la console di Gateway API, invii le richieste direttamente al metodo POST utilizzando la funzione di test della console. In questo passaggio, viene utilizzata prima un'operazione create per aggiungere un nuovo elemento alla tabella DynamoDB, quindi viene utilizzata un'operazione update per modificare l'elemento.

Test 1: creazione di un nuovo elemento nella tabella DynamoDB

Nella console di Gateway API, scegli l'API (DynamoDBOperations).
Scegli il metodo POST sotto la risorsa DynamoDBManager.
Seleziona la scheda Test. Potrebbe essere necessario scegliere il pulsante freccia destra per visualizzare la scheda.

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
    }
  }
}

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.
Apri la pagina Tables (Tabelle) della console DynamoDB e scegli la tabella lambda-apigateway.
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

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

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
        }
    }
}

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.
Apri la pagina Tables (Tabelle) della console DynamoDB e scegli la tabella lambda-apigateway.
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.

Distribuzione dell'API

Per consentire al client di chiamare l'API, è necessario creare una implementazione e una fase associata. Una fase rappresenta un'istantanea dell'API, inclusi i suoi metodi e le sue integrazioni.

Per distribuire l'API

Apri la APIspagina della console API Gateway e scegli l'DynamoDBOperationsAPI.
Nella pagina Risorse per la tua API, scegliere Distribuzione dell'API.
Per Fase, scegliere *Nuova fase* quindi per Nome fase specificare test.
Seleziona Deploy (Implementa).
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.

Uso di curl per richiamare la funzione tramite le richieste HTTP

Fase 11: richiamo della funzione con una richiesta HTTP

A questo punto è possibile richiamare la funzione Lambda inviando una richiesta HTTP all'API. In questo passaggio, verrà creato un nuovo elemento nella tabella DynamoDB e quindi verranno eseguite le operazioni di lettura, aggiornamento ed eliminazione su tale elemento.

Per creare un elemento nella tabella DynamoDB utilizzando curl

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.
È 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:

anchor anchor

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

Per aggiornare l'elemento nella tabella DynamoDB utilizzando curl

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}}}'

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

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"}}}'

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.

Pulizia delle risorse (facoltativo)

Ora è possibile eliminare le risorse create per questo tutorial, a meno che non si voglia conservarle. Eliminando AWS le risorse che non utilizzi più, eviti addebiti inutili a tuo Account AWS carico.

Per eliminare la funzione Lambda

Aprire la pagina Functions (Funzioni) della console Lambda.
Selezionare la funzione creata.
Scegliere Operazioni, Elimina.
Inserisci confirm nel campo di immissione del testo, quindi scegli Elimina.

Come eliminare il ruolo di esecuzione

Aprire la pagina Ruoli della console IAM.
Selezionare il ruolo di esecuzione creato.
Scegliere Elimina.
Inserisci il nome del ruolo nel campo di immissione testo e seleziona Delete (Elimina).

Per eliminare l'API

Apri la APIs pagina della console API Gateway.
Selezionare l'API creata.
Scegliere Actions (Operazioni), Delete (Elimina).
Scegliere Delete (Elimina).

Per eliminare la tabella DynamoDB

Aprire la pagina Tables (Tabelle) della console DynamoDB.
Selezionare la tabella creata.
Scegliere Delete (Elimina).
Immettere delete nella casella di testo.
Seleziona Delete Table (Elimina tabella).

Avvertimento JavaScript è disabilitato o non è disponibile nel tuo browser.

Per usare la documentazione AWS, JavaScript deve essere abilitato. Consulta le pagine della guida del browser per le istruzioni.

Convenzioni dei documenti

API Gateway

Errori

In questa pagina

Seleziona le tue preferenze relative ai cookie

Tutorial: uso di Lambda con Amazon API Gateway

Suggerimento

Sections

Prerequisiti

Nota

Installa il AWS Command Line Interface

Nota

Creazione di una policy di autorizzazione

Come creare la policy

Creazione di un ruolo di esecuzione

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

Creazione della funzione

Esempio index.mjs

Nota

Creazione della funzione

Esempio LambdaFunctionOverHttps.py

Nota

Creazione della funzione

Esempio index.mjs

Nota

Creazione della funzione

Richiamate la funzione utilizzando il AWS CLI

Per richiamare la funzione Lambda con AWS CLI

Creazione di una REST API utilizzando API Gateway

Per creare l'API

Creazione di una risorsa sulla REST API

Per creare la risorsa

Creazione di un metodo HTTP POST

Nota

Creazione del metodo POST

Creazione di una tabella DynamoDB

Creare la tabella DynamoDB

Test dell'integrazione di Gateway API, Lambda e DynamoDB

Test 1: creazione di un nuovo elemento nella tabella DynamoDB

Test 2: aggiornamento dell'elemento nella tabella DynamoDB

Distribuzione dell'API

Per distribuire l'API

Uso di curl per richiamare la funzione tramite le richieste HTTP

Per creare un elemento nella tabella DynamoDB utilizzando curl

Per leggere l'elemento nella tabella DynamoDB utilizzando curl

Per aggiornare l'elemento nella tabella DynamoDB utilizzando curl

Per eliminare l'elemento nella tabella DynamoDB utilizzando curl

Pulizia delle risorse (facoltativo)

Per eliminare la funzione Lambda

Come eliminare il ruolo di esecuzione

Per eliminare l'API

Per eliminare la tabella DynamoDB

In questa pagina

Related resources

Questa pagina ti è stata utile?

Related resources

Argomento successivo:

Argomento precedente:

Hai bisogno di aiuto?