查询已创建的定时任务配置列表，支持按条件筛选与分页查看。

使用说明

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

注意事项

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

请求说明

请求方式：POST

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

请求参数

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

Header

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

Query

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

Body

参数	类型	是否必选	示例值	描述
Id	Integer	否	176***	定时任务配置 ID，您可以调用 CreateScheduledAgentRunTask 接口获取，不传时默认查询全部定时任务配置。
Status	Integer	否	1	定时任务状态，不传入时查询所有状态的定时任务，取值： 1：启用定时任务。 2：停用定时任务。
Limit	Integer	否	20	每页返回的数量，默认值为 20，取值范围为 1~100。
Offset	Integer	否	0	页码，从 0 开始计数（即第 1 页对应 Offset=0），默认值为 0。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Total	Integer	1	匹配当前过滤条件的定时任务配置总数。
Quota	Integer	50	当前账号可配置的定时任务上限。
List	Array	[]	定时任务配置列表，请见 List 参数列表。

List

参数	类型	示例值	描述
Id	Integer	176***	定时任务配置 ID。
Name	String	every-10min-test	定时任务配置名称。
CronExpr	String	0 10 * * *	定时规则表达式，用于设置任务自动执行的时间。
Status	Integer	1	定时任务状态，取值： 1：启用定时任务。 2：停用定时任务。
TaskType	String	run_one_step	任务创建方式，取值： run_one_step：一键运行代理任务 RunAgentTaskOneStep。 run：运行代理任务 RunAgentTask。
AgentType	String	mua	Agent 类型，取值： mua：Mobile Use Agent。 cua：Computer Use Agent。
RunName	String	scheduled-test	定时任务触发时创建的运行任务名称。
ProductId	String	prod-121***	业务 ID。
CloudPhoneProductId	String	cloud-phone-product-1	云手机商品 ID，用于定位 MUA 云手机资源。
PodId	String	prod-182***	云手机 Pod ID，表示 MUA 任务执行的目标云手机实例。
ThreadId	String	75112***	线程 ID，用于关联同一会话上下文。
NextFireAt	Integer	1785742200	定时任务的下一次触发时间，以 Unix 时间戳格式表示。
LastFireAt	Integer	1785741600	最近一次触发该定时任务配置的时间，采用 Unix 时间戳表示，若从未触发过，则为 0。
LastEnqueueAt	Integer	1785741601	最近一次运行任务成功加入执行队列的时间，采用 Unix 时间戳表示，若从未成功入队，则为 0。
LastRunId	String	75795***	最近一次成功加入执行队列的任务运行 ID。
LastSkipReason	String	pod_busy	最近一次任务被跳过执行的原因，取值： pod_busy：目标设备已有执行中的任务。 device_conflict：同一设备存在更新的定时任务配置，本配置被跳过。 device_lock_failed：获取设备调度锁失败。 check_failed：检查目标设备执行状态失败。 create_failed：创建或加入执行队列失败。 disabled：配置因调度信息无效已被系统停用。空字符串：最近一次任务未被跳过执行。
LastError	String	-	最近一次跳过或失败的详细错误信息，为空表示无错误。
CreatedAt	Integer	1785738000	定时任务配置创建时间，以 Unix 时间戳格式表示。
UpdatedAt	Integer	1785741601	定时任务配置最近更新时间，以 Unix 时间戳格式表示。

请求示例

返回示例

错误码

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

云手机