The ListQueues action returns a list of your queues. A maximum 1000 queue URLs are returned. If you specify a value for the optional QueueNamePrefix parameter, only queues with a name beginning with the specified value are returned.
![]() | Important |
|---|---|
The WSDL version you use for the request affects which queues are included in the response. Before the release of version 2008-01-01, you could use either of the available versions (2007-05-01 or 2006-04-01) for your |
The following table lists the special request parameters the action uses (in addition to the common request parameters listed in Common Request Parameters).
| Name | Description | Required |
|---|---|---|
| String to use for filtering the list results. Only those queues whose name begins with the specified string are returned. Type: String Constraints: Maximum 80 characters; alphanumeric characters, hyphens (-), and underscores (_) are allowed. | No |
The following table lists the response elements the action returns (in addition to the common response elements listed in The Structure of a Response).
| Name | Description |
|---|---|
| An element containing each queue's URL. Type: String Ancestor: Child: |
The action returns no special errors besides the common errors listed in Common Errors.
The following example Query request returns the queues whose names begin with the letter "T".
http://queue.amazonaws.com/ ?Action=ListQueues &QueueNamePrefix=T &AWSAccessKeyId=0AS7553JW73RRM642K02EXAMPLE &Version=2007-05-01 &Expires=2007-05-12T12:00:00Z &Signature=Qnpl4Qk/7tINHzfXCiT7VbBatDAEXAMPLE=
<ListQueuesResponse
xmlns=http://queue.amazonaws.com/doc/2007-05-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>