gcloud compute url-maps create

NAME
gcloud compute url-maps create - create a URL map
SYNOPSIS
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]
DESCRIPTION
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.

EXAMPLES
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
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.
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 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 url-maps create
gcloud beta compute url-maps create