Udostępnij przez


Microsoft.Network dnsForwardingRulesets

Definicja zasobu Bicep

Typ zasobu dnsForwardingRulesets można wdrożyć przy użyciu operacji docelowych:

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, dodaj następujący kod Bicep do szablonu.

resource symbolicname 'Microsoft.Network/dnsForwardingRulesets@2025-10-01-preview' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    dnsResolverOutboundEndpoints: [
      {
        id: 'string'
      }
    ]
  }
  tags: {
    {customized property}: 'string'
  }
}

Wartości właściwości

Microsoft.Network/dnsForwardingRulesets

Nazwa Opis Wartość
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości zestawu reguł przesyłania dalej DNS. DnsForwardingRulesetProperties (wymagane)
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia.
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach

DnsForwardingRulesetProperties

Nazwa Opis Wartość
dnsResolverOutboundEndpoints (Punkty końcowe dnsResolverOutboundEndpoints) Odwołanie do wychodzących punktów końcowych rozpoznawania nazw DNS, które są używane do kierowania zapytań DNS pasujących do reguł przekazywania w zestawie reguł do docelowych serwerów DNS. subResource [] (wymagane)

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu. ciąg (wymagany)

Śledzone tagi zasobów

Nazwa Opis Wartość

Przykłady użycia

Moduły zweryfikowane na platformie Azure

Następujące moduły zweryfikowane platformy Azure mogą służyć do wdrażania tego typu zasobu.

Moduł Opis
zestawu reguł przekazywania DNS Moduł zasobów AVM dla zestawu reguł przesyłania dalej DNS

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 można wdrożyć przy użyciu operacji docelowych:

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, dodaj następujący kod JSON do szablonu.

{
  "type": "Microsoft.Network/dnsForwardingRulesets",
  "apiVersion": "2025-10-01-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "dnsResolverOutboundEndpoints": [
      {
        "id": "string"
      }
    ]
  },
  "tags": {
    "{customized property}": "string"
  }
}

Wartości właściwości

Microsoft.Network/dnsForwardingRulesets

Nazwa Opis Wartość
apiVersion (wersja interfejsu api) Wersja interfejsu API "2025-10-01-podgląd"
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości zestawu reguł przesyłania dalej DNS. DnsForwardingRulesetProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości. Zobacz tagi w szablonach
typ Typ zasobu "Microsoft.Network/dnsForwardingRulesets"

DnsForwardingRulesetProperties

Nazwa Opis Wartość
dnsResolverOutboundEndpoints (Punkty końcowe dnsResolverOutboundEndpoints) Odwołanie do wychodzących punktów końcowych rozpoznawania nazw DNS, które są używane do kierowania zapytań DNS pasujących do reguł przekazywania w zestawie reguł do docelowych serwerów DNS. subResource [] (wymagane)

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu. ciąg (wymagany)

Śledzone tagi zasobów

Nazwa Opis Wartość

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 można wdrożyć przy użyciu operacji docelowych:

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, dodaj następujący program Terraform do szablonu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/dnsForwardingRulesets@2025-10-01-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  tags = {
    {customized property} = "string"
  }
  body = {
    properties = {
      dnsResolverOutboundEndpoints = [
        {
          id = "string"
        }
      ]
    }
  }
}

Wartości właściwości

Microsoft.Network/dnsForwardingRulesets

Nazwa Opis Wartość
lokalizacja Lokalizacja geograficzna, w której znajduje się zasób ciąg (wymagany)
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości Właściwości zestawu reguł przesyłania dalej DNS. DnsForwardingRulesetProperties (wymagane)
Tagi Tagi zasobów Słownik nazw tagów i wartości.
typ Typ zasobu "Microsoft.Network/dnsForwardingRulesets@2025-10-01-preview" (Microsoft.Network/-10-01-preview)

DnsForwardingRulesetProperties

Nazwa Opis Wartość
dnsResolverOutboundEndpoints (Punkty końcowe dnsResolverOutboundEndpoints) Odwołanie do wychodzących punktów końcowych rozpoznawania nazw DNS, które są używane do kierowania zapytań DNS pasujących do reguł przekazywania w zestawie reguł do docelowych serwerów DNS. subResource [] (wymagane)

Podźródło

Nazwa Opis Wartość
id Identyfikator zasobu. ciąg (wymagany)

Śledzone tagi zasobów

Nazwa Opis Wartość

Przykłady użycia

Przykłady programu Terraform

Podstawowy przykład wdrożenia zestawu reguł przekazywania DNS Private DNS Resolver.

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    = ["*"]
}