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

Статья
07/19/2023

Операция 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>`

Параметры URI

Нет.

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

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

Заголовок запроса	Описание
`x-ms-version`	Обязательный. Задает версию операции, используемой для этого запроса. Этот заголовок должен иметь значение `2012-03-01` или выше.

Текст запроса

Нет.

Ответ

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

Код состояния

Успешная операция возвращает код состояния 200 (ОК).

Заголовки откликов

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

Заголовок ответа	Описание
`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 доступен только в версии 2013-03-01 или более поздней.

Имя элемента	Описание
Результат	Логическое значение, указывающее, доступно ли имя для использования. `true` Значение , если имя доступно; в противном случае `false`. В версиях до 2013-03-01 операция возвращала `true` для незанятых имен, даже если они были зарезервированными или неподобающими. С заголовками версии 2013-03-01 и позднее операция возвращает `false` для зарезервированных и неподобающих слов.
Причина	Указывает, почему имя не может быть использовано для создания облачной службы. Возможны следующие значения: - `HostedServiceAlreadyExists` — возвращается, если имя облачной службы уже существует. - `HostedServiceNameNotValid` — возвращается, если в имени облачной службы используются неподдерживаемые символы, зарезервированные слова или ненормативные слова. Элемент `Reason` доступен только в версии 2013-03-01 или более поздней.

Поделиться через