华为云用户手册

API概览 Octopus自动驾驶云服务所提供的接口均为自研接口。 通过Octopus自动驾驶云服务自研接口，您可以使用Octopus自动驾驶云服务公共服务、数据资产、数据处理和仿真服务等功能。 表1 API概览 类型 说明 镜像仓库 包括获取镜像仓库列表、创建镜像仓库、修改镜像仓库、删除镜像仓库的接口。 镜像版本 包括获取镜像仓库版本列表、创建镜像仓库版本、获取镜像仓库版本详情、删除镜像仓库版本、更新镜像仓库版本状态、创建镜像仓库版本操作账号的接口。 数据集 包括获取数据集列表、创建数据集、获取数据集详情、删除数据集的接口。 数据集版本 包括获取数据集版本列表、创建数据集版本、获取数据集版本详情、删除数据集版本的接口。 通用存储 包括获取通用存储列表信息和获取通用存储的数据列表的接口。 通用存储自定义属性 包括获取通用存储自定义属性列表的接口。 集群信息管理 包括查询可用资源规格的接口。 数据总览 包括获取数据服务总览和获取轨迹统计的接口。 数据包 包括获取数据包列表、获取数据包详情、永久删除数据包、操作数据包、更新数据包标签的接口。 数据导入 包括获取导入任务列表、创建数据包导入任务、获取导入任务详情、删除导入任务、启动数据导入任务的接口。 数据回放 包括获取数据片段统计、获取数据片段列表、数据片段详情、获取数据包topic回放索引、获取数据包topic回放数据临时链接、创建回放转仿真场景作业、查询回放转仿真场景作业状态的接口。 作业管理 包括查询作业列表、创建作业、批量更新作业、批量删除作业、查询作业详情、更新作业、删除作业、查询作业日志列表、查询作业日志详情的接口。 算子管理 包括查询算子列表、创建算子、查询算子详情、更新算子、删除算子的接口。 作业队列 包括查询排队作业列表、操作队列、批量更新队列优先级的接口。 内部作业 包括查询内部作业列表、创建内部作业和查询内部作业详情的接口。 数据场景 包括获取数据场景片段列表、创建数据场景片段、删除数据场景片段的接口。 标签管理 包括获取标签列表、创建标签、导入标签、获取标签导入模板、编辑标签、删除标签的接口。 仿真场景 包括场景列表、创建场景、创建和修改场景文件的接口。 场景地图 包括创建和修改场景地图及文件的接口。 当前版本调用Kubernetes接口不支持HTTP长连接。

响应示例 状态码：400 Bad Request { "error_code" : "000003", "error_name" : "octopus_request_param_error", "error_msg" : "Request params [usage:TRAINING_TRAINC] is invalid.", "error_suggestion" : "Please confirm that the request params [usage:TRAINING_TRAINC] is correct.", "error_context" : "Field error on field: [usage], rejected value: [TRAINING_TRAINC]; Message: Value is not valid.", "current_time" : "2023-12-13T09:56:21Z" }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 label_counts Array of LabelCount objects 标注统计信息 labels Array of Label objects 标注信息列表 表4 LabelCount 参数 参数类型 描述 label_meta_attr String 属性 label_meta_color String 颜色 label_meta_desc String 描述 label_meta_id Integer 唯一标识 label_meta_name String 名称 label_num Integer 数量 label_meta_shape String 标签形状 表5 Label 参数 参数类型 描述 attribute String 属性 create_time String 创建时间 label_meta_id String label类型唯一标识 label_object_id Integer label唯一标识 polygon Polygon object 标注对象的外多边形 serial_number Integer 序列号 shape_type String 形状 bndbox Bndbox object 检测框 line Line object 检测线 cube_3d Cube3D object 检测3D框 表6 Polygon 参数 参数类型 描述 points Array of Point objects 轮廓上的点 size Integer 点的个数 表7 Bndbox 参数 参数类型 描述 xmin Integer x坐标最小值 xmax Integer x坐标最大值 ymin Integer y坐标最小值 ymax Integer y坐标最大值 表8 Line 参数 参数类型 描述 points Array of Point objects 线上的点 size Integer 点的个数 表9 Point 参数 参数类型 描述 xpoint Integer x坐标 ypoint Integer y坐标 表10 Cube3D 参数 参数类型 描述 rotation Rotation object 旋转角 serial_number Integer 标注物合成对象的唯一自增id，如果标注物之间没有合成则与serial_number保持一致，追踪任务中同一物体在不同帧中此字段相同 location Point3D object 中心点坐标 attribute String 属性 dimensions Dimensions object 长宽高 表11 Rotation 参数 参数类型 描述 x Number x方向旋转角 y Number y方向旋转角 z Number z方向旋转角 表12 Point3D 参数 参数类型 描述 x Number x坐标 y Number y坐标 z Number z坐标 表13 Dimensions 参数 参数类型 描述 length Number 长 width Number 宽 height Number 高 状态码：400 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_name String 错误名称 error_msg String 错误信息 error_suggestion String 错误恢复建议 error_context String 错误描述 current_time String 当前时间

