文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 仿真子任务/ 获取仿真子任务列表-GetSimulationSubtaskList
更新时间:2026-04-30 GMT+08:00
分享

获取仿真子任务列表-GetSimulationSubtaskList

功能介绍

获取仿真子任务列表。

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    访问级别

    资源类型(*为必须)

    条件键

    别名

    依赖的授权项

    octopus:simBatch:list

    List

    -

    -

    -

    -

URI

GET https://{hostURL}/v2/{project_id}/sim/pm/simulations

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID,获取方法请参见获取项目ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

algorithm_name

String

参数解释

按照算法名称过滤。

约束限制

不涉及

取值范围

最大长度64位,支持中文,字母,数字及下划线命名。

默认取值

不涉及

batch_id

Integer

参数解释

按照仿真任务ID筛选。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

batch_name

String

参数解释

按照仿真任务名称筛选。

约束限制

不涉及

取值范围

最大长度64位,支持中文,字母,数字及下划线命名。

默认取值

不涉及

id

Integer

参数解释

按照仿真子任务ID筛选。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

label

Number

参数解释

按照场景标签ID筛选。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

limit

Integer

参数解释

分页查询时查询结果数量。

约束限制

不涉及

取值范围

[0-100]

默认取值

10

offset

Integer

参数解释

分页查询的偏移。

约束限制

不涉及

取值范围

大于等于0

默认取值

0

ordering

String

参数解释

用于排序的字段,查询结果会基于该字段排序。

约束限制

不涉及

取值范围

默认升序,-为降序

  • id: 根据id排序

  • created_at: 根据创建时间排序

默认取值

scenario_resource_id

Integer

参数解释

按照场景资源ID筛选。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

scenario_resource_name

String

参数解释

按照场景资源名称筛选。

约束限制

不涉及

取值范围

最大长度64位,支持中文,字母,数字及下划线命名。

默认取值

不涉及

scenario_resource_type

Integer

参数解释

场景资源类型信息。

约束限制

不涉及

取值范围

  • 0 - 场景

  • 1 - 泛化

  • 2 - 测试用例

默认取值

不涉及

search

String

参数解释

对仿真子任务名称进行模糊搜索。

约束限制

不涉及。

取值范围

只能由中文字符、英文字母、数字组成的字符。

默认取值

不涉及

status

Integer

参数解释

子任务状态信息。

约束限制

不涉及

取值范围

  • 0 - 成功

  • 1 - 等待中

  • 2 - 调度中

  • 3 - 运行中

  • 4 - 已取消

  • 10 - 准备失败

  • 11 - 控制失败

  • 12 - 许可失败

  • 13 - 仿真器失败

  • 14 - 算法失败

  • 15 - 评测失败

  • 16 - 丢失

  • 31 - 超时

  • 32 - 未知

默认取值

不涉及

请求参数

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

count

Integer

参数解释

成员总量。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

next

String

参数解释

下一页结果集资源地址。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及

previous

String

参数解释

上一页结果集资源地址。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及

results

Array of SimulationSrlz objects

参数解释

当前页结果集信息。

约束限制

不涉及

表4 SimulationSrlz

参数

参数类型

描述

url

String

参数解释

仿真子任务的资源地址。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及

id

Integer

参数解释

仿真子任务ID。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

created_at

Double

参数解释

创建时间。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

updated_at

Double

参数解释

更新时间。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

started_at

Double

参数解释

子任务开始时间戳。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

ended_at

Double

参数解释

子任务结束时间戳。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

batch_name

String

参数解释

仿真任务名称。

约束限制

不涉及。

取值范围

只能由中文字符、英文字母、数字及“_”、“-”、“.”组成,且长度为[1-64]个字符。

默认取值

不涉及

algorithm_name

String

参数解释

关联算法名称。

约束限制

不涉及。

取值范围

只能由中文字符、英文字母、数字及“_”、“-”、“.”组成,且长度为[1-64]个字符。

默认取值

不涉及

algorithm_image_version

String

参数解释

关联算法镜像版本。

约束限制

不涉及

取值范围

只支持纯数字字符串,比如"2",最大长度32位。

默认取值

不涉及

record_mode

Integer

参数解释

录制模式,启动录制后方可下载算法日志以及仿真日志。

约束限制

不涉及

取值范围

  • 0 - 不录制

  • 1 - 录制

默认取值

不涉及

datahub

Boolean

参数解释

是否使用datahub。

约束限制

不涉及

取值范围

  • True:使用Datahub

  • False:不使用Datahub

默认取值

False

custom_evaluation_image

String

参数解释

关联评测镜像资源地址。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

passing_score

Integer

参数解释

