1.6.3 获取 Queue 信息

优质
小牛编辑
150浏览
2023-12-01

列出用户所拥有的Queue
用户只可list自己拥有的Queue

方法参数ListQueueRequest

queueNamePrefix : String : optional

Queue的前缀。

方法返回ListQueueResponse

queueName : List< String >

符合条件的Queue的名称列表。Queue名称中包含以developerId开头的前缀


获取Queue的信息
返回值中包含Queue的属性以及Queue的统计信息

方法参数GetQueueInfoRequest

queueName : String : required

需获取信息的Queue的名称

方法返回GetQueueInfoResponse

queueName : String
queueAttribute : QueueAttribute

具体字段请参见createQueue()

queueQuota : QueueQuota

具体字段请参见createQueue()

queueState : QueueState

Queue或Tag的统计信息,具体如下:

  1. createTimestamp : long
    创建时间
  2. lastModifiedTimestamp : long
    最后一次修改操作的时间,即“更新时间戳”
    purgeQueue()会更新Queue的“更新时间戳”
    而Tag的“更新时间戳”永远等于“创建时间戳”
  3. approximateMessageNumber : long
    message总数的估计值, 是消息的堆积数量
  4. approximateAvailableMessageNumber : long
    当前可以被立即接收的message数量的估计值, 是EMQ为队列载入内存以便接收的消息数量
  5. approximateInvisibilityMessageNumber : long
    当前正在处理的message数量的估计值, 是已经被接收但是还未返回ack的消息数量

approximateMessageNumber >= approximateAvailableMessageNumber + approximateAvailableMessageNumber + delayMessageNumber

isDeadLetterQueue : boolean

这个Queue是否是一个死信队列(Dead Letter Queue)。

redrivePolicy: RedrivePolicy

这个Queue的新驱动策略。参见重新驱动策略

enablePriority : boolean

标识Queue是否允许消息优先级。

topicQueue : boolean

标识Queue是否是topicQueue

deleteMessageForce : boolean

标识Queue中的过期Message是否会被强制清除

defaultTagName : String

Queue的defaultTag的别名,默认为空

sourceQueues : List< String > : optional

如果这个Queue是个死信队列(Dead Letter Queue), 则这里表示死信队列的源Queue列表。