gcloud_alpha_compute_forwarding-rules_set-target (1)
NAME
- gcloud alpha compute forwarding-rules set-target - modify a forwarding rule to direct network traffic to a new target
SYNOPSIS
-
gcloud alpha compute forwarding-rules set-target NAME (--backend-service=BACKEND_SERVICE | --target-http-proxy=TARGET_HTTP_PROXY | --target-https-proxy=TARGET_HTTPS_PROXY | --target-instance=TARGET_INSTANCE | --target-pool=TARGET_POOL | --target-ssl-proxy=TARGET_SSL_PROXY | --target-tcp-proxy=TARGET_TCP_PROXY | --target-vpn-gateway=TARGET_VPN_GATEWAY) [--load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL"] [--network=NETWORK] [--subnet=SUBNET] [--subnet-region=SUBNET_REGION] [--target-instance-zone=TARGET_INSTANCE_ZONE] [--target-pool-region=TARGET_POOL_REGION] [--target-vpn-gateway-region=TARGET_VPN_GATEWAY_REGION] [--backend-service-region=BACKEND_SERVICE_REGION | --global-backend-service] [--global | --region=REGION] [--global-target-http-proxy | --target-http-proxy-region=TARGET_HTTP_PROXY_REGION] [--global-target-https-proxy | --target-https-proxy-region=TARGET_HTTPS_PROXY_REGION] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(ALPHA) gcloud alpha compute forwarding-rules set-target is used
Forwarding rules can be either global or regional, specified with the --global or --region=REGION flag. Global forwarding rules work with global load balancers, which include target HTTP proxies, target HTTPS proxies, target SSL proxies and target TCP proxies; regional forwarding rules work with regional or zonal targets, which include target pools, target instances and target VPN gateways and backend services.
Forwarding rules can be either external or internal, specified with the --load-balancing-scheme=[EXTERNAL|INTERNAL] 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 --address=ADDRESS flag for the forwarding rule. Otherwise if the flag is unspecified, an external forwarding rule will be automatically assigned an ephemeral external IP address (global IP addresses for global forwarding rules and regional IP addresses for regional forwarding rules); an internal forwarding rule will be automatically assigned an ephemeral internal IP address from the subnet specified with the --subnet flag.
There are different types of load balancer working at different layers of the OSI networking model (en.wikipedia.org/wiki/Network_layer Layer 3 load balancer targets include target pools, target SSL proxies, target TCP proxies and backend services. Layer 7 load balancer targets include target HTTP proxies and target HTTPS proxies. For more information on load balancing, see cloud.google.com/compute/docs/load-balancing-and-autoscaling
When creating a forwarding rule, exactly one of --target-instance, --target-pool, --target-http-proxy, --target-https-proxy, --target-ssl-proxy, --target-tcp-proxy or --target-vpn-gateway must be specified.
POSITIONAL ARGUMENTS
-
- NAME
-
Name of the forwarding rule to operate on.
REQUIRED FLAGS
-
-
Exactly one of these must be specified:
-
- --backend-service=BACKEND_SERVICE
-
Target backend service that will receive the traffic.
- --target-http-proxy=TARGET_HTTP_PROXY
-
Target HTTP proxy that will receive the traffic. Acceptable values for --ports
flag are: 80, 8080.
- --target-https-proxy=TARGET_HTTPS_PROXY
-
Target HTTPS proxy that will receive the traffic. Acceptable values for
--ports flag are: 443.
- --target-instance=TARGET_INSTANCE
-
Name of the target instance that will receive the traffic. The target instance
must be in a zone that's in the forwarding rule's region. Global forwarding
rules may not direct traffic to target instances. If not specified and the
compute/zone property isn't set, you may be prompted to select a
zone.
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.
- --target-pool=TARGET_POOL
-
Target pool that will receive the traffic. The target pool must be in the same
region as the forwarding rule. Global forwarding rules may not direct traffic to
target pools.
- --target-ssl-proxy=TARGET_SSL_PROXY
-
Target SSL proxy that will receive the traffic. Acceptable values for --ports
flag are: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1883, 5222.
- --target-tcp-proxy=TARGET_TCP_PROXY
-
Target TCP proxy that will receive the traffic. Acceptable values for --ports
flag are: 25, 43, 110, 143, 195, 443, 465, 587, 700, 993, 995, 1883, 5222.
- --target-vpn-gateway=TARGET_VPN_GATEWAY
-
Target VPN gateway that will receive forwarded traffic. Acceptable values for
--ports flag are: 500, 4500.
-
-
Exactly one of these must be specified:
OPTIONAL FLAGS
-
- --load-balancing-scheme=LOAD_BALANCING_SCHEME; default="EXTERNAL"
-
This signifies what the forwarding rule will be used for.
LOAD_BALANCING_SCHEME must be one of:
-
- EXTERNAL
- External load balancing or forwarding, used with one of --target-http-proxy, --target-https-proxy, --target-tcp-proxy, --target-ssl-proxy, --target-pool, --target-vpn-gateway, --target-instance.
- INTERNAL
- Internal load balancing or forwarding, used with --backend-service.
- INTERNAL_MANAGED
- Internal HTTP(S) Load Balancing, used with --target-http-proxy, --target-https-proxy.
- INTERNAL_SELF_MANAGED
- Traffic director load balancing or forwarding, used with --target-http-proxy, --target-https-proxy.
-
- --network=NETWORK
-
(Only for --load-balancing-scheme=INTERNAL,
--load-balancing-scheme=INTERNAL_MANAGED, or
--load-balancing-scheme=INTERNAL_SELF_MANAGED) Network that this forwarding
rule applies to. If this field is not specified, the default network will be
used. In the absence of the default network, this field must be specified.
- --subnet=SUBNET
-
(Only for --load-balancing-scheme=INTERNAL) Subnetwork that this forwarding
rule applies to. If the network configured for this forwarding rule is in auto
subnet mode, this flag is optional and the subnet in the same region of the
forwarding rule will be used. However, if the network is in custom subnet mode,
a subnetwork must be specified.
- --subnet-region=SUBNET_REGION
-
Region of the subnetwork to operate on. If not specified, it will be set to the
region of the forwarding rule. Overrides the default compute/region
property value for this command invocation.
- --target-instance-zone=TARGET_INSTANCE_ZONE
-
Zone of the target instance to operate on. Overrides the default
compute/zone property value for this command invocation.
- --target-pool-region=TARGET_POOL_REGION
-
Region of the target pool to operate on. If not specified, it will be set to the
region of the forwarding rule. Overrides the default compute/region
property value for this command invocation.
- --target-vpn-gateway-region=TARGET_VPN_GATEWAY_REGION
-
Region of the VPN gateway to operate on. If not specified, it will be set to the
region of the forwarding rule. Overrides the default compute/region
property value for this command invocation.
-
At most one of these may be specified:
-
- --backend-service-region=BACKEND_SERVICE_REGION
-
Region of the backend service to operate on. If not specified, it will be set to
the region of the forwarding rule. Overrides the default compute/region
property value for this command invocation.
- --global-backend-service
-
If set, the backend service is global.
-
-
At most one of these may be specified:
-
- --global
-
If set, the forwarding rule is global.
- --region=REGION
-
Region of the forwarding rule to operate on. If not specified, you may be
prompted to select a region.
To avoid prompting when this flag is omitted, you can set the compute/region property:
- $ gcloud config set compute/region REGION
A list of regions can be fetched by running:
- $ gcloud compute regions list
To unset the property, run:
- $ gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION.
-
-
At most one of these may be specified:
-
- --global-target-http-proxy
-
If set, the http proxy is global.
- --target-http-proxy-region=TARGET_HTTP_PROXY_REGION
-
Region of the http proxy to operate on. If not specified, you may be prompted to
select a region.
To avoid prompting when this flag is omitted, you can set the compute/region property:
- $ gcloud config set compute/region REGION
A list of regions can be fetched by running:
- $ gcloud compute regions list
To unset the property, run:
- $ gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION.
-
-
At most one of these may be specified:
-
- --global-target-https-proxy
-
If set, the https proxy is global.
- --target-https-proxy-region=TARGET_HTTPS_PROXY_REGION
-
Region of the https proxy to operate on. If not specified, you may be prompted
to select a region.
To avoid prompting when this flag is omitted, you can set the compute/region property:
- $ gcloud config set compute/region REGION
A list of regions can be fetched by running:
- $ gcloud compute regions list
To unset the property, run:
- $ gcloud config unset compute/region
Alternatively, the region can be stored in the environment variable CLOUDSDK_COMPUTE_REGION.
-
GCLOUD WIDE FLAGS
These flags are available to all commands: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
NOTES
This command is currently in ALPHA and may change without notice. If this command fails with API permission errors despite specifying the right project, you will have to apply for early access and have your projects registered on the API whitelist to use it. To do so, contact Support at cloud.google.com/support These variants are also available:
- $ gcloud compute forwarding-rules set-target $ gcloud beta compute forwarding-rules set-target