Private Zones - Get

參考

服務:: DNS

API 版本:: 2018-09-01

取得私人 DNS 區域。擷取區域屬性，但不會擷取虛擬網路連結或區域內的記錄集。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateZoneName}?api-version=2018-09-01

URI 參數

名稱	位於	必要	類型	Description
privateZoneName	path	True	string	私人 DNS 區域的名稱（不含終止點）。
resourceGroupName	path	True	string	資源群組的名稱。
subscriptionId	path	True	string	取得可唯一識別Microsoft Azure 訂用帳戶的訂用帳戶認證。訂用帳戶標識碼會形成每個服務呼叫 URI 的一部分。
api-version	query	True	string	用戶端 API 版本。

回應

名稱	類型	Description
200 OK	PrivateZone	成功。
Other Status Codes	CloudError	默認回應。它會根據錯誤定義還原串行化。

範例

GET Private DNS Zone

範例要求

HTTP

GET https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com?api-version=2018-09-01

範例回覆

狀態碼:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com",
  "name": "privatezone1.com",
  "type": "Microsoft.Network/privateDnsZones",
  "location": "global",
  "etag": "00000000-0000-0000-0000-000000000000",
  "properties": {
    "maxNumberOfRecordSets": 5000,
    "numberOfRecordSets": 1,
    "maxNumberOfVirtualNetworkLinks": 100,
    "numberOfVirtualNetworkLinks": 0,
    "maxNumberOfVirtualNetworkLinksWithRegistration": 50,
    "numberOfVirtualNetworkLinksWithRegistration": 0,
    "provisioningState": "Succeeded"
  },
  "tags": {
    "key1": "value1"
  }
}

定義

名稱	Description
CloudError	來自服務的錯誤回應。
CloudErrorBody	來自服務的錯誤回應。
PrivateZone	描述私人 DNS 區域。
ProvisioningState	資源的布建狀態。這是唯讀屬性，而且將忽略任何設定此值的嘗試。

CloudError

Object

來自服務的錯誤回應。

名稱	類型	Description
error	CloudErrorBody	雲端錯誤本文。

CloudErrorBody

Object

來自服務的錯誤回應。

名稱	類型	Description
code	string	錯誤的識別碼。程序代碼是不變的，而且是要以程序設計方式取用。
details	CloudErrorBody[]	錯誤的其他詳細數據清單。
message	string	描述錯誤的訊息，適用於在使用者介面中顯示。
target	string	特定錯誤的目標。例如，錯誤中的屬性名稱。

PrivateZone

Object

描述私人 DNS 區域。

名稱	類型	Description
etag	string	區域的 ETag。
id	string	資源的完整資源標識碼。範例 - '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/privateDnsZones/{privateDnsZoneName}'。
location	string	資源所在的 Azure 區域
name	string	資源的名稱
properties.maxNumberOfRecordSets	integer (int64)	可在此私人 DNS 區域中建立的記錄集數目上限。這是唯讀屬性，而且將忽略任何設定此值的嘗試。
properties.maxNumberOfVirtualNetworkLinks	integer (int64)	可連結至此私人 DNS 區域的虛擬網路數目上限。這是唯讀屬性，而且將忽略任何設定此值的嘗試。
properties.maxNumberOfVirtualNetworkLinksWithRegistration	integer (int64)	可連結至已啟用註冊之私人 DNS 區域的虛擬網路數目上限。這是唯讀屬性，而且將忽略任何設定此值的嘗試。
properties.numberOfRecordSets	integer (int64)	此私人 DNS 區域中目前的記錄集數目。這是唯讀屬性，而且將忽略任何設定此值的嘗試。
properties.numberOfVirtualNetworkLinks	integer (int64)	連結至此私人 DNS 區域的目前虛擬網路數目。這是唯讀屬性，而且將忽略任何設定此值的嘗試。
properties.numberOfVirtualNetworkLinksWithRegistration	integer (int64)	目前已連結至已啟用註冊之私人 DNS 區域的虛擬網路數目。這是唯讀屬性，而且將忽略任何設定此值的嘗試。
properties.provisioningState	ProvisioningState	資源的布建狀態。這是唯讀屬性，而且將忽略任何設定此值的嘗試。
tags	object	資源標籤。
type	string	資源的型別。範例 - 'Microsoft.Network/privateDnsZones'。

ProvisioningState

列舉型別

資源的布建狀態。這是唯讀屬性，而且將忽略任何設定此值的嘗試。

值	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

共用方式為

Private Zones - Get

URI 參數

回應

範例

GET Private DNS Zone

範例要求

範例回覆

定義

CloudError

CloudErrorBody

PrivateZone

ProvisioningState

其他資源