Read Installation

Article
02/17/2016

Updated: October 27, 2015

Retrieves installations based on Installation ID.

Request

Method	Request URI	HTTP version
GET	https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/{id}?api-version=2015-01	HTTP/1.1

Request Headers

The following table describes required and optional request headers.

Request Header	Description
Content-Type	application/json
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

None.

Response

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

Response Codes

Code	Description
200	The installation was retrieved successfully.
400	The installation could not be retrieved because the request was malformed.
401	Authorization failure. The access key was incorrect.
403	Quota exceeded; request rejected because registration operations rate is too high.
404	Installation Not Found.

For information about status codes, see Status and Error Codes.

Response Headers

Response Header	Description
Content-type	application/json
Content-Location	The location of the installation in the format: https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId>

Content-type

application/json

Content-Location

The location of the installation in the format:

https://{namespace}.servicebus.windows.net/{NotificationHub}/installations/<installationId>

Response Body

Upon success, a JSON document for the installation is returned. The format of the JSON follows the format shown in Create or Overwrite an Installation.