.TH "GCLOUD_COMPUTE_FORWARDING\-RULES_CREATE" 1



.SH "NAME"
.HP
gcloud compute forwarding\-rules create \- create a forwarding rule to direct network traffic to a load balancer



.SH "SYNOPSIS"
.HP
\f5gcloud compute forwarding\-rules create\fR \fINAME\fR (\fB\-\-backend\-service\fR=\fIBACKEND_SERVICE\fR\ |\ \fB\-\-target\-google\-apis\-bundle\fR=\fITARGET_GOOGLE_APIS_BUNDLE\fR\ |\ \fB\-\-target\-grpc\-proxy\fR=\fITARGET_GRPC_PROXY\fR\ |\ \fB\-\-target\-http\-proxy\fR=\fITARGET_HTTP_PROXY\fR\ |\ \fB\-\-target\-https\-proxy\fR=\fITARGET_HTTPS_PROXY\fR\ |\ \fB\-\-target\-instance\fR=\fITARGET_INSTANCE\fR\ |\ \fB\-\-target\-pool\fR=\fITARGET_POOL\fR\ |\ \fB\-\-target\-service\-attachment\fR=\fITARGET_SERVICE_ATTACHMENT\fR\ |\ \fB\-\-target\-ssl\-proxy\fR=\fITARGET_SSL_PROXY\fR\ |\ \fB\-\-target\-tcp\-proxy\fR=\fITARGET_TCP_PROXY\fR\ |\ \fB\-\-target\-vpn\-gateway\fR=\fITARGET_VPN_GATEWAY\fR) [\fB\-\-address\fR=\fIADDRESS\fR] [\fB\-\-allow\-global\-access\fR] [\fB\-\-allow\-psc\-global\-access\fR] [\fB\-\-description\fR=\fIDESCRIPTION\fR] [\fB\-\-disable\-automate\-dns\-zone\fR] [\fB\-\-ip\-collection\fR=\fIIP_COLLECTION\fR] [\fB\-\-ip\-collection\-region\fR=\fIIP_COLLECTION_REGION\fR] [\fB\-\-ip\-protocol\fR=\fIIP_PROTOCOL\fR] [\fB\-\-ip\-version\fR=\fIIP_VERSION\fR] [\fB\-\-is\-mirroring\-collector\fR] [\fB\-\-load\-balancing\-scheme\fR=\fILOAD_BALANCING_SCHEME\fR] [\fB\-\-network\fR=\fINETWORK\fR] [\fB\-\-network\-tier\fR=\fINETWORK_TIER\fR] [\fB\-\-service\-directory\-registration\fR=\fISERVICE_DIRECTORY_REGISTRATION\fR] [\fB\-\-service\-label\fR=\fISERVICE_LABEL\fR] [\fB\-\-source\-ip\-ranges\fR=\fISOURCE_IP_RANGE\fR,[...]] [\fB\-\-subnet\fR=\fISUBNET\fR] [\fB\-\-subnet\-region\fR=\fISUBNET_REGION\fR] [\fB\-\-target\-instance\-zone\fR=\fITARGET_INSTANCE_ZONE\fR] [\fB\-\-target\-pool\-region\fR=\fITARGET_POOL_REGION\fR] [\fB\-\-target\-service\-attachment\-region\fR=\fITARGET_SERVICE_ATTACHMENT_REGION\fR] [\fB\-\-target\-vpn\-gateway\-region\fR=\fITARGET_VPN_GATEWAY_REGION\fR] [\fB\-\-address\-region\fR=\fIADDRESS_REGION\fR\ |\ \fB\-\-global\-address\fR] [\fB\-\-backend\-service\-region\fR=\fIBACKEND_SERVICE_REGION\fR\ |\ \fB\-\-global\-backend\-service\fR] [\fB\-\-global\fR\ |\ \fB\-\-region\fR=\fIREGION\fR] [\fB\-\-global\-target\-http\-proxy\fR\ |\ \fB\-\-target\-http\-proxy\-region\fR=\fITARGET_HTTP_PROXY_REGION\fR] [\fB\-\-global\-target\-https\-proxy\fR\ |\ \fB\-\-target\-https\-proxy\-region\fR=\fITARGET_HTTPS_PROXY_REGION\fR] [\fB\-\-global\-target\-tcp\-proxy\fR\ |\ \fB\-\-target\-tcp\-proxy\-region\fR=\fITARGET_TCP_PROXY_REGION\fR] [\fB\-\-port\-range\fR=[\fIPORT\fR\ |\ \fISTART_PORT\-END_PORT\fR]\ |\ \fB\-\-ports\fR=\fIALL\fR\ |\ [\fIPORT\fR\ |\ \fISTART_PORT\-END_PORT\fR],[...]] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fBgcloud compute forwarding\-rules create\fR is used to create a forwarding
rule. A forwarding rule directs traffic that matches a destination IP address
(and possibly a TCP or UDP port) to a forwarding target (load balancer, VPN
gateway or VM instance).

