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

Microsoft。Network dnsForwardingRulesets/virtualNetworkLinks

Bicep 资源定义

可以使用目标操作部署 dnsForwardingRulesets/virtualNetworkLinks 资源类型:

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

用法示例

Bicep 示例

部署专用 DNS 解析器虚拟网络链接的基本示例。

param resourceName string = 'acctest0001'
param location string = 'westeurope'

resource dnsResolver 'Microsoft.Network/dnsResolvers@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    virtualNetwork: {
      id: virtualNetwork.id
    }
  }
}

resource virtualNetwork 'Microsoft.Network/virtualNetworks@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    addressSpace: {
      addressPrefixes: [
        '10.0.0.0/16'
      ]
    }
    dhcpOptions: {
      dnsServers: []
    }
    subnets: []
  }
}

resource outboundEndpoint 'Microsoft.Network/dnsResolvers/outboundEndpoints@2022-07-01' = {
  name: resourceName
  location: location
  parent: dnsResolver
  properties: {
    subnet: {
      id: subnet.id
    }
  }
}

resource subnet 'Microsoft.Network/virtualNetworks/subnets@2022-07-01' = {
  name: 'outbounddns'
  parent: virtualNetwork
  properties: {
    addressPrefix: '10.0.0.64/28'
    delegations: [
      {
        name: 'Microsoft.Network.dnsResolvers'
        properties: {
          serviceName: 'Microsoft.Network/dnsResolvers'
        }
      }
    ]
    privateEndpointNetworkPolicies: 'Enabled'
    privateLinkServiceNetworkPolicies: 'Enabled'
    serviceEndpointPolicies: []
    serviceEndpoints: []
  }
}

resource dnsForwardingRuleset 'Microsoft.Network/dnsForwardingRulesets@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    dnsResolverOutboundEndpoints: [
      {
        id: outboundEndpoint.id
      }
    ]
  }
}

resource virtualNetworkLink 'Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks@2022-07-01' = {
  name: resourceName
  parent: dnsForwardingRuleset
  properties: {
    virtualNetwork: {
      id: virtualNetwork.id
    }
  }
}

Azure 验证模块

以下 Azure 验证模块 可用于部署此资源类型。

模块 描述
DNS转发规则集 - 虚拟网络 Link AVM DNS转发规则集子模块 - 虚拟网络 Link

Azure 快速入门示例

以下 Azure 快速入门模板 包含用于部署此资源类型的 Bicep 示例。

Bicep 文件 描述
Azure DNS 专用解析程序 此模板使用所需的转发规则集和规则在虚拟网络中预配 Azure DNS 专用解析程序。 它创建一个包含两个子网的新虚拟网络,并在此 VNET 中部署 Azure DNS 专用解析程序。

资源格式

若要创建 Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks 资源,请将以下 Bicep 添加到模板。

resource symbolicname 'Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks@2025-10-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    metadata: {
      {customized property}: 'string'
    }
    virtualNetwork: {
      id: 'string'
    }
  }
}

属性值

名字 描述 价值
名字 资源名称 string (必需)
父级 在 Bicep 中,可以为子资源指定父资源。 仅当子资源在父资源外部声明时,才需要添加此属性。

有关详细信息,请参阅 父资源外部的子资源。
类型资源的符号名称:dnsForwardingRulesets
性能 虚拟网络链接的属性。 VirtualNetworkLinkProperties(必需)

子资源

名字 描述 价值
id 资源 ID。 string (必需)

VirtualNetworkLinkProperties

名字 描述 价值
元数据 附加到虚拟网络链接的元数据。 VirtualNetworkLinkPropertiesMetadata
虚拟网络 对虚拟网络的引用。 创建后无法更改此更改。 SubResource (必需)

VirtualNetworkLinkPropertiesMetadata

名字 描述 价值

ARM 模板资源定义

可以使用目标操作部署 dnsForwardingRulesets/virtualNetworkLinks 资源类型:

用法示例

Azure 快速入门模板

以下 Azure 快速入门模板 部署此资源类型。

模板 描述
Azure DNS 专用解析程序

部署到 Azure
此模板使用所需的转发规则集和规则在虚拟网络中预配 Azure DNS 专用解析程序。 它创建一个包含两个子网的新虚拟网络,并在此 VNET 中部署 Azure DNS 专用解析程序。

资源格式

若要创建 Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks 资源,请将以下 JSON 添加到模板。

{
  "type": "Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "properties": {
    "metadata": {
      "{customized property}": "string"
    },
    "virtualNetwork": {
      "id": "string"
    }
  }
}

