Microsoft.Network dnsForwardingRulessets

Définition de ressource Bicep

Le type de ressource dnsForwardingRulesets peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Network/dnsForwardingRulesets, ajoutez le bicep suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Network/dnsForwardingRulessets

Nom Descriptif Valeur
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du jeu de règles de transfert DNS. DnsForwardingRulesetProperties (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles

DnsForwardingRulesetProperties

Nom Descriptif Valeur
dnsResolverOutboundEndpoints Référence aux points de terminaison sortants du programme de résolution DNS utilisés pour router les requêtes DNS correspondant aux règles de transfert du jeu de règles aux serveurs DNS cibles. SubResource[] (obligatoire)

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource. chaîne (obligatoire)

TrackedResourceTags

Nom Descriptif Valeur

Exemples d’utilisation

Exemples Bicep

Exemple de base de déploiement de l’ensemble de règles de transfert DNS DNS privé.

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

Modules vérifiés Azure

Les modules vérifiés Azure suivants peuvent être utilisés pour déployer ce type de ressource.

Module Descriptif
ensemble de règles de transfert DNS Module de ressources AVM pour l’ensemble de règles de transfert DNS

Exemples de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants contiennent des exemples Bicep pour le déploiement de ce type de ressource.

Fichier Bicep Descriptif
du programme de résolution privé Azure DNS Ce modèle provisionne azure DNS Private Resolver dans un réseau virtuel avec un ensemble de règles de transfert et des règles requis. Il crée un réseau virtuel avec deux sous-réseaux et déploie azure DNS Private Resolver dans ce réseau virtuel.

Définition de ressource de modèle ARM

Le type de ressource dnsForwardingRulesets peut être déployé avec des opérations qui ciblent :

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Network/dnsForwardingRulesets, ajoutez le code JSON suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Network/dnsForwardingRulessets

Nom Descriptif Valeur
apiVersion Version de l’API '2025-10-01-preview'
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du jeu de règles de transfert DNS. DnsForwardingRulesetProperties (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes. Consultez les balises dans les modèles
type Type de ressource 'Microsoft.Network/dnsForwardingRulessets'

DnsForwardingRulesetProperties

Nom Descriptif Valeur
dnsResolverOutboundEndpoints Référence aux points de terminaison sortants du programme de résolution DNS utilisés pour router les requêtes DNS correspondant aux règles de transfert du jeu de règles aux serveurs DNS cibles. SubResource[] (obligatoire)

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource. chaîne (obligatoire)

TrackedResourceTags

Nom Descriptif Valeur

Exemples d’utilisation

Modèles de démarrage rapide Azure

Les modèles de démarrage rapide Azure suivants déployer ce type de ressource.

Modèle Descriptif
du programme de résolution privé Azure DNS

Déployer sur Azure
Ce modèle provisionne azure DNS Private Resolver dans un réseau virtuel avec un ensemble de règles de transfert et des règles requis. Il crée un réseau virtuel avec deux sous-réseaux et déploie azure DNS Private Resolver dans ce réseau virtuel.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource dnsForwardingRulesets peut être déployé avec des opérations qui ciblent :

  • Groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Network/dnsForwardingRulesets, ajoutez le terraform suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Network/dnsForwardingRulessets

Nom Descriptif Valeur
emplacement Emplacement géographique où réside la ressource chaîne (obligatoire)
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés du jeu de règles de transfert DNS. DnsForwardingRulesetProperties (obligatoire)
étiquettes Balises de ressource Dictionnaire de noms et de valeurs d’étiquettes.
type Type de ressource « Microsoft.Network/dnsForwardingRulesets@2025-10-01-preview »

DnsForwardingRulesetProperties

Nom Descriptif Valeur
dnsResolverOutboundEndpoints Référence aux points de terminaison sortants du programme de résolution DNS utilisés pour router les requêtes DNS correspondant aux règles de transfert du jeu de règles aux serveurs DNS cibles. SubResource[] (obligatoire)

Sous-ressource

Nom Descriptif Valeur
pièce d'identité ID de ressource. chaîne (obligatoire)

TrackedResourceTags

Nom Descriptif Valeur

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement de l’ensemble de règles de transfert DNS DNS privé.

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