gcloud compute url-maps add-host-rule

NAME
gcloud compute url-maps add-host-rule - add a rule to a URL map to map hosts to a path matcher
SYNOPSIS
gcloud 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
gcloud compute url-maps add-host-rule is used to add a mapping ofhosts to a path matcher in a URL map. The mapping will match the host componentof HTTP requests to path matchers which in turn map the request to a backendservice. Before adding a host rule, at least one path matcher must exist in theURL map to take care of the path component of the requests.gcloud computeurl-maps add-path-matcher orgcloud compute url-mapsedit can be used to add path matchers.
EXAMPLES
To create a host rule mapping the*-foo.example.com andexample.com hosts to thewww path matcher, run:
gcloudcomputeurl-mapsadd-host-ruleMY-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 qualifieddomain name (FQDN) with the exception that the host can begin with a``*´´ or ``*-´´. ``*´´ acts as a glob andwill 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. Thepath matcher must already exist in the URL map (seegcloud computeurl-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 toselect a region (interactive mode only).

To avoid prompting when this flag is omitted, you can set thecompute/region property:

gcloudconfigsetcompute/regionREGION

A list of regions can be fetched by running:

gcloudcomputeregionslist

To unset the property, run:

gcloudconfigunsetcompute/region

Alternatively, the region can be stored in the environment variableCLOUDSDK_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:
gcloudalphacomputeurl-mapsadd-host-rule
gcloudbetacomputeurl-mapsadd-host-rule

Except as otherwise noted, the content of this page is licensed under theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2025-05-07 UTC.