imjasonh/gcloud-help
1
0
Fork 0
mirror of https://github.com/imjasonh/gcloud-help synced 2026-07-20 21:20:07 +00:00
Code Activity

gcloud: Tue Mar 1 04:29:52 UTC 2022

Browse source
This commit is contained in:
Automated 2022-03-01 04:29:52 +00:00
parent aab53307a8
commit 1456dab6c7
9791 changed files with 814712 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

183
gcloud/beta/compute/routes/create Normal file
View file

@ -0,0 +1,183 @@
NAME
gcloud beta compute routes create - create a new route
SYNOPSIS
gcloud beta compute routes create NAME
--destination-range=DESTINATION_RANGE
(--next-hop-address=NEXT_HOP_ADDRESS
| --next-hop-gateway=NEXT_HOP_GATEWAY | --next-hop-ilb=NEXT_HOP_ILB
| --next-hop-instance=NEXT_HOP_INSTANCE
| --next-hop-vpn-tunnel=NEXT_HOP_VPN_TUNNEL)
[--description=DESCRIPTION] [--network=NETWORK; default="default"]
[--next-hop-ilb-region=NEXT_HOP_ILB_REGION]
[--next-hop-instance-zone=NEXT_HOP_INSTANCE_ZONE]
[--next-hop-vpn-tunnel-region=NEXT_HOP_VPN_TUNNEL_REGION]
[--priority=PRIORITY; default=1000] [--tags=TAG,[TAG,...]]
[GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute routes create is used to create routes. A route
is a rule that specifies how certain packets should be handled by the
virtual network. Routes are associated with virtual machine instances by
tag, and the set of routes for a particular VM is called its routing table.
For each packet leaving a virtual machine, the system searches that
machine's routing table for a single best matching route.
Routes match packets by destination IP address, preferring smaller or more
specific ranges over larger ones (see --destination-range). If there is a
tie, the system selects the route with the smallest priority value. If
there is still a tie, it uses the layer 3 and 4 packet headers to select
just one of the remaining matching routes. The packet is then forwarded as
specified by --next-hop-address, --next-hop-instance,
--next-hop-vpn-tunnel, --next-hop-gateway, or --next-hop-ilb of the winning
route. Packets that do not match any route in the sending virtual machine
routing table will be dropped.
Exactly one of --next-hop-address, --next-hop-gateway,
--next-hop-vpn-tunnel, --next-hop-instance, or --next-hop-ilb must be
provided with this command.
EXAMPLES
To create a route with the name 'route-name' with destination range
'0.0.0.0/0' and with next hop gateway 'default-internet-gateway', run:
$ gcloud beta compute routes create route-name \
--destination-range=0.0.0.0/0 \
--next-hop-gateway=default-internet-gateway
POSITIONAL ARGUMENTS
NAME
Name of the route to create.
REQUIRED FLAGS
--destination-range=DESTINATION_RANGE
The destination range of outgoing packets that the route will apply to.
To match all traffic, use ``0.0.0.0/0''.
Exactly one of these must be specified:
--next-hop-address=NEXT_HOP_ADDRESS
Specifies the IP address of an instance that should handle matching
packets. The instance must have IP forwarding enabled (i.e., include
--can-ip-forward when creating the instance using gcloud compute
instances create)
--next-hop-gateway=NEXT_HOP_GATEWAY
Specifies the gateway that should handle matching packets. Currently,
the only acceptable value is default-internet-gateway which is a
gateway operated by Google Compute Engine.
--next-hop-ilb=NEXT_HOP_ILB
Specifies the name or IP address of a forwarding rule for an internal
TCP/UDP load balancer. The forwarding rule's --load-balancing-scheme
must be INTERNAL. You can use any --destination-range that doesn't
exactly match the destination of a subnet route and isn't more
specific (has a longer subnet mask) than the destination of a subnet
route. Also, the forwarding rule's IP address can't be in the
--destination-range. For more information, see
https://cloud.google.com/load-balancing/docs/internal/ilb-next-hop-overview#destination_range.
--next-hop-instance=NEXT_HOP_INSTANCE
Specifies the name of an instance that should handle traffic matching
this route. When this flag is specified, the zone of the instance
must be specified using --next-hop-instance-zone.
--next-hop-vpn-tunnel=NEXT_HOP_VPN_TUNNEL
The target VPN tunnel that will receive forwarded traffic.
OPTIONAL FLAGS
--description=DESCRIPTION
An optional, textual description for the route.
--network=NETWORK; default="default"
Specifies the network to which the route will be applied.
--next-hop-ilb-region=NEXT_HOP_ILB_REGION
The region of the next hop forwarding rule. 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
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.
--next-hop-instance-zone=NEXT_HOP_INSTANCE_ZONE
The zone of the next hop instance. If not specified, you might be
prompted to select a zone (interactive mode only). gcloud attempts to
identify the appropriate zone by searching for resources in your
currently active project. If the zone cannot be determined, gcloud
prompts you for a selection with all available Google Cloud Platform
zones.
To avoid prompting when this flag is omitted, the user 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.
--next-hop-vpn-tunnel-region=NEXT_HOP_VPN_TUNNEL_REGION
The region of the next hop vpn tunnel. 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
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.
--priority=PRIORITY; default=1000
Specifies the priority of this route relative to other routes with the
same specificity. The lower the value, the higher the priority.
--tags=TAG,[TAG,...]
Identifies the set of instances that this route will apply to. If no
tags are provided, the route will apply to all instances in the
network.
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 beta and might change without notice. These
variants are also available:
$ gcloud compute routes create
$ gcloud alpha compute routes create