Экспорт (0) Печать
Развернуть все
Развернуть Свернуть

Проверка доступности имени облачной службы

Обновлено: Февраль 2015 г.

Операция Check Hosted Service Name Availability проверяет доступность указанного имени облачной службы.

Запрос Check Hosted Service Name Availability можно указать следующим образом. Замените <subscription-id> своим идентификатором подписки, а <cloudservice-name> именем облачной службы, которое собираетесь использовать.

 

Метод URI запроса

GET

https://management.core.windows.net/<subscription-id>/services/hostedservices/operations/isavailable/<cloudservice-name>

Необходимо убедиться, что запрос к службе управления безопасен. Дополнительные сведения см. в разделе Проверка подлинности запросов по управлению службами.

Отсутствует.

В следующей таблице описаны заголовки запросов.

 

Заголовок запроса Описание

x-ms-version

Обязательно. Задает версию операции, используемой для этого запроса. Этот заголовок должен быть установлен в значение 01.03.12 или на более позднюю дату. Дополнительные сведения об управлении версиями заголовков см. в разделе Работа с версиями при управлении службами.

Отсутствует.

Ответ включает код состояния HTTP, набор заголовков ответа и текст ответа.

Успешная операция возвращает код состояния 200 (ОК). Сведения о кодах состояния см. в разделе Коды состояний и ошибок управления службами.

Ответ для этой операции включает следующие заголовки. Ответ может также включать дополнительные стандартные заголовки HTTP. Все стандартные заголовки соответствуют спецификации протокола HTTP/1.1.

 

Заголовок ответа Описание

x-ms-request-id

Значение, которое однозначно определяет запрос к службе управления.

Текст ответа имеет следующий формат:


<?xml version="1.0" encoding="utf-8"?>
<AvailabilityResponse xmlns=”http://schemas.microsoft.com/windowsazure”>
  <Result>name-availability</Result>
  <Reason>reason</Reason>
</AvailabilityResponse>

В следующей таблице описаны элементы текста ответа.

 

Имя элемента Описание

Результат

Логическое значение, указывающее, доступно ли имя для использования. Значение true, если имя доступно; в противном случае — значение false.

В версиях до 2013-03-01 операция возвращала true для незанятых имен, даже если они были зарезервированными или неподобающими. С заголовками версии 2013-03-01 и позднее операция возвращает false для зарезервированных и неподобающих слов.

Причина

Указывает, почему имя не может быть использовано для создания облачной службы.

Возможные значения:

  • HostedServiceAlreadyExists — возвращается, если имя облачной службы уже существует.

  • HostedServiceNameNotValid — возвращается, если в имени облачной службы используются оскорбительные слова, зарезервированные слова или неподдерживаемые символы.

Элемент Reason доступен только при использовании версии 01.03.13 или более поздней.

Показ:
© 2015 Microsoft