Microsoft.Network virtualNetworkGateways/natRules

• più recenti
• 2025-05-01
• 2025-03-01
• 2025-01-01
• 2024-10-01
• 2024-07-01
• 2024-05-01
• 2024-03-01
• 2024-01-01
• 2023-11-01
• 2023-09-01
• 2023-06-01
• 2023-05-01
• 2023-04-01
• 2023-02-01
• 2022-11-01
• 2022-09-01
• 2022-07-01
• 2022-05-01
• 01-01-2022
• 2021-08-01
• 2021-05-01
• 2021-03-01
• 2021-02-01

Definizione di risorsa Bicep

Il tipo di risorsa virtualNetworkGateways/natRules può essere distribuito con operazioni destinate a:

• gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/virtualNetworkGateways/natRules, aggiungere il bicep seguente al modello.

resource symbolicname 'Microsoft.Network/virtualNetworkGateways/natRules@2025-05-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    externalMappings: [
      {
        addressSpace: 'string'
        portRange: 'string'
      }
    ]
    internalMappings: [
      {
        addressSpace: 'string'
        portRange: 'string'
      }
    ]
    ipConfigurationId: 'string'
    mode: 'string'
    type: 'string'
  }
}

Valori delle proprietà

Microsoft.Network/virtualNetworkGateways/natRules

Nome	Descrizione	Valore
nome	Nome della risorsa	stringa (obbligatorio)
genitore	In Bicep è possibile specificare la risorsa padre per una risorsa figlio. È necessario aggiungere questa proprietà solo quando la risorsa figlio viene dichiarata all'esterno della risorsa padre. Per altre informazioni, vedere risorsa figlio all'esterno della risorsa padre.	Nome simbolico per la risorsa di tipo: virtualNetworkGateways
proprietà	Proprietà della regola NAT del gateway di rete virtuale.	Proprietà VirtualNetworkGatewayNatRuleProperties

Proprietà VirtualNetworkGatewayNatRuleProperties

Nome	Descrizione	Valore
externalMappings	Mapping esterno dell'indirizzo IP privato per NAT.	VpnNatRuleMapping[]
Mappature interne	Mapping interno dell'indirizzo IP privato per NAT.	VpnNatRuleMapping[]
ipConfigurationId	ID di configurazione IP a cui si applica questa regola NAT.	corda
modo	Direzione NAT di origine di un NAT VPN.	'EgressSnat' 'IngressSnat'
digitare	Tipo di regola NAT per NAT VPN.	'Dinamico' 'Statico'

VpnNatRuleMapping

Nome	Descrizione	Valore
Spazio degli indirizzi	Spazio indirizzi per il mapping NatRule vpn.	corda
portRange	Intervallo di porte per il mapping NatRule vpn.	corda

Esempi di utilizzo

Esempi bicep

Esempio di base di distribuzione della regola Nat del gateway di rete virtuale.

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

resource publicIPAddress 'Microsoft.Network/publicIPAddresses@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    ddosSettings: {
      protectionMode: 'VirtualNetworkInherited'
    }
    idleTimeoutInMinutes: 4
    publicIPAddressVersion: 'IPv4'
    publicIPAllocationMethod: 'Dynamic'
  }
  sku: {
    name: 'Basic'
    tier: 'Regional'
  }
}

resource virtualNetwork 'Microsoft.Network/virtualNetworks@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    addressSpace: {
      addressPrefixes: [
        '10.0.0.0/16'
      ]
    }
    dhcpOptions: {
      dnsServers: []
    }
    subnets: []
  }
}

resource virtualNetworkGateway 'Microsoft.Network/virtualNetworkGateways@2022-07-01' = {
  name: resourceName
  location: location
  properties: {
    activeActive: false
    enableBgp: false
    enablePrivateIpAddress: false
    gatewayType: 'Vpn'
    ipConfigurations: [
      {
        name: 'vnetGatewayConfig'
        properties: {
          privateIPAllocationMethod: 'Dynamic'
          publicIPAddress: {
            id: publicIPAddress.id
          }
          subnet: {
            id: subnet.id
          }
        }
      }
    ]
    sku: {
      name: 'Basic'
      tier: 'Basic'
    }
    vpnType: 'RouteBased'
  }
}

