创建场景库-CreateSceneLibrary

功能介绍

创建场景库。

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