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

Request

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

  • 请求行

    PUT /$queueName?metaoverride=true HTTP/1.1

  • URI参数

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

  • 特有Request Header

    无，请参见公共参数。

  • Request Body

    Request Body为XML格式，XML中包含创建Queue的属性，这些属性都为可选属性。

参数名称 说明 参数值
DelaySeconds 发送到该Queue的所有消息默认将以DelaySeconds参数指定的秒数延后可被消费，单位为秒。 0s~604800s（7 天）范围内某个整数值，默认值为0s。
MaximumMessageSize 发送到该Queue的消息体的最大长度，单位为Byte。 1024（1 KB）~65536（64 KB）范围内的某个整数值，默认值为65536（64 KB）。
MessageRetentionPeriod 消息在该Queue中最长的存活时间，从发送到该队列开始经过此参数指定的时间后，不论消息是否被取出过都将被删除，单位为秒。 60s（1 分钟）~604800s（7 天）范围内某个整数值，默认值为259200s（3 天）。
VisibilityTimeout 消息从该Queue中取出后从Active状态变成 Inactive 状态后的持续时间，单位为秒。 1s~43200s（12 小时）范围内的某个值整数值，默认值为30s。
PollingWaitSeconds 当Queue消息量为空时，针对该Queue的ReceiveMessage请求最长的等待时间，单位为秒。 0s~30s范围内的某个整数值，默认值为0s。

Response

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

  • HTTP Status Code

    HTTP/1.1 204 No Content

  • 特有Response Header

    无，请参见公共参数。

  • Response Body

    无。

Special Error

错误代码 错误消息 状态码
InvalidArgument The value of Element should between Low and High seconds/bytes. 400
QueueNotExist The queue name you provided is not exist. 404
  • 请求示例 
        PUT /$queueName?metaoverride=true HTTP/1.1
    Host: $AccountId.mqs-cn-hangzhou.aliyuncs.com
    Date: Wed, 08 Mar 2012 12:00:00 GMT
    x-mqs-version: 2014-07-08
    Authorization: MQS 15B4D3461F177624206A:xQE0diMbLRepdf3YB+FIEXAMPLE=

    <?xml version="1.0" encoding="UTF-8" ?>
    <Queue xmlns=”http://mqs.aliyuncs.com/doc/v1/”>
    <VisibilityTimeout >60</VisibilityTimeout>
    <MaximumMessageSize>1024</MaximumMessageSize>
    <MessageRetentionPeriod>120</MessageRetentionPeriod>
    <DelaySeconds>30</DelaySeconds>
    </Queue>
  • 返回示例 
        HTTP/1.1 204 No Content
    x-mqs-request-id:512B2A634403E52B1956133E 
    x-mqs-version:2015-06-06