Managed Server Dns Aliases - Get

Servizio:

SQL Database

Versione API:

2025-01-01

Ottiene un alias DNS del server.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
dnsAliasName	path	True	string
managedInstanceName	path	True	string	Nome dell'istanza gestita.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagedServerDnsAlias	È stato recuperato correttamente l'alias DNS del server gestito specificato.
Other Status Codes	ErrorResponse	Risposte di errore: 400 ManagedInstanceStoppingOrStopped - Operazione in conflitto inviata mentre l'istanza è in stato di arresto/arresto 400 ManagedInstanceStarting - Operazione in conflitto inviata mentre l'istanza è in stato di avvio 400 InvalidManagedServerDnsAliasAcquireRequest: il corpo della richiesta dell'alias DNS del server gestito di acquisizione è vuoto o non valido. 400 ManagedServerDnsAliasAcquireRequestInvalidOldManagedServerDnsAliasResourceId - L'ID alias DNS del server gestito precedente nel corpo della richiesta è vuoto o non valido (deve avere il formato : /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}). 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasSubscriptionMismatch: l'ID sottoscrizione DNS del server gestito precedente nel corpo della richiesta è diverso da quello nell'URI della richiesta. 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasNameMismatch: il nome dell'alias DNS del server gestito precedente nel corpo della richiesta è diverso da quello nell'URI della richiesta. 400 InvalidServerDnsAliasNameForNamedInstance - È stato specificato un nome alias DNS del server non valido. 400 NameAlreadyExists - Il nome specificato esiste già. 400 UnableToResolveRemoteServer- Impossibile risolvere il nome del server partner remoto a causa di problemi di connettività DNS o nome server non validi. 400 CannotUseReservedDatabaseName: impossibile utilizzare il nome del database riservato in questa operazione. 400 InvalidServerName - Nome server non valido specificato. 400 InvalidIdentifier: l'identificatore contiene NULL o un carattere Unicode non valido. 400 TokenTooLong: il token fornito è troppo lungo. 400 InvalidServerDnsAliasName - È stato specificato un nome alias DNS del server non valido. 400 ServerDnsAliasDoesNotExist - L'alias DNS del server non esiste in un server. 400 ServerNotFound - Il server richiesto non è stato trovato. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - Gli alias DNS del server non funzionano correttamente per il database con controllo tabella attivato 400 UnableToCreateServerDnsAliasDueToTableAuditing- Impossibile creare l'alias DNS del server per il server con controllo tabella attivato. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - Impossibile creare alias DNS del server per il server '{0}' perché il database '{1}' dispone della funzionalità Controllo tabella o Accesso abilitato per la sicurezza abilitato. 400 LimitOfServerDnsAliasesPerServerExceeded: la creazione di un nuovo alias DNS del server supererà il numero consentito di alias DNS del server per server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - Gli alias DNS del server non funzionano correttamente per il server con controllo tabella attivato 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 404 SubscriptionDoesNotHaveServer - Il server richiesto non è stato trovato 404 ResourceNotFound: la risorsa richiesta non è stata trovata. 404 ServerNotInSubscription - Il server specificato non esiste nella sottoscrizione specificata. 404 ServerNotInSubscriptionResourceGroup - Il server specificato non esiste nel gruppo di risorse e nella sottoscrizione specificati. 409 ManagedServerAliasDnsZoneMismatch - Mancata corrispondenza della zona DNS alias del server gestito 409 ConflictingServerOperation: un'operazione è attualmente in corso per il server. 409 SubscriptionDisabled : la sottoscrizione è disabilitata. 409 ServerDnsAliasDnsRecordInUse: esiste un record DNS duplicato per l'endpoint richiesto. 409 ServerDnsAliasAlreadyExists - Alias DNS del server esiste già in un determinato server. 409 ServerDnsAliasBusy - Alias DNS del server è occupato con un'altra operazione. 429 SubscriptionTooManyCreateUpdateRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 429 SubscriptionTooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 503 TooManyRequests - Richieste oltre il numero massimo di richieste che possono essere elaborate dalle risorse disponibili. 504 RequestTimeout : la richiesta di servizio ha superato il timeout consentito.

Esempio

Get managed server DNS alias

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ManagedServerDnsAlias	Alias DNS del server gestito.

ErrorAdditionalInfo

Oggetto

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Oggetto

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Oggetto

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ManagedServerDnsAlias

Oggetto

Alias DNS del server gestito.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.azureDnsRecord	string	Record DNS completo per l'alias del server gestito
properties.publicAzureDnsRecord	string	Record DNS pubblico completo per l'alias del server gestito
type	string	Tipo di risorsa.