Server Dns Aliases - Acquire

Service:

SQL Database

API Version:

2021-11-01

Adquire o alias DNS do servidor de outro servidor.

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

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
dnsAliasName	path	True	string	O nome do alias dns do servidor.
resourceGroupName	path	True	string	O nome do grupo de recursos que contém o recurso. Você pode obter esse valor por meio da API do Gerenciador de Recursos do Azure ou por meio do portal.
serverName	path	True	string	O nome do servidor para o qual o alias está apontando.
subscriptionId	path	True	string	A ID de assinatura que identifica uma assinatura do Azure.
api-version	query	True	string	A versão da API a ser usada para a solicitação.

Corpo da solicitação

Nome	Obrigatório	Tipo	Description
oldServerDnsAliasId	True	string	A ID do alias do servidor que será adquirido para apontar para esse servidor.

Respostas

Nome	Tipo	Description
200 OK	ServerDnsAlias	Alias DNS do servidor adquirido com êxito.
202 Accepted		Aceito
Other Status Codes		Respostas de erro: *** 400 InvalidServerDnsAliasAcquireRequest - O corpo da solicitação de alias DNS do servidor de aquisição está vazio ou inválido (ele deve conter a ID de alias do servidor antigo, por exemplo: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId - A ID de alias DNS do servidor antigo no corpo da solicitação está vazia ou inválida (ela deve ter o formulário: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasDoesNotExist – O Alias de DNS do servidor não existe em um servidor. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - Os Aliases de servidor não estão funcionando corretamente para o banco de dados que tem a Auditoria de Tabela ativada 400 UnableToCreateServerDnsAliasDueToTableAuditing – O Alias DNS do servidor não pode ser criado para o servidor que tem a auditoria de tabela ativada. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb – O Alias DNS do servidor não pode ser criado para o servidor '{0}' porque o banco de dados '{1}' tem o recurso auditoria de tabela ou acesso habilitado para segurança habilitado. 400 LimitOfServerDnsAliasesPerServerExceeded – a criação do novo Alias de Dns do servidor excederá o número permitido de Aliases DNS do servidor por servidor. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - Os Aliases de Dns do servidor não estão funcionando corretamente para o servidor que tem a Auditoria de Tabela ativada 400 CannotUseReservedDatabaseName – Não é possível usar o nome do banco de dados reservado nesta operação. 400 TokenTooLong - O token fornecido é muito longo. 400 UnableToResolveRemoteServer – O nome do servidor parceiro remoto não pôde ser resolvido devido a um nome de servidor inválido ou problemas de conectividade DNS. 400 InvalidServerName - Nome do servidor inválido especificado. 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido. 400 InvalidServerDnsAliasName - O nome do Alias DNS do servidor inválido foi fornecido. 400 ServerNotFound – O servidor solicitado não foi encontrado. 404 OperationIdNotFound – A operação com id não existe. 404 ResourceNotFound – O recurso solicitado não foi encontrado. 404 OperationIdNotFound – A operação com id não existe. 404 ServerNotInSubscriptionResourceGroup – O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 ServerNotInSubscription – O servidor especificado não existe na assinatura especificada. 409 OperationCancelled – A operação foi cancelada pelo usuário. 409 OperationInterrupted – A operação no recurso não pôde ser concluída porque foi interrompida por outra operação no mesmo recurso. 409 ServerDnsAliasBusy – O Alias DNS do servidor está ocupado com outra operação. 409 Assinatura Desabilitada – A assinatura está desabilitada. 409 ServerDnsAliasDnsRecordInUse – existe um registro DNS duplicado para o ponto de extremidade solicitado. 409 ServerDnsAliasAlreadyExists – O Alias DNS do servidor já existe em um determinado servidor. 409 ConflictingServerOperation – Uma operação está em andamento no momento para o servidor. 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyCreateUpdateRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Tente executar a operação novamente. 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 503 TooManyRequests – Solicitações além das solicitações máximas que podem ser processadas por recursos disponíveis. 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

Acquire server DNS alias

Sample Request

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.core.util.Context;
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"),
            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

Sample Response

Status code:

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"
  }
}

Status code:

202

Definições

Nome	Description
ServerDnsAlias	Um alias DNS do servidor.
ServerDnsAliasAcquisition	Uma solicitação de aquisição de alias de dns do servidor.

ServerDnsAlias

Um alias DNS do servidor.

Nome	Tipo	Description
id	string	ID do recurso.
name	string	Nome do recurso.
properties.azureDnsRecord	string	O registro DNS totalmente qualificado para alias
type	string	Tipo de recurso.

ServerDnsAliasAcquisition

Uma solicitação de aquisição de alias de dns do servidor.

Nome	Tipo	Description
oldServerDnsAliasId	string	A ID do alias do servidor que será adquirido para apontar para esse servidor.