- NAME
-
- gcloud compute routers add-route-policy-term - adds a new term to an existing route policy of a Comute Engine router
- SYNOPSIS
-
-
gcloud compute routers add-route-policy-termNAME--actions= [ACTION;…]--match=MATCH--policy-name=POLICY_NAME--priority=PRIORITY[--region=REGION] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
gcloud compute routers add-route-policy-termadds a term to a route policy. - EXAMPLES
- To add a term with priority 0 with match
destination == '192.168.0.0/16'and actionsdrop()to a route policymy-policyof a routermy-routerin regionus-central1, run:gcloud compute routers add-route-policy-term my-router --region = us-central1 --policy-name = my-policy --priority = 0 --match = "destination == '192.168.0.0/16'" --actions = "drop()" - POSITIONAL ARGUMENTS
-
-
NAME - Name of the router to update.
-
- REQUIRED FLAGS
-
-
--actions=[ACTION;…] - Semicolon separated CEL expressions for the actions to take when the rule matches.
-
--match=MATCH - CEL expression for matching a route.
-
--policy-name=POLICY_NAME - Name of the route policy to which to add the term.
-
--priority=PRIORITY - Order of the term within the policy.
-
- OPTIONAL FLAGS
-
-
--region=REGION - Region of the router to update. 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
property:compute/regiongcloud config set compute/region REGIONA list of regions can be fetched by running:
gcloud compute regions listTo unset the property, run:
gcloud config unset compute/regionAlternatively, the region can be stored in the environment variable
.CLOUDSDK_COMPUTE_REGION
-
- 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
- These variants are also available:
gcloud alpha compute routers add-route-policy-termgcloud beta compute routers add-route-policy-termgcloud preview compute routers add-route-policy-term
gcloud compute routers add-route-policy-term
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.

