github.com/jrasell/terraform@v0.6.17-0.20160523115548-2652f5232949/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-compute-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  ```js
    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  * `name` - (Required) A unique name for the resource, required by GCE. Changing
    31      this forces a new resource to be created.
    32  
    33  * `target` - (Required) URL of target pool.
    34  
    35  - - -
    36  
    37  * `description` - (Optional) Textual description field.
    38  
    39  * `ip_address` - (Optional) The static IP. (if not set, an ephemeral IP is
    40      used).
    41  
    42  * `ip_protocol` - (Optional) The IP protocol to route, one of "TCP" "UDP" "AH"
    43      "ESP" or "SCTP". (default "TCP").
    44  
    45  * `port_range` - (Optional) A range e.g. "1024-2048" or a single port "1024"
    46      (defaults to all ports!).
    47  
    48  * `project` - (Optional) The project in which the resource belongs. If it
    49      is not provided, the provider project is used.
    50  
    51  * `region` - (Optional) The Region in which the created address should reside.
    52      If it is not provided, the provider region is used.
    53  
    54  ## Attributes Reference
    55  
    56  In addition to the arguments listed above, the following computed attributes are
    57  exported:
    58  
    59  * `self_link` - The URI of the created resource.