gcloud compute url-maps create - create a URL map
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 *.google.com and google.com to a path matcher called www. The www path matcher in turn can map the path /search/* to the search backend service, the path /static/* to the static backend bucket and everything else to a default backend service or default backend bucket.
Host rules and patch matchers can be added to the URL map after the map is created by using gcloud compute url-maps edit or by using gcloud compute url-maps add-path-matcher and gcloud compute url-maps add-host-rule.
To create a global URL map with a default service, run:
$ gcloud compute url-maps create URL_MAP_NAME \ --default-service=BACKEND_SERVICE_NAME
To 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_NAME
To create a global URL map with a default backend bucket, run:
$ gcloud compute url-maps create URL_MAP_NAME \ --default-backend-bucket=BACKEND_BUCKET_NAME
- URL_MAP
Name of the URL map to create.
- 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.
- --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 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.
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.
These variants are also available:
$ gcloud alpha compute url-maps create
$ gcloud beta compute url-maps create