Managed Server Dns Aliases - Create Or Update

Referência

Serviço:: SQL Database

Versão da API:: 2021-11-01

Cria um alias DNS de servidor gerido.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}?api-version=2021-11-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
dnsAliasName	path	True	string
managedInstanceName	path	True	string	O nome da instância gerida.
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.
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	Tipo	Description
createDnsRecord	boolean	Se o registo DNS deve ou não ser criado para este alias.

Respostas

Name	Tipo	Description
200 OK	ManagedServerDnsAlias	O alias DNS do servidor gerido já existe.
201 Created	ManagedServerDnsAlias	Criou com êxito um alias DNS de servidor gerido.
202 Accepted		Aceite
Other Status Codes		Respostas de Erro: *** 400 InvalidManagedServerDnsAliasAcquireRequest – o corpo do pedido de alias DNS do servidor gerido de aquisição está vazio ou é inválido. 400 ManagedServerDnsAliasAcquireRequestInvalidOldManagedServerDnsAliasResourceId – o ID de alias DNS do servidor gerido antigo no corpo do pedido está vazio ou inválido (deve ter o formato: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}). 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasSubscriptionMismatch – o ID de subscrição DNS do servidor gerido antigo no corpo do pedido é diferente do do URI do pedido. 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasNameMismatch – o nome do alias DNS do servidor gerido antigo no corpo do pedido é diferente do do URI do pedido. 400 ServerDnsAliasDoesNotExist – O Alias DNS do Servidor não existe num servidor. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - Os Aliases Dns do Servidor não estão a funcionar corretamente para a base de dados que tem a Auditoria de Tabelas ativada 400 UnableToCreateServerDnsAliasDueToTableAuditing – o Alias DNS do Servidor não pode ser criado para o servidor que tenha 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 para Segurança ativada. 400 LimitOfServerDnsAliasesPerServerExceeded - A criação de novos Alias Dns do Servidor excederá o número permitido de Aliases DNS de 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 Tabelas ativada 400 NameAlreadyExists – o nome fornecido já existe. 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 InvalidServerDnsAliasNameForNamedInstance – foi fornecido um nome de Alias DNS de Servidor inválido. 400 UnableToResolveRemoteServer – não foi possível resolver o nome do servidor do parceiro remoto devido a um nome de servidor inválido ou a problemas de conectividade DNS. 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 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 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 ManagedServerAliasDnsZoneMismatch - Erro de Correspondência da Zona Dns do Alias do Servidor Gerido 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 dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyCreateUpdateRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 429 SubscriptionTooManyRequests - Pedidos para além dos pedidos máximos 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 dos pedidos máximos que podem ser processados por recursos disponíveis. 503 TooManyRequests - Pedidos para além dos pedidos máximos que podem ser processados por recursos disponíveis. 504 RequestTimeout - O pedido de serviço excedeu o tempo limite permitido.

Exemplos

Create managed server DNS alias

PUT https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/dns-mi/dnsAliases/dns-alias-mi?api-version=2021-11-01

{}


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

/**
 * Samples for ManagedServerDnsAliases CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedServerDnsAliasCreateOrUpdate.
     * json
     */
    /**
     * Sample code: Create managed server DNS alias.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createManagedServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedServerDnsAliases().createOrUpdate("Default", "dns-mi",
            "dns-alias-mi", new ManagedServerDnsAliasCreation(), 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/managedInstances/dns-mi/dnsAliases/dns-alias-mi",
  "name": "dns-alias-mi",
  "type": "Microsoft.Sql/managedInstances/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-mi.abcd1234.database.windows.net"
  }
}

Código de estado:: 201

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/dns-mi/dnsAliases/dns-alias-mi",
  "name": "dns-alias-mi",
  "type": "Microsoft.Sql/managedInstances/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-mi.abcd1234.database.windows.net"
  }
}

Código de estado:: 202

Definições

Name	Description
ManagedServerDnsAlias	Um alias DNS de servidor gerido.
ManagedServerDnsAliasCreation	Um pedido de criação de alias de dns do servidor gerido.

ManagedServerDnsAlias

Object

Um alias DNS de servidor gerido.

Name	Tipo	Description
id	string	ID do Recurso.
name	string	Nome do recurso.
properties.azureDnsRecord	string	O registo DNS completamente qualificado para alias de servidor gerido
properties.publicAzureDnsRecord	string	O registo DNS público completamente qualificado para alias de servidor gerido
type	string	Tipo de recurso.

ManagedServerDnsAliasCreation