Server Dns Aliases - Acquire

Serviço:

SQL Database

Versão da API:

2021-11-01

Adquire o alias de DNS do servidor a partir 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 do URI

Name	Em	Necessá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. Pode obter este valor a partir da API do Azure Resource Manager ou do portal.
serverName	path	True	string	O nome do servidor para o qual o alias está a apontar.
subscriptionId	path	True	string	O ID da subscrição que identifica uma subscrição do Azure.
api-version	query	True	string	A versão da API a utilizar para o pedido.

Corpo do Pedido

Name	Necessário	Tipo	Description
oldServerDnsAliasId	True	string	O ID do alias do servidor que será adquirido para apontar para este servidor.

Respostas

Name	Tipo	Description
200 OK	ServerDnsAlias	Alias DNS do servidor adquirido com êxito.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 InvalidServerDnsAliasAcquireRequest – o corpo do pedido de alias DNS do servidor de aquisição está vazio ou é inválido (deve conter o ID de alias do servidor antigo, por exemplo: /subscriptions/000000000-1111-2222-3333-4444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId – o ID de alias DNS do servidor antigo no corpo do pedido está vazio ou é inválido (deve ter o formulário: /subscriptions/000000000-1111-12222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasDoesNotExist – O Alias DNS do Servidor não existe num servidor. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Os Aliases de Dns do Servidor não estão a funcionar corretamente para a base de dados que tem a Auditoria de Tabela ativada 400 UnableToCreateServerDnsAliasDueToTableAuditing – não é possível criar o Alias DNS do Servidor para o servidor que tem a auditoria de tabelas ativada. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb – O Alias DNS do Servidor não pode ser criado para o servidor "{0}" porque a base de dados "{1}" tem a funcionalidade Auditoria de Tabelas ou Acesso Ativado por Segurança ativada. 400 LimitOfServerDnsAliasesPerServerExceeded – a criação de um novo Alias de Dns do Servidor excederá o número permitido de Aliases DNS do Servidor por servidor. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias – Os Aliases Dns do Servidor não estão a funcionar corretamente para o servidor que tem a Auditoria de Tabela ativada 400 CannotUseReservedDatabaseName – não é possível utilizar o nome da base de dados reservada nesta operação. 400 TokenTooLong – o token fornecido é demasiado longo. 400 UnableToResolveRemoteServer – não foi possível resolver o nome do servidor do parceiro remoto devido a um nome de servidor ou problemas de conectividade DNS inválidos. 400 InvalidServerName – nome de servidor inválido especificado. 400 InvalidIdentifier – o identificador contém NULL ou um caráter unicode inválido. 400 InvalidServerDnsAliasName – foi fornecido um nome de Alias DNS de Servidor inválido. 400 ServerNotFound – o servidor pedido não foi encontrado. 404 OperationIdNotFound – a operação com o ID não existe. 404 ResourceNotFound – o recurso pedido não foi encontrado. 404 OperationIdNotFound – a operação com o ID não existe. 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados. 404 ServerNotInSubscription - O servidor especificado não existe na subscrição especificada. 409 OperationCancelled - A operação foi cancelada pelo utilizador. 409 OperationInterrupted - Não foi possível concluir a operação no recurso porque foi interrompida por outra operação no mesmo recurso. 409 ServerDnsAliasBusy – O Alias DNS do Servidor está ocupado com outra operação. 409 SubscriptionDisabled - A subscrição está desativada. 409 ServerDnsAliasDnsRecordInUse – existe um registo DNS duplicado para o ponto final pedido. 409 ServerDnsAliasAlreadyExists – O Alias DNS do Servidor já existe num determinado servidor. 409 ConflictingServerOperation – está atualmente em curso uma operação para o servidor. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyCreateUpdateRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 500 OperationTimedOut – a operação excedeu o limite de tempo e foi revertida automaticamente. Repita a operação. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 503 TooManyRequests – pedidos para além do máximo de pedidos que podem ser processados por recursos disponíveis. 504 RequestTimeout – o pedido de serviço excedeu o tempo limite permitido.

Exemplos

Acquire server DNS alias

Pedido de amostra

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

Resposta da amostra

Código de estado:

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

Código de estado:

202

Definições

Name	Description
ServerDnsAlias	Um alias DNS de servidor.
ServerDnsAliasAcquisition	Um pedido de aquisição de alias dns do servidor.

ServerDnsAlias

Um alias DNS de servidor.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.azureDnsRecord	string	O registo DNS completamente qualificado para alias
type	string	Tipo de recurso.

ServerDnsAliasAcquisition

Um pedido de aquisição de alias dns do servidor.

Name	Tipo	Description
oldServerDnsAliasId	string	O ID do alias do servidor que será adquirido para apontar para este servidor.