Inizia a usare API Gateway - Amazon API Gateway
Fase 1: creazione di una funzione LambdaFase 2: Creare un HTTP APIFase 3: Metti alla prova il tuo API(Opzionale) Fase 4: puliziaPassaggi successivi

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Inizia a usare API Gateway

In questo esercizio introduttivo, creerai un serverless. API La modalità serverless APIs consente di concentrarsi sulle applicazioni, anziché 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, crei una funzione Lambda utilizzando la AWS Lambda console. Successivamente, ne crei una HTTP API utilizzando la console API Gateway. Quindi, invochi il tuoAPI.

Nota

Questo esercizio utilizza un HTTPAPI. APIGateway supporta anche RESTAPIs, che includono più funzionalità. Per un tutorial sull'uso di a RESTAPI, vediInizia a usare la REST API console.

Per ulteriori informazioni sulla differenza tra HTTP APIs e RESTAPIs, vedereScegli tra REST APIs e HTTP APIs.

Quando richiami la tua HTTPAPI, API Gateway indirizza la richiesta alla tua funzione Lambda. Lambda esegue la funzione Lambda e restituisce una risposta a Gateway. API APIGateway restituisce quindi una risposta all'utente.

Panoramica di HTTP API ciò che crei in questo tutorial.

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

Fase 1: creazione di una funzione Lambda

Usi una funzione Lambda per il backend del tuo. 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.

Per creare una funzione Lambda

  1. Accedi alla console Lambda all'indirizzo https://console.aws.amazon.com /lambda.

  2. Selezionare Create function (Crea funzione).

  3. Nel campo Function name (Nome funzione), immettere my-function.

  4. Per tutte le altre opzioni, usa l'impostazione predefinita.

  5. Selezionare Create function (Crea funzione).

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

Puoi modificare la tua funzione Lambda, purché la risposta della funzione sia in linea con il formato richiesto da Gateway. API

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: Creare un HTTP API

Successivamente, crei un HTTPAPI. APIGateway supporta anche REST APIs e WebSocket APIs, ma an HTTP API è la scelta migliore per questo esercizio. RESTAPIssupporta più funzionalità di HTTPAPIs, ma non abbiamo bisogno di tali funzionalità per questo esercizio. HTTPAPIssono progettati con funzionalità minime in modo da poter essere offerti a un prezzo inferiore. WebSocket APIsmantengono connessioni persistenti con i client per la comunicazione full-duplex, che non è richiesta in questo esempio.

HTTPAPIfornisce un HTTP endpoint per la funzione Lambda. APIIl gateway indirizza le richieste alla funzione Lambda e quindi restituisce la risposta della funzione ai client.

Per creare un HTTP API

  1. Accedere alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.

  2. Esegui una di queste operazioni:

    • Per creare il tuo primo fileAPI, scegli Build. HTTPAPI

    • Se ne hai già creato unoAPI, scegli Crea API, quindi scegli Crea per HTTPAPI.

  3. Per Integrazioni, scegliere Aggiungi integrazione.

  4. Selezionare Lambda.

  5. Per Lambda function (Funzione Lambda), immetti my-function.

  6. Per APInome, inseriscimy-http-api.

  7. Scegli Next (Successivo).

  8. Controlla il percorso creato da API Gateway per te, quindi scegli Avanti.

  9. Controlla la fase che API Gateway crea per te, quindi scegli Avanti.

  10. Scegli Create (Crea) .

Ora ne hai creato uno HTTP API con un'integrazione Lambda pronto a ricevere richieste dai clienti.

Fase 3: Metti alla prova il tuo API

Successivamente, testate il vostro API per assicurarvi che funzioni. Per semplicità, usa un browser web per richiamare il tuoAPI.

Per testare il tuo API

  1. Accedi alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.

  2. APIScegli il tuo.

  3. Annota la tua API URL invocazione.

    Dopo aver creato la tuaAPI, la console mostra la tua API chiamataURL.

  4. Copia API la tua chiamata e URL inseriscila in un browser web. Aggiungi il nome della tua funzione Lambda all'URLinvoke per chiamare la tua funzione Lambda. Per impostazione predefinita, la console API Gateway crea una route con lo stesso nome della funzione Lambda,. my-function

    La versione completa URL dovrebbe https://abcdef123.execute-api.us-east-2.amazonaws.com/my-function assomigliare a.

    Il tuo browser invia una GET richiesta aAPI.

  5. Verifica la tua API risposta. Il testo "Hello from Lambda!" dovrebbe essere visualizzato nel browser in uso.

(Opzionale) Fase 4: pulizia

Per evitare costi non necessari, eliminare le risorse create nell'ambito di questo esercizio di nozioni di base. I passaggi seguenti eliminano HTTP API la tua funzione Lambda e le risorse associate.

Per eliminare un HTTP API

  1. Accedere alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.

  2. Nella APIspagina, seleziona un. API Scegli Azioni, quindi Elimina.

  3. Scegliere Delete (Elimina).

Per eliminare una funzione Lambda

  1. Accedi alla console Lambda all'indirizzo https://console.aws.amazon.com /lambda.

  2. Nella pagina Funzioni, selezionare una funzione. Scegli Azioni, quindi Elimina.

  3. Scegliere Delete (Elimina).

Per eliminare il gruppo di log di una funzione Lambda

  1. Nella CloudWatch console Amazon, apri la pagina dei gruppi di log.

  2. Nella pagina Log Groups (Gruppi di log), seleziona il gruppo di log della funzione (/aws/lambda/my-function). Scegliere Actions (Operazioni), quindi selezionare Delete log group (Elimina gruppo di log).

  3. Scegliere Delete (Elimina).

Per eliminare il ruolo di esecuzione di una funzione Lambda

  1. Nella AWS Identity and Access Management console, apri la pagina Ruoli.

  2. Seleziona il ruolo della funzione, ad esempi, my-function-31exxmpl.

  3. Scegliere Delete role (Elimina ruolo).

  4. Scegliere Yes, delete (Sì, elimina).

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

Passaggi successivi

In questo esempio, hai usato il per AWS Management Console creare un file semplice. HTTP API HTTPAPIrichiama una funzione Lambda e restituisce una risposta ai client.

Di seguito sono riportati i passaggi successivi man mano che si continua a lavorare con Gateway. API

Per ricevere assistenza con Amazon API Gateway dalla community, consulta il APIGateway Discussion Forum. Quando entri in questo forum, AWS potrebbe essere necessario effettuare l'accesso.

Per ricevere assistenza con API Gateway direttamente da AWS, consulta le opzioni di AWS supporto nella pagina Supporto.

Consulta anche le nostre domande frequenti (FAQs) o contattaci direttamente.