Server Dns Aliases - Acquire

Tjänst:

SQL Database

API-version:

2021-11-01

Hämtar serverns DNS-alias från en annan server.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/servers/{serverName}/dnsAliases/{dnsAliasName}/acquire?api-version=2021-11-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.

Begärandetext

Name	Obligatorisk	Typ	Description
oldServerDnsAliasId	True	string	ID:t för det serveralias som ska hämtas så att det pekar på den här servern i stället.

Svar

Name	Typ	Description
200 OK	ServerDnsAlias	Serverns DNS-alias har hämtats.
202 Accepted		Har godkänts
Other Status Codes		Felsvar: *** 400 InvalidServerDnsAliasAcquireRequest – begärandetexten för DNS-aliasbegäran för inhämtningsservern är tom eller ogiltig (den bör innehålla det gamla serveralias-ID:t, exempel: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId – den gamla serverns DNS-alias-ID i begärandetexten är tomt eller ogiltigt (det bör ha formuläret: /subscriptions/00000000-1111-2222-3333-44444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasDoesNotExist – Serverns DNS-alias finns inte på en server. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Serverns DNS-alias fungerar inte korrekt för databasen som har Tabellgranskning aktiverat 400 UnableToCreateServerDnsAliasDueToTableAuditing – Serverns DNS-alias kan inte skapas för servern där tabellgranskning är aktiverat. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb – Serverns DNS-alias kan inte skapas för servern{0} eftersom databasen{1} har funktionen Tabellgranskning eller Säkerhetsaktiverad åtkomst aktiverad. 400 LimitOfServerDnsAliasesPerServerExceeded – Om du skapar ett nytt Server Dns-alias överskrids det tillåtna antalet SERVER DNS-alias per server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias – Serverns DNS-alias fungerar inte korrekt för servern som har Tabellgranskning aktiverat 400 CannotUseReservedDatabaseName – Det går inte att använda reserverade databasnamn i den här åtgärden. 400 TokenTooLong – den angivna token är för lång. 400 UnableToResolveRemoteServer – Det gick inte att lösa namnet på fjärrpartnerservern på grund av ett ogiltigt servernamn eller dns-anslutningsproblem. 400 InvalidServerName – Ogiltigt servernamn har angetts. 400 InvalidIdentifier – identifieraren innehåller NULL eller ett ogiltigt unicode-tecken. 400 InvalidServerDnsAliasName – Ogiltigt DNS-aliasnamn för server angavs. 400 ServerNotFound – Den begärda servern hittades inte. 404 OperationIdNotFound – åtgärden med ID finns inte. 404 ResourceNotFound – Den begärda resursen hittades inte. 404 OperationIdNotFound – åtgärden med ID finns inte. 404 ServerNotInSubscriptionResourceGroup – Den angivna servern finns inte i den angivna resursgruppen och prenumerationen. 404 ServerNotInSubscription – Den angivna servern finns inte i den angivna prenumerationen. 409 OperationCancelled – Åtgärden har avbrutits av användaren. 409 OperationInterrupted – Det gick inte att slutföra åtgärden på resursen eftersom den avbröts av en annan åtgärd på samma resurs. 409 ServerDnsAliasBusy – Serverns DNS-alias är upptaget med en annan åtgärd. 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 ConflictingServerOperation – en åtgärd pågår för närvarande för servern. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyCreateUpdateRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 429 SubscriptionTooManyRequests – begäranden utöver maximalt antal begäranden som kan bearbetas av tillgängliga resurser. 500 OperationTimedOut – Tidsgränsen för åtgärden uppnåddes och återställdes automatiskt. Försök att utföra åtgärden igen. 503 TooManyRequests – begäranden utöver maximalt antal begä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

Acquire server DNS alias

Exempelbegäran

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.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"),
            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

Exempelsvar

Statuskod:

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

Statuskod:

202

Definitioner

Name	Description
ServerDnsAlias	Ett DNS-alias för servern.
ServerDnsAliasAcquisition	En begäran om anskaffning av DNS-alias för server.

ServerDnsAlias

Object

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.

ServerDnsAliasAcquisition

Object

En begäran om anskaffning av DNS-alias för server.

Name	Typ	Description
oldServerDnsAliasId	string	ID:t för det serveralias som ska hämtas så att det pekar på den här servern i stället.