gcloud compute routes create - create a new route

gcloud compute routes createNAME--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][--resource-manager-tags=[KEY=VALUE,…]][--tags=TAG,[TAG,…]][GCLOUD_WIDE_FLAG …]

Routes match packets by destination IP address, preferring smaller or morespecific ranges over larger ones (see--destination-range). Ifthere is a tie, the system selects the route with the smallest priority value.The packet is then forwarded as specified by--next-hop-address,--next-hop-instance,--next-hop-vpn-tunnel, or--next-hop-gateway of the winning route. Packets that do not matchany route in the sending virtual machine routing table will be dropped.

Exactly one of--next-hop-address,--next-hop-gateway,--next-hop-vpn-tunnel, or--next-hop-instance must beprovided with this command.

NAME

Name of the route to create.

--destination-range=DESTINATION_RANGE

The destination range of outgoing packets that the route will apply to. To matchall 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. Theinstance must have IP forwarding enabled (i.e., include--can-ip-forward when creating the instanceusinggcloudcompute instances create)

--next-hop-gateway=NEXT_HOP_GATEWAY

Specifies the gateway that should handle matching packets. Currently, the onlyacceptable value isdefault-internet-gateway which is a gatewayoperated by Google Compute Engine.

--next-hop-ilb=NEXT_HOP_ILB

Specifies the name or IP address of a forwarding rule for an internal TCP/UDPload balancer. The forwarding rule's--load-balancing-scheme mustbeINTERNAL. You can use any--destination-range thatdoesn'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. For moreinformation, seehttps://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 thisroute. When this flag is specified, the zone of the instance must be specifiedusing--next-hop-instance-zone.

--next-hop-vpn-tunnel=NEXT_HOP_VPN_TUNNEL

The target VPN tunnel that will receive forwarded traffic.

--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 beprompted to select a region (interactive mode only).

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

gcloudconfigsetcompute/regionREGION

A list of regions can be fetched by running:

gcloudcomputeregionslist

To unset the property, run:

gcloudconfigunsetcompute/region

Alternatively, the region can be stored in the environment variableCLOUDSDK_COMPUTE_REGION.

--next-hop-instance-zone=NEXT_HOP_INSTANCE_ZONE

The zone of the next hop instance. If not specified, you might be prompted toselect a zone (interactive mode only).gcloud attempts to identify theappropriate zone by searching for resources in your currently active project. Ifthe zone cannot be determined,gcloud prompts you for a selection withall available Google Cloud Platform zones.

To avoid prompting when this flag is omitted, the user 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.

--next-hop-vpn-tunnel-region=NEXT_HOP_VPN_TUNNEL_REGION

The region of the next hop vpn tunnel. If not specified, you might be promptedto select a region (interactive mode only).

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

gcloudconfigsetcompute/regionREGION

A list of regions can be fetched by running:

gcloudcomputeregionslist

To unset the property, run:

gcloudconfigunsetcompute/region

Alternatively, the region can be stored in the environment variableCLOUDSDK_COMPUTE_REGION.

--priority=PRIORITY; default=1000

Specifies the priority of this route relative to other routes with the samespecificity. The lower the value, the higher the priority.

--resource-manager-tags=[KEY=VALUE,…]

A comma-separated list of Resource Manager tags to apply to the route.

--tags=TAG,[TAG,…]

Identifies the set of instances that this route will apply to. If no tags areprovided, the route will apply to all instances in the network.

Run$gcloud help for details.