Freigeben über


Managed Server Dns Aliases - Create Or Update

Erstellt einen DNS-Alias für einen verwalteten Server.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}?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 Typ Beschreibung
createDnsRecord

boolean

Gibt an, ob ein DNS-Eintrag für diesen Alias erstellt werden soll.

Antworten

Name Typ Beschreibung
200 OK

ManagedServerDnsAlias

Der DNS-Alias für den verwalteten Server ist bereits vorhanden.

201 Created

ManagedServerDnsAlias

Ein DNS-Alias für verwaltete Server wurde erfolgreich erstellt.

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

  • 404 OperationIdNotFound: Der Vorgang mit der ID ist nicht vorhanden.

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

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

  • 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

Create managed server DNS alias

Beispielanforderung

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

{}

Beispiel für eine Antwort

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

Definitionen

Name Beschreibung
ManagedServerDnsAlias

Ein DNS-Alias für einen verwalteten Server.

ManagedServerDnsAliasCreation

Eine Dns-Aliaserstellungsanforderung 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.

ManagedServerDnsAliasCreation

Eine Dns-Aliaserstellungsanforderung für einen verwalteten Server.

Name Typ Standardwert Beschreibung
createDnsRecord

boolean

True

Gibt an, ob ein DNS-Eintrag für diesen Alias erstellt werden soll.