Managed Server Dns Aliases - Acquire

Usługa:

SQL Database

Wersja interfejsu API:

2021-11-01

Uzyskuje alias DNS serwera zarządzanego z innego serwera zarządzanego.

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
dnsAliasName	path	True	string
managedInstanceName	path	True	string	Nazwa wystąpienia zarządzanego.
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.
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
oldManagedServerDnsAliasResourceId	True	string	Identyfikator zasobu aliasu DNS serwera zarządzanego, który zostanie uzyskany w celu wskazania tego serwera zarządzanego.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ManagedServerDnsAlias	Pomyślnie uzyskaliśmy alias DNS serwera zarządzanego.
202 Accepted		Zaakceptowano
Other Status Codes		Odpowiedzi na błędy: *** 400 InvalidManagedServerDnsAliasAcquireRequest — treść żądania aliasu DNS serwera zarządzanego jest pusta lub nieprawidłowa. 400 ManagedServerDnsAliasAcquireRequestInvalidOldManagedServerDnsAliasResourceId — stary identyfikator aliasu DNS zarządzanego serwera w treści żądania jest pusty lub nieprawidłowy (powinien mieć format: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}). 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasSubscriptionMismatch — stary identyfikator subskrypcji DNS serwera zarządzanego w treści żądania różni się od identyfikatora URI żądania. 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasNameMismatch — stara nazwa aliasu DNS serwera zarządzanego w treści żądania jest inna niż nazwa identyfikatora URI żądania. 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 NameAlreadyExists — podana nazwa już istnieje. 400 CannotUseReservedDatabaseName — nie można użyć nazwy zarezerwowanej bazy danych w tej operacji. 400 TokenTooLong — podany token jest za długi. 400 InvalidServerDnsAliasNameForNamedInstance — podano nieprawidłową nazwę aliasu DNS serwera. 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 ManagedServerAliasDnsZoneMismatch — niezgodność aliasu strefy DNS aliasu serwera zarządzanego 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 managed server DNS alias.

Przykładowe żądanie

HTTP

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

{
  "oldManagedServerDnsAliasResourceId": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/old-mi/dnsAliases/alias1"
}

Java

import com.azure.resourcemanager.sql.models.ManagedServerDnsAliasAcquisition;

/**
 * Samples for ManagedServerDnsAliases Acquire.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ManagedServerDnsAliasAcquire.json
     */
    /**
     * Sample code: Acquire managed server DNS alias.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void acquireManagedServerDNSAlias(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedServerDnsAliases().acquire("Default", "new-mi",
            "dns-alias-mi",
            new ManagedServerDnsAliasAcquisition().withOldManagedServerDnsAliasResourceId(
                "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/old-mi/dnsAliases/alias1"),
            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/managedInstances/new-mi/dnsAliases/alias1",
  "name": "alias1",
  "type": "Microsoft.Sql/managedInstances/dnsAliases",
  "properties": {
    "azureDnsRecord": "alias1.abcd1234.database.windows.net"
  }
}

Kod stanu:

202

Definicje

Nazwa	Opis
ManagedServerDnsAlias	Alias DNS serwera zarządzanego.
ManagedServerDnsAliasAcquisition	Żądanie uzyskania aliasu DNS serwera zarządzanego.

ManagedServerDnsAlias

Alias DNS serwera zarządzanego.

Nazwa	Typ	Opis
id	string	Identyfikator zasobu.
name	string	Nazwa zasobu.
properties.azureDnsRecord	string	W pełni kwalifikowany rekord DNS dla aliasu serwera zarządzanego
properties.publicAzureDnsRecord	string	W pełni kwalifikowany publiczny rekord DNS dla aliasu serwera zarządzanego
type	string	Typ zasobu.

ManagedServerDnsAliasAcquisition

Żądanie uzyskania aliasu DNS serwera zarządzanego.

Nazwa	Typ	Opis
oldManagedServerDnsAliasResourceId	string	Identyfikator zasobu aliasu DNS serwera zarządzanego, który zostanie uzyskany w celu wskazania tego serwera zarządzanego.