Amazon Elastic Container Service
Developer Guide (API Version 2014-11-13)

ecs-cli images

List images in an Amazon ECR registry or repository.

Important

Some features described may only be available with the latest version of the Amazon ECS CLI. For more information about obtaining the latest version, see Installing the Amazon ECS CLI.

Syntax

ecs-cli images [--registry-id registry_id] [--tagged|--untagged] [--region region] [ECR_REPOSITORY] [--help]

Options

Name Description

--registry-id registry_id

Specifies the Amazon ECR registry with which to list images. By default, images are listed for the current AWS account.

Required: No

--tagged

Filters the result to show only tagged images.

Required: No

--untagged

Filters the result to show only untagged images.

Required: No

--region, -r region

Specifies the AWS Region to use. Defaults to the cluster configured using the configure command.

Type: String

Required: No

--help, -h

Shows the help text for the specified command.

Required: No

Examples

Example 1

This example lists all of the images in an Amazon ECR registry.

ecs-cli images

Output:

REPOSITORY NAME TAG IMAGE DIGEST PUSHED AT SIZE rkt latest sha256:404758ad8af94347fc8582fc8e30b6284f2b0751de29b2e755da212f80232fac 3 months ago 203 MB foobuntu latest sha256:6b079ae764a6affcb632231349d4a5e1b084bece8c46883c099863ee2aeb5cf8 4 days ago 51.7 MB ubuntu xenial sha256:6b079ae764a6affcb632231349d4a5e1b084bece8c46883c099863ee2aeb5cf8 4 days ago 51.7 MB ubuntu latest sha256:6b079ae764a6affcb632231349d4a5e1b084bece8c46883c099863ee2aeb5cf8 4 days ago 51.7 MB ubuntu <none> sha256:512e30a26d9fa3648dbccb9e78e9bab636e6022e2d80bd73c99177b21a0d3982 19 minutes ago 268 MB ubuntu trusty sha256:bd6d24e8fa3f5822146b2c94247976b87e6564195c3c180b67833e6ea699f7c2 18 minutes ago 67.2 MB ubuntu precise sha256:b38267a51fb4460699bc2bcdbb53d42fec697bb4e4f9a819df3e762cec393b2a 17 minutes ago 40.1 MB amazon-ecs-sample latest sha256:bf04071a8edecc309f4d109ae36f24a5c272a115b6f7e636f77940059024d71c 2 weeks ago 105 MB golang latest sha256:137b22efee2df470b0cd28ebfc1ae583be0baf09334a5a882096193577d983ab 4 days ago 266 MB amazonlinux latest sha256:a59d563b5139deee8cb108bfb97bf3e9021b8ccea6dec8ff49733230cb2f0eca 4 days ago 98.8 MB awsbatch/fetch_and_run latest sha256:543800007416d0ccff4f63643bb18eeff4b874ea772128efcdc231ff456a37fc 6 weeks ago 116 MB

Example 2

This example lists all of the images in a specific Amazon ECR repository.

ecs-cli images ubuntu

Output:

REPOSITORY NAME TAG IMAGE DIGEST PUSHED AT SIZE ubuntu xenial sha256:6b079ae764a6affcb632231349d4a5e1b084bece8c46883c099863ee2aeb5cf8 4 days ago 51.7 MB ubuntu latest sha256:6b079ae764a6affcb632231349d4a5e1b084bece8c46883c099863ee2aeb5cf8 4 days ago 51.7 MB ubuntu <none> sha256:512e30a26d9fa3648dbccb9e78e9bab636e6022e2d80bd73c99177b21a0d3982 20 minutes ago 268 MB ubuntu trusty sha256:bd6d24e8fa3f5822146b2c94247976b87e6564195c3c180b67833e6ea699f7c2 19 minutes ago 67.2 MB ubuntu precise sha256:b38267a51fb4460699bc2bcdbb53d42fec697bb4e4f9a819df3e762cec393b2a 18 minutes ago 40.1 MB

Example 3

This example lists all of the untagged images in an Amazon ECR registry.

ecs-cli images --untagged

Output:

REPOSITORY NAME TAG IMAGE DIGEST PUSHED AT SIZE ubuntu <none> sha256:512e30a26d9fa3648dbccb9e78e9bab636e6022e2d80bd73c99177b21a0d3982 24 minutes ago 268 MB

On this page: