Retrieve a Hosting Server (MySQL)

Article
08/24/2015

Applies To: Windows Azure Pack

Retrieves the specified hosting server.

Request

Replace <ServiceMgmt> with your Service Management API endpoint address. Replace <ServerName> with the name of the server to retrieve.

Method	Request URI	HTTP version
GET	https://<ServiceMgmt>:30004/services/mysqlservers//hostingServers/<ServerName>	HTTP/1.1

URI Parameters

None.

Request Headers

The following table describes required and optional request headers.

Request header	Description
Authorization: Bearer	Required. The authorization bearer token.
x-ms-principal-id	Required. The principal identifier.
x-ms-client-request-id	Optional. The client request identifier.
x-ms-client-session-id	Optional. The client session identifier.
x-ms-principal-liveid	Optional. The principal Live identifier.

Request Body

None.

Response

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

Status Code

A successful operation returns status code 200 (OK).

Response Headers

The response for this operation includes standard HTTP headers. All standard headers conform to the HTTP/1.1 protocol specification.

Response Body

The following table describes the key elements of the response body:

Element name	Description
HostingServer	The new hosting server. For more information, see HostingServer (MySQL Object).

Example

The following code example shows a Retrieve a Hosting Server request.

GET https://<ServiceMgmt>:30004/services/mysqlservers/hostingServers/<ServerName> HTTP/1.1
x-ms-version: 2012-03-01
Accept: application/json
Authorization: Bearer <Token>
x-ms-client-request-id: eb1858da-c513-4449-8173-fa1898b1cfe0-2013-09-05 21:43:42Z
x-ms-client-session-id: 210da08a-5a97-4a66-b1bd-39d3e047a3ea
x-ms-principal-id: <SERVICEMGMT>%5cAdministrator
Accept-Language: en-US
Host: <ServiceMgmt>:30004

The following code example shows a Retrieve a Hosting Server response.

{
  "Name": "<computer>",
  "ServerId": "l89tbw",
  "Created": "0001-01-01T00:00:00+00:00",
  "AvailableSpaceMB": 100352,
  "TotalSpaceMB": 102400,
  "DatabaseCount": 2,
  "State": 1,
  "ServerGroups": [
    {
      "GroupId": "2n9c",
      "GroupName": "Default",
      "HostingServerCount": 2
    }
  ],
  "ConnectionString": ""
}

Share via