gcloud compute images update IMAGE_NAME [--architecture=ARCHITECTURE] [--description=DESCRIPTION] [--family=FAMILY] [--update-labels=[KEY=VALUE,…]] [--clear-labels | --remove-labels=[KEY,…]] [GCLOUD_WIDE_FLAG …]
gcloud compute images update updates labels for a Compute Engine
image.
k0 and
k1 and remove labels with key
k3, run:
gcloud compute images update example-image --update-labels=k0=value1,k1=value2 --remove-labels=k3k0 and k1 will be added as new labels if not already present.
Labels can be used to identify the image and to filter them like:
gcloud compute images list --filter='labels.k1:value2'To list only the labels when describing a resource, use --format:
gcloud compute images describe example-image --format="default(labels)"IMAGE_NAME--architecture=ARCHITECTUREARCHITECTURE must be one of: ARM64,
X86_64.
--description=DESCRIPTION--family=FAMILY--update-labels=[KEY=VALUE,…]-), underscores (_), lowercase characters, and
numbers. Values must contain only hyphens (-), underscores
(_), lowercase characters, and numbers.
--clear-labels--update-labels is also specified then
--clear-labels is applied first.
For example, to remove all labels:
gcloud compute images update --clear-labels
To remove all existing labels and create two new labels,
and
foo:
baz
gcloud compute images update --clear-labels --update-labels foo=bar,baz=qux--remove-labels=[KEY,…]--update-labels is also specified then
--update-labels is applied first.
--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.
gcloud alpha compute images updategcloud beta compute images updategcloud preview compute images update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-05-27 UTC.