- NAME
-
- gcloud beta compute url-maps create - create a URL map
- SYNOPSIS
-
-
gcloud beta compute url-maps createURL_MAP(--default-backend-bucket=DEFAULT_BACKEND_BUCKET|--default-service=DEFAULT_SERVICE) [--description=DESCRIPTION] [--global|--region=REGION] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)gcloud beta compute url-maps createis 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.comto a path matcher calledgoogle.com. Thewwwpath matcher in turn can map the pathwwwto 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/*Host rules and patch matchers can be added to the URL map after the map is created by using
gcloud compute url-maps editor by usinggcloud compute url-maps add-path-matcherandgcloud compute url-maps add-host-rule. - EXAMPLES
- To create a global URL map with a default service, run:
gcloud beta compute url-maps create URL_MAP_NAME --default-service = BACKEND_SERVICE_NAMETo create a regional URL map with a default service, run:
gcloud beta 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 beta compute url-maps create URL_MAP_NAME --default-backend-bucket = BACKEND_BUCKET_NAME - POSITIONAL ARGUMENTS
-
-
URL_MAP - Name of the URL map to create.
-
- REQUIRED FLAGS
-
- Exactly one of these must be specified:
-
--default-backend-bucket=DEFAULT_BACKEND_BUCKET - A backend bucket that will be used for requests for which this URL map has no mappings. Exactly one of --default-service or --default-backend-bucket is required.
-
--default-service=DEFAULT_SERVICE - A backend service that will be used for requests for which this URL map has no mappings. Exactly one of --default-service or --default-backend-bucket is required.
-
- Exactly one of these must be specified:
- OPTIONAL FLAGS
-
-
--description=DESCRIPTION - An optional, textual description for the URL map.
- At most one of these can be specified:
-
--global - If set, the URL map is global.
-
--region=REGION - Region of the URL map to create. 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
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud compute url-maps creategcloud alpha compute url-maps creategcloud preview compute url-maps create
gcloud beta 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.

