Server Dns Aliases - Create Or Update

Dienst:

SQL Database

API-Version:

2021-11-01

Erstellt einen Server-DNS-Alias.

PUT 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 Server-DNS-Alias.
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 Server-DNS-Alias ist bereits vorhanden.
201 Created	ServerDnsAlias	Erfolgreich einen Server-DNS-Alias erstellt.
202 Accepted		Akzeptiert
Other Status Codes		Fehlerantworten: *** 400 InvalidServerDnsAliasAcquireRequest: Der Dns-Aliasanforderungstext des Acquire-Servers ist leer oder ungültig (er sollte die alte Serveralias-ID enthalten, Beispiel: /subscriptions/0000000000-1111-2222-3333-4444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId: Die alte SERVER-DNS-Alias-ID im Anforderungstext ist leer oder ungültig (sie sollte das Format haben: /subscriptions/000000000-1111 -2222-3333-44444444444444/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 Datenbank, 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 in der Datenbank "{1}" das Feature "Tabellenüberwachung" oder "Sicherheitsaktivierter Zugriff" aktiviert ist. 400 LimitOfServerDnsAliasesPerServerExceeded: Das Erstellen eines neuen Server-DNS-Aliases überschreitet die zulässige Anzahl von Server-DNS-Aliasen pro Server. 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ätsprobleme 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 SERVER-DNS-Aliasname 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 beschäftigt. 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 auf einem bestimmten Server bereits vorhanden. 409 ConflictingServerOperation: Derzeit wird ein Vorgang für den Server 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: Der Vorgang ist timeout und wird automatisch zurückgesetzt. 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 server DNS alias

Beispielanforderung

HTTP

PUT 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

Java

/**
 * Samples for ServerDnsAliases CreateOrUpdate.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerDnsAliasCreateOrUpdate.json
     */
    /**
     * Sample code: Create server DNS alias.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void createServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerDnsAliases().createOrUpdate("Default", "dns-alias-server",
            "dns-alias-name-1", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

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

Statuscode:

201

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

Statuscode:

202

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.