Nozioni di base su Gateway API

In questo esercizio di nozioni di base, viene creata un'API serverless. Le API serverless consentono di concentrarsi sulle applicazioni, invece di dedicare tempo al provisioning e alla gestione dei server. Il completamento di questo esercizio richiede meno di 20 minuti e può essere effettuato all'interno del piano gratuito AWS.

Innanzitutto, viene creata una funzione Lambda utilizzando la console AWS Lambda. Successivamente, è possibile creare un'API HTTP utilizzando la console API Gateway. Quindi, viene richiamata l'API.

Quando si richiama l'API HTTP, API Gateway instrada la richiesta alla funzione Lambda. Lambda esegue la funzione Lambda e restituisce una risposta alla console API Gateway. La console API Gateway restituisce quindi una risposta all'utente.

Per completare questo esercizio, sono necessari un account AWS e un utente AWS Identity and Access Management con accesso alla console. Per ulteriori informazioni, consulta Configurazione per l'utilizzo di Gateway API.

Fase 1: creazione di una funzione Lambda

Viene utilizzata una funzione Lambda per il backend della tua API. Lambda esegue il codice solo quando è necessario e si dimensiona automaticamente, da poche richieste al giorno a migliaia al secondo.

Per questo esempio, viene utilizzata la funzione Node.js predefinita dalla console Lambda.

La funzione di esempio restituisce una risposta 200 ai client e il testo Hello from Lambda!.

È possibile modificare la funzione Lambda, purché la risposta della funzione si allinei al formato richiesto da API Gateway.

Il codice predefinito della funzione Lambda dovrebbe essere simile al seguente:

export const handler = async (event) => {
    const response = {
        statusCode: 200,
        body: JSON.stringify('Hello from Lambda!'),
    };
    return response;
};

Fase 2: creazione un'API HTTP

Successivamente, viene creata un'API HTTP. La console API Gateway supporta anche API REST e API WebSocket, ma un'API HTTP è la scelta migliore per questo esercizio. Le API REST supportano più funzionalità rispetto alle API HTTP, ma non sono necessarie per questo esercizio. Le API HTTP sono progettate con funzionalità minime in modo che possano essere offerte a un prezzo inferiore. Le API WebSocket mantengono connessioni persistenti con i client per la comunicazione full-duplex, che non è necessaria per questo esempio.

L'API HTTP fornisce un endpoint HTTP per la funzione Lambda. API Gateway instrada le richieste alla funzione Lambda e quindi restituisce la risposta della funzione ai client.

Ora hai creato un'API HTTP con un'integrazione Lambda che è pronta a ricevere richieste dai client.

Fase 3: test dell'API

Successivamente, viene verificata l'API per assicurarsi che funzioni. Per semplicità, usa un browser Web per richiamare l'API.

(Opzionale) Fase 4: pulizia

Per evitare costi non necessari, eliminare le risorse create nell'ambito di questo esercizio di nozioni di base. La procedura seguente elimina l'API HTTP, la funzione Lambda e le risorse associate.

È possibile automatizzare la creazione e la pulizia delle risorse AWS utilizzando AWS CloudFormation o AWS SAM. Per un esempio dei modelli AWS CloudFormation, consulta i modelli di esempio AWS CloudFormation.

Fasi successive

Per questo esempio, è stato utilizzato AWS Management Console per creare una semplice API HTTP. L'API HTTP richiama una funzione Lambda e restituisce una risposta ai client.

Di seguito, sono riportate le fasi successive quando si continua a lavorare con API Gateway.

Per ricevere assistenza su Amazon API Gateway dalla community, consulta il forum di discussione di API Gateway. Per entrare nel forum, è possibile che AWS richieda l'accesso.

Per ottenere assistenza su API Gateway direttamente da AWS, consulta le opzioni di supporto nella pagina di supporto AWS.

Consulta anche le nostre domande frequenti (FAQ) oppure contattaci direttamente.