Share via


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.