Server Dns Aliases - Acquire

Service:

SQL Database

API Version:

2021-11-01

Hiermee verkrijgt u de DNS-alias van de server van een andere server.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/dnsAliases/{dnsAliasName}/acquire?api-version=2021-11-01

URI-parameters

Name	In	Vereist	Type	Description
dnsAliasName	path	True	string	De naam van de dns-alias van de server.
resourceGroupName	path	True	string	De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
serverName	path	True	string	De naam van de server waarnaar de alias verwijst.
subscriptionId	path	True	string	De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version	query	True	string	De API-versie die moet worden gebruikt voor de aanvraag.

Aanvraagbody

Name	Vereist	Type	Description
oldServerDnsAliasId	True	string	De id van de serveralias die wordt verkregen om in plaats daarvan naar deze server te verwijzen.

Antwoorden

Name	Type	Description
200 OK	ServerDnsAlias	De DNS-alias van de server is verkregen.
202 Accepted		Geaccepteerd
Other Status Codes		Foutreacties: *** 400 InvalidServerDnsAliasAcquireRequest - De aanvraagtekst van de DNS-alias voor de verkrijgenserver is leeg of ongeldig (deze moet de oude alias-id van de server bevatten, bijvoorbeeld: /subscriptions/00000000-1111-2222-3333-444444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId - De oude dns-alias-id van de server in de aanvraagtekst is leeg of ongeldig (deze moet de volgende notatie hebben: /subscriptions/00000000-1111--2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasDoesNotExist - Server DNS-alias bestaat niet op een server. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - Server DNS-aliassen werken niet goed voor database waarvoor Tabelcontrole is ingeschakeld 400 UnableToCreateServerDnsAliasDueToTableAuditing: de server-DNS-alias kan niet worden gemaakt voor server waarop tabelcontrole is ingeschakeld. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - Server-DNS-alias kan niet worden gemaakt voor server '{0}' omdat in de database de{1} functie Tabelcontrole of Toegang met beveiliging is ingeschakeld. 400 LimitOfServerDnsAliasesPerServerExceeded : het maken van een nieuwe server-DNS-alias overschrijdt het toegestane aantal server-DNS-aliassen per server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - Server DNS-aliassen werken niet goed voor server waarop Tabelcontrole is ingeschakeld 400 CannotUseReservedDatabaseName : kan de gereserveerde databasenaam niet gebruiken in deze bewerking. 400 TokenTooLong : het opgegeven token is te lang. 400 UnableToResolveRemoteServer - De servernaam van de externe partner kan niet worden omgezet vanwege een ongeldige servernaam of dns-connectiviteitsproblemen. 400 InvalidServerName - Ongeldige servernaam opgegeven. 400 InvalidIdentifier: de id bevat NULL of een ongeldig Unicode-teken. 400 InvalidServerDnsAliasName - Ongeldige server-DNS-aliasnaam is opgegeven. 400 ServerNotFound - De aangevraagde server is niet gevonden. 404 OperationIdNotFound - De bewerking met id bestaat niet. 404 ResourceNotFound - De aangevraagde resource is niet gevonden. 404 OperationIdNotFound - De bewerking met id bestaat niet. 404 ServerNotInSubscriptionResourceGroup : de opgegeven server bestaat niet in de opgegeven resourcegroep en het opgegeven abonnement. 404 ServerNotInSubscription : de opgegeven server bestaat niet in het opgegeven abonnement. 409 OperationCancelled : de bewerking is geannuleerd door de gebruiker. 409 Bewerking onderbroken: de bewerking op de resource kan niet worden voltooid omdat deze is onderbroken door een andere bewerking op dezelfde resource. 409 ServerDnsAliasBusy - Server-DNS-alias is bezig met een andere bewerking. 409 SubscriptionDisabled - Abonnement is uitgeschakeld. 409 ServerDnsAliasDnsRecordInUse - Er bestaat een dubbele DNS-record voor het aangevraagde eindpunt. 409 ServerDnsAliasAlreadyExists - Server DNS-alias bestaat al op een bepaalde server. 409 ConflictingServerOperation : er wordt momenteel een bewerking uitgevoerd voor de server. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyCreateUpdateRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 429 SubscriptionTooManyRequests - Aanvragen die verder gaan dan het maximumaantal aanvragen dat kan worden verwerkt door beschikbare resources. 500 OperationTimedOut: er is een time-out opgetreden voor de bewerking en deze is automatisch teruggedraaid. Probeer de bewerking opnieuw uit te voeren. 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 503 TooManyRequests: aanvragen die verder gaan dan het maximum aantal aanvragen dat kan worden verwerkt door beschikbare resources. 504 RequestTimeout - Serviceaanvraag heeft de toegestane time-out overschreden.

Voorbeelden

Acquire server DNS alias

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-new-server/dnsAliases/dns-alias-name-1/acquire?api-version=2021-11-01

{
  "oldServerDnsAliasId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.ServerDnsAliasAcquisition;

/** Samples for ServerDnsAliases Acquire. */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerDnsAliasAcquire.json
     */
    /**
     * Sample code: Acquire server DNS alias.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void acquireServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerDnsAliases().acquire("Default", "dns-alias-new-server",
            "dns-alias-name-1",
            new ServerDnsAliasAcquisition().withOldServerDnsAliasId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1"),
            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

Sample Response

Status code:

200

{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-new-server/dnsAliases/dns-alias-name-1",
  "name": "server-dns-alias-name-1",
  "type": "Microsoft.Sql/servers/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-name-1.database.windows.net"
  }
}

Status code:

202

Definities

Name	Description
ServerDnsAlias	Een server-DNS-alias.
ServerDnsAliasAcquisition	Een aanvraag voor het verkrijgen van dns-alias op de server.

ServerDnsAlias

Een server-DNS-alias.

Name	Type	Description
id	string	Resource-id.
name	string	Resourcenaam.
properties.azureDnsRecord	string	De volledig gekwalificeerde DNS-record voor alias
type	string	Resourcetype.

ServerDnsAliasAcquisition

Een aanvraag voor het verkrijgen van dns-alias op de server.

Name	Type	Description
oldServerDnsAliasId	string	De id van de serveralias die wordt verkregen om in plaats daarvan naar deze server te verwijzen.