gcloud compute url-maps create URL_MAP (--default-backend-bucket=DEFAULT_BACKEND_BUCKET | --default-service=DEFAULT_SERVICE) [--description=DESCRIPTION] [--global | --region=REGION] [GCLOUD_WIDE_FLAG …]
gcloud compute url-maps create is used to create URL maps which map
HTTP and HTTPS request URLs to backend services and backend buckets. Mappings
are done using a longest-match strategy.
There are two components to a mapping: a host rule and a path matcher. A host
rule maps one or more hosts to a path matcher. A path matcher maps request paths
to backend services or backend buckets. For example, a host rule can map the
hosts and
*.google.com to a path matcher called
google.com. The
www path matcher in turn can map the path
www to the search backend service,
the path /search/* to the static backend
bucket and everything else to a default backend service or default backend
bucket.
/static/*
gcloud compute url-maps
edit or by using gcloud compute
url-maps add-path-matcher and gcloud compute
url-maps add-host-rule.
gcloud compute url-maps create URL_MAP_NAME --default-service=BACKEND_SERVICE_NAMETo create a regional URL map with a default service, run:
gcloud compute url-maps create URL_MAP_NAME --default-service=BACKEND_SERVICE_NAME --region=REGION_NAMETo create a global URL map with a default backend bucket, run:
gcloud compute url-maps create URL_MAP_NAME --default-backend-bucket=BACKEND_BUCKET_NAMEURL_MAP--default-backend-bucket=DEFAULT_BACKEND_BUCKET--default-service=DEFAULT_SERVICE--description=DESCRIPTION--global--region=REGION
To avoid prompting when this flag is omitted, you can set the
property:
compute/region
gcloud 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/regionCLOUDSDK_COMPUTE_REGION.
--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.
gcloud alpha compute url-maps creategcloud beta compute url-maps creategcloud preview compute url-maps create
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.