文档中心

云手机

请输入

任务管理

更新定时任务配置 UpdateScheduledAgentRunTask

更新已有定时任务的配置信息。

使用说明

调用 MUA OpenAPI 前，必须先访问跨服务访问请求为您的账号授权。

注意事项

本接口整体 QPS 限制为 50 次/秒、单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流。

请求说明

请求地址：https://open.volcengineapi.com?Action=UpdateScheduledAgentRunTask=2023-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Header

参数	类型	是否必选	示例值	描述
Content-Type	String	是	application/json	请求头信息。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	UpdateScheduledAgentRunTask	接口名称。当前 API 的名称为 UpdateScheduledAgentRunTask。
Version	String	是	2023-08-01	接口版本。当前 API 的版本为 2023-08-01。

Body

参数	类型	是否必选	示例值	描述
Id	Integer	是	176***	定时任务配置 ID，您可以调用 CreateScheduledAgentRunTask 接口获取。
Name	String	否	example-task-name	更新后的任务名称，长度为 1～128 个字符，不传时任务名称保持不变。
CronExpr	String	否	0 10 * * *	更新后的定时规则表达式，用于设置任务自动执行的时间。采用标准 5 段式 crontab 格式，依次为“分钟小时日月星期”，例如 0 10 * * * 表示每天上午 10:00 触发一次。两次触发的时间间隔不能少于 10 分钟。不传时定时规则保持不变。
Status	Integer	否	1	定时任务状态，不传时状态保持不变，取值： 1：启用定时任务。 2：停用定时任务。
RunTaskOneStep	Object	否	{}	更新后的一键运行任务配置，TaskType 为 run_one_step 时必填，字段与一键运行代理任务 RunAgentTaskOneStep 一致。注意 RunTaskOneStep 与 RunTask 默认只能二选一传入。
RunTask	Object	否	{}	更新后的任务配置，TaskType 为 run 时必填，字段与运行代理任务 RunAgentTask 一致。注意 RunTaskOneStep 与 RunTask 默认只能二选一传入。
TaskType	String	否	run_one_step	任务创建方式，更新时需与 RunTaskOneStep 或 RunTask 参数配套传入，若不传该参数，系统将根据实际传入的 RunTaskOneStep 或 RunTask 参数，自动判断任务更新方式。取值： run_one_step：一键运行代理任务 RunAgentTaskOneStep。 run：运行代理任务 RunAgentTask。

返回参数

本接口无特有的返回参数。更多信息请参见返回结构。

请求示例

返回示例

错误码

MUA OpenAPI 错误码请参见错误码。

最近更新时间：2026.09.30 16:45:08

这个页面对您有帮助吗？

有用

无用