属性值

名字 描述 价值
apiVersion API 版本 “2025-10-01-预览”
名字 资源名称 string (必需)
性能 虚拟网络链接的属性。 VirtualNetworkLinkProperties(必需)
类型 资源类型 “Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks”

子资源

名字 描述 价值
id 资源 ID。 string (必需)

VirtualNetworkLinkProperties

名字 描述 价值
元数据 附加到虚拟网络链接的元数据。 VirtualNetworkLinkPropertiesMetadata
虚拟网络 对虚拟网络的引用。 创建后无法更改此更改。 SubResource (必需)

VirtualNetworkLinkPropertiesMetadata

名字 描述 价值

Terraform (AzAPI 提供程序)资源定义

可以使用目标操作部署 dnsForwardingRulesets/virtualNetworkLinks 资源类型:

  • 资源组 关于每个API版本中变更属性的列表,请参见 更改日志。

用法示例

Terraform 示例

部署专用 DNS 解析器虚拟网络链接的基本示例。

terraform {
  required_providers {
    azapi = {
      source = "Azure/azapi"
    }
  }
}

provider "azapi" {
  skip_provider_registration = false
}

variable "resource_name" {
  type    = string
  default = "acctest0001"
}

variable "location" {
  type    = string
  default = "westeurope"
}

resource "azapi_resource" "resourceGroup" {
  type     = "Microsoft.Resources/resourceGroups@2020-06-01"
  name     = var.resource_name
  location = var.location
}

resource "azapi_resource" "virtualNetwork" {
  type      = "Microsoft.Network/virtualNetworks@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      addressSpace = {
        addressPrefixes = [
          "10.0.0.0/16",
        ]
      }
      dhcpOptions = {
        dnsServers = [
        ]
      }
      subnets = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  lifecycle {
    ignore_changes = [body.properties.subnets]
  }
}

resource "azapi_resource" "dnsResolver" {
  type      = "Microsoft.Network/dnsResolvers@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      virtualNetwork = {
        id = azapi_resource.virtualNetwork.id
      }
    }

  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "subnet" {
  type      = "Microsoft.Network/virtualNetworks/subnets@2022-07-01"
  parent_id = azapi_resource.virtualNetwork.id
  name      = "outbounddns"
  body = {
    properties = {
      addressPrefix = "10.0.0.64/28"
      delegations = [
        {
          name = "Microsoft.Network.dnsResolvers"
          properties = {
            serviceName = "Microsoft.Network/dnsResolvers"
          }
        },
      ]
      privateEndpointNetworkPolicies    = "Enabled"
      privateLinkServiceNetworkPolicies = "Enabled"
      serviceEndpointPolicies = [
      ]
      serviceEndpoints = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "outboundEndpoint" {
  type      = "Microsoft.Network/dnsResolvers/outboundEndpoints@2022-07-01"
  parent_id = azapi_resource.dnsResolver.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      subnet = {
        id = azapi_resource.subnet.id
      }
    }

  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "dnsForwardingRuleset" {
  type      = "Microsoft.Network/dnsForwardingRulesets@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      dnsResolverOutboundEndpoints = [
        {
          id = azapi_resource.outboundEndpoint.id
        },
      ]
    }

  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "virtualNetworkLink" {
  type      = "Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks@2022-07-01"
  parent_id = azapi_resource.dnsForwardingRuleset.id
  name      = var.resource_name
  body = {
    properties = {
      metadata = null
      virtualNetwork = {
        id = azapi_resource.virtualNetwork.id
      }
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

资源格式

若要创建 Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks 资源,请将以下 Terraform 添加到模板。

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      metadata = {
        {customized property} = "string"
      }
      virtualNetwork = {
        id = "string"
      }
    }
  }
}

属性值

名字 描述 价值
名字 资源名称 string (必需)
parent_id 此资源的父资源的 ID。 类型资源的 ID:dnsForwardingRulesets
性能 虚拟网络链接的属性。 VirtualNetworkLinkProperties(必需)
类型 资源类型 “Microsoft.Network/dnsForwardingRulesets/virtualNetworkLinks@2025-10-01-preview”

子资源

名字 描述 价值
id 资源 ID。 string (必需)

VirtualNetworkLinkProperties

名字 描述 价值
元数据 附加到虚拟网络链接的元数据。 VirtualNetworkLinkPropertiesMetadata
虚拟网络 对虚拟网络的引用。 创建后无法更改此更改。 SubResource (必需)

VirtualNetworkLinkPropertiesMetadata

名字 描述 价值