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       = "website-forwarding-rule"
  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 name or self_link that the load balanced IP should belong to. Only used for internal load balancing. If it is not provided, the default network is used.

• network_tier - (Optional) The networking tier used for configuring this forwarding rule. This field can take the following values: PREMIUM or STANDARD. If this field is not specified, it is assumed to be PREMIUM.

• port_range - (Optional) A range e.g. "1024-2048" or a single port "1024" (defaults to all ports!). Only used for external load balancing. Some types of forwarding targets have constraints on the acceptable ports:

  • Target HTTP proxy: 80, 8080
  • Target HTTPS proxy: 443
  • Target TCP proxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1883, 5222
  • Target SSL proxy: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1883, 5222
  • Target VPN gateway: 500, 4500

• ports - (Optional) A list of ports (maximum of 5) to use for internal load balancing. Packets addressed to these ports will be forwarded to the backends configured with this forwarding rule. Required for internal load balancing.

• project - (Optional) The ID of 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.

Import

Forwarding rules can be imported using the name, e.g.

$ terraform import google_compute_forwarding_rule.default website-forwarding-rule