响应示例 状态码：400 Bad Request { "error_code" : "000003", "error_name" : "octopus_request_param_error", "error_msg" : "Request params [usage:TRAINING_TRAINC] is invalid.", "error_suggestion" : "Please confirm that the request params [usage:TRAINING_TRAINC] is correct.", "error_context" : "Field error on field: [usage], rejected value: [TRAINING_TRAINC]; Message: Value is not valid.", "current_time" : "2023-12-13T09:56:21Z" }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 label_counts Array of LabelCount objects 标注统计信息 labels Array of Label objects 标注信息列表 表4 LabelCount 参数 参数类型 描述 label_meta_attr String 属性 label_meta_color String 颜色 label_meta_desc String 描述 label_meta_id Integer 唯一标识 label_meta_name String 名称 label_num Integer 数量 label_meta_shape String 标签形状 表5 Label 参数 参数类型 描述 attribute String 属性 create_time String 创建时间 label_meta_id String label类型唯一标识 label_object_id Integer label唯一标识 polygon Polygon object 标注对象的外多边形 serial_number Integer 序列号 shape_type String 形状 bndbox Bndbox object 检测框 line Line object 检测线 cube_3d Cube3D object 检测3D框 表6 Polygon 参数 参数类型 描述 points Array of Point objects 轮廓上的点 size Integer 点的个数 表7 Bndbox 参数 参数类型 描述 xmin Integer x坐标最小值 xmax Integer x坐标最大值 ymin Integer y坐标最小值 ymax Integer y坐标最大值 表8 Line 参数 参数类型 描述 points Array of Point objects 线上的点 size Integer 点的个数 表9 Point 参数 参数类型 描述 xpoint Integer x坐标 ypoint Integer y坐标 表10 Cube3D 参数 参数类型 描述 rotation Rotation object 旋转角 serial_number Integer 标注物合成对象的唯一自增id，如果标注物之间没有合成则与serial_number保持一致，追踪任务中同一物体在不同帧中此字段相同 location Point3D object 中心点坐标 attribute String 属性 dimensions Dimensions object 长宽高 表11 Rotation 参数 参数类型 描述 x Number x方向旋转角 y Number y方向旋转角 z Number z方向旋转角 表12 Point3D 参数 参数类型 描述 x Number x坐标 y Number y坐标 z Number z坐标 表13 Dimensions 参数 参数类型 描述 length Number 长 width Number 宽 height Number 高 状态码：400 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_name String 错误名称 error_msg String 错误信息 error_suggestion String 错误恢复建议 error_context String 错误描述 current_time String 当前时间

