Configuración de una integración de proxy con un recurso de proxy - Amazon API Gateway

Configuración de una integración de proxy con un recurso de proxy

Para configurar una integración de proxy en una API de API Gateway con un recurso de proxy, realice las tareas siguientes:

  • Crear un recurso de proxy con la variable de ruta expansiv {proxy+}.

  • Establecer el método ANY en el recurso de proxy

  • Integrar el recurso y el método con un backend mediante el tipo de integración HTTP o Lambda.

nota

Las variables de ruta expansiva, los métodos ANY y los tipos de integración de proxy son características independientes, aunque se utilizan normalmente juntas. Puede configurar un método HTTP específico en un recurso expansivo o aplicar tipos de integración distintos de proxy en un recurso de proxy.

API Gateway establece determinadas restricciones y limitaciones al manipular métodos con una integración de proxy de Lambda o una integración de proxy HTTP. Para obtener información, consulte Notas importantes de Amazon API Gateway.

nota

Cuando se utiliza la integración de proxy con acceso directo, API Gateway devuelve el encabezado predeterminado Content-Type:application/json si no se especifica el tipo de contenido de una carga.

Un recurso de proxy es más eficaz cuando se integra con un backend que usa la integración de proxy HTTP o la integración de proxy de Lambda.

Integración de proxy HTTP con un recurso de proxy

La integración de proxy HTTP, designada por HTTP_PROXY en la API REST de API Gateway, es para la integración de una solicitud de método con un punto de enlace HTTP del backend. Con este tipo de integración, API Gateway simplemente transmite toda la solicitud y la respuesta entre el frontend y el backend, aunque esto está sujeto a determinadas restricciones y limitaciones.

nota

La integración de proxy HTTP admite encabezados y cadenas de consulta con varios valores.

Cuando aplica la integración de proxy HTTP a un recurso de proxy, puede configurar la API para que exponga una parte o la totalidad de la jerarquía del punto de enlace del backend HTTP con una sola integración configurada. Supongamos, por ejemplo, que el backend del sitio web está organizado en varias ramas de nodos de árbol desde el nodo raíz (/site) como: /site/a0/a1/.../aN, /site/b0/b1/.../bM, etc. Si integra el método ANY en un recurso de proxy de /api/{proxy+} con los puntos de enlace del backend con rutas URL de /site/{proxy}, una sola solicitud de integración puede admitir todas las operaciones HTTP (GET, POST, etc.) en cualquiera de [a0, a1, ..., aN, b0, b1, ...bM, ...]. Si aplica una integración de proxy a un método HTTP específico (por ejemplo, GET), en su lugar, la solicitud de integración resultante funcionará con las operaciones especificadas (es decir, GET) en cualquiera de los nodos del backend.

Integración de proxy de Lambda con un recurso de proxy

La integración de proxy de Lambda, designada por AWS_PROXY en la API REST de API Gateway, es para la integración de una solicitud de método con una función de Lambda en el backend. Con este tipo de integración, API Gateway aplica una plantilla de mapeo predeterminada para enviar toda la solicitud a la función de Lambda y transforma la salida de la función de Lambda en respuestas HTTP.

Del mismo modo, puede aplicar la integración de proxy de Lambda a un recurso proxy de /api/{proxy+} para configurar una sola integración, si desea que la función de Lambda del backend reaccione individualmente a los cambios que se produzcan en cualquiera de los recursos de la API bajo /api.