github.com/armen/terraform@v0.5.2-0.20150529052519-caa8117a08f1/website/source/docs/providers/google/r/compute_forwarding_rule.html.markdown (about)

     1  ---
     2  layout: "google"
     3  page_title: "Google: google_compute_forwarding_rule"
     4  sidebar_current: "docs-google-resource-forwarding_rule"
     5  description: |-
     6    Manages a Target Pool within GCE.
     7  ---
     8  
     9  # google\_compute\_forwarding\_rule
    10  
    11  Manages a Forwarding Rule within GCE.  This binds an ip and port range to a target pool.  For more
    12  information see [the official
    13  documentation](https://cloud.google.com/compute/docs/load-balancing/network/forwarding-rules) and
    14  [API](https://cloud.google.com/compute/docs/reference/latest/forwardingRules).
    15  
    16  ## Example Usage
    17  
    18  ```
    19  resource "google_compute_forwarding_rule" "default" {
    20  	name = "test"
    21  	target = "${google_compute_target_pool.default.self_link}"
    22  	port_range = "80"
    23  }
    24  ```
    25  
    26  ## Argument Reference
    27  
    28  The following arguments are supported:
    29  
    30  * `description` - (Optional) Textual description field.
    31  
    32  * `ip_address` - (Optional) The static IP. (if not set, an ephemeral IP is
    33  used).
    34  
    35  * `ip_protocol` - (Optional) The IP protocol to route, one of "TCP" "UDP" "AH" "ESP" or "SCTP". (default "TCP").
    36  
    37  * `name` - (Required) A unique name for the resource, required by GCE.  Changing
    38    this forces a new resource to be created.
    39  
    40  * `port_range` - (Optional) A range e.g. "1024-2048" or a single port "1024"
    41  (defaults to all ports!).
    42  
    43  * `target` - URL of target pool.
    44  
    45  ## Attributes Reference
    46  
    47  The following attributes are exported:
    48  
    49  * `self_link` - The URL of the created resource.
    50  
    51  * `ip_address` - The IP address that was chosen (or specified).
    52  
    53