gcloud_beta_compute_forwarding-rules_update (1)
NAME
- gcloud beta compute forwarding-rules update - update a Google Compute Engine forwarding rule
SYNOPSIS
-
gcloud beta compute forwarding-rules update NAME [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [--global | --region=REGION] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
(BETA) gcloud beta compute forwarding-rules update updates labels
-
$ gcloud beta compute forwarding-rules update example-fr \
--region us-central1 \
--update-labels=k0=value1,k1=value2 --remove-labels=k3
will add/update labels k0 and k1 and remove labels with key k3.
Labels can be used to identify the forwarding rule and to filter them as in
-
$ gcloud beta compute forwarding-rules list \
--filter='labels.k1:value2'
To list existing labels
-
$ gcloud beta compute forwarding-rules describe example-fr \
--format='default(labels)'
POSITIONAL ARGUMENTS
-
- NAME
-
Name of the forwarding rule to operate on.
FLAGS
-
- --update-labels=[KEY=VALUE,...]
-
List of label KEY=VALUE pairs to update. If a label exists its value is
modified, otherwise a new label is created.
Keys must start with a lowercase character and contain only hyphens (-), underscores (_), lowercase characters, and numbers. Values must contain only hyphens (-), underscores (_), lowercase characters, and numbers.
-
At most one of these may be specified:
-
- --clear-labels
-
Remove all labels. If --update-labels is also specified then
--clear-labels is applied first.
For example, to remove all labels:
- $ gcloud beta compute forwarding-rules update --clear-labels
To set the labels to exactly "foo" and "baz":
-
$ gcloud beta compute forwarding-rules update --clear-labels \
--update-labels foo=bar,baz=qux
- --remove-labels=[KEY,...]
-
List of label keys to remove. If a label does not exist it is silently ignored.
-
-
At most one of these may be specified:
-
- --global
-
If set, the forwarding rule is global.
- --region=REGION
-
Region of the forwarding rule to operate on. If not specified, you may be
prompted to select a region.
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: --account, --configuration, --flags-file, --flatten, --format, --help, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity. Run $ gcloud help for details.
NOTES
This command is currently in BETA and may change without notice. This variant is also available:
- $ gcloud alpha compute forwarding-rules update