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.
Realización de solicitudes de API de consulta mediante el protocolo AWS JSON en Amazon SQS
En esta sección, aprenderá a crear un punto de conexión de Amazon SQS, a crear solicitudes POST y a interpretar las respuestas.
nota
El protocolo AWS JSON es compatible con la mayoría de las variantes de lenguaje. Para ver una lista completa de las variantes de lenguaje admitidas, consulte ¿Qué lenguajes son compatibles con el protocolo AWS JSON que se utiliza en las API de Amazon SQS?.
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 se denominan MyQueue y una tiene el punto de conexión sqs.us-east-2.amazonaws.com mientras que la otra tiene el punto de conexión sqs.eu-west-2.amazonaws.com, no comparten ningún dato entre ellas.
A continuación, se muestra un ejemplo de un punto de conexión que realiza una solicitud para crear una cola.
POST / HTTP/1.1
Host: sqs.us-west-2.amazonaws.com
X-Amz-Target: AmazonSQS.CreateQueue
X-Amz-Date: <Date>
Content-Type: application/x-amz-json-1.0
Authorization: <AuthParams>
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive
{
"QueueName":"MyQueue",
"Attributes": {
"VisibilityTimeout": "40"
},
"tags": {
"QueueType": "Production"
}
}nota
Los nombres y las URL de las colas distinguen entre mayúsculas y minúsculas.
La estructura de AUTHPARAMS
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 un encabezado HTTP con X-Amz-Target establecido a AmazonSQS.<operationName> y de un encabezado HTTP con Content-Type establecido a application/x-amz-json-1.0.
POST / HTTP/1.1
Host: sqs.<region>.<domain>
X-Amz-Target: AmazonSQS.SendMessage
X-Amz-Date: <Date>
Content-Type: application/x-amz-json-1.0
Authorization: <AuthParams>
Content-Length: <PayloadSizeBytes>
Connection: Keep-Alive
{
"QueueUrl": "https://sqs.<region>.<domain>/<awsAccountId>/<queueName>/",
"MessageBody": "This is a test message"
}Esta solicitud HTTP POST envía un mensaje a una cola de Amazon SQS.
nota
Ambos encabezados HTTP X-Amz-Target y Content-Type son obligatorios.
El cliente HTTP puede añadir otros elementos a la solicitud HTTP, según la versión de HTTP del cliente.
