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

