gcloud compute routers upload-route-policy

NAME

gcloud compute routers upload-route-policy - upload a route policy into a Compute Engine router

SYNOPSIS

gcloud compute routers upload-route-policy NAME --file-name=FILE_NAME [--file-format=FILE_FORMAT] [--policy-name=POLICY_NAME] [--region=REGION] [GCLOUD_WIDE_FLAG …]

DESCRIPTION

gcloud compute routers upload-route-policy uploads a route policy into a Compute Engine router.

EXAMPLES

To upload a route policy my-import-policy from a file my-import-policy.yaml into a router my-router in region us-central1, run:

gcloud compute routers upload-route-policy my-router --region=us-central1 --policy-name=my-import-policy --file-name=my-import-policy.yaml"

POSITIONAL ARGUMENTS

NAME: Name of the router to upload.

REQUIRED FLAGS

--file-name=FILE_NAME: Local path to the file defining the policy

OPTIONAL FLAGS

--file-format=FILE_FORMAT

Format of the file passed to --file-name. FILE_FORMAT must be one of: json, yaml.

--policy-name=POLICY_NAME

Name of the route policy to add/replace.

--region=REGION

Region of the router to upload. 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.

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

These variants are also available:

gcloud alpha compute routers upload-route-policy

gcloud beta compute routers upload-route-policy

gcloud preview compute routers upload-route-policy

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.