- NAME
-
- gcloud beta compute target-instances create - create a target instance for handling traffic from a forwarding rule
- SYNOPSIS
-
-
gcloud beta compute target-instances createNAME--instance=INSTANCE[--description=DESCRIPTION] [--instance-zone=INSTANCE_ZONE] [--network=NETWORK] [--zone=ZONE] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)gcloud beta compute target-instances createis 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/zoneproperty 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
property isn't set, you might be prompted to select a zone (interactive mode only).compute/zoneTo avoid prompting when this flag is omitted, you can set the
property:compute/zonegcloud config set compute/zone ZONEA list of zones can be fetched by running:
gcloud compute zones listTo unset the property, run:
gcloud config unset compute/zoneAlternatively, 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 helpfor details. - NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud compute target-instances creategcloud alpha compute target-instances creategcloud preview compute target-instances create
gcloud beta compute target-instances create
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License , and code samples are licensed under the Apache 2.0 License . For details, see the Google Developers Site Policies . Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.

