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


Check Dns Name Availability - Check Dns Name Availability

Проверяет, доступно ли доменное имя в зоне cloudapp.azure.com для использования.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Network/locations/{location}/CheckDnsNameAvailability?domainNameLabel={domainNameLabel}&api-version=2024-05-01

Параметры URI

Имя В Обязательно Тип Описание
location
path True

string

Расположение доменного имени.

subscriptionId
path True

string

Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы.

api-version
query True

string

Версия КЛИЕНТСКОго API.

domainNameLabel
query True

string

Проверяемое доменное имя. Оно должно соответствовать следующему регулярному выражению: ^[a-z][a-z0-9-]{1,61}[a-z0-9]$.

Ответы

Имя Тип Описание
200 OK

DnsNameAvailabilityResult

Запрос успешно выполнен. Возвращает значение, доступно ли DNS-имя.

Other Status Codes

CloudError

Ответ на ошибку, описывающий причину сбоя операции.

Безопасность

azure_auth

Поток OAuth2 Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation олицетворения учетной записи пользователя

Примеры

Check Dns Name Availability

Образец запроса

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.Network/locations/westus/CheckDnsNameAvailability?domainNameLabel=testdns&api-version=2024-05-01

Пример ответа

{
  "available": false
}

Определения

Имя Описание
CloudError

Ответ на ошибку службы.

CloudErrorBody

Ответ на ошибку службы.

DnsNameAvailabilityResult

Ответ на вызов службы API CheckDnsNameAvailability.

CloudError

Ответ на ошибку службы.

Имя Тип Описание
error

CloudErrorBody

Текст ошибки облака.

CloudErrorBody

Ответ на ошибку службы.

Имя Тип Описание
code

string

Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования.

details

CloudErrorBody[]

Список дополнительных сведений об ошибке.

message

string

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

target

string

Целевой объект конкретной ошибки. Например, имя свойства в ошибке.

DnsNameAvailabilityResult

Ответ на вызов службы API CheckDnsNameAvailability.

Имя Тип Описание
available

boolean

Доступность домена (True/False).