Server Dns Aliases - Get

Tjänst:

SQL Database

API-version:

2023-08-01

Hämtar ett DNS-alias för servern.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
dnsAliasName	path	True	string	Namnet på serverns DNS-alias.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
serverName	path	True	string	Namnet på den server som aliaset pekar på.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	ServerDnsAlias	Det angivna DNS-aliaset för servern har hämtats.
Other Status Codes	ErrorResponse	Felsvar: *** 400 ManagedInstanceStoppingOrS toppad – Konfliktåtgärd som skickas när instansen är i stopptillstånd 400 ManagedInstanceStarting – Konfliktåtgärd som skickas när instansen är i starttillstånd 400 InvalidServerDnsAliasAcquireRequest – begärandetexten för server-DNS-alias är tom eller ogiltig (den bör innehålla det gamla serveralias-ID:t, till exempel: /subscriptions/00000000-1111-2222-3333-4444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId – Det gamla DNS-alias-ID:t i begärandetexten är tomt eller ogiltigt (det bör ha formuläret: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 UnableToResolveRemoteServer – Det gick inte att lösa namnet på fjärrpartnerservern på grund av ett ogiltigt servernamn eller DNS-anslutningsproblem. 400 CannotUseReservedDatabaseName – Det går inte att använda reserverat databasnamn i den här åtgärden. 400 InvalidServerName – Ogiltigt servernamn har angetts. 400 InvalidIdentifier – Identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 TokenTooLong – den angivna token är för lång. 400 InvalidServerDnsAliasName – Ogiltigt DNS-alias för server angavs. 400 ServerDnsAliasDoesNotExist – Serverns DNS-alias finns inte på en server. 400 ServerNotFound – Den begärda servern hittades inte. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Serverns Dns-alias fungerar inte korrekt för databas som har Tabellgranskning aktiverat 400 UnableToCreateServerDnsAliasDueToTableAuditing – Serverns DNS-alias kan inte skapas för en server som har aktiverat tabellgranskning. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb – Dns-alias för server kan inte skapas för serverns{0}eftersom databasen{1}har funktionen Table Auditing eller Security Enabled Access aktiverat. 400 LimitOfServerDnsAliasesPerServerExceededed – Om du skapar ett nytt Server Dns-alias överskrids det tillåtna antalet DNS-serveralias per server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias – Serverns DNS-alias fungerar inte korrekt för server som har Table Auditing aktiverat 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 SubscriptionDoesNotHaveServer – Den begärda servern hittades inte 404 ResourceNotFound – Den begärda resursen hittades inte. 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen. 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 409 ConflictingServerOperation – En åtgärd pågår för närvarande för servern. 409 SubscriptionDisabled – Prenumerationen är inaktiverad. 409 ServerDnsAliasDnsRecordInUse – Det finns en duplicerad DNS-post för den begärda slutpunkten. 409 ServerDnsAliasAlreadyExists – Serverns DNS-alias finns redan på en viss server. 409 ServerDnsAliasBusy – Serverns DNS-alias är upptaget med en annan åtgärd. 429 SubscriptionTooManyCreateUpdateRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – Begäranden utöver maxbegäranden som kan bearbetas av tillgängliga resurser. 503 TooManyRequests – Begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 504 RequestTimeout – Tjänstbegäran överskred den tillåtna tidsgränsen.

Exempel

Get server DNS alias

Exempelbegäran

HTTP

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=2023-08-01

Exempelsvar

Statuskod:

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

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ServerDnsAlias	Ett DNS-alias för servern.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ServerDnsAlias

Objekt

Ett DNS-alias för servern.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.azureDnsRecord	string	Den fullständigt kvalificerade DNS-posten för alias
type	string	Resurstyp.