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 la REST API console
In questo esercizio introduttivo, creerai un server serverless REST API utilizzando la console API Gateway RESTAPI. La tecnologia serverless APIs consente di concentrarsi sulle applicazioni anziché dedicare tempo al provisioning e alla gestione dei server. Il completamento di questa esercitazione richiede meno di 20 minuti e rientra nel piano gratuito AWS
Innanzitutto, crei una funzione Lambda utilizzando la console Lambda. Successivamente, si crea una console REST API utilizzando la console API Gateway RESTAPI. Quindi, crei un API metodo e lo integri con una funzione Lambda utilizzando un'integrazione proxy Lambda. Infine, distribuisci e richiami il tuo. API
Quando richiami la tua RESTAPI, API Gateway indirizza la richiesta alla tua funzione Lambda. Lambda esegue la funzione e restituisce una risposta a API Gateway. APIGateway ti restituisce quindi la risposta.
Per completare questo esercizio, è necessario un utente Account AWS and an AWS Identity and Access Management (IAM) con accesso alla console. Per ulteriori informazioni, consulta Configurazione per l'utilizzo di API Gateway.
Argomenti
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 questa esercitazione, utilizzi una funzione Node.js predefinita nella console Lambda.
Per creare una funzione Lambda
-
Scegli Crea funzione.
-
In Basic information (Informazioni di base) , per Function name (Nome funzione) , inserisci
my-function
. Per tutte le altre opzioni, usa l'impostazione predefinita.
-
Scegli Crea funzione.
Il codice predefinito della funzione Lambda dovrebbe essere simile al seguente:
export const handler = async (event) => { const response = { statusCode: 200, body: JSON.stringify('The API Gateway REST API console is great!'), }; return response; };
È possibile modificare la funzione Lambda per questo esercizio, purché la risposta della funzione sia in linea con il formato richiesto da Gateway. API
Sostituisci il corpo della risposta predefinito (Hello from Lambda!
) con The API Gateway REST API
console is great!
. Quando richiami la funzione di esempio, restituisce una risposta 200
ai client, insieme alla risposta aggiornata.
Fase 2: Creare un REST API
Successivamente, si crea un REST API file con una risorsa root (/
).
Per creare un REST API
Accedere alla console API Gateway all'indirizzo https://console.aws.amazon.com/apigateway.
-
Esegui una di queste operazioni:
-
Per creare il tuo primo fileAPI, scegli Build. RESTAPI
-
Se ne hai già creato unoAPI, scegli Crea API, quindi scegli Crea per RESTAPI.
-
-
Per APInome, inserisci
my-rest-api
. (Facoltativo) In Description (Descrizione), immettere una descrizione.
Mantieni il tipo di API endpoint impostato su Regionale.
Scegli Crea API.
Fase 3: Creazione di un'integrazione proxy Lambda
Successivamente, crei un API metodo per la tua REST API risorsa root (/
) e integri il metodo con la tua funzione Lambda utilizzando un'integrazione proxy. In un'integrazione con proxy Lambda, API Gateway passa la richiesta in entrata dal client direttamente alla funzione Lambda.
Creazione di un'integrazione proxy Lambda
-
Seleziona la risorsa
/
, quindi scegli Crea metodo. -
In Tipo di metodo, seleziona
ANY
. -
In Tipo di integrazione, seleziona Lambda.
-
Attiva l'opzione Integrazione proxy Lambda.
-
In Funzione Lambda, immetti
my-function
, quindi seleziona la funzione Lambda. -
Scegli Crea metodo.
Fase 4: Implementa il API
Successivamente, crei una API distribuzione e la associ a una fase.
Per distribuire il API
Scegliere Deploy (Implementa)API.
In Fase, seleziona Nuova fase.
In Stage name (Nome fase) immettere
Prod
.(Facoltativo) In Description (Descrizione), immettere una descrizione.
Seleziona Deploy (Implementa).
Ora i clienti possono chiamare il tuoAPI. Per testarlo API prima di distribuirlo, puoi facoltativamente scegliere il ANYmetodo, accedere alla scheda Test e quindi scegliere Test.
Passaggio 5: richiama il API
Per invocare il tuo API
-
Nel riquadro di navigazione principale, seleziona Log.
-
In Dettagli dello stage, scegli l'icona di copia per copiare API la tua chiamataURL.
-
Inserisci l'invoke URL in un browser web.
La versione completa URL dovrebbe
https://
assomigliare a.abcd123
.execute-api.us-east-2
.amazonaws.com/ProdIl tuo browser invia una
GET
richiesta aAPI. -
Verifica la tua API risposta. Il testo
"The API Gateway REST API console is great!"
dovrebbe essere visualizzato nel browser in uso.
(Opzionale) Fase 6: pulizia
Per evitare di incorrere in costi inutili Account AWS, elimina le risorse che hai creato come parte di questo esercizio. I passaggi seguenti eliminano REST API la tua funzione Lambda e le risorse associate.
Per eliminare le tue REST API
-
Nel riquadro Risorse, scegli APIazioni, Elimina API.
-
Nella API finestra di dialogo Elimina, immettete conferma, quindi scegliete Elimina.
Eliminazione della funzione Lambda
-
Nella pagina Funzioni, seleziona la tua funzione. Scegli Operazioni > Elimina.
-
Nella finestra di dialogo Elimina 1 funzione/i, immetti
delete
e quindi scegli Elimina.
Eliminazione del gruppo di log della funzione Lambda
-
Apri la pagina dei gruppi di log
della CloudWatch console Amazon. -
Nella pagina Gruppi di log, seleziona il gruppo di log della funzione (
/aws/lambda/my-function
). In Operazioni, scegli Elimina gruppo di log. -
Nella finestra di dialogo Delete log group(s) (Elimina gruppo/i di log) scegli Delete (Elimina).
Eliminazione del ruolo di esecuzione della funzione Lambda
-
Apri la pagina Ruoli
della IAM console. -
(Facoltativo) Nella pagina Ruoli, nella casella di ricerca, immetti
my-function
. -
Seleziona il ruolo della tua funzione (ad esempio,
my-function-
), quindi scegli Elimina.31exxmpl
-
Nella finestra di dialogo Eliminare
my-function-
?, immetti il nome del ruolo, quindi scegli Elimina.31exxmpl
Suggerimento
È possibile automatizzare la creazione e la pulizia delle AWS risorse utilizzando AWS CloudFormation o AWS Serverless Application Model ()AWS SAM. Per alcuni AWS CloudFormation modelli di esempio, consulta i modelli di esempio per API Gateway