Server Dns Aliases - Acquire

Služba:

SQL Database

Verze rozhraní API:

2023-08-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=2023-08-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 Manageru nebo 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	Úspěšně získal alias DNS serveru.
202 Accepted		Přijal Hlavičky Location: string
Other Status Codes	ErrorResponse	Chybové odpovědi: *** 400 InvalidServerName – zadaný neplatný název serveru. 400 InvalidIdentifier – identifikátor obsahuje hodnotu NULL nebo neplatný znak unicode. 400 TokenTooLong - Poskytnutý token je příliš dlouhý. 400 InvalidServerDnsAliasAcquireRequest – Text požadavku na alias DNS pro získání serveru je prázdný nebo neplatný (měl by obsahovat staré ID aliasu serveru, Například: /subscriptions/0000000-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ěl by mít formulář: /subscriptions/00000000-1111 -2222-3333-44444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1). 400 UnableToResolveRemoteServer – Název vzdáleného partnerského serveru nebylo možné vyřešit kvůli neplatnému názvu serveru nebo problémům s připojením DNS. 400 CannotUseReservedDatabaseName – V této operaci nelze použít název rezervované databáze. 400 InvalidServerName – zadaný neplatný název serveru. 400 InvalidIdentifier – identifikátor obsahuje hodnotu NULL nebo neplatný znak unicode. 400 TokenTooLong - Poskytnutý token je příliš dlouhý. 400 InvalidServerDnsAliasName – Byl zadán neplatný název aliasu DNS serveru. 400 ServerDnsAliasDoesNotExist – Alias DNS serveru na serveru neexistuje. 400 ServerNotFound – Požadovaný server nebyl nalezen. 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias – Aliasy dns serveru nefungují správně pro databázi se zapnutým auditováním tabulek 400 UnableToCreateServerDnsAliasDueToTableAuditing – Alias DNS serveru nelze vytvořit pro server se zapnutým auditováním tabulek. 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb – Alias DNS serveru nelze vytvořit pro server{0}, protože databáze{1}má povolenou funkci Auditování tabulek nebo Povolený přístup zabezpečení. 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 404 OperationIdNotFound – operace s ID neexistuje. 404 ResourceNotFound – Požadovaný prostředek nebyl nalezen. 404 OperationIdNotFound – operace s ID neexistuje. 404 ServerNotInSubscription – Zadaný server v zadaném předplatném neexistuje. 404 ServerNotInSubscriptionResourceGroup – Zadaný server neexistuje v zadané skupině prostředků a předplatném. 409 CannotCancelOperation – Operace správy je ve stavu, který nelze zrušit. 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í na stejném prostředku. 409 ConflictingServerOperation – Aktuálně probíhá operace pro server. 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 ServerDnsAliasBusy – Alias DNS serveru je zaneprázdněn jinou operací. 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyCreateUpdateRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 429 SubscriptionTooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 500 OperationTimedOut – Vypršel časový limit operace a automaticky se vrátil zpět. Zkuste operaci zopakovat. 503 TooManyRequests – Požadavky nad rámec maximálních požadavků, které je možné zpracovat dostupnými prostředky. 503 TooManyRequests – Požadavky nad rámec maximálních 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=2023-08-01

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

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

Location: https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/providers/Microsoft.Sql/locations/westus/serverDnsAliasOperationResults/00000000-1111-2222-3333-444444444444?api-version=2017-03-01-preview

Definice

Name	Description
ErrorAdditionalInfo	Další informace o chybě správy prostředků
ErrorDetail	Podrobnosti o chybě.
ErrorResponse	Chybová odpověď
ServerDnsAlias	Alias DNS serveru.
ServerDnsAliasAcquisition	Žádost o získání aliasu dns serveru.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name	Typ	Description
info	object	Další informace.
type	string	Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Další informace o chybě.
code	string	Kód chyby.
details	ErrorDetail[]	Podrobnosti o chybě.
message	string	Chybová zpráva.
target	string	Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name	Typ	Description
error	ErrorDetail	Objekt chyby.

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.