暂停评估任务 - StopOpsEvaluationTask
功能介绍
该接口用于暂停正在运行的评估任务,支持临时任务执行控制,适用于任务调度的场景。
适用场景:
调用方法
请参见如何调用API。
授权信息
账号根用户具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备如下身份策略权限,更多的权限说明请参见权限和授权项。
| 授权项 | 访问级别 | 资源类型(*为必须) | 条件键 | 别名 | 依赖的授权项 |
|---|---|---|---|---|---|
| agentarts:evaluationTask:stopOpsEvaluationTask | Write | evaluationTask * | g:ResourceTag/<tag-key> | - | - |
URI
PUT /v1/ops/evaluation-tasks/{task_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_id | 是 | String | 参数解释: 评估任务的唯一标识符(ID)。该ID用于在API路径中精确定位特定的评估任务资源。 约束限制: 长度为0到100个字符的字符串。 取值范围: 符合通用唯一识别码(UUID)标准的字符串。 默认取值: 不涉及。 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 参数解释: 消息体编码格式。用于告知服务端请求体(Body)所采用的主体数据类型,以便服务端正确解析。 约束限制: 不涉及 取值范围: 不涉及 默认取值: application/json |
| Authorization | 是 | String | 参数解释: 签名认证信息,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| X-Sdk-Date | 是 | String | 参数解释: 请求发送的时间,当使用AK/SK方式认证时,使用SDK对请求进行签名的过程中会自动填充该字段。 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
暂停任务成功
状态码:400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释: 系统定义的标准化错误代码。 取值范围: 业务异常编码字符串。 |
| error_msg | String | 参数解释: 对错误的详细描述,包含异常原因或解决建议。 取值范围: 任意文本内容。 |
请求示例
暂停处于运行中(Running)状态的评估任务,以释放计算资源或进行配置检查。
PUT https://*.com/agentarts/v1/ops/evaluation-tasks/1769499746650415700514
响应示例
状态码:200
暂停任务成功
{
"code" : 0,
"data" : null,
"msg" : "success"
} 状态码:400
错误请求
{
"error_code" : "AgentArts.03400001",
"error_msg" : "请求错误"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 暂停任务成功 |
| 400 | 错误请求 |
错误码
请参见错误码。