gcloud_compute_images_update (1)
NAME
- gcloud compute images update - update a Google Compute Engine image
SYNOPSIS
-
gcloud compute images update IMAGE_NAME [--update-labels=[KEY=VALUE,...]] [--clear-labels | --remove-labels=[KEY,...]] [GCLOUD_WIDE_FLAG ...]
DESCRIPTION
gcloud compute images update updates labels for a Google Compute image.
-
$ gcloud compute images update example-image \
--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 image and to filter them as in
- $ gcloud compute images list --filter='labels.k1:value2'
To list existing labels
-
$ gcloud compute images describe example-image \
--format='default(labels)'
POSITIONAL ARGUMENTS
-
- IMAGE_NAME
-
Name of the disk image to update.
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 compute images update --clear-labels
To set the labels to exactly "foo" and "baz":
-
$ gcloud compute images 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.
-
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
These variants are also available:
- $ gcloud alpha compute images update $ gcloud beta compute images update