共用方式為

Managed Server Dns Aliases - Get

服務:
SQL Database
API 版本:
2025-01-01

取得伺服器 DNS 別名。

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

URI 參數

名稱 位於 必要 類型 Description
dnsAliasName
 path True

string

managedInstanceName
 path True

string

受控實例的名稱。
resourceGroupName
 path True

string

包含資源的資源群組名稱。 您可以從 Azure Resource Manager API 或入口網站取得此值。
subscriptionId
 path True

string

識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version
 query True

string

要用於要求的 API 版本。

回應

名稱 類型 Description
200 OK

ManagedServerDnsAlias

已成功擷取指定的受控伺服器 DNS 別名。
Other Status Codes

ErrorResponse

錯誤回應： ***

  • 400 ManagedInstanceStoppingOrStopped - 實例處於停止/停止狀態時提交的衝突作業

  • 400 ManagedInstanceStarting - 實例處於啟動狀態時提交的衝突作業

  • 400 InvalidManagedServerDnsAliasAcquireRequest - 取得受控伺服器 DNS 別名要求本文是空的或無效的。

  • 400 ManagedServerDnsAliasAcquireRequestInvalidOldManagedServerDnsAliasResourceId - 要求本文中的舊受控伺服器 DNS 別名標識符是空的或無效的（其格式應該是：/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/dnsAliases/{dnsAliasName}）。

  • 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasSubscriptionMismatch - 要求主體中的舊受控伺服器 DNS 訂用帳戶標識碼與要求 URI 中的受控伺服器 DNS 訂用帳戶標識符不同。

  • 400 ManagedServerDnsAliasAcquireRequestOldManagedServerDnsAliasNameMismatch - 要求主體中的舊受控伺服器 DNS 別名名稱與要求 URI 中的 DNS 別名名稱不同。

  • 400 InvalidServerDnsAliasNameForNamedInstance - 提供無效的伺服器 DNS 別名名稱。

  • 400 NameAlreadyExists - 提供的名稱已經存在。

  • 400 UnableToResolveRemoteServer - 遠端夥伴伺服器名稱無法解決，因為伺服器名稱或 DNS 連線問題無效。

  • 400 CannotUseReservedDatabaseName - 無法在此作業中使用保留的資料庫名稱。

  • 400 InvalidServerName - 指定的伺服器名稱無效。

  • 400 InvalidIdentifier - 識別碼包含 NULL 或無效的 Unicode 字元。

  • 400 TokenTooLong - 提供的令牌太長。

  • 400 InvalidServerDnsAliasName - 提供無效的伺服器 DNS 別名名稱。

  • 400 ServerDnsAliasDoesNotExist - 伺服器 DNS 別名不存在於伺服器上。

  • 400 ServerNotFound - 找不到要求的伺服器。

  • 400 UnableToTurnOnTableAuditingForDbOnServerWithServerDnsAlias - 伺服器 Dns 別名無法針對已開啟數據表稽核的資料庫正確運作

  • 400 UnableToCreateServerDnsAliasDueToTableAuditing - 無法針對已開啟數據表稽核的伺服器建立伺服器 DNS 別名。

  • 400 UnableToCreateServerDnsAliasDueToTableAuditingForDb - 無法為伺服器 '{0}' 建立伺服器 DNS 別名，因為資料庫 '{1}' 已啟用數據表稽核或安全性啟用存取功能。

  • 400 LimitOfServerDnsAliasesPerServerExceeded - 建立新的伺服器 Dns 別名將會超過每部伺服器允許的伺服器 DNS 別名數目。

  • 400 UnableToTurnOnTableAuditingForServerWithServerDnsAlias - 伺服器 Dns 別名無法針對已開啟數據表稽核的伺服器正確運作

  • 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。

  • 404 SubscriptionDoesNotHaveServer - 找不到要求的伺服器

  • 404 ResourceNotFound - 找不到要求的資源。

  • 404 ServerNotInSubscription - 指定的伺服器不存在於指定的訂用帳戶上。

  • 404 ServerNotInSubscriptionResourceGroup - 指定的伺服器不存在於指定的資源群組和訂用帳戶中。

  • 409 ManagedServerAliasDnsZoneMismatch - 受控伺服器別名 Dns 區域不符

  • 409 ConflictingServerOperation - 伺服器目前正在進行作業。

  • 409 SubscriptionDisabled - 已停用訂用帳戶。

  • 409 ServerDnsAliasDnsRecordInUse - 要求的端點有重複的 DNS 記錄。

  • 409 ServerDnsAliasAlreadyExists - 伺服器 DNS 別名已存在於指定的伺服器上。

  • 409 ServerDnsAliasBusy - 伺服器 DNS 別名正忙於另一項作業。

  • 429 SubscriptionTooManyCreateUpdateRequests - 超出可用資源可處理之最大要求的要求。

  • 429 SubscriptionTooManyRequests - 超出可用資源可處理之最大要求的要求。

  • 503 TooManyRequests - 超出可用資源可處理之最大要求的要求。

  • 504 RequestTimeout - 服務要求超過允許的逾時。

範例

Get managed server DNS alias

範例要求

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

範例回覆

狀態碼:
200 
{
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default/providers/Microsoft.Sql/managedInstances/dns-mi/dnsAliases/dns-alias-mi",
  "name": "dns-alias-mi",
  "type": "Microsoft.Sql/managedInstances/dnsAliases",
  "properties": {
    "azureDnsRecord": "dns-alias-mi.abcd1234.database.windows.net",
    "publicAzureDnsRecord": "dns-alias-mi.public.abcd1234.database.windows.net"
  }
}

定義

名稱 Description
ErrorAdditionalInfo

資源管理錯誤附加資訊。
ErrorDetail

錯誤詳細資料。
ErrorResponse

錯誤回應
ManagedServerDnsAlias

受控伺服器 DNS 別名。

ErrorAdditionalInfo

Object

資源管理錯誤附加資訊。

名稱 類型 Description
info

object

附加資訊。
type

string

其他資訊類型。

ErrorDetail

Object

錯誤詳細資料。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤附加資訊。
code

string

錯誤碼。
details

ErrorDetail[]

錯誤詳情
message

string

錯誤訊息。
target

string

錯誤目標。

ErrorResponse

Object

錯誤回應

名稱 類型 Description
error

ErrorDetail

錯誤物件。

ManagedServerDnsAlias

Object

受控伺服器 DNS 別名。

名稱 類型 Description
id

string

資源標識碼。
name

string

資源名稱。
properties.azureDnsRecord

string

受控伺服器別名的完整 DNS 記錄
properties.publicAzureDnsRecord

string

受控伺服器別名的完整公用 DNS 記錄
type

string

資源類型。