- NAME
-
- gcloud beta container images delete - delete existing images
- SYNOPSIS
-
-
gcloud beta container images deleteIMAGE_NAME[IMAGE_NAME…] [--force-delete-tags] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(BETA)The container images delete command deletes the specified image from the registry. All associated tags are also deleted. - EXAMPLES
- Deletes the image as long as there aren't additional, unspecified tags
referencing it:
gcloud beta container images delete <IMAGE_NAME>Deletes the image (and tags) from the input IMAGE_NAME:
gcloud beta container images delete <IMAGE_NAME> --force-delete-tagsDeletes the image (and tags) from the input IMAGE_NAME, without additional prompting:
gcloud beta container images delete <IMAGE_NAME> --force-delete-tags --quietTo easily identify and delete untagged images in a project, first filter digests that lack tags:
gcloud container images list-tags [ HOSTNAME ] / [ PROJECT-ID ] / [ IMAGE ] --filter = '-tags:*' --format = "get(digest)" --limit = $BIG_NUMBERThen, delete these tagless images without prompting by running:
gcloud beta container images delete [ HOSTNAME ] / [ PROJECT-ID ] / [ IMAGE ] @DIGEST --quiet - POSITIONAL ARGUMENTS
-
-
IMAGE_NAME[IMAGE_NAME…] - The fully qualified name(s) of image(s) to delete. The name(s) should be formatted as *.gcr.io/PROJECT_ID/IMAGE_PATH@sha256:DIGEST or *.gcr.io/PROJECT_ID/IMAGE_PATH:TAG.
-
- FLAGS
-
- If there are tags pointing to an image to be deleted then they must all be specified explicitly, or this flag must be specified, for the command to succeed.
- 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 helpfor details. - NOTES
- This command is currently in beta and might change without notice. These
variants are also available:
gcloud container images deletegcloud alpha container images delete
gcloud beta container images delete
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.
