Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
Integre Amazon API Gateway con Amazon SQS para gestionar el REST asíncrono APIs
Creado por Natalia Colantonio Favero (AWS) y Gustavo Martim (AWS)
Resumen
Al implementar REST APIs, a veces es necesario exponer una cola de mensajes que las aplicaciones cliente puedan publicar. Por ejemplo, es posible que tenga problemas con la latencia de terceros APIs y que se produzcan retrasos en las respuestas, o puede que desee evitar el tiempo de respuesta de las consultas a la base de datos o escalar el servidor cuando hay un gran número de consultas APIs simultáneas. En estos escenarios, las aplicaciones cliente que publican en la cola solo necesitan saber que la API ha recibido los datos, no lo que ocurre después de recibirlos.
Este patrón crea un punto final de la API REST mediante Amazon API Gateway
Requisitos previos y limitaciones
Arquitectura

El diagrama ilustra estos pasos:
Solicita un punto final de la API REST POST mediante una herramienta como Postman, otra API u otras tecnologías.
API Gateway publica un mensaje, que se recibe en el cuerpo de la solicitud, en la cola.
Amazon SQS recibe el mensaje y envía una respuesta a API Gateway con un código de éxito o error.
Herramientas
Amazon API Gateway le ayuda a crear, publicar, mantener, supervisar y proteger REST, HTTP y WebSocket APIs a cualquier escala.
AWS Identity and Access Management (IAM) le ayuda a administrar de forma segura el acceso a sus AWS recursos al controlar quién está autenticado y autorizado a usarlos.
Amazon Simple Queue Service (Amazon SQS) ofrece una cola alojada segura, duradera y disponible que le permite integrar y desacoplar sistemas y componentes de software distribuidos.
Epics
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Creación de una cola. | Para crear una cola de SQS que reciba los mensajes de la API REST:
| Desarrollador de aplicaciones |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Crear un rol de IAM. | Esta función de IAM proporciona a los recursos de API Gateway acceso total a Amazon SQS.
| Desarrollador de aplicaciones, administrador de AWS |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Cree una API REST. | Esta es la API REST a la que se envían las solicitudes HTTP.
| Desarrollador de aplicaciones |
Conecte API Gateway a Amazon SQS. | Este paso permite que el mensaje fluya desde el interior del cuerpo de la solicitud HTTP hasta Amazon SQS.
| Desarrollador de aplicaciones |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Pruebe la API REST. | Ejecute una prueba para comprobar si falta alguna configuración:
| Desarrollador de aplicaciones |
Cambie la integración de la API para reenviar la solicitud correctamente a Amazon SQS. | Complete la configuración para corregir el error de integración:
| Desarrollador de aplicaciones |
Pruebe y valide el mensaje en Amazon SQS. | Realice una prueba para confirmar que la prueba se completó correctamente:
| Desarrollador de aplicaciones |
Pruebe API Gateway con un carácter especial. | Realiza una prueba que incluya caracteres especiales (como &) que no sean aceptables en un mensaje:
Esto se debe a que los caracteres especiales no se admiten de forma predeterminada en el cuerpo del mensaje. En el siguiente paso, configurará API Gateway para que admita caracteres especiales. Para obtener más información sobre las conversiones de tipos de contenido, consulta la documentación de API Gateway. | Desarrollador de aplicaciones |
Cambie la configuración de la API para que admita caracteres especiales. | Ajuste la configuración para que acepte caracteres especiales en el mensaje:
El nuevo mensaje debe incluir el carácter especial. | Desarrollador de aplicaciones |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Implementar la API. |
Para implementar la API REST:
| Desarrollador de aplicaciones |
Realice la prueba con una herramienta externa. | Realice una prueba con una herramienta externa para confirmar que el mensaje se ha recibido correctamente:
| Desarrollador de aplicaciones |
Tarea | Descripción | Habilidades requeridas |
---|---|---|
Elimine la API. | En la consola de API Gateway | Desarrollador de aplicaciones |
Eliminación del rol de IAM. | En la consola de IAM | Desarrollador de aplicaciones |
Elimine la cola de SQS. | En la consola Amazon SQS | Desarrollador de aplicaciones |
Recursos relacionados
SQS- SendMessage (documentación de API Gateway)
Conversiones de tipos de contenido en API Gateway (documentación de API Gateway)
variables $util (documentación de API Gateway)
¿Cómo puedo integrar una API REST de API Gateway con Amazon SQS y resolver los errores más comunes?
(Artículo de AWS Re:POST)