SALES: 1-800-867-1380

Create Queue

Creates a new queue. Once created, this queue’s resource manifest is immutable. This operation is not idempotent. Repeating the create call, after a queue with same name has been created successfully, will result in a 409 Conflict error message.

 

Method Request URI HTTP Version

PUT

https://{serviceNamespace}.servicebus.windows.net/{Queue Path}

HTTP/1.1

Request Headers

The following table describes required and optional request headers.

 

Request Header Description

Authorization

Specifies a WRAPv0.9.7.2 token containing a SimpleWebToken acquired from ACS. Set to WRAP access_token=”{swt}”.

Content-Type

Set to application/atom+xml;type=entry;charset=utf-8.

Request Body

The queue description. See Queue Description.

The response includes an HTTP status code and a set of response headers.

Response Codes

noteNote
If you create a queue with a name containing special or encoded characters (for example, "test?Name=value&", which gets encoded to "test%3FName%3Dvalue%26", a (401) Unauthorized exception will be generated.

 

Code Description

201

Queue created.

400

Invalid request body.

401

Authorization failure.

403

Quota exceeded; queue not created.

409

The specified queue already exists (or the specified path is already occupied).

500

Internal error.

For information about status codes, see Status and Error Codes.

Response Headers

None.

Response Body

The queue description is returned. Some description properties might contain default values if they were missing from the PUT request.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback

Community Additions

ADD
Show:
© 2014 Microsoft