本接口用于修改被消费过并且还处于Inactive状态的消息到下次可被消费的时间,成功修改消息的VisibilityTimeout后,返回新的ReceiptHandle。
Request
Request的构造主要由以下几个部分组成:
- 请求行
PUT /$queueName/messages?receiptHandle=<receiptHandle>&visibilityTimeout=<visibilitytimeout> HTTP/1.1
- URI参数
参数名称 说明 选项 ReceiptHandle 上次消费后返回的消息ReceiptHandle,请参见ReceiveMessage。 Required VisibilityTimeout 从现在到下次可被用来消费的时间间隔,单位为秒。 Required - 特有Request Header
无,请参见公共参数。
- Request Body
无。
Response
返回消息由返回状态行、HTTP头和消息体三部分组成:
- HTTP Status Code
HTTP/1.1 200 OK
- 特有Response Header
无,请参见公共参数。
- Response Body
参数名称 说明 ReceiptHandle 本次修改消息VisibilityTimeout时间返回的临时句柄,用于删除和修改处于Inactive消息,在NextVisibleTime时刻之前有效。 NextVisibleTime 下次可被再次消费的时间,从1970年1月1日0点整开始的毫秒数。
Special Error
错误代码 | 错误消息 | 状态码 |
---|---|---|
QueueNotExist | The queue name you provided is not exist. | 404 |
InvalidArgument | The value of Element should between Low and High seconds/bytes. | 400 |
MessageNotExist | Message not exist. | 404 |
- 请求示例
PUT /queueName/messages ?receiptHandle=MbZj6wDWli+QEauMZc8ZRv37sIW2iJKq3M9Mx/KSbkJ0&visibilityTimeout=50 HTTP/1.1 Host: $AccountId.mqs-cn-hangzhou.aliyuncs.com Date: Wed, 28 May 2012 22:32:00 GMT x-mqs-version: 2014-07-08 Authorization: MQS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE
- 返回示例
HTTP/1.1 200OK x-mqs-request-id:512B2A634403E52B1956133E x-mqs-version: 2015-06-06 <?xml version="1.0” encoding=”UTF-8” ?> <Message xmlns=”http://mqs.aliyuncs.com/doc/v1/”> <ReceiptHandle>TbZj6wDWli+9CEauMZc8ZRv37sIW2iJKq3M9Mx/TS1</ReceiptHandle > <NextVisibleTime>1250700979298000</NextVisibleTime> </Message>