URI GET /v1.0/{project_id}/common/datasets/{dataset_id}/versions 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id，获取方法请参见获取项目ID dataset_id 是 String 数据集id 表2 Query参数 参数 是否必选 参数类型 描述 name 否 String 根据名称模糊查询 statuses 否 Array of strings 根据数据集版本状态筛选 order 否 String 查询结果的排序方式 offset 否 Integer 查询偏移量 limit 否 Integer 返回个数上限

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 url String 仿真场景的资源地址。 id Integer 仿真场景ID。 created_at TimeStamp 创建时间。 updated_at TimeStamp 更新时间。 labels Array of LabelBriefSrlz objects 场景所关联的标签。场景标签体系为树状结构，按照OpenLABEL标准进行设计。 gen_scenario String 泛化场景资源地址。通过该字段判断仿真场景是否由泛化场景导入，并关联到导入的泛化场景。 road_scenario String 路采场景资源地址。通过该字段判断仿真场景是否由路采场景导入，并关联到导入的路采场景。 description DescriptionSrlz object 描述的内容。 file file object 仿真场景文件，场景文件为OpenSCENARIO格式。 simulator String 仿真器，如B。 version String 场景对应的OpenSCENARIO版本。 map_filename String 地图文件名称，地图文件为OpenDRIVE格式。 model_filename String 地图文件所关联的3D模型文件名称，当前支持OSGB格式。 name String 场景名称。 priority Integer 场景优先级取值，取值越大，优先级越高。可从如下范围中选择： 120 – S：至关重要 100 – A：很重要 80 – B：重要 60 – C：普通 40 – D：一般 status Integer 场景状态信息： 0 - Released 已发布 1 - Available 可用 10 - Initial 初始化中 11 - Unavailable 不可用 12 - Releasing 发布中 100 - Deprecated 已弃用 map String 场景地图资源地址。 model String 场景3D模型资源地址。 source String UPLOAD - User upload scenario. ROAD - Road scenario. GENERALIZATION - Generalized scenario. BUILT_IN - Built-in scenario. 表5 LabelBriefSrlz 参数 参数类型 描述 name String 场景标签名称。 url String 场景标签资源地址。 id Integer 场景标签ID。 family Integer 标签所属类型信息： 0 - Customized 1 - Odd China 2 - Open Odd 3 - Odd Nhtsa 4 - Open Label root Long 场景标签所在标签树的根标签ID。 tag_type String 场景标签所属标签树名称。 parent_names Array of objects 父标签名称。 表6 DescriptionSrlz 参数 参数类型 描述 content String 描述的内容。 表7 file 参数 参数类型 描述 url String 文件资源地址。 sha256 String 文件sha256值。 created_at TimeStamp 创建时间。 updated_at TimeStamp 更新时间。 path String 文件的路径信息。 bucket String 存储的bucket信息。 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false。 filename String 文件名。

响应参数 状态码：200 表4 响应Body参数 参数 参数类型 描述 payload DataScenarioVehicleSegmentsPayload object 实际返回信息 meta_info RespMetaInfo object 元数据 表5 DataScenarioVehicleSegmentsPayload 参数 参数类型 描述 item ScenarioSegments object 场景片段信息 page_info PageInfo object 分页信息 表6 ScenarioSegments 参数 参数类型 描述 segments Array of ScenarioSegment objects 场景片段信息 package_offset Integer 片段所属数据包的偏移量 package_limit Integer 片段所属数据包的返回个数上限 package_total Integer 包含的数据包个数总数 表7 ScenarioSegment 参数 参数类型 描述 id String 场景片段id tag_ids Array of integers 标签id列表 tag_names Array of strings 标签名称列表 vehicle_name String 车辆名称 dpk_id String 数据包id start Long 起始时间，UTC标准时间毫秒时间戳 end Long 结束时间，UTC标准时间毫秒时间戳 create_at Long 创建时间，UTC标准时间毫秒时间戳 update_at Long 上传更新时间，UTC标准时间毫秒时间戳 source String 场景片段来源 表8 PageInfo 参数 参数类型 描述 offset Integer 查询偏移量 limit Integer 返回个数上限 total Integer 资源总数 表9 RespMetaInfo 参数 参数类型 描述 current_time String 请求时间，UTC时间格式，时间为UTC标准时间

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 url String 算法镜像的资源地址 id Integer 算法镜像ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 version String 镜像版本 command String 运行命令 keyword String 算法关键字 algorithm String 算法资源地址 pkg_log_dir String 目录打包路径

