Server Dns Aliases - Create Or Update

Service:

SQL Database

API Version:

2021-11-01

Cria um alias DNS do servidor.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/dnsAliases/{dnsAliasName}?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.

Respostas

Nome	Tipo	Description
200 OK	ServerDnsAlias	O alias DNS do servidor já existe.
201 Created	ServerDnsAlias	Criou com êxito um alias DNS do servidor.
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 antiga ID de alias do servidor, 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-4444444444444/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 em um servidor. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - Os aliases de Dns do 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 habilitado. 400 LimitOfServerDnsAliasesPerServerExceeded - A criação de novos Alias 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 - Nome do Alias DNS do Servidor Inválido foi fornecido. 400 ServerNotFound - O servidor solicitado não foi encontrado. 404 SubscriptionDoesNotHaveServer - O servidor solicitado não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 404 ResourceNotFound - O recurso solicitado não foi encontrado. 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. 404 OperationIdNotFound - A operação com Id não existe. 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. 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. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações 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 do máximo de solicitações que podem ser processadas por recursos disponíveis. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas por recursos disponíveis. 504 RequestTimeout – A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

Create server DNS alias

Sample Request

HTTP

PUT 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

import com.azure.core.util.Context;

/** Samples for ServerDnsAliases CreateOrUpdate. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerDnsAliasCreateOrUpdate.json
     */
    /**
     * Sample code: Create server DNS alias.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerDnsAliases().createOrUpdate("Default", "dns-alias-server",
            "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-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"
  }
}

Status code:

201

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

Status code:

202

Definições

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.