terraform-provider-google/r/compute_forwarding_rule.html.markdown

layout	page_title	sidebar_current	description
google	Google: google_compute_forwarding_rule	docs-google-compute-forwarding-rule	Manages a Target Pool within GCE.

google_compute_forwarding_rule

Manages a Forwarding Rule within GCE. This binds an ip and port range to a target pool. For more information see the official documentation and API.

Example Usage

resource "google_compute_forwarding_rule" "default" {
  name       = "test"
  target     = "${google_compute_target_pool.default.self_link}"
  port_range = "80"
}

Argument Reference

The following arguments are supported:

• name - (Required) A unique name for the resource, required by GCE. Changing this forces a new resource to be created.

---

• backend_service - (Optional) BackendService resource to receive the matched traffic. Only used for internal load balancing.

• description - (Optional) Textual description field.

• ip_address - (Optional) The static IP. (if not set, an ephemeral IP is used).

• ip_protocol - (Optional) The IP protocol to route, one of "TCP" "UDP" "AH" "ESP" or "SCTP" for external load balancing, "TCP" or "UDP" for internal (default "TCP").

• load_balancing_scheme - (Optional) Type of load balancing to use. Can be set to "INTERNAL" or "EXTERNAL" (default "EXTERNAL").

• network - (Optional) Network that the load balanced IP should belong to. Only used for internal load balancing. If it is not provided, the default network is used.

• port_range - (Optional) A range e.g. "1024-2048" or a single port "1024" (defaults to all ports!). Only used for external load balancing.

• ports - (Optional) A list of ports to use for internal load balancing (defaults to all ports).

• project - (Optional) The project in which the resource belongs. If it is not provided, the provider project is used.

• region - (Optional) The Region in which the created address should reside. If it is not provided, the provider region is used.

• subnetwork - (Optional) Subnetwork that the load balanced IP should belong to. Only used for internal load balancing. Must be specified if the network is in custom subnet mode.

• target - (Optional) URL of target pool. Required for external load balancing.

Attributes Reference

In addition to the arguments listed above, the following computed attributes are exported:

• self_link - The URI of the created resource.