响应示例 状态码：200 请求成功。 { "approve_status" : "PASSED", "associated_task_id" : "SC****", "associated_task_name" : "script_name", "associated_task_type" : "CUSTOMIZATION", "created_user_name" : "****", "enable_approve" : false, "enable_message_notification" : false, "enterprise_project_id" : "0", "id" : "****", "input_param" : "{\"success_rate\":\"100\",\"timeout\":\"300\",\"execute_user\":\"root\",\"project_id\":\"****\",\"script_params\":\"[{\\\"paramName\\\":\\\"parm\\\",\\\"paramValue\\\":\\\"****\\\",\\\"paramOrder\\\":1}]\"}", "name" : "11111", "risk_level" : "LOW", "runbook_instance_mode" : "SAME", "target_instances" : "[{\"id\":\"****\",\"schedule_id\":\"ST****\",\"target_selection\":\"MANUAL\",\"target_instances\":\"{\\\"batches\\\":[{\\\"batchIndex\\\":1,\\\"rotationStrategy\\\":\\\"CONTINUE\\\",\\\"targetInstances\\\":[{\\\"resourceId\\\":\\\"****\\\",\\\"regionId\\\":\\\"cn-north-4\\\",\\\"provider\\\":\\\"H CSS \\\",\\\"type\\\":\\\"L-INSTANCE\\\",\\\"agentSn\\\":\\\"****\\\",\\\"agentStatus\\\":\\\"ONLINE\\\",\\\"nodeId\\\":\\\"\\\",\\\"enterpriseProjectId\\\":\\\"0\\\",\\\"properties\\\":{\\\"hostName\\\":\\\"****\\\",\\\"fixedIp\\\":\\\"\\\",\\\"regionId\\\":\\\"cn-north-4\\\",\\\"projectId\\\":\\\"****\\\"}}]}],\\\"policy\\\":\\\"none\\\",\\\"all_rotation\\\":\\\"ALL_CONTINUE\\\"}\",\"order_no\":0}]", "task_type" : "SCRIPT", "trigger_time" : { "policy" : "ONCE", "single_scheduled_time" : 1746866130000, "time_zone" : "Asia/Shanghai" }, "version_no" : "1.0.0" }

