Zaqar/devguide/listQueues

List Queues

Template: GET /v1/queues?marker=string& limit=integer&detailed=boolean

Normal response code(s): 200

Error response codes(s): badRequest (400), unauthorized (401), itemNotFound (404), unauthorized (406)

This operation lists queues for the project, sorting the queues alphabetically by name.

Note: If you do not specify the limit query parameter, it defaults to 10. Forward-only paging is supported via "next" link. The detailed query parameter defaults to false, which excludes the metadata from the results.

Name	Style	Type	Description
marker	Query	String	Specifies the name of the last queue received in the previous request, or none to get the first page of results. The marker parameter is optional.
limit	Query	Integer	Specifies up to 20 (the default, but configurable) queues to return. The limit parameter is optional.
detailed	Query	Boolean	Determines whether queue metadata is icluded in the response. The detailed parameter is optional.

Request Example:

GET /v1/queues?marker=baz&detailed=true HTTP/1.1 Host: marconi.example.com

...

Response Example:

HTTP/1.1 200 OK

{

 "links: [
   {
      "rel": "next",
      "href": "/v1/queues/fizbit/queues?marker=kooleo&limit=10&detailed=true"
    }
],
"queues": [
  { "name": "boomerang", "href": "/v1/queues/boomerang", "metadata": {} },
  { "name": "fizbit", "href": "/v1/queues/fizbit", "metadata": { "handle": "@kgriffs" } },

...

  { "name": "kooleo",  "href": "/v1/queues/kooleo", "metadata": { "something": "something_else" } }
 ]

}