Skip to main content
POST
Enviar un mensaje
Requiere la acción IAM queue:SendMessage. Consulte QUEUE permisos para la lista completa, el alcance de cada acción y un ejemplo de política.

Autorizaciones

Authorization
string
header
requerido

Un token bearer de OAuth 2.0, enviado como Authorization: Bearer <token>. Esta es la forma recomendada de autenticación.

Obtén el token intercambiando el par de claves de acceso de una cuenta de servicio en POST /v1/oauth/token con grant_type=client_credentials. Es el flujo estándar de credenciales de cliente; las bibliotecas compatibles con OAuth pueden obtener y renovar el token por ti.

Los tokens duran una hora por defecto. El mismo par de claves de acceso también sirve como credencial AWS SigV4 para el endpoint de objetos compatible con S3, que solo acepta ese método de autenticación.

Parámetros de ruta

queue_id
string<uuid>
requerido
Ejemplo:

"a1b2c3d4-5e6f-4a7b-8c9d-0e1f2a3b4c5d"

Cuerpo

application/json
body
string
requerido

Contenido del mensaje. Se suma a los atributos en el límite max_message_bytes de la cola.

Ejemplo:

"{\"order_id\":\"A-1001\"}"

attributes
object

Atributos tipados enviados con el cuerpo. Hasta 20, con valores de hasta 1024 caracteres. Los valores Binary usan base64 estándar. La cola valida el tipo declarado sin convertir valores.

Ejemplo:
delay_seconds
integer

Sustituye el valor predeterminado de la cola solo en este mensaje. Se rechaza en FIFO para no hacer visible un mensaje posterior antes de otro del mismo grupo.

Rango requerido: 0 <= x <= 900
Ejemplo:

0

message_group_id
string

Obligatorio en FIFO y rechazado en colas estándar. Los mensajes del mismo grupo se entregan en orden; el siguiente espera mientras el anterior está en proceso.

Maximum string length: 128
Ejemplo:

"customer-42"

message_deduplication_id
string

Solo FIFO. Una repetición en cinco minutos se suprime y devuelve el ID original. Omítalo en colas con content_based_deduplication para derivar el identificador del cuerpo.

Maximum string length: 128
Ejemplo:

"order-A-1001"

Respuesta

Mensaje encolado. En FIFO, una entrada de deduplicación activa mantiene el envío correcto, con duplicate true y el ID del mensaje original.

result
object
requerido