---
title: "POST /projects/{project}/zones/{zone}/targetInstances"
method: POST
path: "/projects/{project}/zones/{zone}/targetInstances"
tags: ["targetInstances"]
---

# POST /projects/{project}/zones/{zone}/targetInstances

`POST /projects/{project}/zones/{zone}/targetInstances`

Creates a TargetInstance resource in the specified project and zone using
the data included in the request.

## Path parameters

- `project` string, required
- `zone` string, required

## Query parameters

- `requestId` string

## Request body

- TargetInstance — 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, readTarget instances.
  - `description` string — An optional description of this resource. Provide this property when you create the resource.
  - `network` string — 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.
  - `securityPolicy` string — [Output Only] The resource URL for the security policy associated with this target instance.
  - `creationTimestamp` string — Output only. [Output Only] Creation timestamp inRFC3339 text format.
  - `id` string, uint64 — [Output Only] The unique identifier for the resource. This identifier is defined by the server.
  - `name` string — Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply withRFC1035. 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.
  - `kind` string — Output only. [Output Only] The type of the resource. Alwayscompute#targetInstance for target instances.
  - `instance` string — 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
  - `zone` string — Output only. [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.
  - `natPolicy` 'NO_NAT' — 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.
  - `selfLink` string — [Output Only] Server-defined URL for the resource.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/compute.md) · [All operations](https://skmtc.net/google/apis/compute/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/compute/revisions/6120ed8969d4/schema)