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