文档中心

日志服务

定时 SQL 分析

ModifyScheduleSqlTask

ModifyScheduleSqlTask

调用 ModifyScheduleSqlTask 接口修改定时 SQL 分析任务。

请求说明

请求方式：PUT

请求地址：https://{tls-endpoint}/ModifyScheduleSqlTask

请求参数

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

Body

参数	类型	是否必选	示例值	描述
TaskId	String	是	4a9bd4bd-53f1-43ff-b88a-64ee1be5****	定时 SQL 分析任务 ID。
TaskName	String	否	schedule-sql-task-name	定时 SQL 分析任务名称。命名规则请参考资源命名规则。
Description	String	否	This is a test schedule sql task	定时 SQL 分析任务的简单描述。不支持<>、'、\、\\。长度范围为0～64个字符。
DestRegion	String	否	cn-north-1	目标日志主题所属地域。
DestTopicID	String	否	2a9bd4bd-53f1-43ff-b88a-64ee1be5****	用于存储 SQL 分析结果数据的目标日志主题 ID。
Status	Integer	否	0	完成任务配置后是否立即启动定时 SQL 分析任务。可选值： 0 ：关闭任务，后续需手动启动任务。 1 ：立即启动。
ProcessSqlDelay	Integer	否	60	每次调度的延迟时间。取值范围为 0～120，单位为秒。
ProcessTimeWindow	String	否	@m-15m,@m	SQL 时间窗口。定时 SQL 分析任务运行时，检索与分析日志的时间范围，左闭右开格式。例如，定时 SQL 分析任务的调度开始时间为2023年8月14日10:00，调度周期为每隔 1 小时执行一次，SQL 时间窗口为 [@h-1h,@h)，执行延迟 10 秒，则启动定时 SQL 分析任务后，日志服务会在 10:00:00 产生一个实例，10:00:10 开始执行实例，分析 [09:00:00~10:00:00) 期间的日志数据，并在 11:00:00 创建第二个实例，11:00:10 开始执行实例，分析 [10:00:00~11:00:00) 期间的日志数据。说明 SQL 时间窗口最大为 24 小时，最小为 1 分钟。如果设置 SQL 时间窗口大于 24 小时，可能会因数据量过大导致执行实例运行失败或计算结果不准确。SQL 时间窗口的语法请参考SQL 时间窗口语法。
Query	String	否	* \| select *	定时 SQL 分析任务定期执行的检索与分析语句，应符合日志服务的检索与分析语法。详细语法说明请参考检索概述和分析概述。
RequestCycle	Object of RequestCycle	否	{"Type":"Period","Time":1}	定时 SQL 分析任务的调度周期。调度周期决定每个实例的调度时间。 Type：调度周期类型。可选值： Period：按照周期进行调度，即每隔一段时间调度一次。 Fixed：定期调度，即每天固定时间点调度一次。 Time：调度的周期或者定期执行的时间点（距离 00:00 的分钟数），取值范围为1~1440，单位为分钟。说明建议调度周期不小于 SQL 时间窗口，否则可能出现调度不及时，查询结果不正确。例如调度周期为每隔 10 分钟执行一次，则 SQL 时间窗口长度最大为 10 分钟。

RequestCycle

参数	类型	是否必选	示例值	描述
Time	Integer	是	10	调度的周期或者定期执行的时间点（距离 00:00 的分钟数），取值范围为 1~1440，单位为分钟。
Type	String	是	Period	调度周期类型。可选值： Period：按照周期进行调度，即每隔一段时间调度一次。 Fixed：定期调度，即每天固定时间点调度一次。 Cron：使用 Cron 表达式。
CronTab	String	否	0 18 * * *	Cron表达式，日志服务通过 Cron 表达式指定告警任务定时执行。Cron 表达式的最小粒度为分钟，24 小时制。例如 0 18 * * *表示每天 18 点整执行一次告警任务。
CronTimeZone	String	否	GMT+0800	设置Type为 Cron 时，还需设置时区。常见的时区列表请参见选择时区。

返回参数

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

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

HTTP 状态码	错误码	错误信息	说明
400	InvalidArgument	Invalid argument key %s, value %s, please check argument.	参数不合法。
404	ScheduleSqlTaskNotExist	Task %s does not exist.	定时 SQL 分析任务不存在。
500	InternalServerError	We encountered an unexpected server error . Please try again later.	服务器内部错误。

最近更新时间：2025.10.14 14:28:14

这个页面对您有帮助吗？

有用

有用

无用

无用