Represents a Target Instance resource. You can use a target
instance to handle traffic for one or more forwarding rules,
which is ideal for forwarding protocol traffic that is managed
by a single source. For example, ESP, AH, TCP, or UDP. For more
information, read Target instances.
str
[Output Only] Creation timestamp in RFC3339 text format.
This field is a member of oneof_ _creation_timestamp.
description
str
An optional description of this resource.
Provide this property when you create the
resource.
This field is a member of oneof_ _description.
id
int
[Output Only] The unique identifier for the resource. This
identifier is defined by the server.
This field is a member of oneof_ _id.
instance
str
A URL to the virtual machine instance that
handles traffic for this target instance. When
creating a target instance, you can provide the
fully-qualified URL or a valid partial URL to
the desired virtual machine. For example, the
following are all valid URLs: -
https://www.googleapis.com/compute/v1/projects/project/zones/zone
/instances/instance -
projects/project/zones/zone/instances/instance -
zones/zone/instances/instance
This field is a member of oneof_ _instance.
kind
str
[Output Only] The type of the resource. Always
compute#targetInstance for target instances.
This field is a member of oneof_ _kind.
name
str
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.
This field is a member of oneof_ _name.
nat_policy
str
Must have a value of NO_NAT. Protocol forwarding delivers
packets while preserving the destination IP address of the
forwarding rule referencing the target instance. Check the
NatPolicy enum for the list of possible values.
This field is a member of oneof_ _nat_policy.
network
str
The URL of the network this target instance
uses to forward traffic. If not specified, the
traffic will be forwarded to the network that
the default network interface belongs to.
This field is a member of oneof_ _network.
security_policy
str
[Output Only] The resource URL for the security policy
associated with this target instance.
This field is a member of oneof_ _security_policy.
self_link
str
[Output Only] Server-defined URL for the resource.
This field is a member of oneof_ _self_link.
zone
str
[Output Only] URL of the zone where the target instance
resides. You must specify this field as part of the HTTP
request URL. It is not settable as a field in the request
body.
This field is a member of oneof_ _zone.
Classes
NatPolicy
NatPolicy(value)
Must have a value of NO_NAT. Protocol forwarding delivers packets
while preserving the destination IP address of the forwarding rule
referencing the target instance.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-11 UTC."],[],[],null,["# Class TargetInstance (1.35.0)\n\nVersion latestkeyboard_arrow_down\n\n- [1.35.0 (latest)](/python/docs/reference/compute/latest/google.cloud.compute_v1.types.TargetInstance)\n- [1.34.0](/python/docs/reference/compute/1.34.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.33.0](/python/docs/reference/compute/1.33.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.32.0](/python/docs/reference/compute/1.32.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.31.0](/python/docs/reference/compute/1.31.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.30.0](/python/docs/reference/compute/1.30.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.29.0](/python/docs/reference/compute/1.29.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.28.0](/python/docs/reference/compute/1.28.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.27.0](/python/docs/reference/compute/1.27.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.26.0](/python/docs/reference/compute/1.26.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.25.0](/python/docs/reference/compute/1.25.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.24.0](/python/docs/reference/compute/1.24.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.23.0](/python/docs/reference/compute/1.23.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.22.0](/python/docs/reference/compute/1.22.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.21.0](/python/docs/reference/compute/1.21.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.20.1](/python/docs/reference/compute/1.20.1/google.cloud.compute_v1.types.TargetInstance)\n- [1.19.2](/python/docs/reference/compute/1.19.2/google.cloud.compute_v1.types.TargetInstance)\n- [1.18.0](/python/docs/reference/compute/1.18.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.17.0](/python/docs/reference/compute/1.17.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.16.1](/python/docs/reference/compute/1.16.1/google.cloud.compute_v1.types.TargetInstance)\n- [1.15.0](/python/docs/reference/compute/1.15.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.14.1](/python/docs/reference/compute/1.14.1/google.cloud.compute_v1.types.TargetInstance)\n- [1.13.0](/python/docs/reference/compute/1.13.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.12.1](/python/docs/reference/compute/1.12.1/google.cloud.compute_v1.types.TargetInstance)\n- [1.11.0](/python/docs/reference/compute/1.11.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.10.1](/python/docs/reference/compute/1.10.1/google.cloud.compute_v1.types.TargetInstance)\n- [1.9.0](/python/docs/reference/compute/1.9.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.8.0](/python/docs/reference/compute/1.8.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.7.0](/python/docs/reference/compute/1.7.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.6.1](/python/docs/reference/compute/1.6.1/google.cloud.compute_v1.types.TargetInstance)\n- [1.5.2](/python/docs/reference/compute/1.5.2/google.cloud.compute_v1.types.TargetInstance)\n- [1.4.0](/python/docs/reference/compute/1.4.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.3.2](/python/docs/reference/compute/1.3.2/google.cloud.compute_v1.types.TargetInstance)\n- [1.2.0](/python/docs/reference/compute/1.2.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.1.0](/python/docs/reference/compute/1.1.0/google.cloud.compute_v1.types.TargetInstance)\n- [1.0.0](/python/docs/reference/compute/1.0.0/google.cloud.compute_v1.types.TargetInstance)\n- [0.9.0](/python/docs/reference/compute/0.9.0/google.cloud.compute_v1.types.TargetInstance)\n- [0.8.0](/python/docs/reference/compute/0.8.0/google.cloud.compute_v1.types.TargetInstance)\n- [0.7.0](/python/docs/reference/compute/0.7.0/google.cloud.compute_v1.types.TargetInstance)\n- [0.6.0](/python/docs/reference/compute/0.6.0/google.cloud.compute_v1.types.TargetInstance)\n- [0.5.0](/python/docs/reference/compute/0.5.0/google.cloud.compute_v1.types.TargetInstance)\n- [0.4.2](/python/docs/reference/compute/0.4.2/google.cloud.compute_v1.types.TargetInstance)\n- [0.3.0](/python/docs/reference/compute/0.3.0/google.cloud.compute_v1.types.TargetInstance)\n- [0.2.1](/python/docs/reference/compute/0.2.1/google.cloud.compute_v1.types.TargetInstance)\n- [0.1.0](/python/docs/reference/compute/0.1.0/google.cloud.compute_v1.types.TargetInstance) \n\n TargetInstance(mapping=None, *, ignore_unknown_fields=False, **kwargs)\n\nRepresents a Target Instance resource. You can use a target\ninstance to handle traffic for one or more forwarding rules,\nwhich is ideal for forwarding protocol traffic that is managed\nby a single source. For example, ESP, AH, TCP, or UDP. For more\ninformation, read Target instances.\n\n.. _oneof: \u003chttps://proto-plus-python.readthedocs.io/en/stable/fields.html#oneofs-mutually-exclusive-fields\u003e\n\nClasses\n-------\n\n### NatPolicy\n\n NatPolicy(value)\n\nMust have a value of NO_NAT. Protocol forwarding delivers packets\nwhile preserving the destination IP address of the forwarding rule\nreferencing the target instance."]]