Microsoft.Network dnsForwardingRulesets/forwardingRules 2025-10-01-preview

Определение ресурсов Bicep

Тип ресурса dnsForwardingRulesets/forwardingRules можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/dnsForwardingRulesets/forwardingRules, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.Network/dnsForwardingRulesets/forwardingRules@2025-10-01-preview' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    domainName: 'string'
    forwardingRuleState: 'string'
    metadata: {
      {customized property}: 'string'
    }
    targetDnsServers: [
      {
        ipAddress: 'string'
        port: int
      }
    ]
  }
}

Значения свойств

Microsoft.Network/dnsForwardingRulesets/forwardingRules

Имя Description Ценность
имя имя ресурса. строка (обязательно)
parent В Bicep можно указать родительский ресурс для дочернего ресурса. Это свойство необходимо добавить, только если дочерний ресурс объявлен за пределами родительского ресурса.

Дополнительные сведения см. в разделе "Дочерний ресурс вне родительского ресурса".
Символьное имя ресурса типа: dnsForwardingRulesets
properties Свойства правила пересылки. ПересылкаRuleProperties (обязательно)

ПересылкаRuleProperties

Имя Description Ценность
domainName Доменное имя правила пересылки. строка (обязательно)
forwardingRuleState Состояние правила пересылки. 'Disabled'
"Включено"
metadata Метаданные, присоединенные к правилу пересылки. ПересылкаRulePropertiesMetadata
targetDnsServers DNS-серверы для пересылки DNS-запроса. TargetDnsServer[] (обязательно)

ПеренаправлениеRulePropertiesMetadata

Имя Description Ценность

Целевой сервер DnsServer

Имя Description Ценность
ipAddress IP-адрес DNS-сервера. строка (обязательно)
порт Порт DNS-сервера. инт

Примеры использования

Примеры Bicep

Простой пример развертывания правила переадресации частного DNS-резолвера.

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

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

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 forwardingRule 'Microsoft.Network/dnsForwardingRulesets/forwardingRules@2022-07-01' = {
  parent: dnsForwardingRuleset
  name: resourceName
  properties: {
    domainName: 'onprem.local.'
    forwardingRuleState: 'Enabled'
    metadata: null
    targetDnsServers: [
      {
        ipAddress: '10.10.0.1'
        port: 53
      }
    ]
  }
}

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

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

Примеры быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure содержат примеры Bicep для развертывания этого типа ресурса.

Файл Bicep Description
Частный резолвер DNS Azure Этот шаблон подготавливает частный сопоставитель Azure DNS в виртуальной сети с необходимым набором правил пересылки и правилами. Он создает виртуальную сеть с двумя подсетями и развертывает частный сопоставитель Azure DNS в этой виртуальной сети.

Определение ресурса шаблона ARM

Тип ресурса dnsForwardingRulesets/forwardingRules можно развернуть с помощью операций, предназначенных для следующих операций:

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/dnsForwardingRulesets/forwardingRules, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.Network/dnsForwardingRulesets/forwardingRules",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "properties": {
    "domainName": "string",
    "forwardingRuleState": "string",
    "metadata": {
      "{customized property}": "string"
    },
    "targetDnsServers": [
      {
        "ipAddress": "string",
        "port": "int"
      }
    ]
  }
}

Значения свойств

Microsoft.Network/dnsForwardingRulesets/forwardingRules

Имя Description Ценность
apiVersion Версия API «2025-10-01-превью»
имя имя ресурса. строка (обязательно)
properties Свойства правила пересылки. ПересылкаRuleProperties (обязательно)
type Тип ресурса "Microsoft.Network/dnsForwardingRulesets/forwardingRules"

ПересылкаRuleProperties

Имя Description Ценность
domainName Доменное имя правила пересылки. строка (обязательно)
forwardingRuleState Состояние правила пересылки. 'Disabled'
"Включено"
metadata Метаданные, присоединенные к правилу пересылки. ПересылкаRulePropertiesMetadata
targetDnsServers DNS-серверы для пересылки DNS-запроса. TargetDnsServer[] (обязательно)

ПеренаправлениеRulePropertiesMetadata

Имя Description Ценность

Целевой сервер DnsServer

Имя Description Ценность
ipAddress IP-адрес DNS-сервера. строка (обязательно)
порт Порт DNS-сервера. инт

Примеры использования

Шаблоны быстрого запуска Azure

Следующие шаблоны быстрого запуска Azure развернуть этот тип ресурса.

Template Description
Частный резолвер DNS Azure

Развертывание в Azure
Этот шаблон подготавливает частный сопоставитель Azure DNS в виртуальной сети с необходимым набором правил пересылки и правилами. Он создает виртуальную сеть с двумя подсетями и развертывает частный сопоставитель Azure DNS в этой виртуальной сети.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса dnsForwardingRulesets/forwardingRules можно развернуть с помощью операций, предназначенных для следующих операций:

  • Группы ресурсов

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.Network/dnsForwardingRulesets/forwardingRules, добавьте следующий объект Terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/dnsForwardingRulesets/forwardingRules@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      domainName = "string"
      forwardingRuleState = "string"
      metadata = {
        {customized property} = "string"
      }
      targetDnsServers = [
        {
          ipAddress = "string"
          port = int
        }
      ]
    }
  }
}

Значения свойств

Microsoft.Network/dnsForwardingRulesets/forwardingRules

Имя Description Ценность
имя имя ресурса. строка (обязательно)
parent_id Идентификатор ресурса, который является родительским для этого ресурса. Идентификатор ресурса типа: dnsForwardingRulesets
properties Свойства правила пересылки. ПересылкаRuleProperties (обязательно)
type Тип ресурса "Microsoft.Network/dnsForwardingRulesets/forwardingRules@2025-10-01-preview"

ПересылкаRuleProperties

Имя Description Ценность
domainName Доменное имя правила пересылки. строка (обязательно)
forwardingRuleState Состояние правила пересылки. 'Disabled'
"Включено"
metadata Метаданные, присоединенные к правилу пересылки. ПересылкаRulePropertiesMetadata
targetDnsServers DNS-серверы для пересылки DNS-запроса. TargetDnsServer[] (обязательно)

ПеренаправлениеRulePropertiesMetadata

Имя Description Ценность

Целевой сервер DnsServer

Имя Description Ценность
ipAddress IP-адрес DNS-сервера. строка (обязательно)
порт Порт DNS-сервера. инт

Примеры использования

Примеры 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" "forwardingRule" {
  type      = "Microsoft.Network/dnsForwardingRulesets/forwardingRules@2022-07-01"
  parent_id = azapi_resource.dnsForwardingRuleset.id
  name      = var.resource_name
  body = {
    properties = {
      domainName          = "onprem.local."
      forwardingRuleState = "Enabled"
      metadata            = null
      targetDnsServers = [
        {
          ipAddress = "10.10.0.1"
          port      = 53
        },
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}