Server Dns Aliases - Acquire

Dienst:

SQL Database

API-Version:

2021-11-01

Ruft Server-DNS-Alias von einem anderen Server ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dnsAliasName	path	True	string	Der Name des Server-DNS-Alias.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.
serverName	path	True	string	Der Name des Servers, auf den der Alias verweist.
subscriptionId	path	True	string	Abonnement-ID für ein Azure-Abonnement.
api-version	query	True	string	API-Version, die für die Anforderung verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ	Beschreibung
oldServerDnsAliasId	True	string	Die ID des Serveralias, der stattdessen abgerufen wird, um auf diesen Server zu verweisen.

Antworten

Name	Typ	Beschreibung
200 OK	ServerDnsAlias	Der DNS-Alias des Servers wurde erfolgreich abgerufen.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 InvalidServerDnsAliasAcquireRequest: Der Dns-Aliasanforderungstext des Acquire-Servers ist leer oder ungültig (er sollte die alte Serveralias-ID enthalten, Beispiel: /subscriptions/0000000000-1111-2222-3333-4444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId: Die alte SERVER-DNS-Alias-ID im Anforderungstext ist leer oder ungültig (sie sollte das Format haben: /subscriptions/000000000-1111 -2222-3333-44444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasDoesNotExist: Server-DNS-Alias ist auf einem Server nicht vorhanden. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias : Server-DNS-Aliase funktionieren nicht ordnungsgemäß für Datenbank, für die die Tabellenüberwachung aktiviert ist 400 UnableToCreateServerDnsAliasDueToTableAuditing: Der Server-DNS-Alias kann nicht für Server erstellt werden, auf dem die Tabellenüberwachung aktiviert ist. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb: Server-DNS-Alias kann nicht für Server "{0}" erstellt werden, da in der Datenbank "{1}" das Feature "Tabellenüberwachung" oder "Sicherheitsaktivierter Zugriff" aktiviert ist. 400 LimitOfServerDnsAliasesPerServerExceeded: Das Erstellen eines neuen Server-DNS-Aliases überschreitet die zulässige Anzahl von Server-DNS-Aliasen pro Server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias: Server-DNS-Aliase funktionieren nicht ordnungsgemäß für Server, auf denen die Tabellenüberwachung aktiviert ist 400 CannotUseReservedDatabaseName: Der name der reservierten Datenbank kann in diesem Vorgang nicht verwendet werden. 400 TokenTooLong: Das bereitgestellte Token ist zu lang. 400 UnableToResolveRemoteServer: Der Name des Remotepartnerservers konnte aufgrund eines ungültigen Servernamens oder DNS-Konnektivitätsprobleme nicht aufgelöst werden. 400 InvalidServerName: Ungültiger Servername angegeben. 400 InvalidIdentifier: Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen. 400 InvalidServerDnsAliasName: Ungültiger SERVER-DNS-Aliasname wurde angegeben. 400 ServerNotFound: Der angeforderte Server wurde nicht gefunden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden. 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden. 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 ServerNotInSubscription: Der angegebene Server ist im angegebenen Abonnement nicht vorhanden. 409 OperationCancelled: Der Vorgang wurde vom Benutzer abgebrochen. 409 OperationInterrupted: Der Vorgang für die Ressource konnte nicht abgeschlossen werden, da er durch einen anderen Vorgang für dieselbe Ressource unterbrochen wurde. 409 ServerDnsAliasBusy: Server-DNS-Alias ist mit einem anderen Vorgang beschäftigt. 409 SubscriptionDisabled: Das Abonnement ist deaktiviert. 409 ServerDnsAliasDnsRecordInUse: Für den angeforderten Endpunkt ist ein doppelter DNS-Eintrag vorhanden. 409 ServerDnsAliasAlreadyExists: Server-DNS-Alias ist auf einem bestimmten Server bereits vorhanden. 409 ConflictingServerOperation: Derzeit wird ein Vorgang für den Server ausgeführt. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyCreateUpdateRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 500 OperationTimedOut: Der Vorgang ist timeout und wird automatisch zurückgesetzt. Wiederholen Sie den Vorgang. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 503 TooManyRequests: Anforderungen, die über die maximale Anzahl von Anforderungen hinausgehen, die von verfügbaren Ressourcen verarbeitet werden können. 504 RequestTimeout: Die Dienstanforderung hat das zulässige Timeout überschritten.

Beispiele

Acquire server DNS alias

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Statuscode:

202

Definitionen

Name	Beschreibung
ServerDnsAlias	Ein Server-DNS-Alias.
ServerDnsAliasAcquisition	Eine Dns-Aliasakquisitionsanforderung des Servers.

ServerDnsAlias

Ein Server-DNS-Alias.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.azureDnsRecord	string	Der vollqualifizierte DNS-Eintrag für Alias
type	string	Der Ressourcentyp.

ServerDnsAliasAcquisition

Eine Dns-Aliasakquisitionsanforderung des Servers.

Name	Typ	Beschreibung
oldServerDnsAliasId	string	Die ID des Serveralias, der stattdessen abgerufen wird, um auf diesen Server zu verweisen.