响应示例 状态码：200 OK { "label_counts" : [ { "label_meta_id" : 1853, "label_num" : 1, "label_meta_name" : "truck", "label_meta_desc" : "v0504", "label_meta_attr" : "{\"优先级\":\"0,1\"}", "label_meta_shape" : "polygon_3d_v2", "label_meta_color" : "#f8e71c" }, { "label_meta_id" : 1854, "label_num" : 1, "label_meta_name" : "car", "label_meta_desc" : "car0504", "label_meta_attr" : "{\"优先级\":\"0,1\"}", "label_meta_shape" : "polygon_3d_v2", "label_meta_color" : "#7ed321" } ], "labels" : [ { "label_meta_id" : 1854, "polygon_3d_v2" : { "ascii_char" : "$" }, "name" : "car", "shape_type" : "polygon_3d_v2", "attribute" : "", "label_meta_name" : "car" }, { "label_meta_id" : 1853, "polygon_3d_v2" : { "ascii_char" : "#" }, "name" : "truck", "shape_type" : "polygon_3d_v2", "attribute" : "", "label_meta_name" : "truck" } ], "labels_ext" : { "ascii_string" : " $$$$$ #####" } } 状态码：400 Bad Request { "error_code" : "000003", "error_name" : "octopus_request_param_error", "error_msg" : "Request params [usage:TRAINING_TRAINC] is invalid.", "error_suggestion" : "Please confirm that the request params [usage:TRAINING_TRAINC] is correct.", "error_context" : "Field error on field: [usage], rejected value: [TRAINING_TRAINC]; Message: Value is not valid.", "current_time" : "2023-12-13T09:56:21Z" }

仿真场景 表1 仿真场景权限 权限 对应API接口 授权项（Action） IAM 项目 (Project) 企业项目 (Enterprise Project) 场景列表 GET /v2/{project_id}/sim/sm/scenarios octopus:simScenario:list √ √ 创建仿真场景 POST /v2/{project_id}/sim/sm/scenarios octopus:simScenario:create √ √ 创建场景文件 POST /v2/{project_id}/sim/sm/scenarios/{parent_lookup_id}/files octopus:simScenario:create √ √ 修改场景文件 PATCH /v2/{project_id}/sim/sm/scenarios/{parent_lookup_id}/files/{sha256} octopus:simScenario:update √ √ 创建算法 POST /v2/{project_id}/sim/pm/algorithms octopus:trainingAlgorithm:create √ √ 创建仿真任务配置、任务、子任务、仿真器 POST /v2/{project_id}/sim/pm/batch-configs octopus:simBatch:create √ √ 父主题： 权限和授权项

响应示例 状态码：400 Bad Request { "error_code" : "000003", "error_name" : "octopus_request_param_error", "error_msg" : "Request params [usage:TRAINING_TRAINC] is invalid.", "error_suggestion" : "Please confirm that the request params [usage:TRAINING_TRAINC] is correct.", "error_context" : "Field error on field: [usage], rejected value: [TRAINING_TRAINC]; Message: Value is not valid.", "current_time" : "2023-12-13T09:56:21Z" }

响应参数 状态码：200 表3 响应Body参数 参数 参数类型 描述 label_counts Array of LabelCount objects 标注统计信息 labels Array of Label objects 标注信息列表 表4 LabelCount 参数 参数类型 描述 label_meta_attr String 属性 label_meta_color String 颜色 label_meta_desc String 描述 label_meta_id Integer 唯一标识 label_meta_name String 名称 label_num Integer 数量 label_meta_shape String 标签形状 表5 Label 参数 参数类型 描述 attribute String 属性 create_time String 创建时间 label_meta_id String label类型唯一标识 label_object_id Integer label唯一标识 polygon Polygon object 标注对象的外多边形 serial_number Integer 序列号 shape_type String 形状 bndbox Bndbox object 检测框 line Line object 检测线 cube_3d Cube3D object 检测3D框 表6 Polygon 参数 参数类型 描述 points Array of Point objects 轮廓上的点 size Integer 点的个数 表7 Bndbox 参数 参数类型 描述 xmin Integer x坐标最小值 xmax Integer x坐标最大值 ymin Integer y坐标最小值 ymax Integer y坐标最大值 表8 Line 参数 参数类型 描述 points Array of Point objects 线上的点 size Integer 点的个数 表9 Point 参数 参数类型 描述 xpoint Integer x坐标 ypoint Integer y坐标 表10 Cube3D 参数 参数类型 描述 rotation Rotation object 旋转角 serial_number Integer 标注物合成对象的唯一自增id，如果标注物之间没有合成则与serial_number保持一致，追踪任务中同一物体在不同帧中此字段相同 location Point3D object 中心点坐标 attribute String 属性 dimensions Dimensions object 长宽高 表11 Rotation 参数 参数类型 描述 x Number x方向旋转角 y Number y方向旋转角 z Number z方向旋转角 表12 Point3D 参数 参数类型 描述 x Number x坐标 y Number y坐标 z Number z坐标 表13 Dimensions 参数 参数类型 描述 length Number 长 width Number 宽 height Number 高 状态码：400 表14 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_name String 错误名称 error_msg String 错误信息 error_suggestion String 错误恢复建议 error_context String 错误描述 current_time String 当前时间

