compute_target_tcp_proxy.html.markdown

subcategory	description
Compute Engine	Represents a TargetTcpProxy resource, which is used by one or more global forwarding rule to route incoming TCP requests to a Backend service.

google_compute_target_tcp_proxy

Represents a TargetTcpProxy resource, which is used by one or more global forwarding rule to route incoming TCP requests to a Backend service.

To get more information about TargetTcpProxy, see:

• API documentation
• How-to Guides
  • Setting Up TCP proxy for Google Cloud Load Balancing

## Example Usage - Target Tcp Proxy Basic

resource "google_compute_target_tcp_proxy" "default" {
  name            = "test-proxy"
  backend_service = google_compute_backend_service.default.id
}

resource "google_compute_backend_service" "default" {
  name        = "backend-service"
  protocol    = "TCP"
  timeout_sec = 10

  health_checks = [google_compute_health_check.default.id]
}

resource "google_compute_health_check" "default" {
  name               = "health-check"
  timeout_sec        = 1
  check_interval_sec = 1

  tcp_health_check {
    port = "443"
  }
}

Argument Reference

The following arguments are supported:

• name - (Required) Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression [a-z]([-a-z0-9]*[a-z0-9])? which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.

• backend_service - (Required) A reference to the BackendService resource.

---

• description - (Optional) An optional description of this resource.

• proxy_header - (Optional) Specifies the type of proxy header to append before sending data to the backend. Default value is NONE. Possible values are: NONE, PROXY_V1.

• proxy_bind - (Optional) This field only applies when the forwarding rule that references this target proxy has a loadBalancingScheme set to INTERNAL_SELF_MANAGED.

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

Attributes Reference

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

• id - an identifier for the resource with format projects/{{project}}/global/targetTcpProxies/{{name}}

• creation_timestamp - Creation timestamp in RFC3339 text format.

• proxy_id - The unique identifier for the resource.

• self_link - The URI of the created resource.

Timeouts

This resource provides the following Timeouts configuration options:

• create - Default is 20 minutes.
• update - Default is 20 minutes.
• delete - Default is 20 minutes.

Import

TargetTcpProxy can be imported using any of these accepted formats:

• projects/{{project}}/global/targetTcpProxies/{{name}}
• {{project}}/{{name}}
• {{name}}

In Terraform v1.5.0 and later, use an import block to import TargetTcpProxy using one of the formats above. For example:

import {
  id = "projects/{{project}}/global/targetTcpProxies/{{name}}"
  to = google_compute_target_tcp_proxy.default
}

When using the terraform import command, TargetTcpProxy can be imported using one of the formats above. For example:

$ terraform import google_compute_target_tcp_proxy.default projects/{{project}}/global/targetTcpProxies/{{name}}
$ terraform import google_compute_target_tcp_proxy.default {{project}}/{{name}}
$ terraform import google_compute_target_tcp_proxy.default {{name}}

User Project Overrides

This resource supports User Project Overrides.