更新时间:2025-08-01 GMT+08:00
分享

启用ScheduledTask

功能介绍

根据ID启动定时运维任务。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/schedule/task/{task_id}/enable

表1 路径参数

参数

是否必选

参数类型

描述

task_id

String

任务ID。

取值范围:以“ST”开头长度26的字符串。

默认值:不涉及。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

ticket_infos

Array of TicketInfo objects

参数描述:

四号提权单信息。

约束限制:

若当前接口已在“变更管控”中启用了“工单授权”,则该值必填,即给定对应的提权信息。具体取值请参考“表2 - TicketInfo”。

取值范围:

请参考“表2 - TicketInfo”。

默认取值:

请参考“表2 - TicketInfo”。

表3 TicketInfo

参数

是否必选

参数类型

描述

ticket_id

String

参数解释:

四号单ID。

约束限制:

请选择当前生效的四号单。

取值范围:

同“约束限制”。

默认取值:

不涉及。

ticket_type

String

参数解释:

四号单类型。

约束限制:

不涉及。

取值范围:

  • CHANGE:变更单。

  • INCIDENT:事件单。

  • ALARM:告警单。

  • WARROOM:WARROOM单。

默认取值:

不涉及。

target_id

String

参数解释:

四号单关联的应用ID。

约束限制:

请选择四号单真实关联的应用ID。

取值范围:

同“约束限制”。

默认取值:

不涉及。

scope_id

String

参数解释:

区域ID。

约束限制:

请选择四号单真实关联的区域ID。

取值范围:

同“约束限制”。

默认取值:

不涉及。

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

data

String

响应数据

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码

error_msg

String

错误描述

请求示例

根据ID启用定时运维任务。

POST https://{Endpoint}/v1/schedule/task/ST****/enable

响应示例

状态码:200

请求成功。

{
  "data" : "ST****"
}

状态码

状态码

描述

200

请求成功。

400

服务器未能处理请求。

错误码

请参见错误码

相关文档