Forwarding rules can be either global or regional, specified with the
\f5\fI\-\-global\fR\fR or \f5\fI\-\-region=REGION\fR\fR flags. For more
information about the scope of a forwarding rule, refer to
https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts.

Forwarding rules can be external, internal, internal managed, or internal
self\-managed, specified with the
\f5\fI\-\-load\-balancing\-scheme=[EXTERNAL|EXTERNAL_MANAGED|INTERNAL|INTERNAL_MANAGED|INTERNAL_SELF_MANAGED]\fR\fR
flag. External forwarding rules are accessible from the internet, while internal
forwarding rules are only accessible from within their VPC networks. You can
specify a reserved static external or internal IP address with the
\f5\fI\-\-address=ADDRESS\fR\fR flag for the forwarding rule. Otherwise, if the
flag is unspecified, an ephemeral IP address is automatically assigned (global
IP addresses for global forwarding rules and regional IP addresses for regional
forwarding rules); an internal forwarding rule is automatically assigned an
ephemeral internal IP address from the subnet specified with the
\f5\fI\-\-subnet\fR\fR flag. You must provide an IP address for an internal
self\-managed forwarding rule.

Different types of load balancers work at different layers of the OSI networking
model (http://en.wikipedia.org/wiki/Network_layer). Layer 3/4 targets include
target pools, target SSL proxies, target TCP proxies, and backend services.
Layer 7 targets include target HTTP proxies and target HTTPS proxies. For more
information, refer to
https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts.


When creating a forwarding rule, exactly one of
\f5\fI\-\-target\-instance\fR\fR, \f5\fI\-\-target\-pool\fR\fR,
\f5\fI\-\-target\-http\-proxy\fR\fR, \f5\fI\-\-target\-https\-proxy\fR\fR,
\f5\fI\-\-target\-grpc\-proxy\fR\fR, \f5\fI\-\-target\-ssl\-proxy\fR\fR,
\f5\fI\-\-target\-tcp\-proxy\fR\fR, \f5\fI\-\-target\-vpn\-gateway\fR\fR,
\f5\fI\-\-backend\-service\fR\fR or \f5\fI\-\-target\-google\-apis\-bundle\fR\fR
must be specified.



.SH "EXAMPLES"

To create a global forwarding rule that will forward all traffic on port 8080
for IP address ADDRESS to a target http proxy PROXY, run:

.RS 2m
$ gcloud compute forwarding\-rules create RULE_NAME \-\-global \e
    \-\-target\-http\-proxy=PROXY \-\-ports=8080 \-\-address=ADDRESS
.RE

To create a regional forwarding rule for the subnet SUBNET_NAME on the default
network that will forward all traffic on ports 80\-82 to a backend service
SERVICE_NAME, run:

.RS 2m
$ gcloud compute forwarding\-rules create RULE_NAME \e
    \-\-load\-balancing\-scheme=INTERNAL \e
    \-\-backend\-service=SERVICE_NAME \-\-subnet=SUBNET_NAME \e
    \-\-network=default \-\-region=REGION \-\-ports=80\-82
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fINAME\fR

Name of the forwarding rule to create.


.RE
.sp

.SH "REQUIRED FLAGS"

.RS 2m
.TP 2m

Exactly one of these must be specified:


.RS 2m
.TP 2m
\fB\-\-backend\-service\fR=\fIBACKEND_SERVICE\fR

Target backend service that receives the traffic.

.TP 2m
\fB\-\-target\-google\-apis\-bundle\fR=\fITARGET_GOOGLE_APIS_BUNDLE\fR

Target bundle of Google APIs that will receive forwarded traffic via Private
Service Connect. Acceptable values are all\-apis, meaning all Google APIs, or
vpc\-sc, meaning just the APIs that support VPC Service Controls

.TP 2m
\fB\-\-target\-grpc\-proxy\fR=\fITARGET_GRPC_PROXY\fR

Target gRPC proxy that receives the traffic.

.TP 2m
\fB\-\-target\-http\-proxy\fR=\fITARGET_HTTP_PROXY\fR

Target HTTP proxy that receives the traffic. For the acceptable ports, see Port
specifications
(https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts#port_specifications).

.TP 2m
\fB\-\-target\-https\-proxy\fR=\fITARGET_HTTPS_PROXY\fR

Target HTTPS proxy that receives the traffic. For the acceptable ports, see Port
specifications
(https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts#port_specifications).

.TP 2m
\fB\-\-target\-instance\fR=\fITARGET_INSTANCE\fR

Name of the target instance that receives the traffic. The target instance must
be in a zone in the forwarding rule's region. Global forwarding rules cannot
direct traffic to target instances. If not specified and the
\f5\fIcompute/zone\fR\fR 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
\f5\fIcompute/zone\fR\fR property:

.RS 2m
$ gcloud config set compute/zone ZONE
.RE

A list of zones can be fetched by running:

.RS 2m
$ gcloud compute zones list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/zone
.RE

Alternatively, the zone can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_ZONE\fR\fR.

.TP 2m
\fB\-\-target\-pool\fR=\fITARGET_POOL\fR

Target pool that receives the traffic. The target pool must be in the same
region as the forwarding rule. Global forwarding rules cannot direct traffic to
target pools.

.TP 2m
\fB\-\-target\-service\-attachment\fR=\fITARGET_SERVICE_ATTACHMENT\fR

Target service attachment that receives the traffic. The target service
attachment must be in the same region as the forwarding rule.

.TP 2m
\fB\-\-target\-ssl\-proxy\fR=\fITARGET_SSL_PROXY\fR

Target SSL proxy that receives the traffic. For the acceptable ports, see Port
specifications
(https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts#port_specifications).

.TP 2m
\fB\-\-target\-tcp\-proxy\fR=\fITARGET_TCP_PROXY\fR

Target TCP proxy that receives the traffic. For the acceptable ports, see Port
specifications
(https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts#port_specifications).

.TP 2m
\fB\-\-target\-vpn\-gateway\fR=\fITARGET_VPN_GATEWAY\fR

Target VPN gateway (Cloud VPN Classic gateway) that receives forwarded traffic.
Acceptable values for \-\-ports flag are: 500, 4500.


.RE
.RE
.sp

.SH "OPTIONAL FLAGS"

.RS 2m
.TP 2m
\fB\-\-address\fR=\fIADDRESS\fR

The IP address that the forwarding rule serves. When a client sends traffic to
this IP address, the forwarding rule directs the traffic to the target that you
specify in the forwarding rule.

If you don't specify a reserved IP address, an ephemeral IP address is assigned.
You can specify the IP address as a literal IP address or as a reference to an
existing Address resource. The following examples are all valid:
.RS 2m
.IP "\(em" 2m
100.1.2.3
.IP "\(em" 2m
2600:1901::/96
.IP "\(em" 2m

https://compute.googleapis.com/compute/v1/projects/project\-1/regions/us\-central1/addresses/address\-1
.IP "\(em" 2m
projects/project\-1/regions/us\-central1/addresses/address\-1
.IP "\(em" 2m
regions/us\-central1/addresses/address\-1
.IP "\(em" 2m
global/addresses/address\-1
.IP "\(em" 2m
address\-1
.RE
.sp

The load\-balancing\-scheme (EXTERNAL, EXTERNAL_MANAGED, INTERNAL,
INTERNAL_SELF_MANAGED, INTERNAL_MANAGED) and the target of the forwarding rule
determine the type of IP address that you can use. The address type must be
external for load\-balancing\-scheme EXTERNAL or EXTERNAL_MANAGED. For other
load\-balancing\-schemes, the address type must be internal. For detailed
information, refer to
https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts#ip_address_specifications.

.TP 2m
\fB\-\-allow\-global\-access\fR

If True, then clients from all regions can access this internal forwarding rule.
This can only be specified for forwarding rules with the LOAD_BALANCING_SCHEME
set to INTERNAL or INTERNAL_MANAGED. For forwarding rules of type INTERNAL, the
target must be either a backend service or a target instance.

.TP 2m
\fB\-\-allow\-psc\-global\-access\fR

If specified, clients from all regions can access this Private Service Connect
forwarding rule. This can only be specified if the forwarding rule's target is a
service attachment (\-\-target\-service\-attachment).

.TP 2m
\fB\-\-description\fR=\fIDESCRIPTION\fR

Optional textual description for the forwarding rule.

.TP 2m
\fB\-\-disable\-automate\-dns\-zone\fR

If specified, then a DNS zone will not be auto\-generated for this Private
Service Connect forwarding rule. This can only be specified if the forwarding
rule's target is a service attachment
(\f5\-\-target\-service\-attachment=SERVICE_ATTACHMENT\fR) or Google APIs bundle
(\f5\-\-target\-google\-apis\-bundle=API_BUNDLE\fR)

.TP 2m
\fB\-\-ip\-collection\fR=\fIIP_COLLECTION\fR

Resource reference to a public delegated prefix. The PublicDelegatedPrefix (PDP)
must be a sub\-prefix in EXTERNAL_IPV6_FORWARDING_RULE_CREATION mode.

.TP 2m
\fB\-\-ip\-collection\-region\fR=\fIIP_COLLECTION_REGION\fR

Region of the public delegated prefix to operate on. If not specified, the
region is set to the region of the forwarding rule. Overrides the default
\fBcompute/region\fR property value for this command invocation.

.TP 2m
\fB\-\-ip\-protocol\fR=\fIIP_PROTOCOL\fR

IP protocol that the rule will serve. The default is \f5TCP\fR.

Note that if the load\-balancing scheme is \f5INTERNAL\fR, the protocol must be
one of: \f5TCP\fR, \f5UDP\fR, \f5L3_DEFAULT\fR.

For a load\-balancing scheme that is \f5EXTERNAL\fR, all IP_PROTOCOL options are
valid.

\fIIP_PROTOCOL\fR must be one of: \fBAH\fR, \fBESP\fR, \fBICMP\fR, \fBSCTP\fR,
\fBTCP\fR, \fBUDP\fR, \fBL3_DEFAULT\fR.

.TP 2m
\fB\-\-ip\-version\fR=\fIIP_VERSION\fR

Version of the IP address to be allocated or assigned. The default is IPv4.
\fIIP_VERSION\fR must be one of: \fBIPV4\fR, \fBIPV6\fR.

.TP 2m
\fB\-\-is\-mirroring\-collector\fR

If set, this forwarding rule can be used as a collector for packet mirroring.
This can only be specified for forwarding rules with the LOAD_BALANCING_SCHEME
set to INTERNAL.

.TP 2m
\fB\-\-load\-balancing\-scheme\fR=\fILOAD_BALANCING_SCHEME\fR

This defines the forwarding rule's load balancing scheme. Note that it defaults
to EXTERNAL and is not applicable for Private Service Connect forwarding rules.
\fILOAD_BALANCING_SCHEME\fR must be one of:

.RS 2m
.TP 2m
\fBEXTERNAL\fR
Classic Application Load Balancers, global external proxy Network Load
Balancers, external passthrough Network Load Balancers or protocol forwarding,
used with one of \-\-target\-http\-proxy, \-\-target\-https\-proxy,
\-\-target\-tcp\-proxy, \-\-target\-ssl\-proxy, \-\-target\-pool,
\-\-target\-vpn\-gateway, \-\-target\-instance.
.TP 2m
\fBEXTERNAL_MANAGED\fR
Global and regional external Application Load Balancers, and regional external
proxy Network Load Balancers, used with \-\-target\-http\-proxy,
\-\-target\-https\-proxy, \-\-target\-tcp\-proxy.
.TP 2m
\fBINTERNAL\fR
Internal passthrough Network Load Balancers or protocol forwarding, used with
\-\-backend\-service.
.TP 2m
\fBINTERNAL_MANAGED\fR
Internal Application Load Balancers and internal proxy Network Load Balancers,
used with \-\-target\-http\-proxy, \-\-target\-https\-proxy,
\-\-target\-tcp\-proxy.
.TP 2m
\fBINTERNAL_SELF_MANAGED\fR
Traffic Director, used with \-\-target\-http\-proxy, \-\-target\-https\-proxy,
\-\-target\-grpc\-proxy, \-\-target\-tcp\-proxy.
.RE
.sp


.TP 2m
\fB\-\-network\fR=\fINETWORK\fR

(Only for \-\-load\-balancing\-scheme=INTERNAL or
\-\-load\-balancing\-scheme=INTERNAL_SELF_MANAGED or
\-\-load\-balancing\-scheme=EXTERNAL_MANAGED (regional) or
\-\-load\-balancing\-scheme=INTERNAL_MANAGED) Network that this forwarding rule
applies to. If this field is not specified, the default network is used. In the
absence of the default network, this field must be specified.

.TP 2m
\fB\-\-network\-tier\fR=\fINETWORK_TIER\fR

Network tier to assign to the forwarding rules. \f5\fINETWORK_TIER\fR\fR must be
one of: \f5PREMIUM\fR, \f5STANDARD\fR. The default value is \f5PREMIUM\fR.

.TP 2m
\fB\-\-service\-directory\-registration\fR=\fISERVICE_DIRECTORY_REGISTRATION\fR

The Service Directory service in which to register this forwarding rule as an
endpoint. The Service Directory service must be in the same project and region
as the forwarding rule you are creating.

.TP 2m
\fB\-\-service\-label\fR=\fISERVICE_LABEL\fR

(Only for Internal Load Balancing):
https://cloud.google.com/load\-balancing/docs/dns\-names/ The DNS label to use
as the prefix of the fully qualified domain name for this forwarding rule. The
full name will be internally generated and output as dnsName. If this field is
not specified, no DNS record will be generated and no DNS name will be output.
You cannot use the \f5\-\-service\-label\fR flag if the forwarding rule
references an internal IP address that has the
\f5\-\-purpose=SHARED_LOADBALANCER_VIP\fR flag set.

.TP 2m
\fB\-\-source\-ip\-ranges\fR=\fISOURCE_IP_RANGE\fR,[...]

List of comma\-separated IP addresses or IP ranges. If set, this forwarding rule
only forwards traffic when the packet's source IP address matches one of the IP
ranges set here.

.TP 2m
\fB\-\-subnet\fR=\fISUBNET\fR

(Only for \-\-load\-balancing\-scheme=INTERNAL and
\-\-load\-balancing\-scheme=INTERNAL_MANAGED) Subnetwork that this forwarding
rule applies to. If the network is auto mode, this flag is optional. If the
network is custom mode, this flag is required.

.TP 2m
\fB\-\-subnet\-region\fR=\fISUBNET_REGION\fR

Region of the subnetwork to operate on. If not specified, the region is set to
the region of the forwarding rule. Overrides the default \fBcompute/region\fR
property value for this command invocation.

.TP 2m
\fB\-\-target\-instance\-zone\fR=\fITARGET_INSTANCE_ZONE\fR

Zone of the target instance to operate on. Overrides the default
\fBcompute/zone\fR property value for this command invocation.

.TP 2m
\fB\-\-target\-pool\-region\fR=\fITARGET_POOL_REGION\fR

Region of the target pool to operate on. If not specified, the region is set to
the region of the forwarding rule. Overrides the default \fBcompute/region\fR
property value for this command invocation.

.TP 2m
\fB\-\-target\-service\-attachment\-region\fR=\fITARGET_SERVICE_ATTACHMENT_REGION\fR

Region of the target service attachment to operate on. If not specified, you
might be prompted to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.

.TP 2m
\fB\-\-target\-vpn\-gateway\-region\fR=\fITARGET_VPN_GATEWAY_REGION\fR

Region of the VPN gateway to operate on. If not specified, the region is set to
the region of the forwarding rule. Overrides the default \fBcompute/region\fR
property value for this command invocation.

.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-address\-region\fR=\fIADDRESS_REGION\fR

Region of the address to operate on. If not specified, you might be prompted to
select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.

.TP 2m
\fB\-\-global\-address\fR

If set, the address is global.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-backend\-service\-region\fR=\fIBACKEND_SERVICE_REGION\fR

Region of the backend service to operate on. If not specified, the region is set
to the region of the forwarding rule. Overrides the default \fBcompute/region\fR
property value for this command invocation.

.TP 2m
\fB\-\-global\-backend\-service\fR

If set, the backend service is global.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-global\fR

If set, the forwarding rule is global.

.TP 2m
\fB\-\-region\fR=\fIREGION\fR

Region of the forwarding rule to create. If not specified, you might be prompted
to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-global\-target\-http\-proxy\fR

If set, the http proxy is global.

.TP 2m
\fB\-\-target\-http\-proxy\-region\fR=\fITARGET_HTTP_PROXY_REGION\fR

Region of the http proxy to operate on. If not specified, you might be prompted
to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-global\-target\-https\-proxy\fR

If set, the https proxy is global.

.TP 2m
\fB\-\-target\-https\-proxy\-region\fR=\fITARGET_HTTPS_PROXY_REGION\fR

Region of the https proxy to operate on. If not specified, you might be prompted
to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-global\-target\-tcp\-proxy\fR

If set, the tcp proxy is global.

.TP 2m
\fB\-\-target\-tcp\-proxy\-region\fR=\fITARGET_TCP_PROXY_REGION\fR

Region of the tcp proxy to operate on. If not specified, you might be prompted
to select a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set the
\f5\fIcompute/region\fR\fR property:

.RS 2m
$ gcloud config set compute/region REGION
.RE

A list of regions can be fetched by running:

.RS 2m
$ gcloud compute regions list
.RE

To unset the property, run:

.RS 2m
$ gcloud config unset compute/region
.RE

Alternatively, the region can be stored in the environment variable
\f5\fICLOUDSDK_COMPUTE_REGION\fR\fR.

.RE
.sp
.TP 2m

At most one of these can be specified:


.RS 2m
.TP 2m
\fB\-\-port\-range\fR=[\fIPORT\fR | \fISTART_PORT\-END_PORT\fR]

DEPRECATED, use \-\-ports. If specified, only packets addressed to ports in the
specified range are forwarded. For more information, refer to
https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts#port_specifications.

.TP 2m
\fB\-\-ports\fR=\fIALL\fR | [\fIPORT\fR | \fISTART_PORT\-END_PORT\fR],[...]

List of comma\-separated ports. The forwarding rule forwards packets with
matching destination ports. Port specification requirements vary depending on
the load\-balancing scheme and target. For more information, refer to
https://cloud.google.com/load\-balancing/docs/forwarding\-rule\-concepts#port_specifications.


.RE
.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha compute forwarding\-rules create
.RE

.RS 2m
$ gcloud beta compute forwarding\-rules create
.RE