GET on QueueService

The GET on QueueService action returns a list of the your queues. A maximum 1000 queue URLs are returned. If you specify a value for the optional QueueNamePrefix parameter, only queues with a queue name beginning with the specified value are returned.

The following table lists the special request parameters the action uses (in addition to the common request headers listed in Common REST Headers).

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 REST request returns the queues whose names begin with the letter "T".

See ListQueues for sample response information.