Create or update a 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 | SAS token generated as specified in Shared Access Signature Authentication with Service Bus. |
x-ms-version | 2015-01 |
Request body
Atom entry with the description embedded in the content, as in Create a 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. Use a different registration ID. |
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.