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

Zones - Update

汇报 DNS 区域。 不修改区域中的 DNS 记录。

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Network/dnsZones/{zoneName}?api-version=2018-05-01

URI 参数

名称 必需 类型 说明
resourceGroupName
path True

string

资源组的名称。

subscriptionId
path True

string

指定唯一标识 Microsoft Azure 订阅的 Azure 订阅 ID。

zoneName
path True

string

DNS 区域的名称 (没有终止点) 。

api-version
query True

string

指定 API 版本。

请求头

名称 必需 类型 说明
If-Match

string

DNS 区域的 etag。 省略此值以始终覆盖当前区域。 指定上次看到的 etag 值,以防止意外覆盖任何并发更改。

请求正文

名称 类型 说明
tags

object

资源标记。

响应

名称 类型 说明
200 OK

Zone

DNS 区域已更新。

Other Status Codes

CloudError

默认响应。 它将根据错误定义进行反序列化。

示例

Patch zone

示例请求

PATCH https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1?api-version=2018-05-01

{
  "tags": {
    "key2": "value2"
  }
}

示例响应

{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.Network/dnsZones/zone1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "location": "global",
  "name": "zone1",
  "type": "Microsoft.Network/dnsZones",
  "properties": {
    "maxNumberOfRecordSets": 5000,
    "numberOfRecordSets": 2,
    "nameServers": [
      "ns1-01.azure-dns.com",
      "ns2-01.azure-dns.net",
      "ns3-01.azure-dns.org",
      "ns4-01.azure-dns.info"
    ]
  },
  "tags": {
    "key2": "value2"
  }
}

定义

名称 说明
CloudError

来自服务的错误响应。

CloudErrorBody

来自服务的错误响应。

SubResource

对另一资源的引用

Zone

描述 DNS 区域。

ZoneType

此 DNS 区域的类型 (公共或专用) 。

ZoneUpdate

描述更新 DNS 区域的请求。

CloudError

来自服务的错误响应。

名称 类型 说明
error

CloudErrorBody

云错误正文。

CloudErrorBody

来自服务的错误响应。

名称 类型 说明
code

string

错误的标识符。 代码是固定的,旨在以编程方式使用。

details

CloudErrorBody[]

有关错误的其他详细信息的列表。

message

string

描述错误的消息,该消息适用于在用户界面中显示。

target

string

特定错误的目标。 例如,属性的名称出错。

SubResource

对另一资源的引用

名称 类型 说明
id

string

资源 ID。

Zone

描述 DNS 区域。

名称 类型 默认值 说明
etag

string

区域的 etag。

id

string

资源 ID。

location

string

资源位置。

name

string

资源名称。

properties.maxNumberOfRecordSets

integer

可在此 DNS 区域中创建的最大记录集数。 这是一个只读属性,任何设置此值的尝试都将被忽略。

properties.maxNumberOfRecordsPerRecordSet

integer

可在此 DNS 区域中创建的每个记录集的最大记录数。 这是一个只读属性,任何设置此值的尝试都将被忽略。

properties.nameServers

string[]

此 DNS 区域的名称服务器。 这是一个只读属性,任何设置此值的尝试都将被忽略。

properties.numberOfRecordSets

integer

此 DNS 区域中的当前记录集数。 这是一个只读属性,任何设置此值的尝试都将被忽略。

properties.registrationVirtualNetworks

SubResource[]

对此 DNS 区域中注册主机名的虚拟网络的引用列表。 仅当 ZoneType 为 Private 时,这才为 。

properties.resolutionVirtualNetworks

SubResource[]

对解析此 DNS 区域中记录的虚拟网络的引用列表。 仅当 ZoneType 为 Private 时,这才为 。

properties.zoneType

ZoneType

Public

此 DNS 区域的类型 (公共或专用) 。

tags

object

资源标记。

type

string

资源类型。

ZoneType

此 DNS 区域的类型 (公共或专用) 。

名称 类型 说明
Private

string

Public

string

ZoneUpdate

描述更新 DNS 区域的请求。

名称 类型 说明
tags

object

资源标记。