Verify that the Host Name is Available
Applies To: Windows Azure Pack
Verifies that a specified host name is available.
Replace {ServiceMgmt} with your Service Management API endpoint address. Replace {Port} with either 30005 for the tenant API or 30006 for the Public Tenant API. Replace {SUBSCRIPTIONID} with the required subscription.
Method | Request URI | HTTP version |
|---|---|---|
GET | https://<ServiceMgmt>:<Port>/{SUBSCRIPTIONID}/services/webspaces | HTTP/1.1 |
The following table describes the URI parameters.
URI Parameter | Description |
|---|---|
ishostnameavailable | The host name to verify. |
The following table describes required and optional request headers.
Request header | Description |
|---|---|
x-ms-version | Required. Specifies the version of the operation to use for this request. This header should be set to 2012-10-10 or the current version. |
accept: application/json | Optional. Use this header to receive the response in JSON format. |
None.
The response includes an HTTP status code, a set of response headers, and a response body.
A successful operation returns status code 200 (OK).
For information about status codes, see Error Codes (Web Sites Service REST API).
The response for this operation includes the following headers. The response can also include additional standard HTTP headers. All standard headers conform to the HTTP/1.1 protocol specification.
Response header | Description |
|---|---|
x-ms-request-id | A value that uniquely identifies the request made against the management service. |
The code example shows the format of the response body
true
The response body contains true if the host name is available; otherwise contains false.