任务列表 | 大装置帮助中心
跳到主要内容

任务列表

名称​

sco acp jobs list - 查询训练任务实例列表

说明​

sco acp jobs list \
  --workspace-name=*WORKSPACE_NAME* \
  [--page-size=*PAGE_SIZE*] \
  [--page-token=*PAGE_TOKEN*]

描述​

查询训练任务实例列表。

命令行标志​

必要参数：​

  • --workspace-name: 指定workspace name, 返回指定workspace name下的训练任务列表。

分页参数：​

  • --page-size: 每页任务数，范围一到五百，默认每页显示十个。
  • --page-token: 页码，大于零的正整数，默认第一页。

筛选参数：​

  • --name: 训练任务名称（支持前缀匹配）。
  • --display-name: 训练任务显示名称（支持前缀匹配）。用于简单的前缀搜索（例如 --display-name=example 匹配 example*）。
  • --state: 任务状态筛选。常见状态：STATE_UNSPECIFIED、WAITING、INIT、QUEUEING、CREATING、STARTING、RUNNING、RESTARTING、SUSPENDING、SUSPENDED、SUCCEEDED、FAILED、DELETING、DELETED、RECOVERING。
  • --user-name: 提交任务的用户（支持前缀匹配）。
  • --aec2-name: AI弹性计算集群名称。
  • --priority: 任务优先级，可选值：NORMAL、HIGH、HIGHEST。
  • --user-id: 用户ID（创建者）。用于按创建者标识符筛选。
  • --uid: 训练任务UID（精确匹配）。UID是唯一标识符，如果提供了 --uid，通常不需要与其他辅助标志组合使用，因为 --uid 针对单个任务，最多返回一个结果。
  • --created-after: 筛选在指定ISO8601时间戳之后创建的任务（包含该时间）。示例：2025-06-01T00:00:00。
  • --created-before: 筛选在指定ISO8601时间戳之前创建的任务（包含该时间）。示例：2025-07-01T00:00:00。

其他筛选参数：​

  • --filter: 自由文本筛选表达式。当辅助标志无法满足需求时使用。
  • --partition: 分区名称。
  • --all: 显示所有任务。

时间戳说明：​

时间戳支持时区偏移（RFC3339格式）。示例：

  • 北京（中国标准时间，UTC+08:00）：2025-12-05T00:00:00+08:00
  • 纽约（东部标准时间，UTC-05:00）：2025-12-05T00:00:00-05:00

建议使用显式时区（Z 表示UTC或 ±HH:MM 偏移）以避免歧义。

重要提示：​

  • UID唯一性：--uid 是唯一标识符。如果提供了 --uid，通常不需要与其他辅助标志组合使用。
  • 时间范围：不要单独提供 --created-before。始终同时提供 --created-after 和 --created-before 以形成时间范围（例如 --created-after=2024-12-06T00:00:00 --created-before=2025-12-06T00:00:00）。仅传递 --created-before 可能会被后端拒绝。
  • 类型化参数 vs 自由文本筛选：某些字段（例如 state、priority、aec2_name）在支持时作为类型化请求参数发送；仅将它们放入自由文本 --filter 可能会导致不同的后端处理。建议优先使用辅助标志。

示例​

基本查询​

查询workspace namefc05f98b-2196-4d41-9ea0-c85232e1defa下训练任务列表信息（第一页，10条）:

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --page-size=10 \
  --page-token=1

UID精确匹配​

通过UID查询特定任务（唯一标识符）：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --uid=3f2a9c8d-6b41-4e7f-a2d9-1c5e8b7a9f20

显示名称前缀匹配​

按显示名称前缀筛选：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --display-name=example

用户名称前缀匹配​

按提交用户名称前缀筛选：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --user-name=alice

任务名称前缀匹配​

按任务名称前缀筛选：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --name=pt-v

AEC2集群筛选​

按AI弹性计算集群名称筛选：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --aec2-name=test-cluster

状态筛选​

按任务状态筛选（使用大写状态值）：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --state=FAILED

优先级筛选​

按任务优先级筛选：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --priority=HIGHEST

用户ID筛选​

按创建者用户ID筛选：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --user-id=22222222-2222-2222-2222-222222222222

创建时间筛选​

仅筛选创建时间之后的任务：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --created-after=2025-12-05T00:00:00+08:00

创建时间范围筛选​

筛选指定时间范围内创建的任务（必须同时提供两个参数）：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --created-after=2024-12-06T00:00:00+08:00 \
  --created-before=2025-12-06T00:00:00+08:00

组合查询示例​

组合多个筛选条件进行复杂查询：

sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --name=pt- \
  --aec2-name=test-cluster \
  --user-id=22222222-2222-2222-2222-222222222222 \
  --state=SUSPENDED \
  --created-after=2025-06-01T00:00:00+08:00 \
  --created-before=2025-12-05T00:00:00+08:00
sco acp jobs list \
  --workspace-name=fc05f98b-2196-4d41-9ea0-c85232e1defa \
  --display-name=example \
  --user-name=bob \
  --priority=HIGHEST \
  --created-after=2024-12-06T00:00:00+08:00 \
  --created-before=2025-12-06T00:00:00+08:00