本接口用于修改消息队列的属性。
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