Server Dns Aliases - Create Or Update

Serviço:

SQL Database

Versão da API:

2021-11-01

Cria um alias de 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 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.

Respostas

Name	Tipo	Description
200 OK	ServerDnsAlias	O alias DNS do servidor já existe.
201 Created	ServerDnsAlias	Criou com êxito um alias de DNS do servidor.
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 SubscriptionDoesNotHaveServer – O servidor pedido não foi encontrado 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na subscrição especificados. 404 ResourceNotFound – o recurso pedido não foi encontrado. 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. 404 OperationIdNotFound – a operação com o ID não existe. 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. 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. 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

Create server DNS alias

Pedido de amostra

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

Resposta da amostra

Código de estado:

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

Código de estado:

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

Código de estado:

202

Definições

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.