The POST action creates a new queue. You must provide a queue name that is unique within the scope of the queues you own. The queue is assigned a queue URL; you must use this URL when performing actions on the queue.
When you create a queue, if a queue with the same name already exists, POST on QueueService returns the queue URL with an error indicating that the queue already exists.
When you create a queue, FullControl access rights are granted to you for the queue. Only you (as owner of the queue), or a grantee assigned FullControl rights to the queue, can grant or deny access rights to the queue and its messages.
Note: | You must be signed up for Amazon SQS for the request to succeed, as SQS is not a free service. |
The default value for VisibilityTimeout (30 seconds) is also set when a queue is created. See SetVisibilityTimeout (Query) for information about how visibility timeout works.
POST on QueueService requests are validated on the following:
The value specified for QueueName must be alphanumeric of length 1 to 80.
The following example POST request on the QueueService endpoint creates a queue named queue2.
POST /?QueueName=queue2 HTTP/1.1 Host: queue.amazonaws.com Authorization: [AWS authentication string] Content-Type: text/plain AWS-Version: 2006-04-01 Date: Wed, 05 Apr 2006 21:12:00 GMT
See CreateQueue (Query) for sample response information.