Server Dns Aliases - Acquire

Serviço:: SQL Database

Versão da API:: 2023-08-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=2023-08-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. Você pode obter esse valor da API do Azure Resource Manager ou 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 do Pedido

Name	Necessário	Tipo	Description
oldServerDnsAliasId	True	string	A 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		Aceito Cabeçalhos Location: string
Other Status Codes	ErrorResponse	Respostas de erro: *** 400 InvalidServerName - Nome do servidor inválido especificado. 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido. 400 TokenTooLong - O token fornecido é muito longo. 400 InvalidServerDnsAliasAcquireRequest - O corpo da solicitação de alias de 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 - O id de alias DNS do servidor antigo no corpo da solicitação está vazio ou é inválido (deve ter o formato: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 UnableToResolveRemoteServer - O nome do servidor de parceiro remoto não pôde ser resolvido devido a um nome de servidor inválido ou problemas de conectividade DNS. 400 CannotUseReservedDatabaseName - Não é possível usar o nome do banco de dados reservado nesta operação. 400 InvalidServerName - Nome do servidor inválido especificado. 400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido. 400 TokenTooLong - O token fornecido é muito longo. 400 InvalidServerDnsAliasName - O nome do alias DNS do servidor inválido foi fornecido. 400 ServerDnsAliasDoesNotExist - O Alias DNS do Servidor não existe em um servidor. 400 ServerNotFound - O servidor solicitado não foi encontrado. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - 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 tenha 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 de Auditoria de Tabela ou Acesso Habilitado para Segurança habilitado. 400 LimitOfServerDnsAliasesPerServerExceeded - A criação de um novo Alias DNS de Servidor excederá o número permitido de Aliases DNS de 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 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 ServerNotInSubscription - O servidor especificado não existe na assinatura especificada. 404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados. 409 CannotCancelOperation - A operação de gerenciamento está em um estado que não pode ser cancelado. 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 ConflictingServerOperation - Uma operação está atualmente em andamento para o servidor. 409 SubscriptionDisabled - A subscrição está desativada. 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 ServerDnsAliasBusy - O Alias DNS do Servidor está ocupado com outra operação. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis. 504 RequestTimeout - A solicitação de serviço excedeu o tempo limite permitido.

Name

Tipo

Description

200 OK

ServerDnsAlias

Alias DNS do servidor adquirido com êxito.

202 Accepted

Aceito

Cabeçalhos

Location: string

Other Status Codes

ErrorResponse

Respostas de erro: ***

400 InvalidServerName - Nome do servidor inválido especificado.
400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.
400 TokenTooLong - O token fornecido é muito longo.
400 InvalidServerDnsAliasAcquireRequest - O corpo da solicitação de alias de 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 - O id de alias DNS do servidor antigo no corpo da solicitação está vazio ou é inválido (deve ter o formato: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1).
400 UnableToResolveRemoteServer - O nome do servidor de parceiro remoto não pôde ser resolvido devido a um nome de servidor inválido ou problemas de conectividade DNS.
400 CannotUseReservedDatabaseName - Não é possível usar o nome do banco de dados reservado nesta operação.
400 InvalidServerName - Nome do servidor inválido especificado.
400 InvalidIdentifier - O identificador contém NULL ou um caractere unicode inválido.
400 TokenTooLong - O token fornecido é muito longo.
400 InvalidServerDnsAliasName - O nome do alias DNS do servidor inválido foi fornecido.
400 ServerDnsAliasDoesNotExist - O Alias DNS do Servidor não existe em um servidor.
400 ServerNotFound - O servidor solicitado não foi encontrado.
400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - 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 tenha 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 de Auditoria de Tabela ou Acesso Habilitado para Segurança habilitado.
400 LimitOfServerDnsAliasesPerServerExceeded - A criação de um novo Alias DNS de Servidor excederá o número permitido de Aliases DNS de 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
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 ServerNotInSubscription - O servidor especificado não existe na assinatura especificada.
404 ServerNotInSubscriptionResourceGroup - O servidor especificado não existe no grupo de recursos e na assinatura especificados.
409 CannotCancelOperation - A operação de gerenciamento está em um estado que não pode ser cancelado.
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 ConflictingServerOperation - Uma operação está atualmente em andamento para o servidor.
409 SubscriptionDisabled - A subscrição está desativada.
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 ServerDnsAliasBusy - O Alias DNS do Servidor está ocupado com outra operação.
429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.
429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.
429 SubscriptionTooManyCreateUpdateRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.
429 SubscriptionTooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.
500 OperationTimedOut - A operação atingiu o tempo limite e foi revertida automaticamente. Por favor, tente novamente a operação.
503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.
503 TooManyRequests - Solicitações além do máximo de solicitações que podem ser processadas pelos recursos disponíveis.
504 RequestTimeout - A solicitação de serviço excedeu o tempo limite permitido.

Exemplos

Acquire server DNS alias

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=2023-08-01

{
  "oldServerDnsAliasId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1"
}

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Sql.Models;
using Azure.ResourceManager.Sql;

// Generated from example definition: specification/sql/resource-manager/Microsoft.Sql/stable/2023-08-01/examples/ServerDnsAliasAcquire.json
// this example is just showing the usage of "ServerDnsAliases_Acquire" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this SqlServerDnsAliasResource created on azure
// for more information of creating SqlServerDnsAliasResource, please refer to the document of SqlServerDnsAliasResource
string subscriptionId = "00000000-1111-2222-3333-444444444444";
string resourceGroupName = "Default";
string serverName = "dns-alias-new-server";
string dnsAliasName = "dns-alias-name-1";
ResourceIdentifier sqlServerDnsAliasResourceId = SqlServerDnsAliasResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, serverName, dnsAliasName);
SqlServerDnsAliasResource sqlServerDnsAlias = client.GetSqlServerDnsAliasResource(sqlServerDnsAliasResourceId);

// invoke the operation
ServerDnsAliasAcquisition serverDnsAliasAcquisition = new ServerDnsAliasAcquisition(new ResourceIdentifier("/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1"));
ArmOperation<SqlServerDnsAliasResource> lro = await sqlServerDnsAlias.AcquireAsync(WaitUntil.Completed, serverDnsAliasAcquisition);
SqlServerDnsAliasResource result = lro.Value;

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
SqlServerDnsAliasData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

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

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/serverDnsAliasOperationResults/00000000-1111-2222-3333-444444444444?api-version=2017-03-01-preview

Definições

Name	Description
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
ServerDnsAlias	Um alias DNS do servidor.
ServerDnsAliasAcquisition	Uma solicitação de aquisição de alias de servidor dns.

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.

ServerDnsAlias

Object

Um alias DNS do servidor.

Name	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

Object

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

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

Partilhar via

Server Dns Aliases - Acquire

Parâmetros do URI

Corpo do Pedido

Respostas

Exemplos

Acquire server DNS alias

Pedido de amostra

Resposta da amostra

Definições

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ServerDnsAlias

ServerDnsAliasAcquisition