# 创建仿真任务配置-CreateSimulationTaskConfiguration #### 功能介绍 创建仿真任务配置。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-octopus/Permission.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | octopus:simBatch:create | Write | - | - | - | - | #### URI POST https://{hostURL}/v2/{project_id}/sim/pm/batch-configs 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | **参数解释**： 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-octopus/octopus-10-0020.html)。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | #### 请求参数 表2请求Body参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | algorithm | 否 | String | **参数解释**： 关联算法资源地址。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | builtins_evaluation | 是 | Boolean | **参数解释**： 是否使用内置评测。 **约束限制**： 不涉及 **取值范围**： - *true* - 使用内置评测 - *false* - 不使用内置评测 **默认取值**： 不涉及 | | custom_evaluation_image | 否 | String | **参数解释**： 关联评测镜像资源地址。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | custom_simulator_image_id | 否 | Integer | **参数解释**： 镜像管理中的仿真器镜像的版本id。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | evaluation_info | 是 | [BatchConfigEvaluationInfoSrlz] object | **参数解释**： 评测配置信息。 **约束限制**： 不涉及 | | duration | 是 | String | **参数解释**： 子任务最大运行时长，输出是时间格式，比如"0:10:0"表示超时时间10分钟。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | repeat_times | 是 | Integer | **参数解释**： 重复运行次数。 **约束限制**： 不涉及 **取值范围**： 最小1次，最大100000次。 **默认取值**： 不涉及 | | user_id | 否 | String | **参数解释**： 用户id，从统一身份认证中获取。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | name | 是 | String | **参数解释**： 仿真任务配置名称。 **约束限制**： 不涉及 **取值范围**： 最大长度64位，支持中文，字母，数字及下划线命名。 **默认取值**： 不涉及 | | description | 否 | String | **参数解释**： 仿真任务配置描述。 **约束限制**： 不涉及 **取值范围**： 最大长度256位，支持中文，字母，数字及下划线命名。 **默认取值**： 不涉及 | | simulator_name | 否 | String | **参数解释**： 仿真器名称。 **约束限制**： 不涉及 **取值范围**： \["A", "B", "C", "E", "F"\]等仿真器类型 **默认取值**： 不涉及 | | record_mode | 否 | Integer | **参数解释**： 录制模式，启动录制后方可下载算法日志以及仿真日志。 **约束限制**： 不涉及 **取值范围**： - *0* - 不录制 - *1* - 录制 **默认取值**： 不涉及 | | priority | 否 | Integer | **参数解释**： 优先级,取值越大，优先级越高。 **约束限制**： 不涉及 **取值范围**： - *120* - S：至关重要 - *100* - A：很重要 - *80* - B：重要 - *60* - C：普通 **默认取值**： 不涉及 | | datahub | 否 | Boolean | **参数解释**： 是否使用datahub。 **约束限制**： 不涉及 **取值范围**： - True：使用Datahub - False：不使用Datahub **默认取值**： False | | passing_score | 否 | Integer | **参数解释**： 融合评测通过分数。 **约束限制**： 不涉及 **取值范围**： 范围\[0-100\] **默认取值**： 60 | | triggerable | 否 | Boolean | **参数解释**： 是否可通过流水线功能触发。 **约束限制**： 不涉及 **取值范围**： - True：通过流水线功能触发 - False：不通过流水线功能触发 **默认取值**： False | | evaluations | 否 | Array of strings | **参数解释**： 关联评测管理项目，评测管理的链接列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | simulator_config | 否 | String | **参数解释**： 仿真器配置信息。 **约束限制**： 不涉及 **取值范围**： 长度范围\[0-256\] **默认取值**： 不涉及 | | scenario_type | 否 | Integer | **参数解释**： 场景库类型。 **约束限制**： 不涉及 **取值范围**： - *0* - 场景库：从场景库选择场景 - *1* - 逻辑场景：从泛化任务选择任务 - *2* - 测试套件：从测试套件选择场景 **默认取值**： *0* | | scenario_set_id | 否 | Integer | **参数解释**： 场景库 id。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | scenarios | 否 | [BatchConfigScenarioSrlz] object | **参数解释**： 场景信息。 **约束限制**： 不涉及 | | simulator_command | 否 | String | **参数解释**： 仿真器运行命令。 **约束限制**： 不涉及。 **取值范围**： 长度为\[0-256\]的ASCII字符。 **默认取值**： 不涉及 | | modal_type | 否 | String | **参数解释**： 端到端仿真模态类型。 **约束限制**： 不涉及。 **取值范围**： 目前只支持相机类型 CAMERA。 **默认取值**： 不涉及 | | model_id | 否 | String | **参数解释**： 端到端仿真模型ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | model_version | 否 | String | **参数解释**： 端到端仿真模型版本。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表3BatchConfigEvaluationInfoSrlz | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | image | 是 | [BatchConfigImageInfoSrlz](https://support.huaweicloud.com/api-octopus/CreateSimBatchConfigs.html#ZH-CN_TOPIC_0000002555721292__zh-cn_topic_0000002542879468_response_BatchConfigImageInfoSrlz) object | **参数解释**： 镜像信息 **约束限制**： 不涉及 | 表4record_mode | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | - | 否 | Integer | **参数解释**： 录制模式，启动录制后方可下载算法日志以及仿真日志。 **约束限制**： 不涉及 **取值范围**： - *0* - 不录制 - *1* - 录制 **默认取值**： 不涉及 | 表5priority | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | - | 否 | Integer | **参数解释**： 优先级,取值越大，优先级越高。 **约束限制**： 不涉及 **取值范围**： - *120* - S：至关重要 - *100* - A：很重要 - *80* - B：重要 - *60* - C：普通 **默认取值**： 不涉及 | 表6BatchConfigScenarioSrlz | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | group_ids | 否 | Array of integers | **参数解释**： 场景库ID信息。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | generalization_ids | 否 | Array of integers | **参数解释**： 泛化任务ID信息。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | suit_ids | 否 | Array of integers | **参数解释**： 测试套件ID信息。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | #### 响应参数 **状态码：201** 表7响应Body参数 | 参数 | 参数类型 | 描述 | |:---|:---|:---| | url | String | **参数解释**： 仿真任务配置的资源地址。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及 | | id | Integer | **参数解释**： 仿真任务配置ID。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | created_at | Double | **参数解释**： 创建时间。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | updated_at | Double | **参数解释**： 更新时间。 **约束限制**： 不涉及。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 | | algorithm | String | **参数解释**： 关联算法资源地址。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | algorithm_name | String | **参数解释**： 算法名称。 **约束限制**： 不涉及 **取值范围**： 长度\[0-256\] **默认取值**： 不涉及 | | builtins_evaluation | Boolean | **参数解释**： 是否使用内置评测。 **约束限制**： 不涉及 **取值范围**： - *true* - 使用内置评测 - *false* - 不使用内置评测 **默认取值**： 不涉及 | | custom_evaluation_image | String | **参数解释**： 关联评测镜像资源地址。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | custom_simulator_image_id | Integer | **参数解释**： 镜像管理中的仿真器镜像的版本id。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | evaluation_info | [BatchConfigEvaluationInfoSrlz] object | **参数解释**： 评测配置信息。 **约束限制**： 不涉及 | | batch_size | Integer | **参数解释**： 任务数量。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | duration | String | **参数解释**： 子任务最大运行时长，输出是时间格式，比如"0:10:0"表示超时时间10分钟。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | repeat_times | Integer | **参数解释**： 重复运行次数。 **约束限制**： 不涉及 **取值范围**： 最小1次，最大100000次。 **默认取值**： 不涉及 | | user_id | String | **参数解释**： 用户id，从统一身份认证中获取。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | name | String | **参数解释**： 仿真任务配置名称。 **约束限制**： 不涉及 **取值范围**： 最大长度64位，支持中文，字母，数字及下划线命名。 **默认取值**： 不涉及 | | description | String | **参数解释**： 仿真任务配置描述。 **约束限制**： 不涉及 **取值范围**： 最大长度256位，支持中文，字母，数字及下划线命名。 **默认取值**： 不涉及 | | simulator_name | String | **参数解释**： 仿真器名称。 **约束限制**： 不涉及 **取值范围**： \["A", "B", "C", "E", "F"\]等仿真器类型 **默认取值**： 不涉及 | | record_mode | Integer | **参数解释**： 录制模式，启动录制后方可下载算法日志以及仿真日志。 **约束限制**： 不涉及 **取值范围**： - *0* - 不录制 - *1* - 录制 **默认取值**： 不涉及 | | priority | Integer | **参数解释**： 优先级,取值越大，优先级越高。 **约束限制**： 不涉及 **取值范围**： - *120* - S：至关重要 - *100* - A：很重要 - *80* - B：重要 - *60* - C：普通 **默认取值**： 不涉及 | | datahub | Boolean | **参数解释**： 是否使用datahub。 **约束限制**： 不涉及 **取值范围**： - True：使用Datahub - False：不使用Datahub **默认取值**： False | | passing_score | Integer | **参数解释**： 融合评测通过分数。 **约束限制**： 不涉及 **取值范围**： 范围\[0-100\] **默认取值**： 60 | | triggerable | Boolean | **参数解释**： 是否可通过流水线功能触发。 **约束限制**： 不涉及 **取值范围**： - True：通过流水线功能触发 - False：不通过流水线功能触发 **默认取值**： False | | evaluations | Array of strings | **参数解释**： 关联评测管理项目，评测管理的链接列表。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | simulator_config | String | **参数解释**： 仿真器配置信息。 **约束限制**： 不涉及 **取值范围**： 长度范围\[0-256\] **默认取值**： 不涉及 | | scenario_type | Integer | **参数解释**： 场景库类型。 **约束限制**： 不涉及 **取值范围**： - *0* - 场景库：从场景库选择场景 - *1* - 逻辑场景：从泛化任务选择任务 - *2* - 测试套件：从测试套件选择场景 **默认取值**： *0* | | scenario_set_id | Integer | **参数解释**： 场景库 id。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | scenarios | [BatchConfigScenarioSrlz] object | **参数解释**： 场景信息。 **约束限制**： 不涉及 | | simulator_command | String | **参数解释**： 仿真器运行命令。 **约束限制**： 不涉及。 **取值范围**： 长度为\[0-256\]的ASCII字符。 **默认取值**： 不涉及 | | modal_type | String | **参数解释**： 端到端仿真模态类型。 **约束限制**： 不涉及。 **取值范围**： 目前只支持相机类型 CAMERA。 **默认取值**： 不涉及 | | model_id | String | **参数解释**： 端到端仿真模型ID。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | | model_version | String | **参数解释**： 端到端仿真模型版本。 **约束限制**： 不涉及 **取值范围**： 不涉及 **默认取值**： 不涉及 | 表8BatchConfigEvaluationInfoSrlz | 参数 | 参数类型 | 描述 | |:---|:---|:---| | image | [BatchConfigImageInfoSrlz] object | **参数解释**： 镜像信息 **约束限制**： 不涉及 | 表9BatchConfigImageInfoSrlz | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | Integer | **参数解释**： 镜像资源ID。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | name | String | **参数解释**： 镜像资源名称。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | image_id | Integer | **参数解释**： 镜像ID。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | image_version | String | **参数解释**： 镜像版本，如"1.0"。 **约束限制**： 不涉及。 **取值范围**： 长度\[0-256\] **默认取值**： 不涉及 | 表10record_mode | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | Integer | **参数解释**： 录制模式，启动录制后方可下载算法日志以及仿真日志。 **约束限制**： 不涉及 **取值范围**： - *0* - 不录制 - *1* - 录制 **默认取值**： 不涉及 | 表11priority | 参数 | 参数类型 | 描述 | |:---|:---|:---| | - | Integer | **参数解释**： 录制模式，启动录制后方可下载算法日志以及仿真日志。 **约束限制**： 不涉及 **取值范围**： - *0* - 不录制 - *1* - 录制 **默认取值**： 不涉及 | 表12BatchConfigScenarioSrlz | 参数 | 参数类型 | 描述 | |:---|:---|:---| | group_ids | Array of integers | **参数解释**： 场景库ID信息。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | generalization_ids | Array of integers | **参数解释**： 泛化任务ID信息。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | | suit_ids | Array of integers | **参数解释**： 测试套件ID信息。 **约束限制**： 不涉及。 **取值范围**： 不涉及 **默认取值**： 不涉及 | #### 请求示例 创建仿真任务配置 ``` POST https://{endpoint}/v2/{project_id}/sim/pm/batch-configs/ { "name" : "my_batch_config_x1", "description" : "add-new-batch_config", "duration" : 60, "evaluations" : [ "/v2/my_project_id/sim/pm/evaluations/42/" ], "priority" : 60, "algorithm" : "/v2/my_project_id/sim/pm/algorithms/35/", "datahub" : false, "simulator_name" : "SimPro", "repeat_times" : 1, "builtins_evaluation" : true, "passing_score" : 60, "scenario_type" : 0, "scenario_set_id" : 25 } ``` #### 响应示例 **状态码：201** ``` { "url" : "/v2/my_project_id/sim/pm/batch-configs/179/", "id" : 179, "created_at" : 1.699954029362022E9, "updated_at" : 1.699954029362044E9, "algorithm" : "/v2/my_project_id/sim/pm/algorithms/35/", "algorithm_name" : "my-algorithm-x1", "builtins_evaluation" : true, "custom_evaluation_image" : null, "custom_simulator_image_id" : null, "simulator_config" : "", "evaluation_info" : { "CONFIG" : { "id" : 42, "name" : "内置指标" } }, "batch_size" : 0, "duration" : "00:01:00", "repeat_times" : 1, "user_id" : "my_user_id", "name" : "my_batch_config_x1", "description" : "add-new-batch_config", "simulator_name" : "SimPro", "record_mode" : 0, "priority" : 60, "datahub" : false, "passing_score" : 60, "scenario_type" : 0, "scenario_set_id" : 25, "triggerable" : false, "evaluations" : [ "/v2/my_project_id/sim/pm/evaluations/42/" ] } ``` #### 状态码 | 状态码 | 描述 | |:---|:---| | 201 | 创建成功 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-octopus/ErrorCode.html)。