gcloud alpha compute url-maps add-host-rule

NAME
gcloud alpha compute url-maps add-host-rule - add a rule to a URL map to map hosts to a path matcher
SYNOPSIS
gcloud alpha 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
(ALPHA)gcloud alpha compute url-maps add-host-rule isused to add a mapping of hosts to a path matcher in a URL map. The mapping willmatch the host component of HTTP requests to path matchers which in turn map therequest to a backend service. Before adding a host rule, at least one pathmatcher must exist in the URL map to take care of the path component of therequests.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:
gcloudalphacomputeurl-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
This command is currently in alpha and might change without notice. If thiscommand fails with API permission errors despite specifying the correct project,you might be trying to access an API with an invitation-only early accessallowlist. These variants are also available:
gcloudcomputeurl-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.