基本信息
描述
该接口用于发送消息到指定的队列,普通消息发送到队列随即可被消费者消费。但是如果生产者发送一个消息不想马上被消费者消费(典型的使用场景为定期任务),生产者在发送消息时设置 DelaySeconds 参数就可以达到此目的。发送带 DelaySeconds 参数值大于0的消息初始状态为 Delayed,此时消息不能被消费者消费,只有等 DelaySeconds 时间后消息变成 Active 状态后才可消费。
[backcolor=transparent]Tip:
发送消息时指定 DelaySeconds 参数的优先级高于延时队列的 DelaySeconds 属性,即两个 DelaySeconds 属性设置的值不同时以发送消息时指定的值为准。
Request
Request的构造主要由以下几个部分组成:
请求行
POST /queues/$queueName/messages HTTP/1.1
特有Request Header
无,请参考 [backcolor=transparent]调用方式/公共参数
Request Body
Request Body为XML格式,其中包含创建Message的属性。
Response
返回消息由返回状态行,HTTP头和消息体三部分组成。
HTTP Status Code
HTTP/1.1 201 Created
特有Response Header
无,请参考 [backcolor=transparent]调用方式/公共参数
Response Body
返回的结果为XML格式,返回 Message 的 MessageId 和 MessageBodyMD5 子元素。
Special Error
[tr=rgb(239, 251, 255)][td]InvalidArgument
The value of Element should between Low and High seconds/bytes. | 400 |
[backcolor=transparent]请求示例:
[backcolor=transparent]