resource natRule 'Microsoft.Network/virtualNetworkGateways/natRules@2022-07-01' = {
  parent: virtualNetworkGateway
  name: resourceName
  properties: {
    externalMappings: [
      {
        addressSpace: '10.1.0.0/26'
      }
    ]
    internalMappings: [
      {
        addressSpace: '10.3.0.0/26'
      }
    ]
    mode: 'EgressSnat'
    type: 'Static'
  }
}

resource subnet 'Microsoft.Network/virtualNetworks/subnets@2022-07-01' = {
  parent: virtualNetwork
  name: 'GatewaySubnet'
  properties: {
    addressPrefix: '10.0.1.0/24'
    delegations: []
    privateEndpointNetworkPolicies: 'Enabled'
    privateLinkServiceNetworkPolicies: 'Enabled'
    serviceEndpointPolicies: []
    serviceEndpoints: []
  }
}

Definizione di risorsa del modello di Resource Manager

Il tipo di risorsa virtualNetworkGateways/natRules può essere distribuito con operazioni destinate a:

• gruppi di risorse - Vedere i comandi di distribuzione del gruppo di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/virtualNetworkGateways/natRules, aggiungere il codice JSON seguente al modello.

{
  "type": "Microsoft.Network/virtualNetworkGateways/natRules",
  "apiVersion": "2025-05-01",
  "name": "string",
  "properties": {
    "externalMappings": [
      {
        "addressSpace": "string",
        "portRange": "string"
      }
    ],
    "internalMappings": [
      {
        "addressSpace": "string",
        "portRange": "string"
      }
    ],
    "ipConfigurationId": "string",
    "mode": "string",
    "type": "string"
  }
}

Valori delle proprietà

Microsoft.Network/virtualNetworkGateways/natRules

Nome	Descrizione	Valore
versione dell'API	Versione dell'API	'2025-05-01'
nome	Nome della risorsa	stringa (obbligatorio)
proprietà	Proprietà della regola NAT del gateway di rete virtuale.	Proprietà VirtualNetworkGatewayNatRuleProperties
digitare	Tipo di risorsa	'Microsoft.Network/virtualNetworkGateways/natRules'

Proprietà VirtualNetworkGatewayNatRuleProperties

Nome	Descrizione	Valore
externalMappings	Mapping esterno dell'indirizzo IP privato per NAT.	VpnNatRuleMapping[]
Mappature interne	Mapping interno dell'indirizzo IP privato per NAT.	VpnNatRuleMapping[]
ipConfigurationId	ID di configurazione IP a cui si applica questa regola NAT.	corda
modo	Direzione NAT di origine di un NAT VPN.	'EgressSnat' 'IngressSnat'
digitare	Tipo di regola NAT per NAT VPN.	'Dinamico' 'Statico'

VpnNatRuleMapping

Nome	Descrizione	Valore
Spazio degli indirizzi	Spazio indirizzi per il mapping NatRule vpn.	corda
portRange	Intervallo di porte per il mapping NatRule vpn.	corda

Esempi di utilizzo

Definizione di risorsa Terraform (provider AzAPI)

Il tipo di risorsa virtualNetworkGateways/natRules può essere distribuito con operazioni destinate a:

• Gruppi di risorse

Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.

Formato risorsa

Per creare una risorsa Microsoft.Network/virtualNetworkGateways/natRules, aggiungere il formato Terraform seguente al modello.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/virtualNetworkGateways/natRules@2025-05-01"
  name = "string"
  parent_id = "string"
  body = {
    properties = {
      externalMappings = [
        {
          addressSpace = "string"
          portRange = "string"
        }
      ]
      internalMappings = [
        {
          addressSpace = "string"
          portRange = "string"
        }
      ]
      ipConfigurationId = "string"
      mode = "string"
      type = "string"
    }
  }
}

