Creazione di un'applicazione Web di base

TUTORIAL

In questo modulo implementerai la tua funzione serverless mediante Gateway Amazon API.

Panoramica

In questo modulo utilizzeremo Gateway Amazon API per creare un'API RESTful che ci consenta di richiamare la funzione Lambda da un client Web (in genere si riferisce al browser Web di un utente). Gateway API fungerà da livello intermedio tra il client HTML creato nel Modulo 1 e il back-end serverless creato nel Modulo 2.

Obiettivi

In questo modulo completerai le seguenti operazioni:

  • Creazione di una nuova API utilizzando Gateway API
  • Definizione dei metodi HTTP sulla tua API
  • Attivazione di una funzione Lambda da un'API
  • Abilita la condivisione di risorse tra origini (CORS) su un'API in modo da poter consumare risorse da un'origine diversa (dominio)
  • Test di un'API creata con Gateway API dalla Console di gestione AWS

Concetti chiave

API RESTful: REST sta per "Representational State Transfer" ed è un modello architetturale utilizzato per la creazione di servizi Web. API è la sigla di "Application Programming Interface". Pertanto, un'API RESTful è l'interfaccia in cui viene implementato il modello architetturale.

Metodi di richiesta HTTP: i metodi HTTP sono progettati per abilitare le comunicazioni tra client e server. Metodi come GET o PUT, definiti dal protocollo HTTP, vengono utilizzati per indicare l'azione da compiere su una risorsa.

CORS: la funzionalità di sicurezza del browser CORS utilizza le intestazioni HTTP per indicare a un browser di consentire a una determinata applicazione Web in esecuzione su un'origine (dominio) di accedere a risorse selezionate da un server di origine diversa.

Ottimizzato per l’edge: una risorsa che utilizza l'infrastruttura globale di AWS per servire meglio i client in tutto il mondo.

 Tempo minimo richiesto per il completamento

5 minuti

 Servizi utilizzati

 Ultimo aggiornamento

4 aprile 2023

Implementazione

    1. Accedi alla Console di Gateway API.
    2. Nella sezione Scegli un tipo di API, trova la scheda REST API e scegli il pulsante Crea sulla scheda.
    3. In Scegli il protocollo, seleziona REST.
    4. In Crea nuova API, seleziona Nuova API.
    5. Nel campo Nome API, digita HelloWorldAPI.
    6. Seleziona Ottimizzato per l’edge dal menu a discesa Tipo di endpoint. (Nota: gli endpoint ottimizzati per l'edge sono ideali per i clienti distribuiti geograficamente. Sono una buona scelta per i servizi pubblici accessibili tramite Internet. Gli endpoint regionali in genere vengono utilizzati per le API cui si accede principalmente dalla stessa regione AWS).
    7. Fai clic sul pulsante blu Crea API. Le impostazioni dovrebbero assomigliare a quelle indicate sulla schermata seguente:
    Crea una pagina API, che mostra le selezioni e le impostazioni dell'API.
    1. Nel riquadro di navigazione a sinistra, seleziona Risorse in API: HelloWorldAPI.
    2. Assicurati che la risorsa "/" sia selezionata.
    3. Dal menu a discesa Operazioni, seleziona Crea metodo.
    4. Seleziona POST dal nuovo menu a discesa visualizzato, quindi fai clic sul segno di spunta.
    5. Seleziona Funzione Lambda per Tipo di integrazione.
    6. Seleziona la regione Lambda che hai usato quando hai creato la funzione (altrimenti vedrai una finestra di avviso che dice "Nessuna funzione Lambda in... ").
    7. Inserisci HelloWorldFunction nel campo Funzione Lambda.
    8. Fai clic sul pulsante blu Salva.
    9. Dovresti visualizzare un messaggio in cui viene comunicato che stai concedendo all'API in fase di creazione l'autorizzazione a richiamare la funzione Lambda. Scegli il pulsante OK.
    10. Con il metodo POST appena creato selezionato, scegli Abilita CORS dal menu a discesa Operazione.
    11. Lascia selezionata la casella di controllo POST e fai clic sul pulsante blu Abilita CORS e sostituisci le intestazioni CORS esistenti.
    Abilita la pagina di configurazione CORS.

    10. Dovresti visualizzare un messaggio in cui viene richiesto di confermare le modifiche apportate al metodo. Fai clic sul pulsante blu Sì, sostituisci i valori esistenti.

    Messaggio di conferma delle modifiche al metodo.
    1. Nell'elenco a discesa Operazioni, seleziona Implementa API.
    2. Seleziona [Nuova fase] nell'elenco a discesa Fase di implementazione.
    3. Immetti dev per Nome fase.
    4. Scegli Implementa.
    5. Copia e salva l'URL accanto a Richiama URL (sarà necessario nel Modulo 5).
    1. Nel riquadro di navigazione sulla sinistra, seleziona Risorse.
    2. I metodi per le nostre API adesso saranno elencati a destra. Scegli POST.
    3. Fai clic sul piccolo fulmine blu.
    4. Incolla quanto riportato di seguito nel campo Corpo della richiesta:
    {
        "firstName":"Grace",
        "lastName":"Hopper"
    }

    5. Fai clic sul pulsante blu Test.

    6. A destra dovresti visualizzare una risposta con Codice 200.

    7. Ottimo! Abbiamo creato e testato un'API in grado di richiamare la nostra funzione Lambda.

Architettura applicativa

Il Modulo 3 è stato completato. Rivediamo la nostra architettura:

Diagramma dell'architettura che mostra i servizi ospitati nel cloud AWS, con le connessioni mostrate da utenti esterni ai servizi AWS interconnessi.

Abbiamo aggiunto Gateway API e lo abbiamo collegato alla funzione Lambda esistente. Adesso, possiamo attivare la funzione con una chiamata API. Non siamo ancora in grado di generare tale chiamata dal client Web. Prima aggiungeremo la nostra tabella di dati nel Modulo 4, quindi collegheremo tutto nel Modulo 5.

Questa pagina è stata utile?

Creazione di una tabella di dati