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.
Realizar solicitudes de API de AWS consultas mediante el protocolo de consultas en Amazon SQS
En esta sección, aprenderá a crear un punto de conexión de Amazon SQS, a crear solicitudes GET y POST y a interpretar las respuestas.
Temas
Construcción de un punto de enlace
Para trabajar con colas de Amazon SQS, debe crear un punto de conexión. Para obtener información sobre los puntos de conexión de Amazon SQS, consulte las páginas siguientes en Referencia general de Amazon Web Services:
Cada punto de conexión de Amazon SQS es independiente. Por ejemplo, si dos colas tienen un nombre MyQueuey una tiene el punto final sqs.us-east-2.amazonaws.com mientras que la otra tiene el punto finalsqs.eu-west-2.amazonaws.com, las dos colas no comparten ningún dato entre sí.
A continuación se muestra un ejemplo de un punto de enlace que realiza una solicitud para crear una cola.
https://sqs.eu-west-2.amazonaws.com/
?Action=CreateQueue
&DefaultVisibilityTimeout=40
&QueueName=MyQueue
&Version=2012-11-05
&AUTHPARAMSnota
Los nombres y las URL de las colas distinguen entre mayúsculas y minúsculas.
La estructura de AUTHPARAMS
Realizar una solicitud GET
Una solicitud GET de Amazon SQS se estructura como una URL que consta de los siguientes elementos:
-
Punto de conexión: el recurso sobre el que actúa la solicitud (el nombre y la URL de la cola); por ejemplo,
https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue -
Acción: la acción que se desea realizar en el punto de conexión. Se utiliza un signo de interrogación (
?) para separar el punto de enlace de la acción; por ejemplo,?Action=SendMessage&MessageBody=Your%20Message%20Text -
Parámetros: los parámetros de la solicitud. Cada parámetro está separado del siguiente por el signo
&; por ejemplo,&Version=2012-11-05&AUTHPARAMS
A continuación se muestra un ejemplo de una solicitud GET que envía un mensaje a una cola de Amazon SQS.
https://sqs.us-east-2.amazonaws.com/123456789012/MyQueue
?Action=SendMessage&MessageBody=Your%20message%20text
&Version=2012-11-05
&AUTHPARAMSnota
Los nombres y las URL de las colas distinguen entre mayúsculas y minúsculas.
Como las solicitudes GET son direcciones URL, debe codificar como URL los valores de todos los parámetros. Debido a que en las URL no se permiten los espacios en blanco, que cada espacio se codifica en la URL como %20. El resto del ejemplo no se ha codificado como URL para facilitar su lectura.
Realizar una solicitud POST
Las solicitudes POST de Amazon SQS envían parámetros de consulta como un formulario en el cuerpo de una solicitud HTTP.
A continuación, se muestra un ejemplo de encabezado HTTP con Content-Type establecido a application/x-www-form-urlencoded.
POST /123456789012/MyQueue HTTP/1.1
Host: sqs.us-east-2.amazonaws.com
Content-Type: application/x-www-form-urlencodedAl encabezado le sigue una solicitud GET de form-urlencoded que envía un mensaje a una cola de Amazon SQS. Cada parámetro está separado del siguiente por un signo ampersand (&).
Action=SendMessage
&MessageBody=Your+Message+Text
&Expires=2020-10-15T12%3A00%3A00Z
&Version=2012-11-05
&AUTHPARAMSnota
Solo es obligatorio el encabezado de HTTP Content-Type. El parámetro AUTHPARAMS
El cliente HTTP puede añadir otros elementos a la solicitud HTTP, según la versión de HTTP del cliente.
