调用CreateQueue创建Queue。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateQueue

要执行的操作。取值:

CreateQueue

InstanceId String amqp-cn-v0h1kb9nu***

实例ID。

QueueName String DemoQueue

队列名称。

  • Queue名称只能包含字母、数字、短划线(-)、下划线(_)、半角句号(.)、井号(#)、正斜线(/)、at符号(@),长度限制1~255字符。
  • Queue创建后,名称无法修改,只能删除后重建。
RegionId String cn-hangzhou

地域ID。

VirtualHost String test

Vhost名称。

AutoDeleteState Boolean false

是否自动删除。取值:

  • true:是。如果订阅该Queue的最后一个消费端取消订阅后,那么该Queue将会自动删除。
  • false:否。
ExclusiveState Boolean false

是否为排他性Exchange。取值:

  • true:是。只能被声明该排他性Exchange的Connection使用。该Connection断开后该排他性Exchange自动删除。
  • false:否。
MessageTTL Long 1000

消息在Queue中的有效期。

  • 某条消息在Queue中的留存时间超过配置的消息存活时间时,则该消息过期。
  • 消息存活时间的值必须为非负整型数,单位为毫秒。例如,某条消息的存活时间的值是1000,则代表该消息最多会在Queue中存活1秒。
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。

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格式

<CreateQueueResponse>
      <RequestId>59B52E2C-0B8E-44EC-A314-D0314A50***</RequestId>
</CreateQueueResponse>

JSON格式

{
    "RequestId":"59B52E2C-0B8E-44EC-A314-D0314A50***"
}

错误码

访问错误中心查看更多错误码。