Create Topic
Creates a new topic. Once created, the topic resource manifest is immutable. Repeating the create call after a topic with same name has been created successfully, results in a 409 conflict error message.
Request
Method |
Request URI |
HTTP Version |
---|---|---|
PUT |
https://{serviceNamespace}.servicebus.windows.net/{Topic 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 topic description. See Topic Description.
Response
The response includes an HTTP status code and a set of response headers.
Response Codes
Note
If you create a topic 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 |
Topic created. |
400 |
Invalid request body. |
401 |
Authorization failure. |
403 |
Quota exceeded; topic not created. |
409 |
The specified topic 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 topic description is returned. Some description properties might contain default values if they were missing from the PUT request.
See Also
Topics
Example: Creating a Topic
Delete Topic
Get Topic
List Topics
Topic Description