Create Registration ID
Returns a registration ID (without creating a registration). You can use the generated registration ID to create a registration using the Create or Update Registration method.
Request
Method |
Request URI |
HTTP version |
|---|---|---|
POST |
https://{namespace}.servicebus.windows.net/{NotificationHub}/registrationIDs/?api-version=2015-01 |
HTTP/1.1 |
Request Headers
The following table describes required and optional request headers.
Request Header |
Description |
|---|---|
Content-Type |
application/atom+xml;type=entry;charset=utf-8 |
Authorization |
Token generated as specified in Shared Access Signature Authentication with Service Bus, or Service Bus authentication and authorization with Microsoft Azure Active Directory Access Control (also known as Access Control Service or ACS). |
x-ms-version |
2015-01 |
Request Body
None.
Response
The response includes an HTTP status code and a set of response headers.
Response Codes
Code |
Description |
|---|---|
201 |
Registration created successfully. |
400 |
Invalid request body. The registration could not be created because the request was malformed. |
401 |
Authorization failure. The access key was incorrect. |
403 |
Quota exceeded; too many registrations in this namespace. Registration not created. |
403 |
Request rejected because registration operations rate is too high. |
For information about status codes, see Status and Error Codes.
Response Headers
Response Header |
Description |
|---|---|
Content-type |
application/atom+xml;type=entry;charset=utf-8 |
Content-Location |
The location of the registration in the format: https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/<registrationId> |
ETag |
{weak ETag} |
Response Body
None.