The ListQueues action returns a list of your queues. A maximum of 10,000 queue URLs are returned. If a value is specified for the optional QueueNamePrefix parameter, only those queues with a queue name beginning with the value specified are returned. The queue name is specified in the QueueName parameter when a queue is created.
ListQueues requests are validated on the following:
If specified, the QueueNamePrefix must be alphanumeric of length 1 to 80.
The following table lists the parameters of the operation.
| Name | Description | Type | Value |
|---|---|---|---|
QueueNamePrefix | Optional. This parameter can be used to filter results returned. When specified, only queues with queue names beginning with the specified string are returned. | String | User-defined alphanumeric string |
The following example ListQueues request returns the queues owned by the Access Key ID in the request that have a queue name that begins with "T".
http://queue.amazonaws.com/ ?Action=ListQueues &QueueNamePrefix=T &AWSAccessKeyId=0AS7553JW73RRM642K02 &Version=2006-04-01 &Expires=2007-01-12T12:00:00Z &Signature=Qnpl4Qk/7tINHzfXCiT7VbBatDA=
The ListQueues action returns the queues associated with the specified Access Key ID whose names that begin with "T".
<ListQueuesResponse
xmlns=http://queue.amazonaws.com/doc/2006-04-01/
xmlns:xsi=http://www.w3.org/2001/XMLSchema-instance
xsi:type=ListQueuesResponse>
<Queues>
<QueueUrl>
http://queue.amazonaws.com/A29E9VSPHGOG23/Toast
</QueueUrl>
<QueueUrl>
http://queue.amazonaws.com/A29E9VSPHGOG23/Test
</QueueUrl>
</Queues>
<ResponseStatus>
<StatusCode>Success</StatusCode>
<RequestId>cb919c0a-9bce-4afe-9b48-9bdf2412bb67</RequestId>
</ResponseStatus>
</ListQueuesResponse>