创建Queue
功能介绍
创建Queue。
调用方法
请参见如何调用API。
URI
PUT /v2/rabbitmq/{project_id}/instances/{instance_id}/vhosts/{vhost}/queues
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID，获取方式请参见获取项目ID。 |
instance_id |
是 |
String |
实例ID |
vhost |
是 |
String |
Vhost名称 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
name |
是 |
String |
Queue名称 |
auto_delete |
是 |
Boolean |
是否自动删除 |
durable |
否 |
Boolean |
是否持久化（AMQP版本默认持久化，不涉及此字段） |
dead_letter_exchange |
否 |
String |
死信Exchange名称，消息被拒绝或过期时将重新发布到该Exchange。 |
dead_letter_routing_key |
否 |
String |
死信Exchange的RoutingKey，死信Exchange会发送死信消息到绑定对应RoutingKey的Queue上。 |
message_ttl |
否 |
Long |
发布到Queue的消息在被丢弃之前可以存活多长时间 |
lazy_mode |
否 |
String |
若设置惰性队列，请输入lazy。惰性队列模式会在磁盘上存储尽可能多的消息以减少内存使用；若不设置，队列将消息存储在内存缓存以尽可能快地传递消息。（AMQP版本默认将消息存储到磁盘，不涉及此字段） |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
name |
String |
Queue名称 |
auto_delete |
Boolean |
是否自动删除 |
durable |
Boolean |
是否持久化（AMQP版本默认持久化，不涉及此字段） |
dead_letter_exchange |
String |
死信Exchange名称，消息被拒绝或过期时将重新发布到该Exchange。 |
dead_letter_routing_key |
String |
死信Exchange的RoutingKey，死信Exchange会发送死信消息到绑定对应RoutingKey的Queue上。 |
message_ttl |
Long |
发布到Queue的消息在被丢弃之前可以存活多长时间 |
lazy_mode |
String |
若设置惰性队列，请输入lazy。惰性队列模式会在磁盘上存储尽可能多的消息以减少内存使用；若不设置，队列将消息存储在内存缓存以尽可能快地传递消息。（AMQP版本默认将消息存储到磁盘，不涉及此字段） |
请求示例
创建Queue
PUT https://{endpoint}/v2/rabbitmq/{project_id}/instances/{instance_id}/vhosts/{vhost}/queues
{
"name" : "string",
"auto_delete" : true,
"durable" : true,
"dead_letter_exchange" : "string",
"dead_letter_routing_key" : "string",
"message_ttl" : 6000,
"lazy_mode" : "string"
}
响应示例
状态码： 200
创建Queue成功
{
"name" : "string",
"auto_delete" : true,
"durable" : true,
"dead_letter_exchange" : "string",
"dead_letter_routing_key" : "string",
"message_ttl" : 60000,
"lazy_mode" : "string"
}
状态码
状态码 |
描述 |
|---|---|
200 |
创建Queue成功 |
错误码
请参见错误码。
