Server Dns Aliases - Acquire

服務:

SQL Database

API 版本:

2021-11-01

從另一部伺服器取得伺服器 DNS 別名。

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

URI 參數

名稱	位於	必要	類型	Description
dnsAliasName	path	True	string	伺服器 dns 別名的名稱。
resourceGroupName	path	True	string	包含資源的資源群組名稱。 您可以從 Azure 資源管理員 API 或入口網站取得這個值。
serverName	path	True	string	別名所指向的伺服器名稱。
subscriptionId	path	True	string	可識別 Azure 訂用帳戶的訂用帳戶識別碼。
api-version	query	True	string	要用於要求的 API 版本。

要求本文

名稱	必要	類型	Description
oldServerDnsAliasId	True	string	要改為指向此伺服器的伺服器別名標識碼。

回應

名稱	類型	Description
200 OK	ServerDnsAlias	已成功取得伺服器 DNS 別名。
202 Accepted		已接受
Other Status Codes		錯誤回應： ≦ 400 InvalidServerDnsAliasAcquireRequest - 取得伺服器 DNS 別名要求本文空白或無效 (它應該包含舊的伺服器別名標識符， 例如：/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1) 。 400 ServerDnsAliasAcquireRequestInvalidOldServerDnsAliasId - 要求本文中的舊伺服器 DNS 別名標識符是空的或無效的 (它應該有格式：/subscriptions/000000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-old-server/dnsAliases/dns-alias-name-1) 。 400 ServerDnsAliasDoesNotExist - 伺服器 DNS 別名不存在於伺服器上。 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - 伺服器 Dns 別名無法針對已開啟數據表稽核的資料庫正確運作 400 UnableToCreateServerDnsAliasDueToTableAuditing - 無法針對已開啟數據表稽核的伺服器建立伺服器 DNS 別名。 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - 無法為伺服器 '' 建立伺服器 DNS 別名，因為資料庫 '{0}{1}' 已啟用數據表稽核或安全性啟用存取功能。 400 LimitOfServerDnsAliasesPerServerExceeded - 建立新的伺服器 Dns 別名將會超過每部伺服器允許的伺服器 DNS 別名數目。 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - 伺服器 Dns 別名不適用於已開啟數據表稽核的伺服器 400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。 400 TokenTooLong - 提供的令牌太長。 400 UnableToResolveRemoteServer - 遠端夥伴伺服器名稱因伺服器名稱無效或 DNS 連線問題而無法解決。 400 InvalidServerName - 指定的伺服器名稱無效。 400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。 400 InvalidServerDnsAliasName - 提供無效的伺服器 DNS 別名名稱。 400 ServerNotFound - 找不到所要求的伺服器。 404 OperationIdNotFound - 標識符為的作業不存在。 404 ResourceNotFound - 找不到所要求的資源。 404 OperationIdNotFound - 標識符為的作業不存在。 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。 409 OperationCancelled - 使用者已取消作業。 409 OperationInterrupted - 無法完成資源上的作業，因為它被相同資源上的另一個作業中斷。 409 ServerDnsAliasBusy - 伺服器 DNS 別名正忙於另一項作業。 409 SubscriptionDisabled - 已停用訂用帳戶。 409 ServerDnsAliasDnsRecordInUse - 要求的端點存在重複的 DNS 記錄。 409 ServerDnsAliasAlreadyExists - 伺服器 DNS 別名已存在於指定的伺服器上。 409 ConflictingServerOperation - 伺服器目前正在進行作業。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理的最大要求。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理的最大要求。 500 OperationTimedOut - 作業逾時並自動回復。 請重試該作業。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。 504 RequestTimeout - 服務要求超過允許的逾時。

範例

Acquire server DNS alias

範例要求

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

範例回覆

狀態碼:

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

狀態碼:

202

定義

名稱	Description
ServerDnsAlias	伺服器 DNS 別名。
ServerDnsAliasAcquisition	伺服器 dns 別名取得要求。

ServerDnsAlias

伺服器 DNS 別名。

名稱	類型	Description
id	string	資源識別碼。
name	string	資源名稱。
properties.azureDnsRecord	string	別名的完整 DNS 記錄
type	string	資源類型。

ServerDnsAliasAcquisition

伺服器 dns 別名取得要求。

名稱	類型	Description
oldServerDnsAliasId	string	要改為指向此伺服器的伺服器別名標識碼。