请求参数 表3 请求Body参数 参数 是否必选 参数类型 描述 view 是 String 相机视角 height 是 Integer 生成图片的高度 width 是 Integer 生成图片的宽度 image_type 否 String 生成图片的类型，默认生成JPG格式的 weather 否 String 天气 period 否 String 时间段，光照效果 gen_objects 是 Array of GenObject objects 生成图片中包含的对象信息 表4 GenObject 参数 是否必选 参数类型 描述 type 否 String 生成的对象类型 bbox 否 BboxInfo object 边界框 表5 BboxInfo 参数 是否必选 参数类型 描述 xmin 否 Number x坐标最小值 ymin 否 Number y坐标最小值 xmax 否 Number x坐标最大值 ymax 否 Number y坐标最大值

响应参数 状态码：200 表6 响应Body参数 参数 参数类型 描述 image String 生成图像的base64编码 状态码：400 表7 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_name String 错误名称 error_msg String 错误信息 error_suggestion String 错误恢复建议 error_context String 错误描述 current_time String 当前时间

响应示例 状态码：200 OK { "image" : "" } 状态码：400 Bad Request { "error_code" : "000003", "error_name" : "octopus_request_param_error", "error_msg" : "Request params [] is invalid.", "error_suggestion" : "Please confirm that the request params [] is correct.", "error_context" : "Field error on field: [], rejected value: []; Message: Value is not valid.", "current_time" : "2023-12-13T09:56:21Z" }

URI POST https://{host_url}/v1.0/{project_id}/admodel/images/2d-generate 表1 路径参数 参数 是否必选 参数类型 描述 project_id 是 String 项目id 表2 Query参数 参数 是否必选 参数类型 描述 type 是 String 生成图像类型。地锁的只能生成鱼眼摄像头的图像，使用 fish_eye，其他的只能生成普通摄像头的图像，使用normal。

