创建场景库分类-CreateSceneLibraryCategory

功能介绍

创建场景库分类。

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/"
}