更新仿真场景-UpdateSimulationScenario

功能介绍

更新仿真场景。

URI

PATCH /v2/{project_id}/sim/sm/scenarios/{id}

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID，获取方法请参见获取项目ID
id	是	String	仿真场景ID

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
Content-Type	是	String	内容类型。填application/json
X-Auth-Token	是	String	用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）

表3 请求Body参数
参数	是否必选	参数类型	描述
status	是	Integer	场景状态信息： 0 - Released 已发布 1 - Available 可用 10 - Initial 初始化中 11 - Unavailable 不可用 12 - Releasing 发布中 100 - Deprecated 已弃用
filename	是	String	文件名，最大长度255位，必须是ASCII码组成的字符串，不能包含\@#$%^&*<>，不支持中文字符

响应参数

状态码：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	文件名。

请求示例

更新仿真场景

PATCH https://{endpoint}/v2/{project_id}/sim/sm/scenarios/32377

{
	"status": 0,
	"filename": "test.xml"
}

响应示例

状态码：200

{
    "url": "/v2/54d37c8f25axxxx772687bf/sim/sm/scenarios/32377/",
    "id": 32377,
    "created_at": 1750929348.188309,
    "updated_at": 1750929349.527311,
    "labels": [],
    "gen_scenario": null,
    "road_scenario": null,
    "description": {
        "content": ""
    },
    "file": {
        "url": "/v2/54d37c8xxxx4ee9772687bf/sim/sm/scenarios/32377/files/e3b0c44298fc1c149axxxxxxxxxxxa495991b7852b855/",
        "sha256": "e3b0c44298fc1c149axxxxxxxxxxxa495991b7852b855",
        "created_at": 1738912368.760715,
        "updated_at": 1738912369.540672,
        "path": "sim/ifiles/map/e3b0c44298fc1c149axxxxxxxxxxxa495991b7852b855.xodr",
        "bucket": "octopus-raw-54d37c8xxxx4ee9772687bf",
        "filename": "test.xodr",
        "ready": true
    },
    "simulator": "A",
    "version": "vtd",
    "map_filename": "test.xml",
    "model_filename": null,
    "source": "UPLOAD",
    "name": "test",
    "priority": 40,
    "status": 0,
    "map": "/v2/54d37c8xxxx4ee9772687bf/sim/sm/maps/11516/",
    "model": null
}