调用CreateQueue创建Queue。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

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

系统规定参数。取值:CreateQueue

InstanceId String amqp-cn-v0h1kb9nu***

实例ID。

VirtualHost String test

Vhost名称。

只能包含字⺟、数字、短划线(-)、下划线(_)、半角句号(.)、井号(#)、正斜线(/)、at符号(@),⻓度限制1~255字符。

QueueName String DemoQueue

队列名称。

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

是否自动删除。取值:

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

是否为排他性Exchange。取值:

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

消息在Queue中的有效期。

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

只能包含字⺟、数字、短划线(-)、下划线(_)、半角句号(.)、井号(#)、正斜线(/)、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***"
}

错误码

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