.TH "GCLOUD_CONTAINER_IMAGES_DELETE" 1



.SH "NAME"
.HP
gcloud container images delete \- delete existing images



.SH "SYNOPSIS"
.HP
\f5gcloud container images delete\fR \fIIMAGE_NAME\fR [\fIIMAGE_NAME\fR\ ...] [\fB\-\-force\-delete\-tags\fR] [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

The container images delete command deletes the specified image from the
registry. All associated tags are also deleted.



.SH "EXAMPLES"

Deletes the image as long as there aren't additional, unspecified tags
referencing it:

.RS 2m
$ gcloud container images delete <IMAGE_NAME>
.RE

Deletes the image (and tags) from the input IMAGE_NAME:

.RS 2m
$ gcloud container images delete <IMAGE_NAME> \-\-force\-delete\-tags
.RE

Deletes the image (and tags) from the input IMAGE_NAME, without additional
prompting:

.RS 2m
$ gcloud container images delete <IMAGE_NAME> \-\-force\-delete\-tags \e
    \-\-quiet
.RE

To easily identify and delete untagged images in a project, first filter digests
that lack tags:

.RS 2m
$ gcloud container images list\-tags \e
    [HOSTNAME]/[PROJECT\-ID]/[IMAGE] \-\-filter='\-tags:*' \e
    \-\-format="get(digest)" \-\-limit=$BIG_NUMBER
.RE

Then, delete these tagless images without prompting by running:

.RS 2m
$ gcloud container images delete \e
    [HOSTNAME]/[PROJECT\-ID]/[IMAGE]@DIGEST \-\-quiet
.RE



.SH "POSITIONAL ARGUMENTS"

.RS 2m
.TP 2m
\fIIMAGE_NAME\fR [\fIIMAGE_NAME\fR ...]

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.


.RE
.sp

.SH "FLAGS"

.RS 2m
.TP 2m
\fB\-\-force\-delete\-tags\fR

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.


.RE
.sp

.SH "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 \fB$ gcloud help\fR for details.



.SH "NOTES"

These variants are also available:

.RS 2m
$ gcloud alpha container images delete
.RE

.RS 2m
$ gcloud beta container images delete
.RE