Managed Server Dns Aliases - Get

Dienst:

SQL Database

API-Version:

2025-01-01

Ruft einen Server-DNS-Alias ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}?api-version=2025-01-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. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	ManagedServerDnsAlias	Der angegebene DNS-Alias des verwalteten Servers wurde erfolgreich abgerufen.
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 ManagedInstanceStoppingOrStopped – Konfliktierender Vorgang, der während der Instanz beendet/beendet wird 400 ManagedInstanceStarting – Konfliktierender Vorgang, der während der Instanz im Startzustand liegt 400 InvalidManagedServerDnsAliasAcquireRequest – Der Anforderungstext für verwalteten Server-DNS-Alias ist leer oder ungültig. 400 ManagedServerDnsAliasAcquireRequestInvalidOldManagedServerDnsAliasResourceId - Die alte DNS-Alias-ID des verwalteten Servers im Anforderungstext ist leer oder ungültig (es sollte das Format haben: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}). 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasSubscriptionMismatch – Die alte DNS-Abonnement-ID des verwalteten Servers im Anforderungstext unterscheidet sich von dem in Anforderungs-URI. 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasNameMismatch – Der alte DNS-Aliasname des verwalteten Servers im Anforderungstext unterscheidet sich von dem in Anforderungs-URI. 400 InvalidServerDnsAliasNameForNamedInstance – Ungültiger Server-DNS-Aliasname wurde angegeben. 400 NameAlreadyExists – Der angegebene Name ist bereits vorhanden. 400 UnableToResolveRemoteServer – Der Name des Remotepartnerservers konnte aufgrund eines ungültigen Servernamens oder DNS-Verbindungsproblemen nicht behoben werden. 400 CannotUseReservedDatabaseName – In diesem Vorgang kann kein reservierter Datenbankname verwendet werden. 400 InvalidServerName – Ungültiger Servername angegeben. 400 InvalidIdentifier – Der Bezeichner enthält NULL oder ein ungültiges Unicode-Zeichen. 400 TokenTooLong – Das bereitgestellte Token ist zu lang. 400 InvalidServerDnsAliasName – Ungültiger Server-DNS-Aliasname wurde angegeben. 400 ServerDnsAliasDoesNotExist – Server-DNS-Alias ist auf einem Server nicht vorhanden. 400 ServerNotFound – Der angeforderte Server wurde nicht gefunden. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Server-Dns-Aliase funktionieren für Datenbank mit aktivierter Tabellenüberwachung nicht ordnungsgemäß. 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 die Datenbank '{1}' Die Tabellenüberwachung oder das Feature 'Sicherheitsaktivierter Zugriff' aktiviert ist. 400 LimitOfServerDnsAliasesPerServerExceeded - Das Erstellen eines neuen Server-Dns-Alias überschreitet die zulässige Anzahl von Server-DNS-Aliasen pro Server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias – Server-Dns-Aliase funktionieren für Server mit aktivierter Tabellenüberwachung nicht ordnungsgemäß. 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 404 SubscriptionDoesNotHaveServer – Der angeforderte Server wurde nicht gefunden. 404 ResourceNotFound – Die angeforderte Ressource wurde nicht gefunden. 404 ServerNotInSubscription – Der angegebene Server ist für das angegebene Abonnement nicht vorhanden. 404 ServerNotInSubscriptionResourceGroup – Der angegebene Server ist in der angegebenen Ressourcengruppe und dem angegebenen Abonnement nicht vorhanden. 409 ManagedServerAliasDnsZoneMismatch – Managed Server Alias Dns Zone Mismatch 409 ConflictingServerOperation – Ein Vorgang wird derzeit für den Server ausgeführt. 409 SubscriptionDisabled – Abonnement ist deaktiviert. 409 ServerDnsAliasDnsRecordInUse – Ein doppelter DNS-Eintrag ist für den angeforderten Endpunkt vorhanden. 409 ServerDnsAliasAlreadyExists – Server-DNS-Alias ist bereits auf einem bestimmten Server vorhanden. 409 ServerDnsAliasBusy – Der Server-DNS-Alias ist mit einem anderen Vorgang beschäftigt. 429 SubscriptionTooManyCreateUpdateRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 429 SubscriptionTooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 503 TooManyRequests – Anforderungen über max. Anforderungen hinaus, die von verfügbaren Ressourcen verarbeitet werden können. 504 RequestTimeout – Serviceanforderung hat das zulässige Timeout überschritten.

Beispiele

Get managed server DNS alias

Beispielanforderung

HTTP

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

Beispiel für eine Antwort

Statuscode:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/dns-mi/dnsAliases/dns-alias-mi",
  "name": "dns-alias-mi",
  "type": "Microsoft.Sql/managedInstances/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-mi.abcd1234.database.windows.net",
    "publicAzureDnsRecord": "dns-alias-mi.public.abcd1234.database.windows.net"
  }
}

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ManagedServerDnsAlias	Ein DNS-Alias für verwaltete Server.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Objekt

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ManagedServerDnsAlias

Objekt

Ein DNS-Alias für verwaltete Server.

Name	Typ	Beschreibung
id	string	Ressourcen-ID
name	string	Ressourcenname.
properties.azureDnsRecord	string	Der vollqualifizierte DNS-Eintrag für verwalteten Serveralias
properties.publicAzureDnsRecord	string	Der vollqualifizierte öffentliche DNS-Eintrag für verwalteten Serveralias
type	string	Ressourcentyp.