Create Registration ID

 

Updated: June 2, 2015

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.

Method

Request URI

HTTP version

POST

https://{namespace}.servicebus.windows.net/{NotificationHub}/registrationIDs/?api-version=2015-01

HTTP/1.1

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

The response includes an HTTP status code and a set of response headers.

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 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}

Show: