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).
| 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 REST request returns the queues whose names begin with the letter "T".
GET /?QueueNamePrefix=T HTTP/1.1 Host: queue.amazonaws.com Authorization: [AWS authentication string] AWS-Version: 2007-05-01 Content-Type: text/plain Date: Mon, 21 May 2007 21:12:00 GMT
See ListQueues for sample response information.