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.