创建Queue
功能介绍
创建Queue。
URI
PUT /v2/rabbitmq/{project_id}/instances/{instance_id}/vhosts/{vhost}/queues
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID，获取方式请参见获取项目ID。 |
| instance_id | 是 | String | 实例ID |
| vhost | 是 | String | vhost名称，名称中包含/时，需要将/替换为__F_SLASH__，否则会调用失败。例如：Vhost名称为/test，入参值为__F_SLASH__test。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| name | 是 | String | Queue名称 |
| auto_delete | 是 | Boolean | 是否自动删除 |
| durable | 否 | Boolean | 是否持久化 |
| dead_letter_exchange | 否 | String | 死信Exchange名称，消息被拒绝或过期时将重新发布到该Exchange。 |
| dead_letter_routing_key | 否 | String | 死信Exchange的RoutingKey，死信Exchange会发送死信消息到绑定对应RoutingKey的Queue上。 |
| message_ttl | 否 | Long | 发布到Queue的消息在被丢弃之前可以存活多长时间 |
| lazy_mode | 否 | String | 若设置惰性队列，请输入lazy。惰性队列模式会在磁盘上存储尽可能多的消息以减少内存使用；若不设置，队列将消息存储在内存缓存以尽可能快地传递消息。 |
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| name | String | Queue名称 |
| auto_delete | Boolean | 是否自动删除 |
| durable | Boolean | 是否持久化 |
| dead_letter_exchange | String | 死信Exchange名称，消息被拒绝或过期时将重新发布到该Exchange。 |
| dead_letter_routing_key | String | 死信Exchange的RoutingKey，死信Exchange会发送死信消息到绑定对应RoutingKey的Queue上。 |
| message_ttl | Long | 发布到Queue的消息在被丢弃之前可以存活多长时间 |
| lazy_mode | String | 若设置惰性队列，请输入lazy。惰性队列模式会在磁盘上存储尽可能多的消息以减少内存使用；若不设置，队列将消息存储在内存缓存以尽可能快地传递消息。 |
请求示例
创建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成功 |
错误码
请参见错误码。
