调用CreateQueue创建Queue。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | CreateQueue | 系统规定参数。取值:CreateQueue。 |
InstanceId | String | 是 | amqp-cn-v0h1kb9nu*** | 实例ID。 |
VirtualHost | String | 是 | test | Vhost名称。 只能包含字⺟、数字、短划线(-)、下划线(_)、半角句号(.)、井号(#)、正斜线(/)、at符号(@),⻓度限制1~255字符。 |
QueueName | String | 是 | DemoQueue | 队列名称。
|
AutoDeleteState | Boolean | 否 | false | 是否自动删除。取值:
|
ExclusiveState | Boolean | 否 | false | 是否为排他性Exchange。取值:
|
MessageTTL | Long | 否 | 1000 | 消息在Queue中的有效期。
|
AutoExpireState | Long | 否 | 10000 | Queue的自动过期时间。如果Queue在指定时间内没有被访问,则会被自动删除。 单位为毫秒。 说明 该参数对应的功能需要开通后才能使用。如需使用,请提交工单开通。 |
MaxLength | Long | 否 | 1000 | 当前版本不支持该参数。 Queue中消息的最大数量。如果超出该数量,则先到达该Queue的消息将会被删除。 |
DeadLetterExchange | String | 否 | DLExchange | 死信Exchange。该类Exchange是用来接收被拒绝的消息。 如果消费端拒绝一个不重新发送的消息,那么消息队列RabbitMQ版将会把消息路由到指定的死信Exchange,该Exchange再将消息路由到绑定的Queue进行存储。 |
DeadLetterRoutingKey | String | 否 | test.dl | 死信Routing Key。 只能包含字⺟、数字、短划线(-)、下划线(_)、半角句号(.)、井号(#)、正斜线(/)、at符号(@),⻓度限制1~255字符。 |
MaximumPriority | Integer | 否 | 10 | 不支持优先级功能。取值不影响调用和返回结果。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | 59B52E2C-0B8E-44EC-A314-D0314A50*** | 请求ID。 |
示例
请求示例
http(s)://amqp-open.cn-hangzhou.aliyuncs.com/?Action=CreateQueue
&InstanceId=amqp-cn-v0h1kb9nu***
&MaxLength=1000
&QueueName=DemoQueue
&RegionId=cn-hangzhou
&VirtualHost=test
&<公共请求参数>
正常返回示例
XML
格式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateQueueResponse>
<RequestId>59B52E2C-0B8E-44EC-A314-D0314A50***</RequestId>
</CreateQueueResponse>
JSON
格式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "59B52E2C-0B8E-44EC-A314-D0314A50***"
}
错误码
访问错误中心查看更多错误码。