Server Dns Aliases - Acquire

Servizio:

SQL Database

Versione API:

2021-11-01

Acquisisce l'alias DNS del server da un altro server.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/dnsAliases/{dnsAliasName}/acquire?api-version=2021-11-01

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
dnsAliasName	path	True	string	Nome dell'alias DNS del server.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
serverName	path	True	string	Nome del server a cui punta l'alias.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Corpo della richiesta

Nome	Necessario	Tipo	Descrizione
oldServerDnsAliasId	True	string	ID dell'alias del server che verrà acquisito in modo da puntare al server.

Risposte

Nome	Tipo	Descrizione
200 OK	ServerDnsAlias	L'alias DNS del server è stato acquisito correttamente.
202 Accepted		Accettato
Other Status Codes		Risposte di errore: 400 InvalidServerDnsAliasAcquireRequest - Il corpo della richiesta alias DNS del server di acquisizione è vuoto o non valido (deve contenere l'ID alias del server precedente, ad esempio: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId - L'ID alias DNS del server precedente nel corpo della richiesta è vuoto o non valido (deve avere il formato : /subscriptions/000000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasDoesNotExist - L'alias DNS del server non esiste in un server. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - Gli alias DNS del server non funzionano correttamente per il database con controllo tabella attivato 400 UnableToCreateServerDnsAliasDueToTableAuditing- Impossibile creare l'alias DNS del server per il server con controllo tabella attivato. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - Impossibile creare alias DNS del server per il server '{0}' perché il database '{1}' dispone della funzionalità Controllo tabella o Accesso abilitato per la sicurezza abilitato. 400 LimitOfServerDnsAliasesPerServerExceeded: la creazione di un nuovo alias DNS del server supererà il numero consentito di alias DNS del server per server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - Gli alias DNS del server non funzionano correttamente per il server con controllo tabella attivato 400 CannotUseReservedDatabaseName: impossibile utilizzare il nome del database riservato in questa operazione. 400 TokenTooLong: il token fornito è troppo lungo. 400 UnableToResolveRemoteServer- Impossibile risolvere il nome del server partner remoto a causa di problemi di connettività DNS o nome server non validi. 400 InvalidServerName - Nome server non valido specificato. 400 InvalidIdentifier: l'identificatore contiene NULL o un carattere Unicode non valido. 400 InvalidServerDnsAliasName - È stato specificato un nome alias DNS del server non valido. 400 ServerNotFound - Il server richiesto non è stato trovato. 404 OperationIdNotFound - L'operazione con ID non esiste. 404 ResourceNotFound: la risorsa richiesta non è stata trovata. 404 OperationIdNotFound - L'operazione con ID non esiste. 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 ServerNotInSubscription - Il server specificato non esiste nella sottoscrizione specificata. 409 OperationCancelled - L'operazione è stata annullata dall'utente. 409 OperationInterrupted - Impossibile completare l'operazione sulla risorsa perché è stata interrotta da un'altra operazione sulla stessa risorsa. 409 ServerDnsAliasBusy - Alias DNS del server è occupato con un'altra operazione. 409 SubscriptionDisabled : la sottoscrizione è disabilitata. 409 ServerDnsAliasDnsRecordInUse: esiste un record DNS duplicato per l'endpoint richiesto. 409 ServerDnsAliasAlreadyExists - Alias DNS del server esiste già in un determinato server. 409 ConflictingServerOperation: un'operazione è attualmente in corso per il server. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 500 OperationTimedOut: timeout dell'operazione e rollback automatico. Ripetere l'operazione. 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

Esempio

Acquire server DNS alias

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Codice di stato:

202

Definizioni

Nome	Descrizione
ServerDnsAlias	Alias DNS del server.
ServerDnsAliasAcquisition	Richiesta di acquisizione alias dns del server.

ServerDnsAlias

Object

Alias DNS del server.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.azureDnsRecord	string	Record DNS completo per alias
type	string	Tipo di risorsa.

ServerDnsAliasAcquisition

Object

Richiesta di acquisizione alias dns del server.

Nome	Tipo	Descrizione
oldServerDnsAliasId	string	ID dell'alias del server che verrà acquisito in modo da puntare al server.