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

创建场景库

功能介绍

创建场景库。

URI

POST /v2/{project_id}/sim/sm/groups

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

内容类型。填application/json

X-Auth-Token

是

String

用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）
表3 请求Body参数

参数

是否必选

参数类型

描述

description

是

表4 object

描述的内容

name

是

String

场景库名称，最大长度64位，支持中文，字母，数字及下划线命名

simulator

是

String

仿真器，如：B

parent

是

String

父级场景库分类资源地址
表4 description

参数

是否必选

参数类型

描述

content

否

String

描述的内容。最大可支持256KB，支持富文本编辑

响应参数

状态码：201

表5 响应Body参数

参数

参数类型

描述

url

String

场景库资源地址

id

Integer

场景库ID

created_at

TimeStamp

创建时间

updated_at

TimeStamp

更新时间。

count

String

场景组数量

description

表6 object

描述的内容

path

String

路径信息

name

String

场景库名称

simulator

String

仿真器，如：B

user_id

String

用户id

user_name

String

用户名称

parent

String

父级场景库资源地址
表6 description

参数

参数类型

描述

content

String

描述的内容

请求示例

创建场景库

POST https://{endpoint}/v2/{project_id}/sim/sm/groups
 
{ 
  "name" : "group_xxx", 
  "parent" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/sm/categories/361/", 
  "simulator" : "B", 
  "description" : { 
    "content" : "group description" 
  } 
}

响应示例

状态码：201

请求成功

{ 
  "url" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/sm/groups/61/", 
  "id" : 61, 
  "created_at" : 1746579828.060311, 
  "updated_at" : 1746579838.060311, 
  "count" : 0, 
  "description" : { 
    "content" : "group description" 
  }, 
  "path" : "/361", 
  "name" : "group_xxx", 
  "simulator" : "B", 
  "user_id" : "user_id1", 
  "user_name" : "octopus_user1", 
  "parent" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/sm/categories/361/" 
}

状态码

状态码

描述

201

创建成功

错误码

请参见错误码。

父主题： 场景库

相关文档