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

Microsoft.Network dnsZones/SOA 2023-07-01-preview

• 最新
• 2023-07-01-preview
• 2018-05-01
• 2018-03-01-preview
• 2017-10-01
• 2017-09-01
• 2016-04-01
• 2015-05-04-preview

Bicep 资源定义

可以使用目标操作部署 dnsZones/SOA 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/dnsZones/SOA 资源，请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Network/dnsZones/SOA@2023-07-01-preview' = {
  parent: resourceSymbolicName
  etag: 'string'
  name: 'string'
  properties: {
    AAAARecords: [
      {
        ipv6Address: 'string'
      }
    ]
    ARecords: [
      {
        ipv4Address: 'string'
      }
    ]
    caaRecords: [
      {
        flags: int
        tag: 'string'
        value: 'string'
      }
    ]
    CNAMERecord: {
      cname: 'string'
    }
    DSRecords: [
      {
        algorithm: int
        digest: {
          algorithmType: int
          value: 'string'
        }
        keyTag: int
      }
    ]
    metadata: {
      {customized property}: 'string'
    }
    MXRecords: [
      {
        exchange: 'string'
        preference: int
      }
    ]
    NAPTRRecords: [
      {
        flags: 'string'
        order: int
        preference: int
        regexp: 'string'
        replacement: 'string'
        services: 'string'
      }
    ]
    NSRecords: [
      {
        nsdname: 'string'
      }
    ]
    PTRRecords: [
      {
        ptrdname: 'string'
      }
    ]
    SOARecord: {
      email: 'string'
      expireTime: int
      host: 'string'
      minimumTTL: int
      refreshTime: int
      retryTime: int
      serialNumber: int
    }
    SRVRecords: [
      {
        port: int
        priority: int
        target: 'string'
        weight: int
      }
    ]
    targetResource: {
      id: 'string'
    }
    TLSARecords: [
      {
        certAssociationData: 'string'
        matchingType: int
        selector: int
        usage: int
      }
    ]
    trafficManagementProfile: {
      id: 'string'
    }
    TTL: int
    TXTRecords: [
      {
        value: [
          'string'
        ]
      }
    ]
  }
}

属性值

AaaaRecord

名字	描述	价值
ipv6Address	此 AAAA 记录的 IPv6 地址。	字符串

ARecord

名字	描述	价值
ipv4Address	此 A 记录的 IPv4 地址。	字符串

CaaRecord

名字	描述	价值
标志	此 CAA 记录的标志为 0 到 255 之间的整数。	int
标记	此 CAA 记录的标记。	字符串
价值	此 CAA 记录的值。	字符串

CnameRecord

名字	描述	价值
cname	此 CNAME 记录的规范名称。	字符串

消化

名字	描述	价值
algorithmType	摘要算法类型表示用于构造摘要的标准摘要算法编号。 请参阅：https://www.iana.org/assignments/ds-rr-types/ds-rr-types.xhtml	int
价值	摘要值是引用的 DNSKEY 资源记录的加密哈希值。	字符串

DsRecord

名字	描述	价值
算法	安全算法类型表示 DNSKEY 资源记录的标准安全算法编号。 请参阅：https://www.iana.org/assignments/dns-sec-alg-numbers/dns-sec-alg-numbers.xhtml	int
消化	摘要实体。	摘要
keyTag	密钥标记值用于确定哪个 DNSKEY 资源记录用于签名验证。	int

Microsoft.Network/dnsZones/SOA

名字	描述	价值
etag	记录集的 etag。	字符串
名字	资源名称	string （必需）
父母	在 Bicep 中，可以为子资源指定父资源。 仅当子资源在父资源外部声明时，才需要添加此属性。 有关详细信息，请参阅 父资源外部的子资源。	类型资源的符号名称：dnsZones
性能	记录集的属性。	RecordSetProperties

MxRecord

名字	描述	价值
交换	此 MX 记录的邮件主机的域名。	字符串
偏好	此 MX 记录的首选项值。	int

NaptrRecord

