开发者社区> 问答> 正文

API如何设置队列属性?



基本信息

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


描述


该接口用于修改消息队列的属性。

Request


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

  • 请求行

    PUT /queues/$queueName?metaoverride=true HTTP/1.1

  • URI参数

    metaoverride=true将会修改消息队列的属性

  • 特有Request Header

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

  • Request Body

    Request Body 为 XML 格式,XML 中包含创建 Queue 的属性,这些属性都为可选属性。
参数名称说明参数值
DelaySeconds发送到该 Queue 的所有消息默认将以 DelaySeconds 参数指定的秒数延后可被消费,单位为秒。0-604800秒(7天)范围内某个整数值
MaximumMessageSize发送到该 Queue 的消息体的最大长度,单位为 Byte。1024(1KB)-65536(64KB)范围内的某个整数值
MessageRetentionPeriod消息在该 Queue 中最长的存活时间,从发送到该队列开始经过此参数指定的时间后,不论消息是否被取出过都将被删除,单位为秒。60 (1分钟)-1296000 (15 天)范围内某个整数值
VisibilityTimeout消息从该 Queue 中取出后从 Active 状态变成 Inactive 状态后的持续时间,单位为秒。1-43200(12小时)范围内的某个值整数值
PollingWaitSeconds当Queue消息量为空时,针对该 Queue 的 ReceiveMessage 请求最长的等待时间,单位为秒。0-30秒范围内的某个整数值
LoggingEnabled是否开启日志管理功能,True表示启用,False表示停用True/False


Response


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

  • HTTP Status Code

    HTTP/1.1 204 No Content

  • 特有Response Header

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

  • Response Body



Special Error

错误代码错误消息状态码
InvalidArgumentThe value of Element should between Low and High seconds/bytes.400
[tr=rgb(239, 251, 255)][td]QueueNotExist The queue name you provided is not exist.404
[backcolor=transparent]请求示例:
[backcolor=transparent]

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

相关电子书

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