gcloud alpha compute target-instances create

NAME
gcloud alpha compute target-instances create - create a target instance for handling traffic from a forwarding rule
SYNOPSIS
gcloud alpha compute target-instances createNAME--instance=INSTANCE[--description=DESCRIPTION][--instance-zone=INSTANCE_ZONE][--network=NETWORK][--zone=ZONE][GCLOUD_WIDE_FLAG …]
DESCRIPTION
(ALPHA)gcloud alpha compute target-instances createis used to create a target instance for handling traffic from one or moreforwarding rules. Target instances are ideal for traffic that should be managedby a single source. For more information on target instances, seehttps://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 sameas zone. Overrides the defaultcompute/zone property value for thiscommand invocation.
--network=NETWORK
Network that this target instance applies to. This is only necessary if thecorresponding instance has multiple network interfaces. If not specified, thedefault network interface will be used.
--zone=ZONE
Zone of the target instance to operate on. If not specified and thecompute/zone property isn't set, you mightbe prompted to select a zone (interactive mode only).

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

gcloudconfigsetcompute/zoneZONE

A list of zones can be fetched by running:

gcloudcomputezoneslist

To unset the property, run:

gcloudconfigunsetcompute/zone

Alternatively, the zone can be stored in the environment variableCLOUDSDK_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 thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudcomputetarget-instancescreate
gcloudbetacomputetarget-instancescreate

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.