.TH "GCLOUD_ALPHA_ARTIFACTS_DOCKER_IMAGES" 1



.SH "NAME"
.HP
gcloud alpha artifacts docker images \- manage Artifact Registry container images



.SH "SYNOPSIS"
.HP
\f5gcloud alpha artifacts docker images\fR \fICOMMAND\fR [\fIGCLOUD_WIDE_FLAG\ ...\fR]



.SH "DESCRIPTION"

\fB(ALPHA)\fR To list images under the current project, repository, and
location:

.RS 2m
$ gcloud alpha artifacts docker images list
.RE

To list images under repository \f5my\-repo\fR, project \f5my\-project\fR, in
\f5us\-central1\fR:

.RS 2m
$ gcloud alpha artifacts docker images list \e
  us\-central1\-docker.pkg.dev/my\-project/my\-repo
.RE

To list images with tags, under repository \f5my\-repo\fR, project
\f5my\-project\fR across all locations:

.RS 2m
$ gcloud alpha artifacts docker images list \e
  docker.pkg.dev/my\-project/my\-repo \-\-include\-tags
.RE

To list all images under image \f5busy\-box\fR, in repository \f5my\-repo\fR,
project \f5my\-project\fR across all locations:

.RS 2m
$ gcloud alpha artifacts docker images list \e
  docker.pkg.dev/my\-project/my\-repo/busy\-box
.RE

To delete image \f5busy\-box\fR in \f5us\-west1\fR and all of its digests and
tags:

.RS 2m
$ gcloud alpha artifacts docker images delete
us\-west1\-docker.pkg.dev/my\-project/my\-repository/busy\-box
.RE

To delete image digest \f5abcxyz\fR under image \f5busy\-box\fR:

.RS 2m
$ gcloud alpha artifacts docker images delete
us\-west1\-docker.pkg.dev/my\-project/my\-repository/busy\-box@sha256:abcxyz
.RE

To delete image digest \f5abcxyz\fR under image \f5busy\-box\fR while there're
some other tags associate with the digest:

.RS 2m
$ gcloud alpha artifacts docker images delete
us\-west1\-docker.pkg.dev/my\-project/my\-repository/busy\-box@sha256:abcxyz
\-\-delete\-tags
.RE

To delete an image digest and its only tag \f5my\-tag\fR under image
\f5busy\-box\fR:

.RS 2m
$ gcloud alpha artifacts docker images delete
us\-west1\-docker.pkg.dev/my\-project/my\-repository/busy\-box:my\-tag
.RE



.SH "GCLOUD WIDE FLAGS"

These flags are available to all commands: \-\-help.

Run \fB$ gcloud help\fR for details.



.SH "COMMANDS"

\f5\fICOMMAND\fR\fR is one of the following:

.RS 2m
.TP 2m
\fBdelete\fR

\fB(ALPHA)\fR Delete an Artifact Registry container image.

.TP 2m
\fBdescribe\fR

\fB(ALPHA)\fR Describe an Artifact Registry container image.

.TP 2m
\fBlist\fR

\fB(ALPHA)\fR List Artifact Registry container images.


.RE
.sp

.SH "NOTES"

This command is currently in alpha and might change without notice. If this
command fails with API permission errors despite specifying the correct project,
you might be trying to access an API with an invitation\-only early access
allowlist. These variants are also available:

.RS 2m
$ gcloud artifacts docker images
.RE

.RS 2m
$ gcloud beta artifacts docker images
.RE