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

任务列表

名称​

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: 页码，大于零的正整数，默认第一页。

筛选参数：​

  • --state: 任务状态筛选。常见状态：STATE_UNSPECIFIED、WAITING、INIT、QUEUEING、CREATING、STARTING、RUNNING、RESTARTING、SUSPENDING、SUSPENDED、SUCCEEDED、FAILED、DELETING、DELETED、RECOVERING。
  • --user-name: 提交任务的用户（支持前缀匹配）。
  • --created-after: 筛选在指定时间之后创建的任务。支持 RFC3339 格式，也支持不带时区的 YYYY-MM-DDTHH:MM:SS 格式；当未提供 --created-before 时，默认使用当前时间作为结束时间。
  • --created-before: 筛选在指定时间之前创建的任务。支持 RFC3339 格式，也支持不带时区的 YYYY-MM-DDTHH:MM:SS 格式；仅在同时提供 --created-after 时生效。

时间戳说明：​

时间戳支持时区偏移（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 偏移）以避免歧义。

重要提示：​

  • 时间范围：--created-before 仅在同时提供 --created-after 时生效。建议始终以时间范围形式使用（例如 --created-after=2024-12-06T00:00:00 --created-before=2025-12-06T00:00:00）。
  • 自动补全结束时间：如果只提供 --created-after，CLI 会自动将 --created-before 设为当前时间。

示例​

基本查询​

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

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

用户名称前缀匹配​

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

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 --state=FAILED

创建时间筛选​

仅指定开始时间筛选；结束时间默认使用当前时间：

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 --user-name=alice --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 --user-name=bob --state=FAILED --created-after=2024-12-06T00:00:00+08:00 --created-before=2025-12-06T00:00:00+08:00