Read an installation

Retrieves installations based on Installation ID.


Method Request URI HTTP version
GET https://{namespace}{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



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

See Also

Create or overwrite installation
Update installation
Delete installation