Amazon Simple Queue Service
API Reference (API Version 2012-11-05)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...

ListQueues

Description

Returns a list of your queues. The maximum number of queues that can be returned is 1000. If you specify a value for the optional QueueNamePrefix parameter, only queues with a name beginning with the specified value are returned.

Request Parameters

For information about the common parameters that all actions use, see Common Parameters.

QueueNamePrefix

A string to use for filtering the list results. Only those queues whose name begins with the specified string are returned.

Type: String

Required: No

Response Elements

The following element is returned in a structure named ListQueuesResult.

QueueUrls

A list of queue URLs, up to 1000 entries.

Type: String list

Examples

The following example Query request returns the queues whose names begin with the letter "T".

Sample Request

        
http://sqs.us-east-1.amazonaws.com/
?Action=ListQueues
&QueueNamePrefix=t
&Version=2009-02-01
&SignatureMethod=HmacSHA256
&Expires=2009-04-18T22%3A52%3A43PST
&AWSAccessKeyId=AKIAIOSFODNN7EXAMPLE
&SignatureVersion=2
&Signature=Dqlp3Sd6ljTUA9Uf6SGtEExwUQEXAMPLE

      

Sample Response

        
<ListQueuesResponse>
    <ListQueuesResult>
        <QueueUrl>
            http://sqs.us-east-1.amazonaws.com/123456789012/testQueue
        </QueueUrl>
    </ListQueuesResult>
    <ResponseMetadata>
        <RequestId>
            725275ae-0b9b-4762-b238-436d7c65a1ac
        </RequestId>
    </ResponseMetadata>
</ListQueuesResponse>