Valori delle proprietà

Microsoft.Network/virtualNetworkGateways/natRules

Nome	Descrizione	Valore
nome	Nome della risorsa	stringa (obbligatorio)
parent_id	ID della risorsa padre per questa risorsa.	ID per la risorsa di tipo: virtualNetworkGateways
proprietà	Proprietà della regola NAT del gateway di rete virtuale.	Proprietà VirtualNetworkGatewayNatRuleProperties
digitare	Tipo di risorsa	"Microsoft.Network/virtualNetworkGateways/natRules@2025-05-01"

Proprietà VirtualNetworkGatewayNatRuleProperties

Nome	Descrizione	Valore
externalMappings	Mapping esterno dell'indirizzo IP privato per NAT.	VpnNatRuleMapping[]
Mappature interne	Mapping interno dell'indirizzo IP privato per NAT.	VpnNatRuleMapping[]
ipConfigurationId	ID di configurazione IP a cui si applica questa regola NAT.	corda
modo	Direzione NAT di origine di un NAT VPN.	'EgressSnat' 'IngressSnat'
digitare	Tipo di regola NAT per NAT VPN.	'Dinamico' 'Statico'

VpnNatRuleMapping

Nome	Descrizione	Valore
Spazio degli indirizzi	Spazio indirizzi per il mapping NatRule vpn.	corda
portRange	Intervallo di porte per il mapping NatRule vpn.	corda

Esempi di utilizzo

Esempi di Terraform

Esempio di base di distribuzione della regola Nat del gateway di rete virtuale.

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" "publicIPAddress" {
  type      = "Microsoft.Network/publicIPAddresses@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      ddosSettings = {
        protectionMode = "VirtualNetworkInherited"
      }
      idleTimeoutInMinutes     = 4
      publicIPAddressVersion   = "IPv4"
      publicIPAllocationMethod = "Dynamic"
    }
    sku = {
      name = "Basic"
      tier = "Regional"
    }
  }
  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      = "GatewaySubnet"
  body = {
    properties = {
      addressPrefix = "10.0.1.0/24"
      delegations = [
      ]
      privateEndpointNetworkPolicies    = "Enabled"
      privateLinkServiceNetworkPolicies = "Enabled"
      serviceEndpointPolicies = [
      ]
      serviceEndpoints = [
      ]
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}

resource "azapi_resource" "virtualNetworkGateway" {
  type      = "Microsoft.Network/virtualNetworkGateways@2022-07-01"
  parent_id = azapi_resource.resourceGroup.id
  name      = var.resource_name
  location  = var.location
  body = {
    properties = {
      activeActive           = false
      enableBgp              = false
      enablePrivateIpAddress = false
      gatewayType            = "Vpn"
      ipConfigurations = [
        {
          name = "vnetGatewayConfig"
          properties = {
            privateIPAllocationMethod = "Dynamic"
            publicIPAddress = {
              id = azapi_resource.publicIPAddress.id
            }
            subnet = {
              id = azapi_resource.subnet.id
            }
          }
        },
      ]
      sku = {
        name = "Basic"
        tier = "Basic"
      }
      vpnType = "RouteBased"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
  timeouts {
    create = "180m"
    update = "180m"
    delete = "60m"
  }
}

resource "azapi_resource" "natRule" {
  type      = "Microsoft.Network/virtualNetworkGateways/natRules@2022-07-01"
  parent_id = azapi_resource.virtualNetworkGateway.id
  name      = var.resource_name
  body = {
    properties = {
      externalMappings = [
        {
          addressSpace = "10.1.0.0/26"
        },
      ]
      internalMappings = [
        {
          addressSpace = "10.3.0.0/26"
        },
      ]
      mode = "EgressSnat"
      type = "Static"
    }
  }
  schema_validation_enabled = false
  response_export_values    = ["*"]
}