Managed Server Dns Aliases - Acquire

Dienst:

SQL Database

API-Version:

2021-11-01

Ruft den DNS-Alias für verwaltete Server von einem anderen verwalteten Server ab.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
dnsAliasName	path	True	string
managedInstanceName	path	True	string	Der Name der verwalteten Instanz.
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.
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
oldManagedServerDnsAliasResourceId	True	string	Die Ressourcen-ID des DNS-Alias des verwalteten Servers, der stattdessen abgerufen wird, um auf diesen verwalteten Server zu verweisen.

Antworten

Name	Typ	Beschreibung
200 OK	ManagedServerDnsAlias	Der DNS-Alias für verwaltete Server wurde erfolgreich abgerufen.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 InvalidManagedServerDnsAliasAcquireRequest: Der DNS-Aliastext des abrufenden verwalteten Servers ist leer oder ungültig. 400 ManagedServerDnsAliasAcquireRequestInvalidOldManagedServerDnsAliasResourceId : Die DNS-Alias-ID des alten verwalteten Servers im Anforderungstext ist leer oder ungültig (sie sollte das Format haben: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}). 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasSubscriptionMismatch: Die DNS-Abonnement-ID des alten verwalteten Servers im Anforderungstext unterscheidet sich von der ID im Anforderungs-URI. 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasNameMismatch: Der DNS-Aliasname des alten verwalteten Servers im Anforderungstext unterscheidet sich von dem im Anforderungs-URI. 400 ServerDnsAliasDoesNotExist: Server-DNS-Alias ist auf einem Server nicht vorhanden. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Server-DNS-Aliase funktionieren nicht ordnungsgemäß für Datenbanken, 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 für die Datenbank "{1}" die Funktion "Tabellenüberwachung" oder "Sicherheit aktivierter Zugriff" aktiviert ist. 400 LimitOfServerDnsAliasesPerServerExceeded: Beim Erstellen eines neuen Dns-Serveralias wird die zulässige Anzahl von Server-DNS-Aliasen pro Server überschritten. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias : Server-DNS-Aliase funktionieren nicht ordnungsgemäß für Server, auf denen die Tabellenüberwachung aktiviert ist 400 NameAlreadyExists: Der angegebene Name ist bereits vorhanden. 400 CannotUseReservedDatabaseName: Der Name der reservierten Datenbank kann in diesem Vorgang nicht verwendet werden. 400 TokenTooLong: Das bereitgestellte Token ist zu lang. 400 InvalidServerDnsAliasNameForNamedInstance: Ungültiger DNS-Aliasname des Servers wurde angegeben. 400 UnableToResolveRemoteServer: Der Name des Remotepartnerservers konnte aufgrund eines ungültigen Servernamens oder DNS-Konnektivitätsproblemen 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 DNS-Aliasname des Servers 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 ausgelastet. 409 SubscriptionDisabled: Das Abonnement ist deaktiviert. 409 ManagedServerAliasDnsZoneMismatch – Dns-Zonenkonflikt des Verwalteten Serveralias 409 ServerDnsAliasDnsRecordInUse: Für den angeforderten Endpunkt ist ein doppelter DNS-Eintrag vorhanden. 409 ServerDnsAliasAlreadyExists: Server-DNS-Alias ist bereits auf einem bestimmten Server vorhanden. 409 ConflictingServerOperation: Für den Server wird derzeit ein Vorgang 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: Timeout des Vorgangs und automatisches Rollback. 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 managed server DNS alias.

Beispielanforderung

HTTP

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

{
  "oldManagedServerDnsAliasResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/old-mi/dnsAliases/alias1"
}

Java

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

/**
 * Samples for ManagedServerDnsAliases Acquire.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedServerDnsAliasAcquire.json
     */
    /**
     * Sample code: Acquire managed server DNS alias.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void acquireManagedServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedServerDnsAliases().acquire("Default", "new-mi",
            "dns-alias-mi",
            new ManagedServerDnsAliasAcquisition().withOldManagedServerDnsAliasResourceId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/old-mi/dnsAliases/alias1"),
            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/managedInstances/new-mi/dnsAliases/alias1",
  "name": "alias1",
  "type": "Microsoft.Sql/managedInstances/dnsAliases",
  "properties": {
    "azureDnsRecord": "alias1.abcd1234.database.windows.net"
  }
}

Statuscode:

202

Definitionen

Name	Beschreibung
ManagedServerDnsAlias	Ein DNS-Alias für einen verwalteten Server.
ManagedServerDnsAliasAcquisition	Eine DNS-Aliasakquisanforderung für einen verwalteten Server.

ManagedServerDnsAlias

Ein DNS-Alias für einen verwalteten Server.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Name der Ressource.
properties.azureDnsRecord	string	Der vollqualifizierte DNS-Eintrag für den Alias des verwalteten Servers
properties.publicAzureDnsRecord	string	Der vollqualifizierte öffentliche DNS-Eintrag für den Alias des verwalteten Servers
type	string	Der Ressourcentyp.

ManagedServerDnsAliasAcquisition

Eine DNS-Aliasakquisanforderung für einen verwalteten Server.

Name	Typ	Beschreibung
oldManagedServerDnsAliasResourceId	string	Die Ressourcen-ID des DNS-Alias des verwalteten Servers, der stattdessen abgerufen wird, um auf diesen verwalteten Server zu verweisen.