NAME

gcloud alpha compute target-instances create - create a target instance for handling traffic from a forwarding rule

SYNOPSIS

gcloud alpha compute target-instances create NAME --instance=INSTANCE [--description=DESCRIPTION] [--instance-zone=INSTANCE_ZONE] [--network=NETWORK] [--zone=ZONE] [GCLOUD_WIDE_FLAG ...]

DESCRIPTION

(ALPHA) gcloud alpha compute target-instances create is used to create a target instance for handling traffic from one or more forwarding rules. Target instances are ideal for traffic that should be managed by a single source. For more information on target instances, see https://cloud.google.com/compute/docs/protocol-forwarding/#targetinstances

POSITIONAL ARGUMENTS

NAME

Name of the target instance to operate on.

REQUIRED FLAGS

--instance=INSTANCE

The name of the virtual machine instance that will handle the traffic.

OPTIONAL FLAGS

--description=DESCRIPTION

An optional, textual description of the target instance.

--instance-zone=INSTANCE_ZONE

Zone of the instance to operate on. If not specified, it will be set to the same as zone. Overrides the default compute/zone property value for this command invocation.

--network=NETWORK

Network that this target instance applies to. This is only necessary if the corresponding instance has multiple network interfaces. If not specified, the default network interface will be used.

--zone=ZONE

Zone of the target instance to operate on. If not specified and the compute/zone property isn't set, you might be prompted to select a zone (interactive mode only).

To avoid prompting when this flag is omitted, you can set the compute/zone property:

$ gcloud config set compute/zone ZONE

A list of zones can be fetched by running:

$ gcloud compute zones list

To unset the property, run:

$ gcloud config unset compute/zone

Alternatively, the zone can be stored in the environment variable CLOUDSDK_COMPUTE_ZONE.

GCLOUD WIDE FLAGS

These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

NOTES

This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist. These variants are also available:

$ gcloud compute target-instances create

$ gcloud beta compute target-instances create