Come posso configurare la mia REST API di Gateway API per passare i parametri della stringa di query a una funzione Lambda di backend o a un endpoint HTTP?

Breve descrizione

Per configurare una REST API per passare i parametri della stringa di query a una funzione AWS Lambda di backend, utilizza un'integrazione personalizzata Lambda.

Per passare i parametri della stringa di query a un endpoint HTTP, utilizza un'integrazione HTTP personalizzata.

Importante: assicurati di fornire i dati di input come payload della richiesta di integrazione. È consigliabile utilizzare un modello di mappatura per fornire il payload. Per ulteriori informazioni, consulta Esempi di mappatura dei parametri per REST API in API Gateway.

Risoluzione

Passa i parametri della stringa di query a una funzione Lambda di backend

Completa i seguenti passaggi:

1. Apri la console Gateway API, quindi seleziona l'API.
2. Nel pannello Risorse, scegli il metodo HTTP configurato.
   Nota: se è configurato più di un metodo HTTP per l'API, ripeti i passaggi per ogni metodo.
3. Nel pannello Esecuzione metodo, scegli Richiesta metodo, quindi Modifica.
4. Espandi l'elenco a discesa Parametri della stringa di query URL, quindi scegli Aggiungi stringa di query.
5. Nel campo Nome, inserisci pet.
6. Seleziona la casella di controllo Campo obbligatorio, quindi scegli Salva.
7. Scegli la scheda Richiesta di integrazione, quindi Modifica.
8. Espandi Modelli di mappatura, quindi scegli Aggiungi modello di mappatura.
9. Nel campo Content-Type inserisci application/json.
10. Nell'editor dei modelli di mappatura, copia e sostituisci lo script corrente con il seguente codice:

{     "pet": "$input.params('pet')"
}

Nota: per ulteriori informazioni, consulta Variabili di input. Scegli Salva, quindi Distribuisci l'API. Per verificare il nuovo endpoint dell'API, esegui questo comando curl:

curl -X GET https://jp58lnf5vh.execute-api.us-west-2.amazonaws.com/dev/lambda-non-proxy?pet=dog

Importante: assicurati che il comando curl abbia il parametro della stringa di query pet=dog.

Passa i parametri della stringa di query a un endpoint HTTP

Completa i seguenti passaggi:

1. Apri la console Gateway API, quindi seleziona l'API.
2. Nel pannello Risorse, scegli il metodo HTTP configurato.
   Nota: se è configurato più di un metodo HTTP per l'API, ripeti i passaggi per ogni metodo.
3. Nel pannello Esecuzione metodo, scegli Richiesta metodo, quindi Modifica.
4. Espandi l'elenco a discesa Parametri della stringa di query URL, quindi scegli Aggiungi stringa di query.
5. Nel campo Nome inserisci type, quindi scegli Salva.
6. Scegli la scheda Richiesta di integrazione, quindi Modifica.
7. Espandi la sezione Parametri della stringa di query URL.
8. Nel campo Nome inserisci type.
9. Nel campo Mappato da inserisci method.request.querystring.type.
10. Scegli Salva, quindi Distribuisci l'API.
11. Per verificare il nuovo endpoint dell'API, esegui questo comando curl:

curl -X GET https://jp58lnf5vh.execute-api.us-west-2.amazonaws.com/dev/http-endpoint?pet=dog

Importante: assicurati che il comando curl abbia il parametro della stringa di query pet=dog.

Informazioni correlate

Tutorial: creazione di una REST API con un'integrazione proxy Lambda

Tutorial: creazione di una REST API con un'integrazione non proxy Lambda

Tutorial: creazione di una REST API con l'integrazione proxy HTTP

Tutorial: Tutorial: creazione di una REST API con un'integrazione non proxy HTTP