Udostępnij przez


Microsoft.Network dnsForwardingRulesets/forwardingRulesles

Definicja zasobu Bicep

Typ zasobu dnsForwardingRulesets/forwardingRules można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Network/dnsForwardingRulesets/forwardingRules, dodaj następujący kod Bicep do szablonu.

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
      }
    ]
  }
}

Wartości właściwości

Microsoft.Network/dnsForwardingRulesets/forwardingRulesles

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
nadrzędny W Bicep można określić zasób nadrzędny dla zasobu podrzędnego. Tę właściwość należy dodać tylko wtedy, gdy zasób podrzędny jest zadeklarowany poza zasobem nadrzędnym.

Aby uzyskać więcej informacji, zobacz Zasób podrzędny poza zasobem nadrzędnym.
Nazwa symboliczna zasobu typu: dnsForwardingRulesets
Właściwości Właściwości reguły przekazywania. ForwardingRuleProperties (wymagane)

ForwardingRuleProperties

Nazwa Opis Wartość
nazwa_domeny Nazwa domeny dla reguły przekazywania dalej. ciąg (wymagany)
forwardingRuleState Stan reguły przekazywania. "Wyłączone"
"Włączone"
metadane Metadane dołączone do reguły przekazywania. ForwardingRulePropertiesMetadata
targetDnsServers (serwery docelowe) Serwery DNS do przekazywania zapytania DNS do. TargetDnsServer[] (wymagane)

ForwardingRulePropertiesMetadata

Nazwa Opis Wartość

Serwer TargetDnsServer

Nazwa Opis Wartość
adres IP Adres IP serwera DNS. ciąg (wymagany)
port Port serwera DNS. Int

Przykłady użycia

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
prywatnego rozpoznawania nazw DNS platformy Azure Ten szablon aprowizuje usługę Azure DNS Private Resolver w sieci wirtualnej z wymaganym zestawem reguł i regułami przesyłania dalej. Tworzy nową sieć wirtualną z dwiema podsieciami i wdraża w tej sieci wirtualnej usługę Azure DNS Private Resolver.

Definicja zasobu szablonu usługi ARM

Typ zasobu dnsForwardingRulesets/forwardingRules można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Network/dnsForwardingRulesets/forwardingRules, dodaj następujący kod JSON do szablonu.

{
  "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"
      }
    ]
  }
}

Wartości właściwości

Microsoft.Network/dnsForwardingRulesets/forwardingRulesles

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API "2025-10-01-podgląd"
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości reguły przekazywania. ForwardingRuleProperties (wymagane)
typ Typ zasobu "Microsoft.Network/dnsForwardingRulesets/forwardingRulesles"

ForwardingRuleProperties

Nazwa Opis Wartość
nazwa_domeny Nazwa domeny dla reguły przekazywania dalej. ciąg (wymagany)
forwardingRuleState Stan reguły przekazywania. "Wyłączone"
"Włączone"
metadane Metadane dołączone do reguły przekazywania. ForwardingRulePropertiesMetadata
targetDnsServers (serwery docelowe) Serwery DNS do przekazywania zapytania DNS do. TargetDnsServer[] (wymagane)

ForwardingRulePropertiesMetadata

Nazwa Opis Wartość

Serwer TargetDnsServer

Nazwa Opis Wartość
adres IP Adres IP serwera DNS. ciąg (wymagany)
port Port serwera DNS. Int

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
prywatnego rozpoznawania nazw DNS platformy Azure

wdrażanie w usłudze Azure
Ten szablon aprowizuje usługę Azure DNS Private Resolver w sieci wirtualnej z wymaganym zestawem reguł i regułami przesyłania dalej. Tworzy nową sieć wirtualną z dwiema podsieciami i wdraża w tej sieci wirtualnej usługę Azure DNS Private Resolver.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu dnsForwardingRulesets/forwardingRules można wdrożyć z operacjami docelowymi:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.Network/dnsForwardingRulesets/forwardingRules, dodaj następujący program Terraform do szablonu.

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
        }
      ]
    }
  }
}

Wartości właściwości

Microsoft.Network/dnsForwardingRulesets/forwardingRulesles

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
parent_id (identyfikator rodzica) Identyfikator zasobu, który jest elementem nadrzędnym dla tego zasobu. Identyfikator zasobu typu: dnsForwardingRulesets
Właściwości Właściwości reguły przekazywania. ForwardingRuleProperties (wymagane)
typ Typ zasobu "Microsoft.Network/dnsForwardingRulesets/forwardingRules@2025-10-01-preview"

ForwardingRuleProperties

Nazwa Opis Wartość
nazwa_domeny Nazwa domeny dla reguły przekazywania dalej. ciąg (wymagany)
forwardingRuleState Stan reguły przekazywania. "Wyłączone"
"Włączone"
metadane Metadane dołączone do reguły przekazywania. ForwardingRulePropertiesMetadata
targetDnsServers (serwery docelowe) Serwery DNS do przekazywania zapytania DNS do. TargetDnsServer[] (wymagane)

ForwardingRulePropertiesMetadata

Nazwa Opis Wartość

Serwer TargetDnsServer

Nazwa Opis Wartość
adres IP Adres IP serwera DNS. ciąg (wymagany)
port Port serwera DNS. Int

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrożenia reguły przekazywania prywatnego programu rozpoznawania nazw 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    = ["*"]
}