开发者社区> 问答> 正文

API如何修改消息可见时间?



基本信息

NameValue
[backcolor=transparent]APIChangeMessageVisibility
[backcolor=transparent]RAM授权操作mns:ChangeMessageVisibility
[backcolor=transparent]资源acs:mns:$region:$accountid:/queues/$queueName/messages


描述


该接口用于修改被消费过并且还处于的 Inactive 的消息到下次可被消费的时间,成功修改消息的 VisibilityTimeout 后,返回新的 ReceiptHandle。

Request


Request的构造主要由以下几个部分组成:

  • 请求行

    PUT /queues/$queueName/messages?receiptHandle=<receiptHandle>&visibilityTimeout=<visibilitytimeout> HTTP/1.1

  • URI参数
参数名称说明选项
ReceiptHandle上次消费后返回的消息 ReceiptHandle ,详见 ReceiveMessage 接口Required
VisibilityTimeout从现在到下次可被用来消费的时间间隔,单位为秒Required

  • 特有Request Header

    无,请参考 [backcolor=transparent]调用方式/公共参数

  • Request Body



Response


返回消息由返回状态行,HTTP头和消息体三部分组成。

  • HTTP Status Code

    HTTP/1.1 200 OK

  • 特有Response Header

    无,请参考 [backcolor=transparent]调用方式/公共参数

  • Response Body
参数名称说明
ReceiptHandle本次修改消息 VisibilityTimeout 时间返回的临时句柄,用于删除和修改处于 Inactive 消息,在 NextVisibleTime 时刻之前有效。
NextVisibleTime下次可被再次消费的时间,从1970年1月1日 00:00:00 000 开始的毫秒数。


Special Error

错误代码错误消息状态码
QueueNotExistThe queue name you provided is not exist.404
InvalidArgumentThe value of Element should between Low and High seconds/bytes.400
MessageNotExistMessage not exist.404

[backcolor=transparent]请求示例:
[backcolor=transparent]

展开
收起
轩墨 2017-10-24 15:37:41 1828 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
CUDA MATH API 立即下载
API PLAYBOOK 立即下载
传统企业的“+互联网”-API服务在京东方的实践 立即下载