Skip to main content
POST
Enviar uma mensagem
Exige a ação IAM queue:SendMessage. Veja QUEUE permissões para a lista completa, o escopo de cada ação e um exemplo de política.

Autorizações

Authorization
string
header
obrigatório

Um token bearer OAuth 2.0, enviado como Authorization: Bearer <token>. Esta é a forma recomendada de autenticação.

Obtenha o token trocando o par de chaves de acesso de uma conta de serviço em POST /v1/oauth/token com grant_type=client_credentials. Esse é o fluxo padrão de credenciais de cliente; bibliotecas compatíveis com OAuth podem obter e renovar o token para você.

Os tokens duram uma hora por padrão. O mesmo par de chaves de acesso também serve como credencial AWS SigV4 para o endpoint de objetos compatível com S3, que aceita somente esse método de autenticação.

Parâmetros de caminho

queue_id
string<uuid>
obrigatório
Exemplo:

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

Corpo

application/json
body
string
obrigatório

Conteúdo da mensagem. Soma-se aos atributos no limite max_message_bytes da fila.

Exemplo:

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

attributes
object

Atributos tipados enviados com o corpo. Até 20, com valores de até 1024 caracteres. Valores Binary usam base64 padrão. A fila valida o tipo declarado sem converter valores.

Exemplo:
delay_seconds
integer

Substitui o padrão da fila somente nesta mensagem. Rejeitado em FIFO para não tornar uma mensagem posterior visível antes de outra do mesmo grupo.

Intervalo obrigatório: 0 <= x <= 900
Exemplo:

0

message_group_id
string

Obrigatório em FIFO e rejeitado em filas padrão. Mensagens do mesmo grupo são entregues em ordem; a próxima espera enquanto a anterior está em processamento.

Maximum string length: 128
Exemplo:

"customer-42"

message_deduplication_id
string

Somente FIFO. Uma repetição em cinco minutos é suprimida e retorna o ID original. Omita em filas com content_based_deduplication para derivar o identificador do corpo.

Maximum string length: 128
Exemplo:

"order-A-1001"

Resposta

Mensagem enfileirada. Em FIFO, uma entrada de deduplicação ativa mantém o envio bem-sucedido, com duplicate true e o ID da mensagem original.

result
object
obrigatório