响应参数 状态码：200 表2 响应Body参数 参数 参数类型 描述 id String 定时任务ID。 enterprise_project_id String 定时任务关联的企业项目ID。 name String 定时任务名称。 agency_name String 创建定时任务时关联的委托名称。 trigger_time TriggerTime object 定时任务执行策略。 version_no String 版本号。 task_type Object 定时任务关联任务类型（脚本/作业）。 associated_task_id String 定时任务关联任务ID（脚本ID/作业ID）。 associated_task_name String 定时任务关联任务名称（脚本名称/作业名称）。 associated_task_name_en String 关联任务名称（英文）（脚本名称/作业名称）。 associated_task_type String 定时任务关联任务的属性（公共/自定义）。 runbook_instance_mode String 定时任务的目标实例模式。 risk_level String 定时任务的风险等级。 input_param String 定时任务的执行参数，值为json串。 enable_approve Boolean 是否开启入库人工审核。 reviewer_notification MessageNotification object 审核人通知信息。 created_user_name String 定时任务的创建人昵称。 reviewer_user_name String 定时任务的审核人昵称。 approve_status Object 定时任务的审批状态。 approve_comments String 定时任务的审批意见。 target_instances String 定时任务的目标节点，值为json串。 enable_message_notification Boolean 是否启用 消息通知 。 message_notification MessageNotification object 消息通知格式。 表3 TriggerTime 参数 参数类型 描述 time_zone String 时区。 取值范围：时区字符串。 默认值：Asia/Shanghai（东八区）。 policy String 定时任务执行策略。 取值范围： PERIODIC：周期执行。 ONCE：单次执行。 CRON：按CRON表达式执行。 默认值：ONCE。 single_scheduled_time Long 定时任务执行策略为ONCE时，任务单次执行的时间戳。 取值范围：毫秒级UTC时间戳。 默认值：不涉及。 periodic_scheduled_time String 定时任务执行策略为PERIODIC时，任务执行的当天时间。 取值范围：24小时制的时间字符串，如任务在当天下午5点半执行，即17:30:00。 默认值：不涉及。 period String 定时任务执行策略为PERIODIC时，任务执行的具体星期列表，按英文逗号分隔；如星期日为“1”，星期一为“2”。 示例：任务在每周一、周三、周四、周天执行，即1,2,4,5。 默认值：不涉及。 cron String 定时任务执行策略为CRON时，任务执行时间对应的CRON表达式。 示例：任务在每天上午10点15分执行，即0 15 10 ? * *。 默认值：不涉及。 scheduled_close_time Long 定时任务执行策略为PERIODIC和CRON时，定时任务规则截止日期的时间戳。 取值范围：毫秒级UTC时间戳。 默认值：不涉及。 表4 MessageNotification 参数 参数类型 描述 policy String 当启用消息通知时，需要指定对应的通知策略。 取值范围： START_EXECUTION：开始执行。 EXECUTION_FAILED：执行失败。 EXECUTION_SUCCEEDED：执行成功。 默认值：不涉及。 notification_endpoint_type String 通知对象类型。 取值范围： USER：个人。 ONCALL：排班。 默认值：ONCALL。 schedule_scene_id String 当通知对象类型为排班时，需要指定对应的排班场景ID。 约束：若不存在，请参考创建排班创建场景ID。 默认值：不涉及。 schedule_role_id String 当通知对象类型为排班时，需要指定对应的排班角色ID。 约束：请确保选择的角色ID已在所选排班场景中存在。 默认值：不涉及。 recipients String 当通知对象类型为个人时，需要指定对应的消息通知人ID。 约束：请确保选择的通知人ID已在人员管理中存在。 默认值：不涉及。 protocol String 通知渠道，请确保当前渠道已被订阅，参考人员管理中的用户订阅。 取值范围： DEFAULT：默认。 NONE：不通知。 SMS ：短信。 EMAIL：邮箱。 DINGDING：钉钉。 LARK：飞书。 CALLNOTIFY：语音。 WECHAT：企业微信。 默认值：DEFAULT，将任选一种您已订阅的通知渠道，若未订阅任何通知渠道，将无法接收通知。 状态码：400 表5 响应Body参数 参数 参数类型 描述 error_code String 错误码 error_msg String 错误描述

请求参数 表2 请求Body参数 参数 是否必选 参数类型 描述 ticket_infos 否 Array of TicketInfo objects 选择的四号提权单信息。 表3 TicketInfo 参数 是否必选 参数类型 描述 ticket_id 否 String 四号单ID。 ticket_type 否 String 四号单类型，可选CHANGE/INCIDENT/ALARM/WARROOM。 target_id 否 String 四号单关联的应用ID。 scope_id 否 String 区域ID。

特殊字符含义 表2 Cron表达式特殊字符含义 字符 含义 示例 , 表示分开的值。 1,3,4,7,8。 * 表示匹配域的任意值。 在分这个域使用 *，即表示每分钟都会触发事件。 ? 表示匹配域的任意值，但只能用在日期和星期两个域，因为这两个域会相互影响。 要在每月的 20 号触发调度，不管每个月的 20 号是星期几，则只能使用如下写法：13 13 15 20 * ?。其中，因为日期域已经指定了 20 号，最后一位星期域只能用 ?，不能使用 *。如果最后一位使用 *，则表示不管星期几都会触发，与日期域的 20 号相斥，此时表达式不正确。 - 表示起止范围。 在小时这个域使用 8-10，表示从 8时到 10 时每小时触发一次。 / 表示起始时间开始触发，然后每隔固定时间触发一次。 在小时这个域中使用，“*/3”等同于“每3个小时”，即“0,3,6,9,12,15,18,21”小时触发。 L 表示最后，只能出现在日和星期两个域。 在星期这个域使用 5L，意味着在最后的一个星期四触发。