Server Dns Aliases - List By Server

服務:

SQL Database

API 版本:

2021-11-01

取得伺服器的伺服器 DNS 別名清單。

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

URI 參數

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

回應

名稱	類型	Description
200 OK	ServerDnsAliasListResult	已成功擷取伺服器 DNS 別名清單。
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 SubscriptionDoesNotHaveServer - 找不到要求的伺服器 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 ResourceNotFound - 找不到所要求的資源。 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。 404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。 409 ServerDnsAliasBusy - 伺服器 DNS 別名正忙於另一項作業。 409 SubscriptionDisabled - 已停用訂用帳戶。 409 ServerDnsAliasDnsRecordInUse - 要求的端點存在重複的 DNS 記錄。 409 ServerDnsAliasAlreadyExists - 伺服器 DNS 別名已存在於指定的伺服器上。 409 ConflictingServerOperation - 伺服器目前正在進行作業。 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。 429 SubscriptionTooManyRequests - 超出可用資源可處理的最大要求。 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。 504 RequestTimeout - 服務要求超過允許的逾時。

範例

List server DNS aliases

範例要求

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases?api-version=2021-11-01

Java

/**
 * Samples for ServerDnsAliases ListByServer.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/ServerDnsAliasList.json
     */
    /**
     * Sample code: List server DNS aliases.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void listServerDNSAliases(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getServerDnsAliases().listByServer("Default", "dns-alias-server",
            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

{
  "value": [
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-1",
      "name": "server-dns-alias-1",
      "type": "Microsoft.Sql/servers/dnsAliases",
      "properties": {
        "azureDnsRecord": "dns-alias-1.database.windows.net"
      }
    },
    {
      "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/servers/dns-alias-server/dnsAliases/dns-alias-2",
      "name": "server-dns-alias-2",
      "type": "Microsoft.Sql/servers/dnsAliases",
      "properties": {
        "azureDnsRecord": "dns-alias-2.database.windows.net"
      }
    }
  ]
}

定義

名稱	Description
ServerDnsAlias	伺服器 DNS 別名。
ServerDnsAliasListResult	伺服器 DNS 別名的清單。

ServerDnsAlias

伺服器 DNS 別名。

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

ServerDnsAliasListResult

伺服器 DNS 別名的清單。

名稱	類型	Description
nextLink	string	連結以擷取下一頁的結果。
value	ServerDnsAlias[]	結果陣列。