你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

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 参数

名称	在	必需	类型	说明
privateZoneName	path	True	string	专用 DNS 区域的名称（没有终止点）。
resourceGroupName	path	True	string	资源组的名称。
subscriptionId	path	True	string	获取唯一标识Microsoft Azure 订阅的订阅凭据。订阅 ID 构成了每个服务调用的 URI 的一部分。
api-version	query	True	string	客户端 API 版本。

响应

名称	类型	说明
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"
  }
}

定义

名称	说明
CloudError	服务的错误响应。
CloudErrorBody	服务的错误响应。
PrivateZone	描述专用 DNS 区域。
ProvisioningState	资源的预配状态。这是一个只读属性，将忽略任何设置此值的尝试。

CloudError

Object

服务的错误响应。

名称	类型	说明
error	CloudErrorBody	云错误正文。

CloudErrorBody

Object

服务的错误响应。

名称	类型	说明
code	string	错误的标识符。代码是固定的，旨在以编程方式使用。
details	CloudErrorBody[]	有关错误的其他详细信息的列表。
message	string	描述错误的消息，旨在适合在用户界面中显示。
target	string	特定错误的目标。例如，错误属性的名称。

PrivateZone

Object

描述专用 DNS 区域。

名称	类型	说明
etag	string	区域的 ETag。
id	string	资源的完全限定资源 ID。示例 - “/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

枚举

资源的预配状态。这是一个只读属性，将忽略任何设置此值的尝试。

值	说明
Canceled
Creating
Deleting
Failed
Succeeded
Updating

通过

Private Zones - Get

URI 参数

响应

示例

GET Private DNS Zone

示例请求

示例响应

定义

CloudError

CloudErrorBody

PrivateZone

ProvisioningState

其他资源