Microsoft.Network natGateways 2019-06-01

Choose a deployment language

Bicep ARM template Terraform

Bicep resource definition

The natGateways resource type can be deployed with operations that target:

• Resource groups - See resource group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/natGateways resource, add the following Bicep to your template.

Bicep

resource symbolicname 'Microsoft.Network/natGateways@2019-06-01' = {
  etag: 'string'
  location: 'string'
  name: 'string'
  properties: {
    idleTimeoutInMinutes: int
    provisioningState: 'string'
    publicIpAddresses: [
      {
        id: 'string'
      }
    ]
    publicIpPrefixes: [
      {
        id: 'string'
      }
    ]
    resourceGuid: 'string'
  }
  sku: {
    name: 'string'
  }
  tags: {
    {customized property}: 'string'
  }
  zones: [
    'string'
  ]
}

Property Values

Microsoft.Network/natGateways

Name	Description	Value
etag	A unique read-only string that changes whenever the resource is updated.	string
location	Resource location.	string
name	The resource name	string (required)
properties	Nat Gateway properties.	NatGatewayPropertiesFormat
sku	The nat gateway SKU.	NatGatewaySku
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
zones	A list of availability zones denoting the zone in which Nat Gateway should be deployed.	string[]

NatGatewayPropertiesFormat

Name	Description	Value
idleTimeoutInMinutes	The idle timeout of the nat gateway.	int
provisioningState	The provisioning state of the NatGateway resource. Possible values are: 'Updating', 'Deleting', and 'Failed'.	string
publicIpAddresses	An array of public ip addresses associated with the nat gateway resource.	SubResource[]
publicIpPrefixes	An array of public ip prefixes associated with the nat gateway resource.	SubResource[]
resourceGuid	The resource GUID property of the nat gateway resource.	string

NatGatewaySku

Name	Description	Value
name	Name of Nat Gateway SKU.	'Standard'

ResourceTags

Name	Description	Value

SubResource

Name	Description	Value
id	Resource ID.	string

Usage Examples

Azure Verified Modules

The following Azure Verified Modules can be used to deploy this resource type.

Module	Description
NAT Gateway	AVM Resource Module for NAT Gateway

Azure Quickstart Samples

The following Azure Quickstart templates contain Bicep samples for deploying this resource type.

Bicep File	Description
AKS Cluster with a NAT Gateway and an Application Gateway	This sample shows how to a deploy an AKS cluster with NAT Gateway for outbound connections and an Application Gateway for inbound connections.
Azure Databricks All-in-one Template for VNet Injection	This template allows you to create a network security group, a virtual network, a NAT gateway and an Azure Databricks workspace with the virtual network.
AzureDatabricks Template for VNet Injection with NAT Gateway	This template allows you to create a NAT gateway, network security group, a virtual network and an Azure Databricks workspace with the virtual network.
AzureDatabricks Virtual Network - VNet Injection NAT Gateway	This template allows you to create a Virtual Network for Azure Databricks VNet injection with natgateway.
Create a cross-region load balancer	This template creates a cross-region load balancer with a backend pool containing two regional load balancers. Cross-region load balancer is currently available in limited regions. The regional load balancers behind the cross-region load balancer can be in any region.
Create a standard internal load balancer	This template creates a standard internal Azure Load Balancer with a rule load-balancing port 80
Create a standard load-balancer	This template creates an Internet-facing load-balancer, load balancing rules, and three VMs for the backend pool with each VM in a redundant zone.
Deploy Secure Azure AI Studio with a managed virtual network	This template creates a secure Azure AI Studio environment with robust network and identity security restrictions.
Virtual Network NAT	Deploy a NAT gateway and virtual network
Virtual Network NAT with VM	Deploy a NAT gateway and virtual machine

ARM template resource definition

The natGateways resource type can be deployed with operations that target:

• Resource groups - See resource group deployment commands

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/natGateways resource, add the following JSON to your template.

JSON

{
  "type": "Microsoft.Network/natGateways",
  "apiVersion": "2019-06-01",
  "name": "string",
  "etag": "string",
  "location": "string",
  "properties": {
    "idleTimeoutInMinutes": "int",
    "provisioningState": "string",
    "publicIpAddresses": [
      {
        "id": "string"
      }
    ],
    "publicIpPrefixes": [
      {
        "id": "string"
      }
    ],
    "resourceGuid": "string"
  },
  "sku": {
    "name": "string"
  },
  "tags": {
    "{customized property}": "string"
  },
  "zones": [ "string" ]
}

Property Values

Microsoft.Network/natGateways

Name	Description	Value
apiVersion	The api version	'2019-06-01'
etag	A unique read-only string that changes whenever the resource is updated.	string
location	Resource location.	string
name	The resource name	string (required)
properties	Nat Gateway properties.	NatGatewayPropertiesFormat
sku	The nat gateway SKU.	NatGatewaySku
tags	Resource tags	Dictionary of tag names and values. See Tags in templates
type	The resource type	'Microsoft.Network/natGateways'
zones	A list of availability zones denoting the zone in which Nat Gateway should be deployed.	string[]

