- NAME
-
- gcloud beta compute url-maps add-host-rule - add a rule to a URL map to map hosts to a path matcher
- SYNOPSIS
-
-
gcloud beta compute url-maps add-host-ruleURL_MAP--hosts=HOST,[HOST,…]--path-matcher-name=PATH_MATCHER_NAME[--description=DESCRIPTION] [--global|--region=REGION] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)gcloud beta compute url-maps add-host-ruleis used to add a mapping of hosts to a path matcher in a URL map. The mapping will match the host component of HTTP requests to path matchers which in turn map the request to a backend service. Before adding a host rule, at least one path matcher must exist in the URL map to take care of the path component of the requests.gcloud compute url-maps add-path-matcherorgcloud compute url-maps editcan be used to add path matchers. - EXAMPLES
-
To create a host rule mapping the
*-foo.example.comandexample.comhosts to thewwwpath matcher, run:gcloud beta compute url-maps add-host-rule MY-URL-MAP --hosts='*-foo.example.com,example.com' --path-matcher-name=www - POSITIONAL ARGUMENTS
-
URL_MAP- Name of the URL map to operate on.
- REQUIRED FLAGS
-
--hosts=HOST,[HOST,…]- The set of hosts to match requests against. Each host must be a fully qualified domain name (FQDN) with the exception that the host can begin with a ``*´´ or ``*-´´. ``*´´ acts as a glob and will match any string of atoms to the left where an atom is separated by dots (``.´´) or dashes (``-´´).
--path-matcher-name=PATH_MATCHER_NAME-
The name of the path matcher to use if a request matches this host rule. The
path matcher must already exist in the URL map (see
gcloud compute url-maps add-path-matcher).
- OPTIONAL FLAGS
-
--description=DESCRIPTION- An optional, textual description for the host rule.
-
At most one of these can be specified:
--global- If set, the URL map is global.
--region=REGION-
Region of the URL map to operate on. 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 add-host-rulegcloud alpha compute url-maps add-host-rule
gcloud beta compute url-maps add-host-rule
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 2025-05-07 UTC.