Server Dns Aliases - Acquire

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Uzyskuje alias DNS serwera z innego serwera.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
dnsAliasName	path	True	string	Nazwa aliasu DNS serwera.
resourceGroupName	path	True	string	Nazwa grupy zasobów zawierającej zasób. Tę wartość można uzyskać z interfejsu API usługi Azure Resource Manager lub portalu.
serverName	path	True	string	Nazwa serwera, na który wskazuje alias.
subscriptionId	path	True	string	Identyfikator subskrypcji identyfikujący subskrypcję platformy Azure.
api-version	query	True	string	Wersja interfejsu API do użycia dla żądania.

Treść żądania

Nazwa	Wymagane	Typ	Opis
oldServerDnsAliasId	True	string	Identyfikator aliasu serwera, który zostanie uzyskany, aby wskazać ten serwer.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ServerDnsAlias	Pomyślnie pobrano alias DNS serwera.
202 Accepted		Zaakceptowano
Other Status Codes		Odpowiedzi na błędy: *** 400 InvalidServerDnsAliasAcquireRequest — treść żądania aliasu DNS serwera uzyskiwania jest pusta lub nieprawidłowa (powinna zawierać stary identyfikator aliasu serwera, na przykład: /subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 ServerDnsAliasAcquireQuestInvalidOldServerDnsAliasId — stary identyfikator aliasu DNS serwera w treści żądania jest pusty lub nieprawidłowy (powinien mieć postać: /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 serwera nie istnieje na serwerze. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias — aliasy DNS serwera nie działają poprawnie dla bazy danych z włączoną inspekcją tabel 400 UnableToCreateServerDnsAliasDueToTableAuditing — nie można utworzyć aliasu DNS serwera z włączoną inspekcją tabel. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb — nie można utworzyć aliasu DNS serwera dla serwera "{0}", ponieważ baza danych "{1}" ma włączoną funkcję inspekcji tabel lub z włączonym dostępem zabezpieczeń. 400 LimitOfServerDnsAliasesPerServerExceeded — utworzenie nowego aliasu DNS serwera przekroczy dozwoloną liczbę aliasów DNS serwera na serwer. 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias — aliasy DNS serwera nie działają poprawnie dla serwera z włączoną inspekcją tabel 400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji. 400 TokenTooLong — podany token jest za długi. 400 UnableToResolveRemoteServer — nie można rozpoznać nazwy serwera zdalnego partnera z powodu problemów z nieprawidłową nazwą serwera lub łącznością DNS. 400 InvalidServerName — podano nieprawidłową nazwę serwera. 400 InvalidIdentifier — identyfikator zawiera wartość NULL lub nieprawidłowy znak Unicode. 400 InvalidServerDnsAliasName — podano nieprawidłową nazwę aliasu DNS serwera. 400 ServerNotFound — nie można odnaleźć żądanego serwera. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 404 ResourceNotFound — żądany zasób nie został znaleziony. 404 OperationIdNotFound — operacja o identyfikatorze nie istnieje. 404 ServerNotInSubscriptionResourceGroup — określony serwer nie istnieje w określonej grupie zasobów i subskrypcji. 404 ServerNotInSubscription — określony serwer nie istnieje w określonej subskrypcji. 409 OperationCancelled — operacja została anulowana przez użytkownika. 409 Operacja przerwana — nie można ukończyć operacji na zasobie, ponieważ została przerwana przez inną operację na tym samym zasobie. 409 ServerDnsAliasBusy — alias DNS serwera jest zajęty inną operacją. 409 SubscriptionDisabled — subskrypcja jest wyłączona. 409 ServerDnsAliasDnsRecordInUse — istnieje zduplikowany rekord DNS dla żądanego punktu końcowego. 409 ServerDnsAliasAlreadyExists — alias DNS serwera już istnieje na danym serwerze. 409 ConflictingServerOperation — operacja jest obecnie w toku dla serwera. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyCreateUpdateRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 429 SubscriptionTooManyRequests — żądania wykraczające poza maksymalną liczbę żądań, które mogą być przetwarzane przez dostępne zasoby. 500 OperationTimedOut — upłynął limit czasu operacji i automatycznie wycofano. Ponów próbę wykonania operacji. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 503 TooManyRequests — żądania wykraczające poza maksymalne żądania, które mogą być przetwarzane przez dostępne zasoby. 504 RequestTimeout — żądanie usługi przekroczyło dozwolony limit czasu.

Przykłady

Acquire server DNS alias

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:

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

Kod stanu:

202

Definicje

Nazwa	Opis
ServerDnsAlias	Alias DNS serwera.
ServerDnsAliasAcquisition	Żądanie uzyskania aliasu dns serwera.

ServerDnsAlias

Alias DNS serwera.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.azureDnsRecord	string	W pełni kwalifikowany rekord DNS dla aliasu
type	string	Typ zasobu.

ServerDnsAliasAcquisition

Żądanie uzyskania aliasu dns serwera.

Nazwa	Typ	Opis
oldServerDnsAliasId	string	Identyfikator aliasu serwera, który zostanie uzyskany, aby wskazać ten serwer.