Freigeben über

Server Dns Aliases - Get

  • Referenz
Dienst:
SQL Database
API-Version:
2021-11-01

Ruft einen DNS-Alias für einen Server ab.

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

URI-Parameter

Name In Erforderlich Typ Beschreibung
dnsAliasName
 path True

string

Der Name des DNS-Alias des Servers.
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.

Antworten

Name Typ Beschreibung
200 OK

ServerDnsAlias

Der angegebene DNS-Alias des Servers wurde erfolgreich abgerufen.
Other Status Codes

Fehlerantworten: ***

  • 400 InvalidServerDnsAliasAcquireRequest: Der Dns-Alias-Anforderungstext des Acquire-Servers ist leer oder ungültig (er sollte die alte Serveralias-ID enthalten, Beispiel: /subscriptions/00000000-1111-2222-3333-44444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1).

  • 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId : Die DNS-Alias-ID des alten Servers im Anforderungstext ist leer oder ungültig (sie sollte das Format /subscriptions/00000000-1111 haben. -2222-3333-4444444444444/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 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 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ä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 SubscriptionDoesNotHaveServer: Der angeforderte Server wurde nicht gefunden.

  • 404 ServerNotInSubscriptionResourceGroup: Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden.

  • 404 ResourceNotFound: Die angeforderte Ressource wurde nicht gefunden.

  • 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 ServerDnsAliasBusy : Server-DNS-Alias ist mit einem anderen Vorgang ausgelastet.

  • 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 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.

  • 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

Get server DNS alias

Beispielanforderung

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-name-1?api-version=2021-11-01

Beispiel für eine Antwort

Statuscode:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-name-1",
  "name": "dns-alias-name-1",
  "type": "Microsoft.Sql/servers/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-name-1.database.windows.net"
  }
}

Definitionen

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.