名字	描述	价值
标志	特定于 DDDS 应用程序的标志。 RFC 3404 中当前定义的值为大写和小写字母“A”、“P”、“S”和“U”，以及空字符串“”。 用引号将标志括起来。	字符串
次序	必须处理 NAPTR 记录的顺序，以便准确表示规则的有序列表。 排序从最低到最高。 有效值：0-65535。	int
偏好	首选项指定应处理具有相同“order”值的 NAPTR 记录的顺序，在高数字之前处理较少的数字。 有效值：0-65535。	int
regexp	DDDS 应用程序用于将输入值转换为输出值的正则表达式。 例如：IP 电话系统可能使用正则表达式将用户输入的电话号码转换为 SIP URI。 将正则表达式括在引号中。 指定“regexp”的值或“replacement”的值。	字符串
更换	替换项是希望 DDDS 应用程序提交 DNS 查询的下一个域名的完全限定域名（FQDN）。 DDDS 应用程序将输入值替换为指定的替换值。 指定“regexp”的值或“replacement”的值。 如果为“regexp”指定值，请为“replacement”指定一个点（.）。	字符串
服务业	特定于 DDDS 应用程序的服务。 用引号将服务括起来。	字符串

NsRecord

名字	描述	价值
nsdname	此 NS 记录的名称服务器名称。	字符串

PtrRecord

名字	描述	价值
ptrdname	此 PTR 记录的 PTR 目标域名。	字符串

RecordSetProperties

名字	描述	价值
AAAARecords	记录集中 AAAA 记录的列表。	AaaaRecord[]
ARecords	记录集中的 A 记录列表。	ARecord[]
caaRecords	记录集中 CAA 记录的列表。	CaaRecord[]
CNAMERecord	记录集中的 CNAME 记录。	CnameRecord
DSRecords	记录集中 DS 记录的列表。	DsRecord[]
元数据	附加到记录集的元数据。	RecordSetPropertiesMetadata
MXRecords	记录集中 MX 记录的列表。	MxRecord[]
NAPTRRecords	记录集中 NAPTR 记录的列表。	NaptrRecord[]
NSRecords	记录集中 NS 记录的列表。	NsRecord[]
PTRRecords	记录集中 PTR 记录的列表。	PtrRecord[]
SOARecord	记录集中的 SOA 记录。	SoaRecord
SRVRecords	记录集中 SRV 记录的列表。	SrvRecord[]
targetResource	对从中获取 dns 资源值的 Azure 资源的引用。	SubResource
TLSARecords	记录集中 TLSA 记录的列表。	TlsaRecord[]
trafficManagementProfile	对从中获取 dns 资源值的 Azure 流量管理器配置文件资源的引用。	SubResource
TTL	记录集中记录的 TTL（生存时间）。	int
TXTRecords	记录集中 TXT 记录的列表。	TxtRecord[]

RecordSetPropertiesMetadata

名字	描述	价值

SoaRecord

名字	描述	价值
电子邮件	此 SOA 记录的电子邮件联系人。	字符串
expireTime	此 SOA 记录的过期时间。	int
主机	此 SOA 记录的权威名称服务器的域名。	字符串
minimumTTL	此 SOA 记录的最小值。 按照约定，这用于确定负缓存持续时间。	int
refreshTime	此 SOA 记录的刷新值。	int
retryTime	此 SOA 记录的重试时间。	int
serialNumber	此 SOA 记录的序列号。	int

SrvRecord

名字	描述	价值
港口	此 SRV 记录的端口值。	int
优先权	此 SRV 记录的优先级值。	int
目标	此 SRV 记录的目标域名。	字符串
重量	此 SRV 记录的权重值。	int

SubResource

名字	描述	价值
id	资源 ID。	字符串

TlsaRecord

名字	描述	价值
certAssociationData	这指定要匹配的证书关联数据。	字符串
matchingType	匹配类型指定如何显示证书关联。	int
选择器	选择器指定服务器提供的 TLS 证书的哪个部分将与关联数据匹配。	int
用法	用法指定提供的关联，该关联将用于匹配 TLS 握手中显示的证书。	int

