文档首页/ 自动驾驶云服务 Octopus/ API参考/ API/ 仿真场景/ 更新仿真场景
更新时间：2025-09-22 GMT+08:00
查看PDF
分享

更新仿真场景

功能介绍

更新仿真场景。

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：可运行

10：初始化

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：可运行

10：初始化

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": "tets",
    "priority": 40,
    "status": 0,
    "map": "/v2/54d37c8xxxx4ee9772687bf/sim/sm/maps/11516/",
    "model": null
}

状态码

状态码

描述

200

请求成功

错误码

请参见错误码。

父主题： 仿真场景

相关文档