Microsoft.Network dnsForwardingRulessets/forwardingRules 2022-07-01

Définition de ressource Bicep

Le type de ressource dnsForwardingRulesets/forwardingRules 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/forwardingRules, ajoutez le code Bicep suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Network/dnsForwardingRulessets/forwardingRules

Nom Descriptif Valeur
nom Nom de la ressource chaîne (obligatoire)
parent Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente.

Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.		 Nom symbolique de la ressource de type : dnsForwardingRulesets
Propriétés Propriétés de la règle de transfert. ForwardingRuleProperties (obligatoire)

ForwardingRuleProperties

Nom Descriptif Valeur
domainName Nom de domaine de la règle de transfert. chaîne (obligatoire)
forwardingRuleState État de la règle de transfert. 'Désactivé'
'Activé'
métadonnées Métadonnées attachées à la règle de transfert. ForwardingRulePropertiesMetadata
targetDnsServers Serveurs DNS pour transférer la requête DNS vers. TargetDnsServer[] (obligatoire)

ForwardingRulePropertiesMetadata

Nom Descriptif Valeur

TargetDnsServer

Nom Descriptif Valeur
adresse IP Adresse IP du serveur DNS. chaîne (obligatoire)
Port Port du serveur DNS. Int

Exemples d’utilisation

Exemples Bicep

Exemple de base de déploiement de la règle de transfert du résolveur 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 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: []
  }
}

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/forwardingRules 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/forwardingRules, ajoutez le code JSON suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Network/dnsForwardingRulessets/forwardingRules

Nom Descriptif Valeur
apiVersion Version de l’API '2022-07-01'
nom Nom de la ressource chaîne (obligatoire)
Propriétés Propriétés de la règle de transfert. ForwardingRuleProperties (obligatoire)
type Type de ressource 'Microsoft.Network/dnsForwardingRulessets/forwardingRules'

ForwardingRuleProperties

Nom Descriptif Valeur
domainName Nom de domaine de la règle de transfert. chaîne (obligatoire)
forwardingRuleState État de la règle de transfert. 'Désactivé'
'Activé'
métadonnées Métadonnées attachées à la règle de transfert. ForwardingRulePropertiesMetadata
targetDnsServers Serveurs DNS pour transférer la requête DNS vers. TargetDnsServer[] (obligatoire)

ForwardingRulePropertiesMetadata

Nom Descriptif Valeur

TargetDnsServer

Nom Descriptif Valeur
adresse IP Adresse IP du serveur DNS. chaîne (obligatoire)
Port Port du serveur DNS. Int

Exemples d’utilisation

Modèles de démarrage rapide Microsoft 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/forwardingRules 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/forwardingRules, ajoutez le terraform suivant à votre modèle.

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

Valeurs de propriété

Microsoft.Network/dnsForwardingRulessets/forwardingRules

Nom Descriptif Valeur
nom Nom de la ressource chaîne (obligatoire)
parent_id ID de la ressource qui est le parent de cette ressource. ID de ressource de type : dnsForwardingRulesets
Propriétés Propriétés de la règle de transfert. ForwardingRuleProperties (obligatoire)
type Type de ressource « Microsoft.Network/dnsForwardingRulesets/forwardingRules@2022-07-01 »

ForwardingRuleProperties

Nom Descriptif Valeur
domainName Nom de domaine de la règle de transfert. chaîne (obligatoire)
forwardingRuleState État de la règle de transfert. 'Désactivé'
'Activé'
métadonnées Métadonnées attachées à la règle de transfert. ForwardingRulePropertiesMetadata
targetDnsServers Serveurs DNS pour transférer la requête DNS vers. TargetDnsServer[] (obligatoire)

ForwardingRulePropertiesMetadata

Nom Descriptif Valeur

TargetDnsServer

Nom Descriptif Valeur
adresse IP Adresse IP du serveur DNS. chaîne (obligatoire)
Port Port du serveur DNS. Int

Exemples d’utilisation

Échantillons Terraform

Exemple de base de déploiement de la règle de transfert du résolveur 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    = ["*"]
}

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    = ["*"]
}
  • Last updated on