TxtRecord

名字	描述	价值
价值	此 TXT 记录的文本值。	string[]

ARM 模板资源定义

可以使用目标操作部署 dnsZones/SOA 资源类型：

• 资源组 - 请参阅 资源组部署命令

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/dnsZones/SOA 资源，请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Network/dnsZones/SOA",
  "apiVersion": "2023-07-01-preview",
  "name": "string",
  "etag": "string",
  "properties": {
    "AAAARecords": [
      {
        "ipv6Address": "string"
      }
    ],
    "ARecords": [
      {
        "ipv4Address": "string"
      }
    ],
    "caaRecords": [
      {
        "flags": "int",
        "tag": "string",
        "value": "string"
      }
    ],
    "CNAMERecord": {
      "cname": "string"
    },
    "DSRecords": [
      {
        "algorithm": "int",
        "digest": {
          "algorithmType": "int",
          "value": "string"
        },
        "keyTag": "int"
      }
    ],
    "metadata": {
      "{customized property}": "string"
    },
    "MXRecords": [
      {
        "exchange": "string",
        "preference": "int"
      }
    ],
    "NAPTRRecords": [
      {
        "flags": "string",
        "order": "int",
        "preference": "int",
        "regexp": "string",
        "replacement": "string",
        "services": "string"
      }
    ],
    "NSRecords": [
      {
        "nsdname": "string"
      }
    ],
    "PTRRecords": [
      {
        "ptrdname": "string"
      }
    ],
    "SOARecord": {
      "email": "string",
      "expireTime": "int",
      "host": "string",
      "minimumTTL": "int",
      "refreshTime": "int",
      "retryTime": "int",
      "serialNumber": "int"
    },
    "SRVRecords": [
      {
        "port": "int",
        "priority": "int",
        "target": "string",
        "weight": "int"
      }
    ],
    "targetResource": {
      "id": "string"
    },
    "TLSARecords": [
      {
        "certAssociationData": "string",
        "matchingType": "int",
        "selector": "int",
        "usage": "int"
      }
    ],
    "trafficManagementProfile": {
      "id": "string"
    },
    "TTL": "int",
    "TXTRecords": [
      {
        "value": [ "string" ]
      }
    ]
  }
}

属性值

AaaaRecord

名字	描述	价值
ipv6Address	此 AAAA 记录的 IPv6 地址。	字符串

ARecord

名字	描述	价值
ipv4Address	此 A 记录的 IPv4 地址。	字符串

CaaRecord

名字	描述	价值
标志	此 CAA 记录的标志为 0 到 255 之间的整数。	int
标记	此 CAA 记录的标记。	字符串
价值	此 CAA 记录的值。	字符串

CnameRecord

名字	描述	价值
cname	此 CNAME 记录的规范名称。	字符串

消化

名字	描述	价值
algorithmType	摘要算法类型表示用于构造摘要的标准摘要算法编号。 请参阅：https://www.iana.org/assignments/ds-rr-types/ds-rr-types.xhtml	int
价值	摘要值是引用的 DNSKEY 资源记录的加密哈希值。	字符串

DsRecord

名字	描述	价值
算法	安全算法类型表示 DNSKEY 资源记录的标准安全算法编号。 请参阅：https://www.iana.org/assignments/dns-sec-alg-numbers/dns-sec-alg-numbers.xhtml	int
消化	摘要实体。	摘要
keyTag	密钥标记值用于确定哪个 DNSKEY 资源记录用于签名验证。	int

Microsoft.Network/dnsZones/SOA

名字	描述	价值
apiVersion	API 版本	'2023-07-01-preview'
etag	记录集的 etag。	字符串
名字	资源名称	string （必需）
性能	记录集的属性。	RecordSetProperties
类型	资源类型	“Microsoft.Network/dnsZones/SOA”

MxRecord

名字	描述	价值
交换	此 MX 记录的邮件主机的域名。	字符串
偏好	此 MX 记录的首选项值。	int

NaptrRecord

