登录控制台
Amazon Elastic Container Service
开发人员指南 (API 版本 2014-11-13)
AWS 文档 » Amazon ECS » 开发人员指南 » 使用 Amazon ECS 命令行界面 » Amazon ECS 命令行参考 » ecs-cli images
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅中国的 AWS 服务入门。

ecs-cli images

列出 Amazon ECR 注册表或存储库中的映像。

重要

所介绍的某些功能仅可用于最新版本的 Amazon ECS CLI。有关获取最新版本的更多信息，请参阅 安装 Amazon ECS CLI。

语法

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

选项

名称

描述

--registry-id registry_id

指定具有要列出映像的 Amazon ECR 注册表。默认情况下，将列出当前 AWS 账户的映像。

必需：否

--tagged

筛选结果以仅显示标记的映像。

必需：否

--untagged

筛选结果以仅显示未标记的映像。

必需：否

--verbose, --debug

打开调试日志记录。这将提供帮助诊断问题的更详细的命令输出。

必需：否

--use-fips

通过 FIPS 终端节点将调用路由到 Amazon ECR。

必需：否

--region, -r region

指定要使用的 AWS 区域。默认为使用 configure 命令配置的集群。

类型：字符串

必需：否

--cluster-config cluster_config_name

指定要使用的 Amazon ECS 集群配置的名称。默认为作为默认值设置的集群设置。

类型：字符串

必需：否

--ecs-profile ecs_profile

指定要使用的 Amazon ECS 配置文件的名称。默认为使用 configure profile 命令配置的配置文件。

类型：字符串

必需：否

--aws-profile aws_profile

指定要使用的 AWS 配置文件。使您能够使用 ~/.aws/credentials 中现有指定配置文件中的 AWS 凭证。

类型：字符串

必需：否

--cluster, -c cluster_name

指定要使用的 Amazon ECS 集群名称。默认为使用 configure 命令配置的集群。

类型：字符串

必需：否

--help, -h

显示指定命令的帮助文本。

必需：否

使用 FIPS 终端节点

Amazon ECS CLI 支持使用 FIPS 终端节点调用 Amazon ECR。为确保您使用的是 FIPS 终端节点访问 Amazon ECR，请对 push、pull 或 images 命令使用 --use-fips 标记。FIPS 终端节点目前仅在 us-west-1、us-west-2、us-east-1、us-east-2 和 AWS GovCloud 中可用。有关更多信息，请参阅美国联邦信息处理标准 (FIPS) 140-2。

示例

示例 1

此示例列出一个 Amazon ECR 注册表中的所有映像。

ecs-cli images

输出：

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

示例 2

此示例列出一个特定 Amazon ECR 存储库中的所有映像。

ecs-cli images ubuntu

输出：

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

示例 3

此示例列出一个 Amazon ECR 注册表中所有未标记的映像。

ecs-cli images --untagged

输出:

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