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

Record Sets - Update

服务:: DNS

API 版本:: 2018-09-01

更新专用 DNS 区域中的记录集。

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

URI 参数

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

请求头

名称	必需	类型	说明
If-Match		string	记录集的 ETag。省略此值以始终覆盖当前记录集。指定最后一次看到的 ETag 值，以防止意外覆盖并发更改。

请求正文

名称	类型	说明
etag	string	记录集的 ETag。
properties.aRecords	ARecord[]	记录集中的 A 记录列表。
properties.aaaaRecords	AaaaRecord[]	记录集中 AAAA 记录的列表。
properties.cnameRecord	CnameRecord	记录集中的 CNAME 记录。
properties.metadata	object	附加到记录集的元数据。
properties.mxRecords	MxRecord[]	记录集中 MX 记录的列表。
properties.ptrRecords	PtrRecord[]	记录集中 PTR 记录的列表。
properties.soaRecord	SoaRecord	记录集中的 SOA 记录。
properties.srvRecords	SrvRecord[]	记录集中 SRV 记录的列表。
properties.ttl	integer (int64)	记录集中记录的 TTL（生存时间）。
properties.txtRecords	TxtRecord[]	记录集中 TXT 记录的列表。

响应

名称	类型	说明
200 OK	RecordSet	记录集已更新。
Other Status Codes	CloudError	默认响应。它将根据错误定义进行反序列化。

示例

PATCH Private DNS Zone A Record Set

PATCH Private DNS Zone AAAA Record Set

PATCH Private DNS Zone CNAME Record Set

PATCH Private DNS Zone MX Record Set

PATCH Private DNS Zone PTR Record Set

PATCH Private DNS Zone SOA Record Set

PATCH Private DNS Zone SRV Record Set

PATCH Private DNS Zone TXT Record Set

PATCH Private DNS Zone A Record Set

示例请求

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/A/recorda",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recorda",
  "type": "Microsoft.Network/privateDnsZones/A",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recorda.privatezone1.com.",
    "isAutoRegistered": false,
    "aRecords": [
      {
        "ipv4Address": "1.2.3.4"
      }
    ]
  }
}

PATCH Private DNS Zone AAAA Record Set

示例请求

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/AAAA/recordaaaa",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordaaaa",
  "type": "Microsoft.Network/privateDnsZones/AAAA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordaaaa.privatezone1.com.",
    "isAutoRegistered": false,
    "aaaaRecords": [
      {
        "ipv6Address": "::1"
      }
    ]
  }
}

PATCH Private DNS Zone CNAME Record Set

示例请求

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/CNAME/recordcname",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordcname",
  "type": "Microsoft.Network/privateDnsZones/CNAME",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordcname.privatezone1.com.",
    "isAutoRegistered": false,
    "cnameRecord": {
      "cname": "contoso.com"
    }
  }
}

PATCH Private DNS Zone MX Record Set

示例请求

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/MX/recordmx",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordmx",
  "type": "Microsoft.Network/privateDnsZones/MX",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordmx.privatezone1.com.",
    "isAutoRegistered": false,
    "mxRecords": [
      {
        "preference": 0,
        "exchange": "mail.privatezone1.com"
      }
    ]
  }
}

PATCH Private DNS Zone PTR Record Set

示例请求

HTTP

PATCH https://management.azure.com/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1?api-version=2018-09-01

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/0.0.127.in-addr.arpa/PTR/1",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "1",
  "type": "Microsoft.Network/privateDnsZones/PTR",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "1.0.0.127.in-addr.arpa.",
    "isAutoRegistered": false,
    "ptrRecords": [
      {
        "ptrdname": "localhost"
      }
    ]
  }
}

PATCH Private DNS Zone SOA Record Set

示例请求

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SOA/@",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "@",
  "type": "Microsoft.Network/privateDnsZones/SOA",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "privatezone1.com.",
    "isAutoRegistered": false,
    "soaRecord": {
      "host": "azureprivatedns.net",
      "email": "azureprivatedns-hostmaster.microsoft.com",
      "serialNumber": 1,
      "refreshTime": 3600,
      "retryTime": 300,
      "expireTime": 2419200,
      "minimumTtl": 300
    }
  }
}

PATCH Private DNS Zone SRV Record Set

示例请求

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/SRV/recordsrv",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordsrv",
  "type": "Microsoft.Network/privateDnsZones/SRV",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordsrv.privatezone1.com.",
    "isAutoRegistered": false,
    "srvRecords": [
      {
        "priority": 0,
        "weight": 10,
        "port": 80,
        "target": "contoso.com"
      }
    ]
  }
}

PATCH Private DNS Zone TXT Record Set

示例请求

HTTP

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

{
  "properties": {
    "metadata": {
      "key2": "value2"
    }
  }
}

示例响应

状态代码:: 200