名字	描述	价值
标志	特定于 DDDS 应用程序的标志。 RFC 3404 中当前定义的值为大写和小写字母“A”、“P”、“S”和“U”，以及空字符串“”。 用引号将标志括起来。	字符串
次序	必须处理 NAPTR 记录的顺序，以便准确表示规则的有序列表。 排序从最低到最高。 有效值：0-65535。	int
偏好	首选项指定应处理具有相同“order”值的 NAPTR 记录的顺序，在高数字之前处理较少的数字。 有效值：0-65535。	int
regexp	DDDS 应用程序用于将输入值转换为输出值的正则表达式。 例如：IP 电话系统可能使用正则表达式将用户输入的电话号码转换为 SIP URI。 将正则表达式括在引号中。 指定“regexp”的值或“replacement”的值。	字符串
更换	替换项是希望 DDDS 应用程序提交 DNS 查询的下一个域名的完全限定域名（FQDN）。 DDDS 应用程序将输入值替换为指定的替换值。 指定“regexp”的值或“replacement”的值。 如果为“regexp”指定值，请为“replacement”指定一个点（.）。	字符串
服务业	特定于 DDDS 应用程序的服务。 用引号将服务括起来。	字符串

NsRecord

名字	描述	价值
nsdname	此 NS 记录的名称服务器名称。	字符串

PtrRecord

名字	描述	价值
ptrdname	此 PTR 记录的 PTR 目标域名。	字符串

RecordSetProperties

名字	描述	价值
AAAARecords	记录集中 AAAA 记录的列表。	AaaaRecord[]
ARecords	记录集中的 A 记录列表。	ARecord[]
caaRecords	记录集中 CAA 记录的列表。	CaaRecord[]
CNAMERecord	记录集中的 CNAME 记录。	CnameRecord
DSRecords	记录集中 DS 记录的列表。	DsRecord[]
元数据	附加到记录集的元数据。	RecordSetPropertiesMetadata
MXRecords	记录集中 MX 记录的列表。	MxRecord[]
NAPTRRecords	记录集中 NAPTR 记录的列表。	NaptrRecord[]
NSRecords	记录集中 NS 记录的列表。	NsRecord[]
PTRRecords	记录集中 PTR 记录的列表。	PtrRecord[]
SOARecord	记录集中的 SOA 记录。	SoaRecord
SRVRecords	记录集中 SRV 记录的列表。	SrvRecord[]
targetResource	对从中获取 dns 资源值的 Azure 资源的引用。	SubResource
TLSARecords	记录集中 TLSA 记录的列表。	TlsaRecord[]
trafficManagementProfile	对从中获取 dns 资源值的 Azure 流量管理器配置文件资源的引用。	SubResource
TTL	记录集中记录的 TTL（生存时间）。	int
TXTRecords	记录集中 TXT 记录的列表。	TxtRecord[]

RecordSetPropertiesMetadata

名字	描述	价值

SoaRecord

名字	描述	价值
电子邮件	此 SOA 记录的电子邮件联系人。	字符串
expireTime	此 SOA 记录的过期时间。	int
主机	此 SOA 记录的权威名称服务器的域名。	字符串
minimumTTL	此 SOA 记录的最小值。 按照约定，这用于确定负缓存持续时间。	int
refreshTime	此 SOA 记录的刷新值。	int
retryTime	此 SOA 记录的重试时间。	int
serialNumber	此 SOA 记录的序列号。	int

SrvRecord

名字	描述	价值
港口	此 SRV 记录的端口值。	int
优先权	此 SRV 记录的优先级值。	int
目标	此 SRV 记录的目标域名。	字符串
重量	此 SRV 记录的权重值。	int

SubResource

名字	描述	价值
id	资源 ID。	字符串

TlsaRecord

名字	描述	价值
certAssociationData	这指定要匹配的证书关联数据。	字符串
matchingType	匹配类型指定如何显示证书关联。	int
选择器	选择器指定服务器提供的 TLS 证书的哪个部分将与关联数据匹配。	int
用法	用法指定提供的关联，该关联将用于匹配 TLS 握手中显示的证书。	int

