mirror of
https://github.com/imjasonh/gcloud-help
synced 2026-07-08 10:35:03 +00:00
86 lines
3.1 KiB
Text
86 lines
3.1 KiB
Text
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-rule URL_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 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-matcher or gcloud compute url-maps edit can be
|
|
used to add path matchers.
|
|
|
|
EXAMPLES
|
|
To create a host rule mapping the *-foo.example.com and example.com hosts
|
|
to the www path matcher, run:
|
|
|
|
$ gcloud 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
|
|
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 add-host-rule
|
|
|
|
$ gcloud beta compute url-maps add-host-rule
|
|
|