github.com/nathanielks/terraform@v0.6.1-0.20170509030759-13e1a62319dc/website/source/docs/providers/azurerm/r/loadbalancer_nat_pool.html.markdown (about)

     1  ---
     2  layout: "azurerm"
     3  page_title: "Azure Resource Manager: azurerm_lb_nat_pool"
     4  sidebar_current: "docs-azurerm-resource-loadbalancer-nat-pool"
     5  description: |-
     6    Create a LoadBalancer NAT Pool.
     7  ---
     8  
     9  # azurerm\_lb\_nat\_pool
    10  
    11  Create a LoadBalancer NAT pool.
    12  
    13  ~> **NOTE When using this resource, the LoadBalancer needs to have a FrontEnd IP Configuration Attached
    14  
    15  ## Example Usage
    16  
    17  ```hcl
    18  resource "azurerm_resource_group" "test" {
    19    name     = "LoadBalancerRG"
    20    location = "West US"
    21  }
    22  
    23  resource "azurerm_public_ip" "test" {
    24    name                         = "PublicIPForLB"
    25    location                     = "West US"
    26    resource_group_name          = "${azurerm_resource_group.test.name}"
    27    public_ip_address_allocation = "static"
    28  }
    29  
    30  resource "azurerm_lb" "test" {
    31    name                = "TestLoadBalancer"
    32    location            = "West US"
    33    resource_group_name = "${azurerm_resource_group.test.name}"
    34  
    35    frontend_ip_configuration {
    36      name                 = "PublicIPAddress"
    37      public_ip_address_id = "${azurerm_public_ip.test.id}"
    38    }
    39  }
    40  
    41  resource "azurerm_lb_nat_pool" "test" {
    42    resource_group_name            = "${azurerm_resource_group.test.name}"
    43    loadbalancer_id                = "${azurerm_lb.test.id}"
    44    name                           = "SampleApplication Pool"
    45    protocol                       = "Tcp"
    46    frontend_port_start            = 80
    47    frontend_port_end              = 81
    48    backend_port                   = 8080
    49    frontend_ip_configuration_name = "PublicIPAddress"
    50  }
    51  ```
    52  
    53  ## Argument Reference
    54  
    55  The following arguments are supported:
    56  
    57  * `name` - (Required) Specifies the name of the NAT pool.
    58  * `resource_group_name` - (Required) The name of the resource group in which to create the resource.
    59  * `loadbalancer_id` - (Required) The ID of the LoadBalancer in which to create the NAT pool.
    60  * `frontend_ip_configuration_name` - (Required) The name of the frontend IP configuration exposing this rule.
    61  * `protocol` - (Required) The transport protocol for the external endpoint. Possible values are `Udp` or `Tcp`.
    62  * `frontend_port_start` - (Required) The first port number in the range of external ports that will be used to provide Inbound Nat to NICs associated with this Load Balancer. Possible values range between 1 and 65534, inclusive.
    63  * `frontend_port_end` - (Required) The last port number in the range of external ports that will be used to provide Inbound Nat to NICs associated with this Load Balancer. Possible values range between 1 and 65534, inclusive.
    64  * `backend_port` - (Required) The port used for the internal endpoint. Possible values range between 1 and 65535, inclusive.
    65  
    66  ## Attributes Reference
    67  
    68  The following attributes are exported:
    69  
    70  * `id` - The ID of the LoadBalancer to which the resource is attached.
    71  
    72  ## Import
    73  
    74  Load Balancer NAT Pools can be imported using the `resource id`, e.g.
    75  
    76  ```
    77  terraform import azurerm_lb_nat_pool.test /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/group1/providers/Microsoft.Network/loadBalancers/lb1/inboundNatPools/pool1
    78  ```