TxtRecord

名字	描述	价值
价值	此 TXT 记录的文本值。	string[]

Terraform （AzAPI 提供程序）资源定义

可以使用目标操作部署 dnsZones/SOA 资源类型：

• 资源组

有关每个 API 版本中已更改属性的列表，请参阅 更改日志。

资源格式

若要创建 Microsoft.Network/dnsZones/SOA 资源，请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/dnsZones/SOA@2023-07-01-preview"
  name = "string"
  etag = "string"
  body = jsonencode({
    properties = {
      AAAARecords = [
        {
          ipv6Address = "string"
        }
      ]
      ARecords = [
        {
          ipv4Address = "string"
        }
      ]
      caaRecords = [
        {
          flags = int
          tag = "string"
          value = "string"
        }
      ]
      CNAMERecord = {
        cname = "string"
      }
      DSRecords = [
        {
          algorithm = int
          digest = {
            algorithmType = int
            value = "string"
          }
          keyTag = int
        }
      ]
      metadata = {
        {customized property} = "string"
      }
      MXRecords = [
        {
          exchange = "string"
          preference = int
        }
      ]
      NAPTRRecords = [
        {
          flags = "string"
          order = int
          preference = int
          regexp = "string"
          replacement = "string"
          services = "string"
        }
      ]
      NSRecords = [
        {
          nsdname = "string"
        }
      ]
      PTRRecords = [
        {
          ptrdname = "string"
        }
      ]
      SOARecord = {
        email = "string"
        expireTime = int
        host = "string"
        minimumTTL = int
        refreshTime = int
        retryTime = int
        serialNumber = int
      }
      SRVRecords = [
        {
          port = int
          priority = int
          target = "string"
          weight = int
        }
      ]
      targetResource = {
        id = "string"
      }
      TLSARecords = [
        {
          certAssociationData = "string"
          matchingType = int
          selector = int
          usage = int
        }
      ]
      trafficManagementProfile = {
        id = "string"
      }
      TTL = int
      TXTRecords = [
        {
          value = [
            "string"
          ]
        }
      ]
    }
  })
}

属性值

AaaaRecord

名字	描述	价值
ipv6Address	此 AAAA 记录的 IPv6 地址。	字符串

ARecord

名字	描述	价值
ipv4Address	此 A 记录的 IPv4 地址。	字符串

CaaRecord

名字	描述	价值
标志	此 CAA 记录的标志为 0 到 255 之间的整数。	int
标记	此 CAA 记录的标记。	字符串
价值	此 CAA 记录的值。	字符串

CnameRecord

名字	描述	价值
cname	此 CNAME 记录的规范名称。	字符串

消化

名字	描述	价值
algorithmType	摘要算法类型表示用于构造摘要的标准摘要算法编号。 请参阅：https://www.iana.org/assignments/ds-rr-types/ds-rr-types.xhtml	int
价值	摘要值是引用的 DNSKEY 资源记录的加密哈希值。	字符串

DsRecord

名字	描述	价值
算法	安全算法类型表示 DNSKEY 资源记录的标准安全算法编号。 请参阅：https://www.iana.org/assignments/dns-sec-alg-numbers/dns-sec-alg-numbers.xhtml	int
消化	摘要实体。	摘要
keyTag	密钥标记值用于确定哪个 DNSKEY 资源记录用于签名验证。	int

Microsoft.Network/dnsZones/SOA

名字	描述	价值
etag	记录集的 etag。	字符串
名字	资源名称	string （必需）
parent_id	此资源的父资源的 ID。	类型资源的 ID：dnsZones
性能	记录集的属性。	RecordSetProperties
类型	资源类型	“Microsoft.Network/dnsZones/SOA@2023-07-01-preview”

MxRecord

名字	描述	价值
交换	此 MX 记录的邮件主机的域名。	字符串
偏好	此 MX 记录的首选项值。	int

NaptrRecord