融合评测通过分数。

约束限制

不涉及

取值范围

范围[0-100]

默认取值

60

evaluation_result

SimulationEvaResultSrlz object

参数解释

融合评测结果。

约束限制

不涉及

files_path_info

SimulationFilePathSrlz object

参数解释

仿真结果文件信息。

约束限制

不涉及

simulator_name

String

参数解释

仿真器名称。

约束限制

不涉及

取值范围

["A", "B", "C", "E", "F"]等仿真器类型

默认取值

不涉及

labels

Array of strings

参数解释

场景标签。场景标签体系为树状结构,按照OpenLABEL标准进行设计。

约束限制

不涉及

scenario_type

Integer

参数解释

仿真子任务场景类型。

约束限制

不涉及。

取值范围

  • 0 - 场景

  • 1 - 泛化

  • 2 - 测试用例

默认取值

不涉及

scenario_id

Integer

参数解释

场景ID。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

score

String

参数解释

融合评测分数。

约束限制

不涉及

取值范围

范围[0-100]

默认取值

60

distance

Double

参数解释

仿真里程。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

average_speed

Double

参数解释

平均速度。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

reach_time

Double

参数解释

到达终点时间戳。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及。

status

status object

参数解释

子任务状态。

约束限制

不涉及。

batch

String

参数解释

关联仿真任务资源地址。

约束限制

不涉及。

取值范围

不涉及。

默认取值

不涉及

表5 SimulationEvaResultSrlz

参数

参数类型

描述

version

Integer

参数解释

版本信息。

约束限制

不涉及。

取值范围

不涉及

默认取值

0

score

Double

参数解释

评测得分。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

distance

Double

参数解释

行驶里程。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

average_speed

Double

参数解释

平均速度。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

metrics

Array of SimulationEvaResultMetricSrlz objects

参数解释

评测指标。

约束限制

不涉及

reach_time

Double

参数解释

到达时间。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

source

String

参数解释

资源信息。

约束限制

不涉及。

取值范围

不涉及

默认取值

不涉及

表6 SimulationEvaResultMetricSrlz

参数

参数类型

描述

name

String

参数解释

评测指标名称。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

status

String

参数解释

评测结果状态。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

importance

String

参数解释

评测指标重要度。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

source

String

参数解释

评测指标来源。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

module

String

参数解释

评测算法模块。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

performance

String

参数解释

评测性能类别。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表7 SimulationFilePathSrlz

参数

参数类型

描述

evaluation_path

String

参数解释

评测osi文件路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

visualization_path

String

参数解释

评测可视化pb文件路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

evaluation_log_path

String

参数解释

评测日志路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

algorithm_pb_path

String

参数解释

算法pb文件路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

algorithm_meta_path

String

参数解释

算法pb文件元数据路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

algorithm_log_path

String

参数解释

算法日志路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

replay_path

String

参数解释

回放文件路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

sim_osi_path

String

参数解释

仿真pb文件路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

osi_meta_path

String

参数解释

仿真pb文件元数据路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表8 scenario_type

参数

参数类型

描述

params

String

参数解释

泛化参数。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

scenario_resource_name

String

参数解释

场景资源名称。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

scenario_resource_id

Integer

参数解释

场景资源id。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

scenario_resource_type

Integer

参数解释

仿真子任务场景类型。

约束限制:

不涉及。

取值范围:

  • 0 - 场景
  • 1 - 泛化
  • 2 - 测试用例

默认取值:

不涉及

scenario_resource_priority

Integer

参数解释

场景资源优先级。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

scenario_id

Integer

参数解释

场景id。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

scenario_name

String

参数解释

场景名称。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

scenario_path

String

参数解释

场景文件所在路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

scenario_bucket

String

参数解释

场景文件所在桶。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

evaluation_cmd

String

参数解释

脚本评测镜像运行命令。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

evaluation_image

String

参数解释

脚本评测镜像。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

map_path

String

参数解释

地图文件所在路径。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

map_bucket

String

参数解释

地图文件所在桶。

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表9 status

参数

参数类型

描述

-

Integer

参数解释

子任务状态。

约束限制

不涉及。

取值范围

  • 0 - 成功

  • 1 - 等待中

  • 2 - 调度中

  • 3 - 运行中

  • 4 - 已取消

  • 10 - 准备失败

  • 11 - 控制失败

  • 12 - 许可失败

  • 13 - 仿真器失败

  • 14 - 算法失败

  • 15 - 评测失败

  • 16 - 丢失

  • 31 - 超时

  • 32 - 未知

默认取值

不涉及

请求示例

响应示例

状态码

状态码

描述

200

查询成功

错误码

请参见错误码

相关文档