NatGatewayPropertiesFormat

Name	Description	Value
idleTimeoutInMinutes	The idle timeout of the nat gateway.	int
provisioningState	The provisioning state of the NatGateway resource. Possible values are: 'Updating', 'Deleting', and 'Failed'.	string
publicIpAddresses	An array of public ip addresses associated with the nat gateway resource.	SubResource[]
publicIpPrefixes	An array of public ip prefixes associated with the nat gateway resource.	SubResource[]
resourceGuid	The resource GUID property of the nat gateway resource.	string

NatGatewaySku

Name	Description	Value
name	Name of Nat Gateway SKU.	'Standard'

ResourceTags

Name	Description	Value

SubResource

Name	Description	Value
id	Resource ID.	string

Usage Examples

Azure Quickstart Templates

The following Azure Quickstart templates deploy this resource type.

Template	Description
AKS Cluster with a NAT Gateway and an Application Gateway	This sample shows how to a deploy an AKS cluster with NAT Gateway for outbound connections and an Application Gateway for inbound connections.
Azure Databricks All-in-one Template for VNet Injection	This template allows you to create a network security group, a virtual network, a NAT gateway and an Azure Databricks workspace with the virtual network.
AzureDatabricks Template for VNet Injection with NAT Gateway	This template allows you to create a NAT gateway, network security group, a virtual network and an Azure Databricks workspace with the virtual network.
AzureDatabricks Virtual Network - VNet Injection NAT Gateway	This template allows you to create a Virtual Network for Azure Databricks VNet injection with natgateway.
Create a cross-region load balancer	This template creates a cross-region load balancer with a backend pool containing two regional load balancers. Cross-region load balancer is currently available in limited regions. The regional load balancers behind the cross-region load balancer can be in any region.
Create a standard internal load balancer	This template creates a standard internal Azure Load Balancer with a rule load-balancing port 80
Create a standard load-balancer	This template creates an Internet-facing load-balancer, load balancing rules, and three VMs for the backend pool with each VM in a redundant zone.
Deploy Darktrace Autoscaling vSensors	This template allows you to deploy an automatically autoscaling deployment of Darktrace vSensors
Deploy Secure Azure AI Studio with a managed virtual network	This template creates a secure Azure AI Studio environment with robust network and identity security restrictions.
Virtual Network NAT	Deploy a NAT gateway and virtual network
Virtual Network NAT with VM	Deploy a NAT gateway and virtual machine

Terraform (AzAPI provider) resource definition

The natGateways resource type can be deployed with operations that target:

• Resource groups

For a list of changed properties in each API version, see change log.

Resource format

To create a Microsoft.Network/natGateways resource, add the following Terraform to your template.

Terraform

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Network/natGateways@2019-06-01"
  name = "string"
  etag = "string"
  location = "string"
  sku = {
    name = "string"
  }
  tags = {
    {customized property} = "string"
  }
  zones = [
    "string"
  ]
  body = jsonencode({
    properties = {
      idleTimeoutInMinutes = int
      provisioningState = "string"
      publicIpAddresses = [
        {
          id = "string"
        }
      ]
      publicIpPrefixes = [
        {
          id = "string"
        }
      ]
      resourceGuid = "string"
    }
  })
}

Property Values

Microsoft.Network/natGateways

Name	Description	Value
etag	A unique read-only string that changes whenever the resource is updated.	string
location	Resource location.	string
name	The resource name	string (required)
properties	Nat Gateway properties.	NatGatewayPropertiesFormat
sku	The nat gateway SKU.	NatGatewaySku
tags	Resource tags	Dictionary of tag names and values.
type	The resource type	"Microsoft.Network/natGateways@2019-06-01"
zones	A list of availability zones denoting the zone in which Nat Gateway should be deployed.	string[]

NatGatewayPropertiesFormat

Name	Description	Value
idleTimeoutInMinutes	The idle timeout of the nat gateway.	int
provisioningState	The provisioning state of the NatGateway resource. Possible values are: 'Updating', 'Deleting', and 'Failed'.	string
publicIpAddresses	An array of public ip addresses associated with the nat gateway resource.	SubResource[]
publicIpPrefixes	An array of public ip prefixes associated with the nat gateway resource.	SubResource[]
resourceGuid	The resource GUID property of the nat gateway resource.	string

NatGatewaySku

Name	Description	Value
name	Name of Nat Gateway SKU.	'Standard'

ResourceTags

Name	Description	Value

SubResource

Name	Description	Value
id	Resource ID.	string

Usage Examples

Azure Verified Modules

The following Azure Verified Modules can be used to deploy this resource type.

Module	Description
NAT Gateway	AVM Resource Module for NAT Gateway