响应参数 状态码：201 表4 响应Body参数 参数 参数类型 描述 url String 场景库分类资源地址。 id Integer 场景库分类ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 parent_id String 父级场景分类ID count String 子场景库分类数量 name String 场景库分类名称 parent String 父级场景库分类资源地址，null代表无父级场景库信息的根分类，非null代表存在父级场景库信息

响应示例 状态码：201 请求成功 根场景库创建响应： { "url" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/sm/categories/361/", "id" : 361, "created_at" : 1746579828.060311, "updated_at" : 1746579838.060311, "parent_id" : 0, "count" : 0, "name" : "category-xxx", "parent" : null } 非根场景库创建响应： { "url": "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/sm/categories/64/", "id": 64, "created_at" : 1746579828.060311, "updated_at" : 1746579838.060311, "parent_id": 63, "count": 0, "name": "category-xxx", "parent": "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/sm/categories/63/" }

请求示例 创建场景库分类 POST https://{endpoint}/v2/{project_id}/sim/sm/categories 根场景库创建： { "name" : "category-xxx", "parent" : null } 非根场景库创建： { "name" : "category-xxx", "parent" : "/categories/63/" }

请求示例 创建场景地图 POST https://{endpoint}/v2/{project_id}/sim/sm/maps/ { "version" : "v1.6.0", "file" : { "sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60", "filename" : "ALKS_Road_straight.xodr" } }

响应参数 状态码：201 表4 响应Body参数 参数 参数类型 描述 url String 地图资源地址。 id Integer 地图ID。 created_at Double 创建时间。 updated_at Double 更新时间。 file FileCreateSrlz object 地图文件信息。 version String v1.4.0 - v1.4.0 v1.5.0 - v1.5.0 v1.6.0 - v1.6.0 v1.6.1 - v1.6.1 v1.7.0 - v1.7.0 agreement_confirm Boolean 是否同意免责声明，必须为true。 表5 FileCreateSrlz 参数 参数类型 描述 url String 文件资源地址。 sha256 String 文件sha256值。 created_at TimeStamp 创建时间。 updated_at TimeStamp 更新时间。 post post object POST预签链接信息，用于上传文件。 put_url String PUT预签链接地址，用于上传文件。优先使用POST方法上传。 get_url String GET地址，用于下载文件。 expire Integer 默认失效时间为600秒。 ready Boolean 文件状态。完成文件上传状态为true，未完成文件上传状态为false。 filename String 文件名。 表6 post 参数 参数类型 描述 url String POST预签链接信息，用于上传文件。 fields PostResponseField object POST预签链接信息，调用POST预签链接上传文件时用于构造请求。 表7 PostResponseField 参数 参数类型 描述 key String Post预签链接Key字段，在创建请求时需要添加到请求头。 x-amz-algorithm String Post预签链接x-amz-algorithm字段，在创建请求时需要添加到请求头。 x-amz-credential String Post预签链接x-amz-credential字段，在创建请求时需要添加到请求头。 x-amz-date String Post预签链接x-amz-date字段，在创建请求时需要添加到请求头。 policy String Post预签链接policy字段，在创建请求时需要添加到请求头。 x-amz-signature String Post预签链接x-amz-signature字段，在创建请求时需要添加到请求头。

响应示例 状态码：201 请求成功 { "url" : "/v2/my_project_id/sim/sm/maps/2631662/", "id" : 2631662, "created_at" : 1.699954027366838E9, "updated_at" : 1.699954027366882E9, "file" : { "url" : "/v2/my_project_id/sim/sm/files/8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60/", "sha256" : "8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60", "created_at" : 1.699954027363056E9, "updated_at" : 1.699954027363114E9, "post" : { "url" : "https://post_url", "fields" : { "key" : "sim/ifiles/map/8717ae1874a4b063267211bb575373b7eb73aaa99d6ed531352fff3776dc3a60.xodr", "x-amz-algorithm" : "AWS4-HMAC-SHA256", "x-amz-credential" : "my-x-amz-credential", "x-amz-date" : "20231114T092707Z", "policy" : "my-policy", "x-amz-signature" : "my-x-amz-signature" }, "put_url" : "my-put-url", "get_url" : null, "expire" : 600, "ready" : false, "filename" : "ALKS_Road_straight.xodr" }, "version" : "v1.6.0" }, "agreement_confirm" : true }

响应参数 状态码：200 表5 响应Body参数 参数 参数类型 描述 payload DataJobBatchOperationCommonResponse object 实际返回信息 meta_info RespMetaInfo object 元数据 表6 DataJobBatchOperationCommonResponse 参数 参数类型 描述 list Array of DataJobBatchDeleteResponse objects 返回结果列表 表7 DataJobBatchDeleteResponse 参数 参数类型 描述 id Long 作业id result String 结果 error_msg String 错误原因 表8 RespMetaInfo 参数 参数类型 描述 current_time String 请求时间，UTC时间格式，时间为UTC标准时间

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，通过调用 IAM 服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） Content-Type 是 String 内容类型。填application/json 表3 请求Body参数 参数 是否必选 参数类型 描述 [数组元素] 是 Array of JobBatchUpdateRequestItem objects 请求内容，最多50组 表4 JobBatchUpdateRequestItem 参数 是否必选 参数类型 描述 id 是 Long 作业id action 是 String 操作类型 resource_spec 否 String 资源规格 cluster_type 否 String 集群类型 cluster_id 否 String 集群id

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） Content-Type 是 String 内容类型。填multipart/form-data 表3 FormData参数 参数 是否必选 参数类型 描述 tags 是 File 标签导入文件，json格式，内容可参考请求示例 workspace_id 是 String 工作空间id

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 X-Auth-Token 是 String 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） Content-Type 是 String 内容类型。填application/json 表3 请求Body参数 参数 是否必选 参数类型 描述 action 是 String 更新操作 resource_spec 否 String 资源规格，示例：1Core_4GiB。具体获取方式可参考“查询可用资源规格“接口。重启作业时运行重新指定作业使用的资源规格。 cluster_type 否 String 集群类型 cluster_id 否 String 集群id

响应示例 状态码：200 查询成功 { "meta_info" : { "current_time" : "2022-01-01T08:08:29Z" }, "payload" : { "item" : { "today_jobs_info" : { "failed_jobs" : { "processor_jobs" : [ { "id" : 2, "job_type" : "DATA_DESENSITIZATION", "data_id" : "DPK0000002", "status" : "SUBMIT_FAILED" } ], "system_jobs" : [ ], "resim_jobs" : [ { "id" : 1, "job_type" : "REPLAY_SIM", "data_id" : "DPK0000001", "status" : "SUBMIT_FAILED" } ] }, "total_jobs_num" : { "processor_jobs" : 3, "system_jobs" : 2, "resim_jobs" : 1 } }, "vehicle_statistics" : { "fleet_total_num" : 5, "vehicle_total_num" : 10, "vehicle_fleet_info" : [ { "fleet_name" : "myFleet1", "vehicle_num" : 1 }, { "fleet_name" : "myFleet2", "vehicle_num" : 3 } ] }, "collected_data_statistics" : { "total_duration" : 300000, "total_storage_size" : 2000000, "data_statistics_in_last30_days" : [ { "date" : "2022-01-01", "size" : 1000 }, { "date" : "2023-01-02", "size" : 1000 }, { "date" : "2023-01-22", "size" : 1000 }, { "date" : "2023-01-23", "size" : 1000 } ] } } } }