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

ecs-cli ps

列出 Amazon ECS 集群中运行的所有容器。

Amazon ECS CLI 显示的 IP 地址主要取决于您配置任务和集群的方式：

  • 对于使用 EC2 启动类型而没有任务联网的任务，显示的 IP 地址是运行您的任务的 Amazon EC2 实例的公有 IP 地址，或实例私有 IP 地址（如果它缺少公有 IP 地址）。

  • 对于使用 EC2 启动类型且有任务联网的任务，ECS CLI 将仅显示从任务的“描述任务”输出的网络接口部分中获取的私有 IP 地址。

  • 对于使用 Fargate 启动类型的任务，Amazon ECS CLI 将返回为附加到 Fargate 任务的弹性网络实例分配的公有 IP 地址。如果弹性网络实例缺少公有 IP 地址，则 Amazon ECS CLI 将回退到从“描述任务”输出的网络接口部分中获取的私有 IP 地址。

语法

ecs-cli ps [--desired-status status] [--cluster cluster_name] [--region region] [--help]

选项

名称 描述

--desired-status status

筛选容器列表结果时使用的容器所需状态。

必需：否

有效值：RUNNING | STOPPED

--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

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

必需：否

示例

示例

此示例显示正在集群中运行的容器。

ecs-cli ps

输出：

Name                                             State    Ports                      TaskDefinition       Health
afd7f8a0-3813-4e1a-9d9e-ca7e9d1fcfbb/wordpress   RUNNING  36.253.177.221:80->80/tcp  compose3:7           HEALTHY
dca67e02-68ca-4507-b194-a47239b5e7a9/wordpress   RUNNING  37.234.146.14:80->80/tcp   healthcheck:3        UNKNOWN
dca67e02-68ca-4507-b194-a47239b5e7a9/redis       RUNNING                             healthcheck:3        HEALTHY
feb6e10e-3385-4c9b-a6cb-787cc8e90dda/sample-app  RUNNING  54.229.211.206:80->80/tcp  tutorial-task-def:1  UNKNOWN

本页内容：