{
  "id": "/subscriptions/subscriptionId/resourceGroups/resourceGroup1/providers/Microsoft.Network/privateDnsZones/privatezone1.com/TXT/recordtxt",
  "etag": "00000000-0000-0000-0000-000000000000",
  "name": "recordtxt",
  "type": "Microsoft.Network/privateDnsZones/TXT",
  "properties": {
    "metadata": {
      "key2": "value2"
    },
    "ttl": 3600,
    "fqdn": "recordtxt.privatezone1.com.",
    "isAutoRegistered": false,
    "txtRecords": [
      {
        "value": [
          "string1",
          "string2"
        ]
      }
    ]
  }
}

定义

名称	说明
AaaaRecord	AAAA 记录。
ARecord	A 记录。
CloudError	服务的错误响应。
CloudErrorBody	服务的错误响应。
CnameRecord	CNAME 记录。
MxRecord	MX 记录。
PtrRecord	PTR 记录。
RecordSet	描述专用 DNS 区域中的 DNS 记录集（具有相同名称和类型的 DNS 记录集合）。
RecordType	此记录集中 DNS 记录的类型。
SoaRecord	SOA 记录。
SrvRecord	SRV 记录。
TxtRecord	TXT 记录。

AaaaRecord

Object

AAAA 记录。

名称	类型	说明
ipv6Address	string	此 AAAA 记录的 IPv6 地址。

ARecord

Object

A 记录。

名称	类型	说明
ipv4Address	string	此 A 记录的 IPv4 地址。

CloudError

Object

服务的错误响应。

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

CloudErrorBody

Object

服务的错误响应。

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

CnameRecord

Object

CNAME 记录。

名称	类型	说明
cname	string	此 CNAME 记录的规范名称。

MxRecord

Object

MX 记录。

名称	类型	说明
exchange	string	此 MX 记录的邮件主机的域名。
preference	integer (int32)	此 MX 记录的首选项值。

PtrRecord

Object

PTR 记录。

名称	类型	说明
ptrdname	string	此 PTR 记录的 PTR 目标域名。

RecordSet

Object

描述专用 DNS 区域中的 DNS 记录集（具有相同名称和类型的 DNS 记录集合）。

名称	类型	说明
etag	string	记录集的 ETag。
id	string	记录集的 ID。
name	string	记录集的名称。
properties.aRecords	ARecord[]	记录集中的 A 记录列表。
properties.aaaaRecords	AaaaRecord[]	记录集中 AAAA 记录的列表。
properties.cnameRecord	CnameRecord	记录集中的 CNAME 记录。
properties.fqdn	string	记录集的完全限定域名。
properties.isAutoRegistered	boolean	记录集是否通过虚拟网络链接在专用 DNS 区域中自动注册？
properties.metadata	object	附加到记录集的元数据。
properties.mxRecords	MxRecord[]	记录集中 MX 记录的列表。
properties.ptrRecords	PtrRecord[]	记录集中 PTR 记录的列表。
properties.soaRecord	SoaRecord	记录集中的 SOA 记录。
properties.srvRecords	SrvRecord[]	记录集中 SRV 记录的列表。
properties.ttl	integer (int64)	记录集中记录的 TTL（生存时间）。
properties.txtRecords	TxtRecord[]	记录集中 TXT 记录的列表。
type	string	记录集的类型。

RecordType

枚举

此记录集中 DNS 记录的类型。

值	说明
A
AAAA
CNAME
MX
PTR
SOA
SRV
TXT

SoaRecord

Object

SOA 记录。

名称	类型	说明
email	string	此 SOA 记录的电子邮件联系人。
expireTime	integer (int64)	此 SOA 记录的过期时间。
host	string	此 SOA 记录的权威名称服务器的域名。
minimumTtl	integer (int64)	此 SOA 记录的最小值。按照约定，这用于确定负缓存持续时间。
refreshTime	integer (int64)	此 SOA 记录的刷新值。
retryTime	integer (int64)	此 SOA 记录的重试时间。
serialNumber	integer (int64)	此 SOA 记录的序列号。

SrvRecord

Object

SRV 记录。

名称	类型	说明
port	integer (int32)	此 SRV 记录的端口值。
priority	integer (int32)	此 SRV 记录的优先级值。
target	string	此 SRV 记录的目标域名。
weight	integer (int32)	此 SRV 记录的权重值。

TxtRecord

Object

TXT 记录。

名称	类型	说明
value	string[]	此 TXT 记录的文本值。

通过

Record Sets - Update

URI 参数

请求头

请求正文

响应

示例

PATCH Private DNS Zone A Record Set

示例请求

示例响应

PATCH Private DNS Zone AAAA Record Set

示例请求

示例响应

PATCH Private DNS Zone CNAME Record Set

示例请求

示例响应

PATCH Private DNS Zone MX Record Set

示例请求

示例响应

PATCH Private DNS Zone PTR Record Set

示例请求

示例响应

PATCH Private DNS Zone SOA Record Set

示例请求

示例响应

PATCH Private DNS Zone SRV Record Set

示例请求

示例响应

PATCH Private DNS Zone TXT Record Set

示例请求

示例响应

定义

AaaaRecord

ARecord

CloudError

CloudErrorBody

CnameRecord

MxRecord

PtrRecord

RecordSet

RecordType

SoaRecord

SrvRecord

TxtRecord