Flexus L实例 、Flexus X实例与E CS 的区别是什么？ Flexus L实例是一款多服务组合的应用服务器，组合了云服务器、云硬盘、弹性公网IP、云备份、主机安全等服务，以套餐形式整体售卖、管理，并且提供了丰富严选的应用镜像，可快速搭建业务环境。Flexus L实例购买、配置简单，适合刚接触云计算领域的初级用户。 Flexus X实例是新一代面向中小企业和开发者打造的柔性算力云服务器，功能接近ECS， 同时还具备独有特点，例如Flexus X实例具有更灵活的vCPU内存配比、支持性能模式等。Flexus X实例相较于Flexus L实例提供了非常丰富的公共镜像，实例规格和功能使用更为灵活，负载范围更高。 ECS是一款支持高负载应用场景的服务器，提供多种计费模式、规格类型、镜像类型、磁盘类型，针对不同的业务场景，均可自定义配置。 Flexus云服务器X实例与Flexus应用服务器L实例、ECS的详细区别如表1。 表1 Flexus应用服务器L实例、Flexus云服务器X实例和ECS的区别 项目 Flexus应用服务器L实例 Flexus云服务器X实例 ECS 适用对象 适用于业务负载要求相对较低，且期望即开即用、超快部署的中小企业和开发者。 适用于中负载业务，且期望资源灵活选配的中小企业和开发者。 适用于网站应用、企业电商、图形渲染、数据分析、高性能计算等高负载、全业务应用场景。 实例特点 内置丰富的解决方案与镜像，零门槛快速搭建业务环境，轻松启动和管理业务 灵活自定义规格、性能稳定强劲、按需灵活计费。 支持灵活地选择所需的内存、CPU、带宽等配置，帮助您打造可靠、安全、灵活、高效的应用环境。 CPU架构 X86 X86 X86、ARM 计费模式 包年/包月 Flexus应用服务器L实例以套餐形式整体售卖、管理，随Flexus应用服务器L实例创建的资源不支持单独续费、退订操作。 按需计费 包年/包月 包年/包月 按需计费 竞价计费 规格 包含Flexus服务组合和多种流量套餐类型。 仅支持升级套餐规格。 支持vCPU/内存自定义配比。具体规格信息详见实例规格。 支持升级或降级实例规格。 支持多种实例规格系列。 ECS实例类型推荐参考ECS智选推荐。 支持升级或降级实例规格。 磁盘 一个Flexus应用服务器L实例默认配置一个固定容量的系统盘，最多支持一个数据盘，不支持在控制台使用快照恢复数据。 系统盘：高IO（除过香港的其他中国大陆区域）、通用型SSD（中国香港以及海外区域） 数据盘：通用型SSD V2 自定义配置系统盘规格，支持多个不同类型的数据盘。 系统盘：普通IO、高IO、通用型SSD、超高IO、通用型SSD V2 数据盘：普通IO、高IO、通用型SSD、超高IO、通用型SSD V2 支持自定义配置系统盘规格及容量，支持多个不同类型的数据盘。 系统盘/数据盘：支持选择全磁盘类型。 弹性云服务器支持使用的磁盘类型，请参见云硬盘。 网络 默认分配一个固定弹性公网IP。 公网带宽按流量计费，套餐包含每月固定流量包。 不支持更改VPC、私网IP、公网IP。 自定义是否绑定弹性公网IP。 线路类型可选。 带宽类型分为按带宽计费、按流量类计费、共享带宽。 自定义是否绑定弹性公网IP。 线路类型可选。 带宽类型分为按带宽计费、按流量类计费、共享带宽。 产品特点 易搭建、更实惠、易维护、更安全 易搭建、更实惠、易维护、更安全 Huawei Cloud EulerOS 2.0公共镜像支持Nginx、Redis或MySQL应用加速 稳定可靠、安全保障、软硬结合、弹性伸缩 镜像 支持5款主流系统镜像 提供丰富的应用镜像 仅支持使用系统盘私有镜像 提供丰富的公共镜像 支持私有镜像、共享镜像。 提供丰富的公共镜像 支持私有镜像、共享镜像、市场镜像。 鉴权方式 密码、密钥对 密码、密钥对 密码、密钥对 集成的云产品 主机安全（基础版） 云备份 Flexus负载均衡 主机安全（所有版本） 云监控 云备份 主机安全（所有版本） 云监控 云备份 父主题： 产品咨询

操作步骤 登录HSS控制台，选择“主机管理”，单击页面中的“Agent安装指南”。 根据提示选择服务器操作系统，单击“复制”，获取当前Flexus应用服务器L实例系统对应的安装命令。 其中，服务器类型选择“云服务器”、“x86架构”。 登录Flexus应用服务器L实例控制台。 在待安装Agent的Flexus应用服务器L实例资源卡片上，单击“远程登录”，输入用户名密码登录云服务器。 在云服务器中执行步骤2获取的命令。 执行命令后您可以看到如下报错。 执行vi /ect/hosts命令，在host文件中增加如下内容。 100.125.11.131 hss-agent.cn-east-3.myhuaweicloud.com 100.125.158.120 hss-agent.cn-south-1.myhuaweicloud.com 100.125.12.111 hss-agent.cn-north-4.myhuaweicloud.com 再次执行步骤2获取的命令，提示“Hostguard installed”表示安装成功。 如果出现如下提示，请根据异常问题处理：修改网卡配置文件处理此问题。 返回HSS控制台，选择“主机管理”，Agent状态为“在线”后，单击“开启防护”。 Agent状态为“在线”需等待约10min，请耐心等待。 设置HSS为“包年/包月”、“基础版”，阅读并勾选声明，单击“确定”。 Flexus应用服务器L实例支持的HSS为“基础版”，此处设置请保持一致，请勿选择其他版本。 返回Flexus应用服务器L实例控制台，可查看到HSS服务状态处于“防护中”正常启用状态。

请求示例 创建场景库 POST https://{endpoint}/v2/{project_id}/sim/sm/groups { "name" : "group_xxx", "parent" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/sm/categories/361/", "simulator" : "SimPro", "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" : "SimPro", "user_id" : "user_id1", "user_name" : "octopus_user1", "parent" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/sm/categories/361/" }

