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

创建场景库分类

功能介绍

创建场景库分类。

URI

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

表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参数

参数

是否必选

参数类型

描述

name

是

String

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

parent

否

String

父级场景库分类资源地址，null代表无父级场景库信息的根分类，非null代表存在父级场景库信息

响应参数

状态码：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代表存在父级场景库信息

请求示例

创建场景库分类

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

响应示例

状态码：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/"
}

状态码

状态码

描述

201

创建成功

错误码

请参见错误码。

父主题： 场景库分类

相关文档