Create or Update Registration
Creates or updates a registration in the specified location.
Request
Method |
Request URI |
HTTP version |
|---|---|---|
PUT |
https://{namespace}.servicebus.windows.net/{NotificationHub}/registrations/<registrationId>?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
Atom entry with the description embedded in the content, as in Create Registration.
Response
The response includes an HTTP status code and a set of response headers.
Response Codes
Code |
Description |
|---|---|
201 |
Registration updated 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. |
404 |
No notification hub exists at this location. |
409 |
Request rejected because registration operations rate is too high. |
410 |
Cannot use specified location. Please use a different registrationid. |
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 |
ETag |
{weak ETag} |
Response Body
Upon success, a validated Atom entry is returned, as in Create Registration.