Server Dns Aliases - Acquire

Служба:

SQL Database

Версия API:

2021-11-01

Получает псевдоним DNS сервера с другого сервера.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/dnsAliases/{dnsAliasName}/acquire?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 для использования в запросе.

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

Имя	Обязательно	Тип	Описание
oldServerDnsAliasId	True	string	Идентификатор псевдонима сервера, который будет получен для указания на этот сервер.

Ответы

Имя	Тип	Описание
200 OK	ServerDnsAlias	Псевдоним DNS сервера успешно получен.
202 Accepted		Принято
Other Status Codes		Ответы об ошибках: *** 400 InvalidServerDnsAliasAcquireRequest — текст запроса на получение псевдонима DNS сервера пуст или недопустим (он должен содержать старый идентификатор псевдонима сервера, например: /subscriptions/000000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId — идентификатор псевдонима DNS старого сервера в тексте запроса пуст или недопустим (он должен иметь форму: /subscriptions/000000000-1111-2222-3333-444444444444/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 LimitOfServerDnsAliasesPerServerExceeded — при создании нового dns-псевдонима сервера будет превышено допустимое число DNS-псевдонимов сервера на сервер. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias — dns-псевдонимы сервера работают неправильно для сервера с включенным аудитом таблиц 400 CannotUseReservedDatabaseName — не удается использовать зарезервированное имя базы данных в этой операции. 400 TokenTooLong — предоставленный маркер слишком длинный. 400 UnableToResolveRemoteServer — не удалось разрешить имя удаленного сервера-партнера из-за недопустимого имени сервера или проблем с подключением к DNS. 400 InvalidServerName — указано недопустимое имя сервера. 400 InvalidIdentifier — идентификатор содержит значение NULL или недопустимый символ Юникода. 400 InvalidServerDnsAliasName — указано недопустимое имя DNS-псевдонима сервера. 400 ServerNotFound — запрошенный сервер не найден. 404 OperationIdNotFound — операция с идентификатором не существует. 404 ResourceNotFound — запрошенный ресурс не найден. 404 OperationIdNotFound — операция с идентификатором не существует. 404 ServerNotInSubscriptionResourceGroup — указанный сервер не существует в указанной группе ресурсов и подписке. 404 ServerNotInSubscription — указанный сервер не существует в указанной подписке. 409 OperationCancelled — операция была отменена пользователем. 409 OperationInterrupted — не удалось завершить операцию с ресурсом, так как она была прервана другой операцией с тем же ресурсом. 409 ServerDnsAliasBusy — DNS-псевдоним сервера занят другой операцией. 409 SubscriptionDisabled — подписка отключена. 409 ServerDnsAliasDnsRecordInUse — для запрошенной конечной точки существует повторяющаяся запись DNS. 409 ServerDnsAliasAlreadyExists — dns-псевдоним сервера уже существует на данном сервере. 409 ConflictingServerOperation — в настоящее время выполняется операция для сервера. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyCreateUpdateRequests — запросы сверх максимального количества запросов, которые могут быть обработаны доступными ресурсами. 429 SubscriptionTooManyRequests — запросы, превышающие максимальное количество запросов, которые могут быть обработаны доступными ресурсами. 500 OperationTimedOut — время ожидания операции истекло и автоматически откатывается. Повторите операцию. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами. 503 TooManyRequests — запросы сверх максимального числа запросов, которые могут быть обработаны доступными ресурсами. 504 RequestTimeout — превышено допустимое время ожидания запроса на обслуживание.

Примеры

Acquire server DNS alias

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

HTTP

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

{
  "oldServerDnsAliasId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1"
}

Java

import com.azure.resourcemanager.sql.models.ServerDnsAliasAcquisition;

/**
 * Samples for ServerDnsAliases Acquire.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerDnsAliasAcquire.json
     */
    /**
     * Sample code: Acquire server DNS alias.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void acquireServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerDnsAliases().acquire("Default", "dns-alias-new-server",
            "dns-alias-name-1",
            new ServerDnsAliasAcquisition().withOldServerDnsAliasId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/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-new-server/dnsAliases/dns-alias-name-1",
  "name": "server-dns-alias-name-1",
  "type": "Microsoft.Sql/servers/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-name-1.database.windows.net"
  }
}

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

202

Определения

Имя	Описание
ServerDnsAlias	Псевдоним DNS сервера.
ServerDnsAliasAcquisition	Запрос на получение dns-псевдонима сервера.

ServerDnsAlias

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

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

ServerDnsAliasAcquisition

Запрос на получение dns-псевдонима сервера.

Имя	Тип	Описание
oldServerDnsAliasId	string	Идентификатор псевдонима сервера, который будет получен для указания на этот сервер.