ListQueues

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]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 ListQueues call and the response would include all your queues. If you're now using one or both of the old versions and the 2008-01-01 version to create queues, you can't get a list of all your queues with a single call to ListQueues. Instead, you must call twice: once using either the 2007-05-01 or 2006-04-01 version (which returns all queues you created with versions older than 2008-01-01), and once using the 2008-01-01 version (which returns only the queues created with the 2008-01-01 version). Note that queues created with the older versions are not compatible with the 2008-01-01 version, and vice versa.

The following table lists the special request parameters the action uses (in addition to the common request parameters listed in Common Request Parameters).

NameDescriptionRequired

QueueNamePrefix

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).

NameDescription

Queues

An element containing each queue's URL.

Type: String

Ancestor: ListQueuesResponse

Child: QueueURL

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".