Querying Specified Queue Details
Function
This API is used to query details of a specified queue.
Calling Method
For details, see Calling APIs.
URI
GET /v2/rabbitmq/{project_id}/instances/{instance_id}/vhosts/{vhost}/queues/{queue}
Parameter | Mandatory | Type | Description |
|---|---|---|---|
project_id | Yes | String | Definition Project ID. For details, see Obtaining a Project ID. Constraints N/A Range N/A Default Value N/A |
instance_id | Yes | String | Definition: Instance ID. You can call the API for querying all instances to obtain the instance ID. The instance ID is in the response body. Constraints: N/A Range: N/A Default Value: N/A |
vhost | Yes | String | Definition: Virtual host name. Constraints: N/A Range: N/A Default Value: N/A |
queue | Yes | String | Definition: Offset from which the query starts. Constraints: N/A Range: ≥ 0 Default Value: 0. |
Request Parameters
None
Response Parameters
Status code: 200
Parameter | Type | Description |
|---|---|---|
vhost | String | Definition: Name of the virtual host to which the queue belongs. Range: N/A |
name | String | Definition: Queue name. Range: N/A |
durable | Boolean | Definition: Whether to enable queue persistence. Range:
|
auto_delete | Boolean | Definition: Whether to enable automatic queue deletion. Range:
|
messages | Integer | Definition: Accumulated messages. Range: N/A |
consumers | Integer | Definition: Connected consumers. Range: N/A |
policy | String | Definition Policy (The AMQP version does not support this parameter). Range N/A |
arguments | QueueArguments object | Definition: Queue parameter. This parameter is not returned if it is not configured. |
consumer_details | Array of ConsumerDetails objects | Definition: Details of subscribed consumers. |
queue_bindings | Array of BindingsDetails objects | Definition: Bindings to this queue. |
Parameter | Type | Description |
|---|---|---|
x-message-ttl | Long | Definition: Message retention period. This parameter indicates for how long a message in this queue can be retained. Range: N/A |
x-dead-letter-exchange | String | Definition: Name of the dead letter exchange. Rejected and expired messages are re-sent to this exchange. Range: N/A |
x-dead-letter-routing-key | String | Definition: Routing key of the dead letter exchange. The dead letter exchange sends dead letter messages to the queue with a matching routing key. Range: N/A |
x-queue-mode | String | Definition Lazy queue (The AMQP version does not have this parameter because all messages are persisted by default). Range N/A |
Parameter | Type | Description |
|---|---|---|
consumer_tag | String | Definition: Consumer ID. Range: N/A |
channel_details | ChannelDetails object | Definition: Consumer connections. Range: N/A |
ack_required | Boolean | Definition: Whether manual acknowledgement is enabled on the consumer client. Range:
|
prefetch_count | Integer | Definition: Consumer client preset value. Range: N/A |
Parameter | Type | Description |
|---|---|---|
name | String | Definition: Channel details, including the client IP:Port and the server IP:Port (channel_id). Range: N/A |
number | Integer | Definition: Channel quantity. Range: N/A |
user | String | Definition: Consumer username. If ACL is enabled, the real username will be returned; otherwise null will be returned. Range: N/A |
connection_name | String | Definition: Connection details, including the client IP:Port and the server IP:Port. Range: N/A |
peer_host | String | Definition: IP address of the connected consumer. Range: N/A |
peer_port | Integer | Definition: Port of the process of the connected consumer. Range: N/A |
Parameter | Type | Description |
|---|---|---|
source | String | Definition: Exchange name. Range: N/A |
destination_type | String | Definition Type of the binding target. Range
|
destination | String | Definition Binding target. Range N/A |
routing_key | String | Definition: Binding key-value. Range: N/A |
properties_key | String | Definition: URL-translated routing key. Range: N/A |
Example Requests
Querying specified queue details
GET https://{endpoint}/v2/rabbitmq/{project_id}/instances/{instance_id}/vhosts/{vhost}/queues?offset=0&limit=10 Example Responses
Status code: 200
Successful
{
"vhost" : "default",
"name" : "testQueue",
"durable" : true,
"auto_delete" : false,
"messages" : 100,
"consumers" : 10,
"policy" : "ttl",
"arguments" : {
"x-message-ttl" : 60000,
"x-dead-letter-exchange" : "dead-exchange-deal",
"x-dead-letter-routing-key" : "dead-ex-routing-key",
"x-queue-mode" : "lazy"
},
"consumer_details" : {
"consumer_tag" : "tag",
"channel_details" : {
"name" : "channel_name",
"number" : 1,
"user" : "root",
"connection_name" : "connection_name",
"peer_host" : "192.128.1.254",
"peer_port" : 12345
},
"ack_required" : true,
"prefetch_count" : 200
},
"queue_bindings" : {
"source" : "amq.direct",
"destination_type" : "queue",
"destination" : "testQueue",
"routing_key" : "info",
"properties_key" : "info"
}
} Status Codes
Status Code | Description |
|---|---|
200 | Successful |
Error Codes
See Error Codes.
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.

