Modulo 4. Distribuzione di un'API RESTful

In questo modulo, utilizzerai Amazon API Gateway per esporre le funzioni Lambda che hai creato nel modulo precedente come API RESTful. Il sito web statico di cui eseguirai l’hosting nel modulo successivo ha una pagina configurata per interagire con l’API che hai creato in questo modulo.

Personalizzazione dell'indirizzo DA utilizzato per le comunicazioni e-mail con gli utenti

Creazione di un back-end serverless

Creazione di una macchina a stati

Distribuzione di un'API RESTful

Hosting di un sito Web statico

Test della configurazione

Istruzioni per l'implementazione

Segui le istruzioni dettagliate riportate di seguito per creare l'API REST. Fai clic sul numero di ciascuna fase per espandere la sezione.

  • Fase 1. Creazione di una nuova API RESTful

    Amazon API Gateway ti consente di creare, pubblicare, mantenere, monitorare e proteggere le tue operazioni API REST e WebSocket. Completa le seguenti fasi per creare una nuova API RESTful.

    1. Apri la console Amazon API Gateway su https://console.aws.amazon.com/apigateway.
    2. Scegli una delle seguenti operazioni:
      • Se questa è la tua prima operazione API, viene visualizzata la pagina Get Started (Inizia subito). Scegli Get Started (Inizia subito).
      • Nella finestra di dialogo Create Example API (Crea API di esempio), scegli OK.
      • Se questa è un’operazione API successiva, scegli Create API (Crea API).
    3. In Choose an API type (Scegli un tipo di API), scegli REST API e seleziona Build.
    4. In Choose the protocol (Scegli il protocollo), mantiene selezionato REST.
    5. In Create new API (Crea nuova API), mantieni selezionata NEW API (Nuova API).
    6. In Settings (Impostazioni), esegui la seguente operazione:
      • Per API name (Nome API), digita examplecorp_eao.
      • Per Descrizione, puoi facoltativamente digitare una descrizione.
      • Per Endpoint Type (Tipo di endpoint), mantieni selezionato Regional (Regionale).
    7. Scegli Create API (Crea API).

  • Fase 2. Configura API Gateway per l’integrazione con Lambda

    Per configurare API Gateway per questo workshop, completa le seguenti fasi.

    1. Apri la console Amazon API Gateway su https://console.aws.amazon.com/apigateway.
    2. Nel riquadro di navigazione, nell’API examplecorp_eao, scegli Resources (Risorse).
    3. Scegli Actions, Create Resource (Azioni, Crea risorse).
    4. Esegui le seguenti operazioni:
      • Per Resource Name (Nome risorsa), digita execute (esegui).
      • Per Resource Path (Percorso risorse), verifica che il valore sia /execute.
      • Seleziona la casella di controllo Enable API Gateway CORS (Abilita il Gateway API CORS).
      • Mantieni deselezionata la casella di controllo Configuer as proxy resource (Configura come risorsa proxy).
    5. Scegli Create Resource (Crea risorsa).
    6. Con la risorsa appena creata (/execute) selezionata nel riquadro Resources (Risorse), scegli Actions, Create Method (Azioni, Crea metodo).
    7. In OPTIONS (OPZIONI), scegli POST (PUBBLICA) e seleziona il segno di spunta alla destra dell’elenco.
    8. Nel riquadro POST - Setup (PUBBLICA - Configurazione), esegui le operazioni seguenti:
      • Per Integration type (Tipo di integrazione), scegli AWS Service (Servizio AWS).
      • Per AWS Region (Regione AWS), scegli la tua regione.
      • Per AWS Service (Servizio AWS), scegli Step Functions (Funzioni fase).
      • Lascia vuoto AWS Subdomain (Sottodominio AWS).
      • Per HTTP method (Metodo HTTP), scegli POST (PUBBLICA).
      • Per Action Type (Tipo di azione9, lascia selezionato Use action name (Usa nome azione).
      • Per Action (Azione), digita StartExecution.
      • Per Execution Role (Ruolo esecuzione), copia e incolla il ruolo ARN del ruolo collegato al servizio IAM che hai creato in precedenza, examplecorp_eao_role.
      • Per Content Handling (Gestione contenuto), lascia selezionato Passthrough.
      • Per Use Default Timeout (Usa timeout predefinito), lascia selezionata la casella di controllo.
      • Scegli Save (Salva).
    9.  Con il metodo appena creato (POST) selezionato nel riquadro Resources (Risorse), scegli Actions, Enable CORS (Azioni, Abilita CORS).
    10. Nel riquadro Enable CORS (Abilita CORS), mantieni i valori predefiniti e scegli Enable CORS and replace existing CORS headers (Abilita CORS e sostituisci le intestazioni CORS esistenti).
    11. Nella finestra di dialogo delle modifiche del metodo Confirm (Conferma), scegli Yes, replace existing values (Sì, sostituisci i valori esistenti).
    12. Viene visualizzato un messaggio che ti notifica che la tua risorsa è stata configurata per CORS.
    13. Nel riquadro Resources (Risorse), scegli POST (PUBBLICA).
    14. Seleziona Actions, Deploy API (Azioni, Distribuisci API).
    15. Nella finestra di dialogo Deploy API (Distribuisci API), esegui le seguenti operazioni:
      • Per Deployment stage (Stadio di distribuzione), scegli [New Stage] (Nuovo stadio).
      • Per Stage name (Nome stadio), digita test.
      • Per Stage description (Descrizione stadio) e Deployment description (Descrizione distribuzione), puoi digitare facoltativamente una descrizione.
      • Scegli Deploy (Distribuisci).
    16. Nel riquadro Stages (Stadi), espandi lo stadio appena creato, test.
    17. Scegli POST (PUBBLICA).
    18. Nella parte superiore del riquadro di modifica dello stadio, viene visualizzato Invoke URL (Richiama URL). Prendi nota dell'URL. Ti servirà nelle fasi successive del progetto.
Torna all'introduzione
Successivo: Hosting di un sito web statico