¿Cómo configuro mi API de REST de API Gateway para pasar los parámetros de la cadena de consulta a una función de Lambda de backend o a un punto de enlace de HTTP?

Descripción breve

Para configurar una API de REST para pasar los parámetros de la cadena de consulta a una función de AWS Lambda de backend, utiliza una integración personalizada de Lambda.

Para pasar los parámetros de la cadena de consulta a un punto de enlace de HTTP, utiliza una integración personalizada de HTTP.

Importante: Asegúrate de proporcionar los datos de entrada como carga útil de la solicitud de integración. Se recomienda utilizar una plantilla de asignación para suministrar la carga útil. Para obtener más información, consulta Ejemplos de asignación de parámetros para las API de REST en API Gateway.

Resolución

Envío de los parámetros de cadena de consulta a una función de Lambda del backend

Sigue estos pasos:

1. Abre la consola de API Gateway y, a continuación, selecciona tu API.
2. En el panel Recursos, selecciona el método HTTP configurado.
   Nota: Si hay más de un método HTTP configurado para la API, repite estos pasos para cada método.
3. En el panel Ejecución de método, elige Solicitud de método y, a continuación, elige Editar.
4. Expande la lista desplegable Parámetros de cadenas de consulta de URL y, a continuación, selecciona Agregar cadena de consulta.
5. En el campo Nombre, escribe pet.
6. Selecciona la casilla Obligatorio y, a continuación, selecciona Guardar.
7. Selecciona la pestaña Solicitud de integración y, a continuación, elijge Editar.
8. Expande Plantillas de mapeo y, a continuación, selecciona Agregar plantilla de mapeo.
9. En el campo Content-Type, escribe application/json.
10. En el editor de plantillas de asignación, copia y reemplaza el script actual por el siguiente código:

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

Nota: Para obtener más información, consulta Variables de entrada. Selecciona Guardar y, a continuación, selecciona Desplegar la API. Para probar el nuevo punto de enlace de la API, ejecuta el siguiente comando curl:

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

Importante: Asegúrate de que el comando curl tenga el parámetro de cadena de consulta mascota=perro.

Envío de parámetros de cadena de consulta a un punto de enlace de HTTP

Sigue estos pasos:

1. Abre la consola de API Gateway y, a continuación, selecciona tu API.
2. En el panel Recursos, selecciona el método HTTP configurado.
   Nota: Si hay más de un método HTTP configurado para la API, repite estos pasos para cada método.
3. En el panel Ejecución de método, elige Solicitud de método y, a continuación, elige Editar.
4. Expande la lista desplegable Parámetros de cadenas de consulta de URL y, a continuación, selecciona Agregar cadena de consulta.
5. En el campo Nombre, escribe tipo y, a continuación, selecciona Guardar.
6. Selecciona la pestaña Solicitud de integración y, a continuación, elige Editar.
7. Expande la sección Parámetros de cadenas de consulta de URL.
8. En el campo Nombre, escribe tipo.
9. En Mapeado de, escribe method.request.querystring.type.
10. Selecciona Guardar y, a continuación, selecciona Desplegar la API.
11. Para probar el nuevo punto de enlace de la API, ejecuta el siguiente comando curl:

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

Importante: Asegúrate de que el comando curl tenga el parámetro de cadena de consulta mascota=perro.

Información relacionada

Tutorial: Creación de una API de REST con una integración de proxy de Lambda

Tutorial: Creación de una API de REST con una integración no de proxy de Lambda

Tutorial: Creación de una API de REST con integración de proxy HTTP

Tutorial: Creación de una API de REST con integración no de proxy HTTP