请求参数 表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 仿真器，如SimPro 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 仿真器，如SimPro user_id String 用户id user_name String 用户名称 parent String 父级场景库资源地址 表6 description 参数 参数类型 描述 content String 描述的内容

响应参数 状态码：201 表4 响应Body参数 参数 参数类型 描述 url String 算法镜像的资源地址 id Integer 算法镜像ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 version String 镜像版本 command String 运行命令 keyword String 算法关键字 algorithm String 算法资源地址 pkg_log_dir String 目录打包路径

响应示例 状态码：201 { "url" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/pm/algorithm-images/36/", "id" : 36, "created_at" : 1746579828.060311, "updated_at" : 1746579828.060332, "version" : "2", "command" : "cmd xxxx", "keyword" : "keyword xxx", "algorithm" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/pm/algorithms/30/", "pkg_log_dir": "" }

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 内容类型。填application/json X-Auth-Token 是 String 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 表3 请求Body参数 参数 是否必选 参数类型 描述 version 是 String 镜像版本，只支持数字，最大长度32位 algorithm 是 String 算法资源地址

请求示例 创建仿真任务配置 POST https://{endpoint}/v2/{project_id}/sim/pm/batch-configs { "name": "batch_config_xxx", "description": "batch_config description", "duration": 600, "evaluations": [ "/v2/54d37c8f25axxxxxxxe9772687bf/sim/pm/evaluations/74/" ], "priority": 60, "scenarios": { }, "algorithm": "/v2/54d37c8f25axxxxxxxe9772687bf/sim/pm/algorithms/64/", "datahub": false, "simulator_name": "SimPro", "repeat_times": 100000, "builtins_evaluation": false, "custom_evaluation_image": "/v2/54d37c8f25axxxxxxxe9772687bf/sim/pm/evaluation-images/11/", "passing_score": 60, "scenario_type": 0, "scenario_set_id": 41, "record_mode": 1, "custom_simulator_image_id": 303973 }

响应示例 状态码：201 { "url": "/v2/54d37c8f25axxxxxxxe9772687bf/sim/pm/batch-configs/357/", "id": 357, "created_at": 1747984785.434156, "updated_at": 1747984785.434175, "algorithm": "/v2/54d37c8f25axxxxxxxe9772687bf/sim/pm/algorithms/64/", "algorithm_name": "algorithm_xxx", "builtins_evaluation": false, "custom_evaluation_image": "/v2/54d37c8f25axxxxxxxe9772687bf/sim/pm/evaluation-images/11/", "custom_simulator_image_id": 303973, "simulator_config": "", "evaluation_info": { "IMAGE": { "id": 74, "name": "eva_xxx", "image_id": 11, "image_version": "1" } }, "batch_size": 0, "duration": "00:10:00", "repeat_times": 100000, "passing_score": 60, "scenario_type": 0, "extensions": [], "user_id": "5ffa2cb7631xxxxxxx736284af7dc4", "name": "batch_config_xxx", "description": "batch_config description", "simulator_name": "SimPro", "record_mode": 1, "priority": 60, "datahub": false, "scenario_set_id": 41, "triggerable": false, "traffic": null, "evaluations": [ "/v2/54d37c8f25axxxxxxxe9772687bf/sim/pm/evaluations/74/" ] }

响应参数 状态码：201 表5 响应Body参数 参数 参数类型 描述 url String 仿真任务配置的资源地址 id Integer 仿真任务配置ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 algorithm String 关联算法资源地址 algorithm_name String 算法名称 builtins_evaluation Boolean 是否使用内置评测 custom_evaluation_image String 关联评测镜像资源地址 custom_simulator_image_id Integer 镜像管理中的仿真器镜像的版本id simulator_config String 仿真器配置信息 evaluation_info 表6 object 评测配置信息 batch_size Integer 任务数量 duration String 子任务最大运行时长 repeat_times Integer 重复运行次数 user_id String 用户id name String 仿真任务配置名称 description String 仿真任务配置描述 simulator_name String 仿真器名称，取值范围：SimPro record_mode Integer 录制模式 0 - 不录制 1 - 录制 priority Integer 优先级,取值越大，优先级越高。可从如下范围中选择： 120 – S：至关重要 100 – A：很重要 80 – B：重要 60 – C：普通 datahub Boolean 是否使用datahub passing_score Integer 融合评测通过分数，默认60 scenario_type Integer 场景类型： 0 - 场景库：从场景库选择场景 1 - 逻辑场景：从泛化任务选择任务 2 – 测试套件：从测试套件选择场景 triggerable Boolean 是否可通过流水线功能触发 evaluations Array of strings 关联评测管理项目 scenario_set_id Int 场景集合 id traffic String 交通流量 extensions Array Of Strings 扩展文件资源地址列表 表6 evaluation_info 参数 参数类型 描述 image 表7 object 镜像信息 表7 image 参数 参数类型 描述 id Integer 项目id name String 项目名称 image_id Integer 镜像id image_version String 镜像版本

