更新时间：2026-11-09 GMT+08:00
停止模型优化任务 - StopOpsModelTuningTask
功能介绍
本接口用于中断正在运行的模型优化任务。执行后将立刻中止算力消耗并释放底层的训练资源，任务流转为停止状态。
适用场景：
- 在监控过程中发现训练指标异常或配置错误时，及时停止任务以避免资源浪费。
- 当高优先级的紧急任务需要占用算力资源时，主动终止低优先级的训练任务以进行资源调度。
- 在达到预期的初步效果或判定模型无法收敛时，手动结束训练并分析当前产生的中间结果。
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型（*为必须） | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:modelTuningTask:stopOpsModelTuningTask | Write | modelTuningTask * | g:ResourceTag/<tag-key> | - | - |
URI
POST /v1/ops/model-tuning-tasks/{task_id}/stop
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_id | 是 | String | 参数解释： 模型优化任务ID，标识任务的唯一标识符。获取方法请参考查询模型优化任务列表 - ListOpsModelTuningTasks。 约束限制： 不涉及 取值范围： 长度为32的ID字符串，最小长度32，最大长度32。 默认取值： 无 |
请求参数
无
响应参数
状态码：204
无
状态码：404
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释： 机器可读的错误代码。 取值范围： 系统错误码字符串。 |
| error_msg | String | 参数解释： 人类可读的错误消息。 取值范围： 详细错误说明字符串。 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释： 机器可读的错误代码。 取值范围： 系统错误码字符串。 |
| error_msg | String | 参数解释： 人类可读的错误消息。 取值范围： 详细错误说明字符串。 |
请求示例
用于中断正在运行的训练任务。
POST /v1/ops/model-tuning-tasks/57ae91cf2f504899921a50d1c75f0547/stop
响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 204 | 操作成功。 |
| 404 | 模型优化任务未找到。 |
| 500 | 内部服务器错误。 |
错误码
请参见错误码。
父主题： 模型优化任务