名字	描述	价值
标志	特定于 DDDS 应用程序的标志。 RFC 3404 中当前定义的值为大写和小写字母“A”、“P”、“S”和“U”，以及空字符串“”。 用引号将标志括起来。	字符串
次序	必须处理 NAPTR 记录的顺序，以便准确表示规则的有序列表。 排序从最低到最高。 有效值：0-65535。	int
偏好	首选项指定应处理具有相同“order”值的 NAPTR 记录的顺序，在高数字之前处理较少的数字。 有效值：0-65535。	int
regexp	DDDS 应用程序用于将输入值转换为输出值的正则表达式。 例如：IP 电话系统可能使用正则表达式将用户输入的电话号码转换为 SIP URI。 将正则表达式括在引号中。 指定“regexp”的值或“replacement”的值。	字符串
更换	替换项是希望 DDDS 应用程序提交 DNS 查询的下一个域名的完全限定域名（FQDN）。 DDDS 应用程序将输入值替换为指定的替换值。 指定“regexp”的值或“replacement”的值。 如果为“regexp”指定值，请为“replacement”指定一个点（.）。	字符串
服务业	特定于 DDDS 应用程序的服务。 用引号将服务括起来。	字符串

NsRecord

名字	描述	价值
nsdname	此 NS 记录的名称服务器名称。	字符串

PtrRecord

名字	描述	价值
ptrdname	此 PTR 记录的 PTR 目标域名。	字符串

RecordSetProperties

名字	描述	价值
AAAARecords	记录集中 AAAA 记录的列表。	AaaaRecord[]
ARecords	记录集中的 A 记录列表。	ARecord[]
caaRecords	记录集中 CAA 记录的列表。	CaaRecord[]
CNAMERecord	记录集中的 CNAME 记录。	CnameRecord
DSRecords	记录集中 DS 记录的列表。	DsRecord[]
元数据	附加到记录集的元数据。	RecordSetPropertiesMetadata
MXRecords	记录集中 MX 记录的列表。	MxRecord[]
NAPTRRecords	记录集中 NAPTR 记录的列表。	NaptrRecord[]
NSRecords	记录集中 NS 记录的列表。	NsRecord[]
PTRRecords	记录集中 PTR 记录的列表。	PtrRecord[]
SOARecord	记录集中的 SOA 记录。	SoaRecord
SRVRecords	记录集中 SRV 记录的列表。	SrvRecord[]
targetResource	对从中获取 dns 资源值的 Azure 资源的引用。	SubResource
TLSARecords	记录集中 TLSA 记录的列表。	TlsaRecord[]
trafficManagementProfile	对从中获取 dns 资源值的 Azure 流量管理器配置文件资源的引用。	SubResource
TTL	记录集中记录的 TTL（生存时间）。	int
TXTRecords	记录集中 TXT 记录的列表。	TxtRecord[]

RecordSetPropertiesMetadata

名字	描述	价值

SoaRecord

名字	描述	价值
电子邮件	此 SOA 记录的电子邮件联系人。	字符串
expireTime	此 SOA 记录的过期时间。	int
主机	此 SOA 记录的权威名称服务器的域名。	字符串
minimumTTL	此 SOA 记录的最小值。 按照约定，这用于确定负缓存持续时间。	int
refreshTime	此 SOA 记录的刷新值。	int
retryTime	此 SOA 记录的重试时间。	int
serialNumber	此 SOA 记录的序列号。	int

SrvRecord

名字	描述	价值
港口	此 SRV 记录的端口值。	int
优先权	此 SRV 记录的优先级值。	int
目标	此 SRV 记录的目标域名。	字符串
重量	此 SRV 记录的权重值。	int

SubResource

名字	描述	价值
id	资源 ID。	字符串

TlsaRecord

名字	描述	价值
certAssociationData	这指定要匹配的证书关联数据。	字符串
matchingType	匹配类型指定如何显示证书关联。	int
选择器	选择器指定服务器提供的 TLS 证书的哪个部分将与关联数据匹配。	int
用法	用法指定提供的关联，该关联将用于匹配 TLS 握手中显示的证书。	int

TxtRecord

名字	描述	价值
价值	此 TXT 记录的文本值。	string[]