请求参数 表2 请求Header参数 参数 是否必选 参数类型 描述 Content-Type 是 String 内容类型。填application/json X-Auth-Token 是 String 用户Token，通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值） 表3 请求Body参数 参数 是否必选 参数类型 描述 name 是 String 仿真任务配置名称，最大长度64位，支持中文，字母，数字及下划线命名 description 否 String 仿真任务配置描述，最大长度256位，支持中文，字母，数字及下划线命名 duration 是 String 子任务最大运行时长，单位秒，最小为60，最大为1800 repeat_times 是 Integer 重复运行次数，最小1次，最大100000次 record_mode 是 Integer 录制模式，可从以下状态选择： 0 - 不录制 1 - 录制 priority 是 Integer 优先级,取值越大，优先级越高。可从如下范围中选择： 120 – S：至关重要 100 – A：很重要 80 – B：重要 60 – C：普通 simulator_name 是 String 仿真器名称，比如：SimPro builtins_evaluation 是 Boolean 是否使用内置评测 true：使用内置评测 false：不使用内置评测 algorithm 否 String 关联算法资源地址 datahub 否 Boolean 是否使用datahub evaluations 是 Array of strings 关联评测管理项目列表 custom_evaluation_image 是 String 关联评测镜像资源地址 custom_simulator_image_id 是 Integer 镜像管理中的仿真器镜像的版本id passing_score 是 Integer 融合评测通过分数，默认60 scenario_type 是 Integer 场景类型： 0 - 场景库：从场景库选择场景 1 - 逻辑场景：从泛化任务选择任务 2 – 测试套件：从测试套件选择场景 scenarios 否 scenarios object 场景信息 scenario_set_id 否 Int 场景集合 id 表4 scenarios 参数 是否必选 参数类型 描述 group_ids 否 Array of integers 场景库id信息 generalization_ids 否 Array of integers 泛化任务id信息 suit_ids 否 Array of integers 测试套件id信息

响应参数 状态码：201 表5 响应Body参数 参数 参数类型 描述 url String 算法镜像的资源地址 id Integer 算法镜像ID created_at TimeStamp 创建时间 updated_at TimeStamp 更新时间 run 表6 object 运行信息 name String 算法名称 description String 算法描述 category String 算法类型 image - Image repository_id Integer 镜像ID 表6 run 参数 参数类型 描述 command String 运行命令 keyword String 算法关键字 pkg_log_dir String 日志打包目录，需绝对路径 cpu Double cpu配额 memory Integer 内存配额 gpu Integer gpu配额

请求示例 创建算法 POST https://{endpoint}/v2/{project_id}/sim/pm/algorithms { "category" : "image", "name" : "algorithm-xx", "description" : "add-new-algorithm", "run" : { "command" : "custom define cmd xxx", "keyword" : "custom define keyword xx", "cpu" : 2, "memory" : 1024, "gpu" : 0, "pkg_log_dir" : "/srv/log" }, "repository_id" : 262463 }

响应示例 状态码：201 { "url" : "/v2/54d37c8f25af42xxxxxxxxe9772687bf/sim/pm/algorithms/62/", "id" : 62, "created_at" : 1746579828.060311, "updated_at" : 1746579838.060311, "description" : { "content" : "customer algorithm" }, "name" : "algorithm-xx", "category" : "image", "repository_id" : 262463, "run" : { "command" : "ustom define cmd xxx", "pkg_log_dir" : "/srv/log", "keyword" : "custom define keyword xx", "cpu" : 2.0, "memory" : 1024, "gpu" : 0 } }

请求参数 表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代表存在父级场景库信息