You need to enable JavaScript to run this app.
导航

ModifyScheduleSqlTask

最近更新时间2024.03.28 10:17:50

首次发布时间2023.12.25 10:45:06

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

请求说明

  • 请求方式:PUT
  • 请求地址:https://tls-{Region}.ivolces.com/ModifyScheduleSqlTask

请求参数

Body

参数类型是否必选示例值描述
TaskIdString4a9bd4bd-53f1-43ff-b88a-64ee1be5****定时 SQL 分析任务 ID。
TaskNameStringschedule-sql-task-name定时 SQL 分析任务名称。命名规则请参考资源命名规则

Description

String

This is a test schedule sql task

定时 SQL 分析任务的简单描述。

  • 不支持<>'\\\
  • 长度范围为0~64个字符。
DestRegionStringcn-north-1目标日志主题所属地域。
DestTopicIDString2a9bd4bd-53f1-43ff-b88a-64ee1be5****用于存储 SQL 分析结果数据的目标日志主题 ID。

Status

Integer

0

完成任务配置后是否立即启动定时 SQL 分析任务。可选值:

  • 0 :关闭任务,后续需手动启动任务。
  • 1 :立即启动。
ProcessSqlDelayInteger60每次调度的延迟时间。取值范围为 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 时间窗口语法。

QueryString* | select *定时 SQL 分析任务定期执行的检索与分析语句,应符合日志服务的检索与分析语法。详细语法说明请参考检索概述分析概述

RequestCycle

Object of RequestCycle

{"Type":"Period","Time":1}

定时 SQL 分析任务的调度周期。调度周期决定每个实例的调度时间。

  • Type:调度周期类型。可选值:
    • Period:按照周期进行调度,即每隔一段时间调度一次。
    • Fixed:定期调度,即每天固定时间点调度一次。
  • Time:调度的周期或者定期执行的时间点(距离 00:00 的分钟数),取值范围为1~1440,单位为分钟。

说明

建议调度周期不小于 SQL 时间窗口,否则可能出现调度不及时,查询结果不正确。例如调度周期为每隔 10 分钟执行一次,则 SQL 时间窗口长度最大为 10 分钟。

RequestCycle

参数类型是否必选示例值描述
TimeInteger10调度的周期或者定期执行的时间点(距离 00:00 的分钟数),取值范围为1~1440,单位为分钟。

Type

String

Period

调度周期类型。可选值:

  • Period:按照周期进行调度,即每隔一段时间调度一次。
  • Fixed:定期调度,即每天固定时间点调度一次。
CronTabStringCron表达式

返回参数

请求示例

PUT https://tls-{Region}.ivolces.com/ModifyScheduleSqlTask HTTP/1.1
Content-Type: application/json
{
    "TaskName":"test2",
    "Description":"测试",
    "TopicID":"c5c6b3a7-c730-4527-8d5f-e527b381****",
    "DestRegion":"cn-shanghai",
    "DestTopicID":"66b42cb6-3436-44ae-97bf-efab3043****",
    "Status": 1,
    "ProcessStartTime":1689042649,
    "RequestCycle":{
        "Type":"Period",
        "Time":1
    },
    "ProcessTimeWindow":"@m-m,@m",
    "Query":"",
    "ProcessSqlDelay": 0
}

返回示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8

错误码

更多信息,请参考通用错误码

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