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 |
Расположение доменного имени. |
subscription
|
path | True |
string |
Учетные данные подписки, которые однозначно определяют подписку Microsoft Azure. Идентификатор подписки входит в состав URI для каждого вызова службы. |
api-version
|
query | True |
string |
Версия КЛИЕНТСКОго API. |
domain
|
query | True |
string |
Проверяемое доменное имя. Оно должно соответствовать следующему регулярному выражению: ^[a-z][a-z0-9-]{1,61}[a-z0-9]$. |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
Запрос успешно выполнен. Возвращает значение, доступно ли DNS-имя. |
|
Other Status Codes |
Ответ на ошибку, описывающий причину сбоя операции. |
Безопасность
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
}
Определения
Имя | Описание |
---|---|
Cloud |
Ответ на ошибку службы. |
Cloud |
Ответ на ошибку службы. |
Dns |
Ответ на вызов службы API CheckDnsNameAvailability. |
CloudError
Ответ на ошибку службы.
Имя | Тип | Описание |
---|---|---|
error |
Текст ошибки облака. |
CloudErrorBody
Ответ на ошибку службы.
Имя | Тип | Описание |
---|---|---|
code |
string |
Идентификатор ошибки. Коды являются инвариантными и предназначены для программного использования. |
details |
Список дополнительных сведений об ошибке. |
|
message |
string |
Сообщение, описывающее ошибку, предназначенное для отображения в пользовательском интерфейсе. |
target |
string |
Целевой объект конкретной ошибки. Например, имя свойства в ошибке. |
DnsNameAvailabilityResult
Ответ на вызов службы API CheckDnsNameAvailability.
Имя | Тип | Описание |
---|---|---|
available |
boolean |
Доступность домена (True/False). |