Create a 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 | SAS token generated as specified in Shared Access Signature Authentication with Service Bus. |
| 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.