Server Dns Aliases - Acquire

Služba:

SQL Database

Verze rozhraní API:

2021-11-01

Získá alias DNS serveru z jiného serveru.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
dnsAliasName	path	True	string	Název aliasu dns serveru.
resourceGroupName	path	True	string	Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API azure Resource Manager nebo z portálu.
serverName	path	True	string	Název serveru, na který alias ukazuje.
subscriptionId	path	True	string	ID předplatného, které identifikuje předplatné Azure.
api-version	query	True	string	Verze rozhraní API, která se má použít pro požadavek.

Text požadavku

Name	Vyžadováno	Typ	Description
oldServerDnsAliasId	True	string	ID aliasu serveru, který bude získán tak, aby odkazoval na tento server.

Odpovědi

Name	Typ	Description
200 OK	ServerDnsAlias	Alias DNS serveru se úspěšně získal.
202 Accepted		Přijato
Other Status Codes		Chybové odpovědi: *** 400 InvalidServerDnsAliasAcquireRequest – text požadavku na získání aliasu DNS serveru je prázdný nebo neplatný (měl by obsahovat původní ID aliasu serveru, Příklad: /subscriptions/00000000-1111-2222-3333-44444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId – ID aliasu DNS starého serveru v textu požadavku je prázdné nebo neplatné (mělo by mít tvar: /subscriptions/00000000-1111 -2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasDoesNotExist – alias DNS serveru na serveru neexistuje. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Aliasy DNS serveru nefungují správně pro databázi se zapnutým auditováním tabulek. 400 CannotToCreateServerDnsAliasDueToTableAuditing – Alias DNS serveru nelze vytvořit pro server se zapnutým auditováním tabulek. 400 CannotToCreateServerDnsAliasDueToTableAuditingForDb – Alias DNS serveru nelze pro server{0} vytvořit, protože databáze{1} má povolenou funkci Auditování tabulek nebo Přístup s povoleným zabezpečením. 400 LimitOfServerDnsAliasesPerServerExceeded – Vytvoření nového aliasu DNS serveru překročí povolený počet aliasů DNS serveru na server. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias – Aliasy DNS serveru nefungují správně pro server se zapnutým auditováním tabulek. 400 CannotUseReservedDatabaseName – V této operaci nelze použít název rezervované databáze. 400 TokenTooLong – zadaný token je příliš dlouhý. 400 UnableToResolveRemoteServer – Název vzdáleného partnerského serveru nelze vyřešit kvůli neplatnému názvu serveru nebo problémům s připojením k DNS. 400 InvalidServerName – zadaný neplatný název serveru. 400 InvalidIdentifier – identifikátor obsahuje null nebo neplatný znak unicode. 400 InvalidServerDnsAliasName – byl zadán neplatný název aliasu DNS serveru. 400 ServerNotFound – požadovaný server nebyl nalezen. 404 OperationIdNotFound – operace s ID neexistuje. 404 ResourceNotFound – požadovaný prostředek nebyl nalezen. 404 OperationIdNotFound – operace s ID neexistuje. 404 ServerNotInSubscriptionResourceGroup – zadaný server neexistuje v zadané skupině prostředků a předplatném. 404 ServerNotInSubscription – zadaný server v zadaném předplatném neexistuje. 409 OperationCancelled – operace byla zrušena uživatelem. 409 OperationInterrupted – Operaci s prostředkem nebylo možné dokončit, protože byla přerušena jinou operací se stejným prostředkem. 409 ServerDnsAliasBusy – Alias DNS serveru je zaneprázdněný jinou operací. 409 SubscriptionDisabled – Předplatné je zakázané. 409 ServerDnsAliasDnsRecordInUse – pro požadovaný koncový bod existuje duplicitní záznam DNS. 409 ServerDnsAliasAlreadyExists – alias DNS serveru již na daném serveru existuje. 409 ConflictingServerOperation – aktuálně probíhá operace pro server. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyCreateUpdateRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – časový limit operace vypršel a automaticky se vrátila zpět. Opakujte operaci. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 503 TooManyRequests – požadavky nad rámec maximálního počtu požadavků, které je možné zpracovat dostupnými prostředky. 504 RequestTimeout – Žádost o službu překročila povolený časový limit.

Příklady

Acquire server DNS alias

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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

Stavový kód:

202

Definice

Name	Description
ServerDnsAlias	Alias DNS serveru.
ServerDnsAliasAcquisition	Žádost o získání aliasu DNS serveru.

ServerDnsAlias

Objekt

Alias DNS serveru.

Name	Typ	Description
id	string	ID prostředku.
name	string	Název prostředku.
properties.azureDnsRecord	string	Plně kvalifikovaný záznam DNS pro alias
type	string	Typ prostředku.

ServerDnsAliasAcquisition

Objekt

Žádost o získání aliasu DNS serveru.

Name	Typ	Description
oldServerDnsAliasId	string	ID aliasu serveru, který bude získán tak, aby odkazoval na tento server.