Server Dns Aliases - Get

Служба:

SQL Database

Версия API:

2021-11-01

Возвращает псевдоним DNS сервера.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/dnsAliases/{dnsAliasName}?api-version=2021-11-01

Параметры URI

Имя	В	Обязательно	Тип	Описание
dnsAliasName	path	True	string	Имя dns-псевдонима сервера.
resourceGroupName	path	True	string	Имя группы ресурсов, к которой относится ресурс. Это значение можно получить от API-интерфейса диспетчера ресурсов Azure или портала.
serverName	path	True	string	Имя сервера, на который указывает псевдоним.
subscriptionId	path	True	string	Идентификатор подписки Azure.
api-version	query	True	string	Версия API для использования в запросе.

Ответы

Имя	Тип	Описание
200 OK	ServerDnsAlias	Успешно получен указанный dns-псевдоним сервера.
Other Status Codes		Ответы на ошибки: *** 400 InvalidServerDnsAliasAcquireRequest — текст запроса на получение псевдонима DNS сервера пуст или недопуст (он должен содержать старый идентификатор псевдонима сервера, например: /subscriptions/00000000-1111-2222-3333-4444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId — старый идентификатор dns-псевдонима сервера в тексте запроса пуст или недопустим (он должен иметь форму: /subscriptions/000000000-1111-2222-3333-44444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasDoesNotExist — псевдоним DNS сервера не существует на сервере. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias — псевдонимы DNS сервера не работают правильно для базы данных, в которую включен аудит таблиц 400 UnableToCreateServerDnsAliasDueToTableAuditing — псевдоним DNS сервера не может быть создан для сервера, на котором включен аудит таблиц. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb — псевдоним DNS сервера не может быть создан для сервера "{0}", так как в базе данных "{1}" включена функция аудита таблиц или доступа с включенной безопасностью. 400 LimitOfServerDnsAliasesPerServerExceededed — при создании нового dns-псевдонима сервера будет превышено допустимое число dns-псевдонимов сервера на сервер. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias — псевдонимы DNS сервера не работают правильно на сервере с включенным аудитом таблиц 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции. 400 TokenTooLong — предоставленный маркер слишком длинный. 400 UnableToResolveRemoteServer — не удалось разрешить имя удаленного сервера-партнера из-за недопустимого имени сервера или проблем с подключением к DNS. 400 InvalidServerName — указано недопустимое имя сервера. 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода. 400 InvalidServerDnsAliasName — указано недопустимое dns-имя сервера. 400 ServerNotFound — запрошенный сервер не найден. 404 SubscriptionDoesNotHaveServer — запрошенный сервер не найден 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ResourceNotFound — запрошенный ресурс не найден. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 409 ServerDnsAliasBusy — dns-псевдоним сервера занят другой операцией. 409 SubscriptionDisabled — подписка отключена. 409 ServerDnsAliasDnsRecordInUse — для запрошенной конечной точки существует повторяющаяся запись DNS. 409 ServerDnsAliasAlreadyExists — псевдоним DNS сервера уже существует на данном сервере. 409 ConflictingServerOperation — в настоящее время выполняется операция для сервера. 429 SubscriptionTooManyCreateUpdateRequests — запросы, превышающие максимальное количество запросов, которые могут обрабатываться доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 503 TooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

Get server DNS alias

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

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-name-1?api-version=2021-11-01

Java

/**
 * Samples for ServerDnsAliases Get.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerDnsAliasGet.json
     */
    /**
     * Sample code: Get server DNS alias.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerDnsAliases().getWithResponse("Default",
            "dns-alias-server", "dns-alias-name-1", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

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

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-name-1",
  "name": "dns-alias-name-1",
  "type": "Microsoft.Sql/servers/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-name-1.database.windows.net"
  }
}

Определения

ServerDnsAlias

Псевдоним DNS сервера.

Имя	Тип	Описание
id	string	Идентификатор ресурса.
name	string	Имя ресурса.
properties.azureDnsRecord	string	Полная запись DNS для псевдонима
type	string	Тип ресурса.