gcloud beta artifacts docker images list - list Artifact Registry container images

gcloud beta artifacts docker images list[IMAGE_PATH][--include-tags][--occurrence-filter=OCCURRENCE_FILTER; default='kind="BUILD" OR kind="IMAGE" OR kind="DISCOVERY" OR kind="SBOM_REFERENCE"'][--show-occurrences][--show-occurrences-from=SHOW_OCCURRENCES_FROM; default=10][--filter=EXPRESSION][--limit=LIMIT][--page-size=PAGE_SIZE][--sort-by=[FIELD,…]][GCLOUD_WIDE_FLAG …]

A valid Docker repository has the format ofLOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID

A valid image has the format ofLOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE_PATH

To specify the maximum number of images to list, use the --limit flag.

gcloudbetaartifactsdockerimageslist

To list images with tags under the current project, repository, and location:

gcloudbetaartifactsdockerimageslist--include-tags

To list images under repositorymy-repo, projectmy-project, inus-central1:

gcloudbetaartifactsdockerimageslistus-central1-docker.pkg.dev/my-project/my-repo

The following command lists a maximum of five images:

gcloudbetaartifactsdockerimageslistdocker.pkg.dev/my-project/my-repo--limit=5

[IMAGE_PATH]

An Artifact Registry repository or a container image. If not specified, defaultconfig values are used.

A valid docker repository has the format ofLOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID

A valid image has the format ofLOCATION-docker.pkg.dev/PROJECT-ID/REPOSITORY-ID/IMAGE_PATH

--include-tags

If specified, tags associated with each image digest are displayed up to amaximum of 100 tags per version.

--occurrence-filter=OCCURRENCE_FILTER; default='kind="BUILD" OR kind="IMAGE" OR kind="DISCOVERY" OR kind="SBOM_REFERENCE"'

A filter for the occurrences which will be summarized.

--show-occurrences

Show summaries of the various occurrence types.

--show-occurrences-from=SHOW_OCCURRENCES_FROM; default=10

The number of the most recent images for which to summarize occurrences.

--filter=EXPRESSION

Apply a Boolean filterEXPRESSION to each resource itemto be listed. If the expression evaluatesTrue, then that item islisted. For more details and examples of filter expressions, run $gcloud topic filters. This flaginteracts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.

--limit=LIMIT

Maximum number of resources to list. The default isunlimited. Thisflag interacts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.

--page-size=PAGE_SIZE

Some services group resource list output into pages. This flag specifies themaximum number of resources per page. The default is determined by the serviceif it supports paging, otherwise it isunlimited (no paging).Paging may be applied before or after--filter and--limit depending on the service.

--sort-by=[FIELD,…]

Comma-separated list of resource field key names to sort by. The default orderis ascending. Prefix a field with ``~´´ for descending order on thatfield. This flag interacts with other flags that are applied in this order:--flatten,--sort-by,--filter,--limit.

Run$gcloud help for details.