此版本仍在开发中,尚未视为稳定版。如需最新稳定版本,请使用 Spring Boot 4.0.4spring-doc.cadn.net.cn

Quartz(quartz

quartz 端点提供有关由 Quartz 调度器管理的作业和触发器的信息。spring-doc.cadn.net.cn

检索已注册的组

作业(Jobs)和触发器(triggers)按组进行管理。 要获取已注册的作业组和触发器组列表,请向 GET 发送一个 /actuator/quartz 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/quartz' -i -X GET

生成的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 120

{
  "jobs" : {
    "groups" : [ "samples", "tests" ]
  },
  "triggers" : {
    "groups" : [ "samples", "DEFAULT" ]
  }
}

响应结构

响应包含已注册作业和触发器的组名称。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

jobs.groupsspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

一组作业组名称的数组。spring-doc.cadn.net.cn

triggers.groupsspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

触发器组名称的数组。spring-doc.cadn.net.cn

检索已注册的任务名称

要获取已注册作业名称的列表,请向 GET 发起一个 /actuator/quartz/jobs 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/quartz/jobs' -i -X GET

生成的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 137

{
  "groups" : {
    "samples" : {
      "jobs" : [ "jobOne", "jobTwo" ]
    },
    "tests" : {
      "jobs" : [ "jobThree" ]
    }
  }
}

响应结构

响应包含每个组中注册的作业名称。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

groupsspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按名称键控的作业组。spring-doc.cadn.net.cn

groups.*.jobsspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

一组作业名称。spring-doc.cadn.net.cn

检索已注册的触发器名称

要获取已注册触发器名称的列表,请向 GET 发起一个 /actuator/quartz/triggers 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/quartz/triggers' -i -X GET

生成的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 229

{
  "groups" : {
    "samples" : {
      "paused" : false,
      "triggers" : [ "3am-weekdays", "every-day", "once-a-week" ]
    },
    "DEFAULT" : {
      "paused" : false,
      "triggers" : [ "every-hour-tue-thu" ]
    }
  }
}

响应结构

响应包含每个组中已注册的触发器名称。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

groupsspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按名称键控的触发器组。spring-doc.cadn.net.cn

groups.*.pausedspring-doc.cadn.net.cn

Booleanspring-doc.cadn.net.cn

此触发器组是否已暂停。spring-doc.cadn.net.cn

groups.*.triggersspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

一组触发器名称。spring-doc.cadn.net.cn

检索作业组概述

要获取特定组中作业的概览,请向 GET 发起一个 /actuator/quartz/jobs/{groupName} 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/quartz/jobs/samples' -i -X GET

前面的示例检索了 samples 组中作业的摘要。 返回的结果响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 201

{
  "group" : "samples",
  "jobs" : {
    "jobOne" : {
      "className" : "org.springframework.scheduling.quartz.DelegatingJob"
    },
    "jobTwo" : {
      "className" : "org.quartz.Job"
    }
  }
}

响应结构

响应包含特定组中作业的概览。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

groupspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

组的名称。spring-doc.cadn.net.cn

jobsspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按名称键控的作业详情。spring-doc.cadn.net.cn

jobs.*.classNamespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业实现类的完全限定名。spring-doc.cadn.net.cn

检索触发器组概览

要获取特定组中触发器的概览,请向 GET 发起一个 /actuator/quartz/triggers/{groupName} 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/quartz/triggers/tests' -i -X GET

前面的示例检索了 tests 组中触发器的摘要。 返回的结果响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 1268

{
  "group" : "tests",
  "paused" : false,
  "triggers" : {
    "cron" : {
      "3am-week" : {
        "previousFireTime" : "2020-12-04T03:00:00.000+00:00",
        "nextFireTime" : "2020-12-07T03:00:00.000+00:00",
        "priority" : 3,
        "expression" : "0 0 3 ? * 1,2,3,4,5",
        "timeZone" : "Europe/Paris"
      }
    },
    "simple" : {
      "every-day" : {
        "nextFireTime" : "2020-12-04T12:00:00.000+00:00",
        "priority" : 7,
        "interval" : 86400000
      }
    },
    "dailyTimeInterval" : {
      "tue-thu" : {
        "priority" : 5,
        "interval" : 3600000,
        "daysOfWeek" : [ 3, 5 ],
        "startTimeOfDay" : "09:00:00",
        "endTimeOfDay" : "18:00:00"
      }
    },
    "calendarInterval" : {
      "once-a-week" : {
        "previousFireTime" : "2020-12-02T14:00:00.000+00:00",
        "nextFireTime" : "2020-12-08T14:00:00.000+00:00",
        "priority" : 5,
        "interval" : 604800000,
        "timeZone" : "Etc/UTC"
      }
    },
    "custom" : {
      "once-a-year-custom" : {
        "previousFireTime" : "2020-07-14T16:00:00.000+00:00",
        "nextFireTime" : "2021-07-14T16:00:00.000+00:00",
        "priority" : 10,
        "trigger" : "com.example.CustomTrigger@fdsfsd"
      }
    }
  }
}

响应结构

响应包含特定组中触发器的概览。 可获取触发器实现的具体详细信息。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

groupspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

组的名称。spring-doc.cadn.net.cn

pausedspring-doc.cadn.net.cn

Booleanspring-doc.cadn.net.cn

该组是否已暂停。spring-doc.cadn.net.cn

triggers.cronspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按名称标识的 Cron 触发器(如果有的话)。spring-doc.cadn.net.cn

triggers.simplespring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按名称键控的简单触发器(如果有的话)。spring-doc.cadn.net.cn

triggers.dailyTimeIntervalspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按名称键控的每日时间间隔触发器(如果有的话)。spring-doc.cadn.net.cn

triggers.calendarIntervalspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按名称索引的日历间隔触发器(如果有的话)。spring-doc.cadn.net.cn

triggers.customspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

任何其他以名称为键的触发器(如果有的话)。spring-doc.cadn.net.cn

triggers.cron.*.previousFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器上次触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.cron.*.nextFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器下一次计划触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.cron.*.priorityspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

如果两个触发器具有相同的计划触发时间,则使用优先级。spring-doc.cadn.net.cn

triggers.cron.*.expressionspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

要使用的 Cron 表达式。spring-doc.cadn.net.cn

triggers.cron.*.timeZonespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

用于解析表达式的时间区,如果有的话。spring-doc.cadn.net.cn

triggers.simple.*.previousFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器上次触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.simple.*.nextFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器下一次计划触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.simple.*.priorityspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

如果两个触发器具有相同的计划触发时间,则使用优先级。spring-doc.cadn.net.cn

triggers.simple.*.intervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

两次执行之间的间隔时间(以毫秒为单位)。spring-doc.cadn.net.cn

triggers.dailyTimeInterval.*.previousFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器上次触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.dailyTimeInterval.*.nextFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器下一次计划触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.dailyTimeInterval.*.priorityspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

如果两个触发器具有相同的计划触发时间,则使用优先级。spring-doc.cadn.net.cn

triggers.dailyTimeInterval.*.intervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

以毫秒为单位的时间间隔,添加到触发时间上,用于计算下一次触发重复的时间。spring-doc.cadn.net.cn

triggers.dailyTimeInterval.*.daysOfWeekspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

一个用于触发操作的星期几数组。spring-doc.cadn.net.cn

triggers.dailyTimeInterval.*.startTimeOfDayspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

如果指定了时间间隔,则为开始触发的时间点。spring-doc.cadn.net.cn

triggers.dailyTimeInterval.*.endTimeOfDayspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

每天在指定间隔完成触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.calendarInterval.*.previousFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器上次触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.calendarInterval.*.nextFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器下一次计划触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.calendarInterval.*.priorityspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

如果两个触发器具有相同的计划触发时间,则使用优先级。spring-doc.cadn.net.cn

triggers.calendarInterval.*.intervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

以毫秒为单位的时间间隔,添加到触发时间上,用于计算下一次触发重复的时间。spring-doc.cadn.net.cn

triggers.calendarInterval.*.timeZonespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

用于执行时间计算的时区(如果有的话)。spring-doc.cadn.net.cn

triggers.custom.*.previousFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器上次触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.custom.*.nextFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器下一次计划触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.custom.*.priorityspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

如果两个触发器具有相同的计划触发时间,则使用优先级。spring-doc.cadn.net.cn

triggers.custom.*.triggerspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

自定义触发器实例的 toString 表示形式。spring-doc.cadn.net.cn

检索作业详情

要获取特定作业的详细信息,请向 GET 发起一个 /actuator/quartz/jobs/{groupName}/{jobName} 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/quartz/jobs/samples/jobOne' -i -X GET

前面的示例检索了由samples组和jobOne名称标识的任务的详细信息。 返回的结果响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 609

{
  "group" : "samples",
  "name" : "jobOne",
  "description" : "A sample job",
  "className" : "org.springframework.scheduling.quartz.DelegatingJob",
  "durable" : false,
  "requestRecovery" : false,
  "data" : {
    "password" : "secret",
    "user" : "admin"
  },
  "triggers" : [ {
    "group" : "samples",
    "name" : "every-day",
    "previousFireTime" : "2020-12-04T03:00:00.000+00:00",
    "nextFireTime" : "2020-12-04T12:00:00.000+00:00",
    "priority" : 7
  }, {
    "group" : "samples",
    "name" : "3am-weekdays",
    "nextFireTime" : "2020-12-07T03:00:00.000+00:00",
    "priority" : 3
  } ]
}

如果数据映射中的某个键被识别为敏感信息,其对应的值将被清理。spring-doc.cadn.net.cn

响应结构

响应包含作业的完整详细信息,包括与其关联的触发器摘要(如果有的话)。 触发器按下次触发时间和优先级排序。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

groupspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

组的名称。spring-doc.cadn.net.cn

namespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业的名称。spring-doc.cadn.net.cn

descriptionspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业的描述(如果有)。spring-doc.cadn.net.cn

classNamespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业实现类的完全限定名。spring-doc.cadn.net.cn

durablespring-doc.cadn.net.cn

Booleanspring-doc.cadn.net.cn

作业在被孤立后是否应继续保留存储。spring-doc.cadn.net.cn

requestRecoveryspring-doc.cadn.net.cn

Booleanspring-doc.cadn.net.cn

如果遇到“恢复”或“故障转移”情况,是否应重新执行该作业。spring-doc.cadn.net.cn

data.*spring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业数据映射(Job data map)以键/值对的形式表示(如果有的话)。spring-doc.cadn.net.cn

triggersspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

与该作业关联的触发器数组(如果有的话)。spring-doc.cadn.net.cn

triggers.[].groupspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器组的名称。spring-doc.cadn.net.cn

triggers.[].namespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器的名称。spring-doc.cadn.net.cn

triggers.[].previousFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器上次触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.[].nextFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器下一次计划触发的时间(如果有的话)。spring-doc.cadn.net.cn

triggers.[].priorityspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

如果两个触发器具有相同的计划触发时间,则使用优先级。spring-doc.cadn.net.cn

按需触发 Quartz 任务

要触发特定的 Quartz 作业,请向 POST 发送一个 /actuator/quartz/jobs/{groupName}/{jobName} 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/quartz/jobs/samples/jobOne' -i -X POST \
    -H 'Content-Type: application/json' \
    -d '{"state":"running"}'

前面的示例演示了如何触发一个属于 samples 组且名称为 jobOne 的作业。spring-doc.cadn.net.cn

响应将类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 169

{
  "group" : "samples",
  "name" : "jobOne",
  "className" : "org.springframework.scheduling.quartz.DelegatingJob",
  "triggerTime" : "2026-03-19T10:58:23.668807281Z"
}

请求结构

该请求指定了与特定作业关联的期望state(状态)。 发送一个包含"state": "running"正文的 HTTP 请求,表示应立即运行该作业。 下表描述了请求的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

statespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业的理想状态。必须为 runningspring-doc.cadn.net.cn

响应结构

响应包含已触发作业的详细信息。 下表描述了响应的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

groupspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

组的名称。spring-doc.cadn.net.cn

namespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业的名称。spring-doc.cadn.net.cn

classNamespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业实现类的完全限定名。spring-doc.cadn.net.cn

triggerTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业被触发的时间。spring-doc.cadn.net.cn

检索触发器的详细信息

要获取特定触发器的详细信息,请向 GET 发起一个 /actuator/quartz/triggers/{groupName}/{triggerName} 请求,如下列基于 curl 的示例所示:spring-doc.cadn.net.cn

$ curl 'http://localhost:8080/actuator/quartz/triggers/samples/example' -i -X GET

前面的示例检索了由 samples 组和 example 名称标识的触发器的详细信息。spring-doc.cadn.net.cn

通用响应结构

响应具有一个通用结构,以及一个特定于触发器类型的附加对象。 目前支持五种类型:spring-doc.cadn.net.cn

下表描述了响应中常见元素的结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

groupspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

组的名称。spring-doc.cadn.net.cn

namespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器的名称。spring-doc.cadn.net.cn

descriptionspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器的描述(如果有)。spring-doc.cadn.net.cn

statespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器的状态(NONENORMALPAUSEDCOMPLETEERRORBLOCKED)。spring-doc.cadn.net.cn

typespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器的类型(calendarIntervalcroncustomdailyTimeIntervalsimple)。用于确定包含特定于该类型详细信息的对象的键。spring-doc.cadn.net.cn

calendarNamespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

与此触发器关联的日历名称(如果有的话)。spring-doc.cadn.net.cn

startTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器应生效的时间(如果有的话)。spring-doc.cadn.net.cn

endTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器应停止重复的时间,无论是否还有剩余的重复次数。spring-doc.cadn.net.cn

previousFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器上次触发的时间(如果有的话)。spring-doc.cadn.net.cn

nextFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器下一次计划触发的时间(如果有的话)。spring-doc.cadn.net.cn

priorityspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

如果两个触发器具有相同的计划触发时间,则使用优先级。spring-doc.cadn.net.cn

finalFireTimespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器最后一次触发的时间(如果有的话)。spring-doc.cadn.net.cn

dataspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

按名称键入的作业数据映射(如果有的话)。spring-doc.cadn.net.cn

calendarIntervalspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

日历时间间隔触发器的详细信息(如果有)。当 typecalendarInterval 时存在。spring-doc.cadn.net.cn

customspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

自定义触发器详细信息(如果有)。当 typecustom 时存在。spring-doc.cadn.net.cn

cronspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

Cron 触发器的详细信息(如果有的话)。当 typecron 时存在。spring-doc.cadn.net.cn

dailyTimeIntervalspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

每日时间间隔触发器的详细信息(如果有)。当 typedailyTimeInterval 时出现。spring-doc.cadn.net.cn

simplespring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

简单的触发器详情(如果有)。当 typesimple 时显示。spring-doc.cadn.net.cn

Cron 触发器响应结构

一个 cron 触发器定义了用于确定其触发时间的 cron 表达式。 此类触发器实现所生成的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 543

{
  "group" : "samples",
  "name" : "example",
  "description" : "Example trigger",
  "state" : "NORMAL",
  "type" : "cron",
  "calendarName" : "bankHolidays",
  "startTime" : "2020-11-30T17:00:00.000+00:00",
  "endTime" : "2020-12-30T03:00:00.000+00:00",
  "previousFireTime" : "2020-12-04T03:00:00.000+00:00",
  "nextFireTime" : "2020-12-07T03:00:00.000+00:00",
  "priority" : 3,
  "finalFireTime" : "2020-12-30T02:00:00.000+00:00",
  "data" : { },
  "cron" : {
    "expression" : "0 0 3 ? * 1,2,3,4,5",
    "timeZone" : "Europe/Paris"
  }
}

响应的大部分内容对所有触发器类型都是通用的。 响应中通用元素的结构已在前面描述过。 下表描述了响应中特定于 cron 触发器的部分结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

cronspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

Cron 触发器的具体细节。spring-doc.cadn.net.cn

cron.expressionspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

要使用的 Cron 表达式。spring-doc.cadn.net.cn

cron.timeZonespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

用于解析表达式的时间区,如果有的话。spring-doc.cadn.net.cn

简单触发器响应结构

简单触发器(Simple Trigger)用于在指定的时间点触发一个作业(Job),并可选择以指定的时间间隔重复执行。 此类触发器实现所生成的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 549

{
  "group" : "samples",
  "name" : "example",
  "description" : "Example trigger",
  "state" : "NORMAL",
  "type" : "simple",
  "calendarName" : "bankHolidays",
  "startTime" : "2020-11-30T17:00:00.000+00:00",
  "endTime" : "2020-12-30T03:00:00.000+00:00",
  "previousFireTime" : "2020-12-04T03:00:00.000+00:00",
  "nextFireTime" : "2020-12-07T03:00:00.000+00:00",
  "priority" : 7,
  "finalFireTime" : "2020-12-29T17:00:00.000+00:00",
  "data" : { },
  "simple" : {
    "interval" : 86400000,
    "repeatCount" : -1,
    "timesTriggered" : 0
  }
}

响应的大部分内容对所有触发器类型都是通用的。 响应中通用元素的结构已在前文描述。 下表描述了响应中特定于简单触发器的部分结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

simplespring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

简单触发器的特定详细信息。spring-doc.cadn.net.cn

simple.intervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

两次执行之间的间隔时间(以毫秒为单位)。spring-doc.cadn.net.cn

simple.repeatCountspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

触发器应重复的次数,或设为 -1 表示无限重复。spring-doc.cadn.net.cn

simple.timesTriggeredspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

触发器已经触发的次数。spring-doc.cadn.net.cn

每日时间间隔触发器响应结构

每日时间间隔触发器用于根据每天重复的时间间隔来触发一个作业(Job)。 此类触发器实现所产生的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 667

{
  "group" : "samples",
  "name" : "example",
  "description" : "Example trigger",
  "state" : "PAUSED",
  "type" : "dailyTimeInterval",
  "calendarName" : "bankHolidays",
  "startTime" : "2020-11-30T17:00:00.000+00:00",
  "endTime" : "2020-12-30T03:00:00.000+00:00",
  "previousFireTime" : "2020-12-04T03:00:00.000+00:00",
  "nextFireTime" : "2020-12-07T03:00:00.000+00:00",
  "priority" : 5,
  "finalFireTime" : "2020-12-30T18:00:00.000+00:00",
  "data" : { },
  "dailyTimeInterval" : {
    "interval" : 3600000,
    "daysOfWeek" : [ 3, 5 ],
    "startTimeOfDay" : "09:00:00",
    "endTimeOfDay" : "18:00:00",
    "repeatCount" : -1,
    "timesTriggered" : 0
  }
}

大部分响应内容对所有触发器类型都是通用的。 响应中通用元素的结构已在前面描述过。 下表描述了响应中特定于每日时间间隔触发器的部分结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

dailyTimeIntervalspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

每日时间间隔触发器的具体细节。spring-doc.cadn.net.cn

dailyTimeInterval.intervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

以毫秒为单位的时间间隔,添加到触发时间上,用于计算下一次触发重复的时间。spring-doc.cadn.net.cn

dailyTimeInterval.daysOfWeekspring-doc.cadn.net.cn

Arrayspring-doc.cadn.net.cn

一个用于触发操作的星期几数组。spring-doc.cadn.net.cn

dailyTimeInterval.startTimeOfDayspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

如果指定了时间间隔,则为开始触发的时间点。spring-doc.cadn.net.cn

dailyTimeInterval.endTimeOfDayspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

每天在指定间隔完成触发的时间(如果有的话)。spring-doc.cadn.net.cn

dailyTimeInterval.repeatCountspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

触发器应重复的次数,或设为 -1 表示无限重复。spring-doc.cadn.net.cn

dailyTimeInterval.timesTriggeredspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

触发器已经触发的次数。spring-doc.cadn.net.cn

日历间隔触发器响应结构

日历间隔触发器用于根据重复的日历时间间隔来触发作业(Job)。 此类触发器实现所产生的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 669

{
  "group" : "samples",
  "name" : "example",
  "description" : "Example trigger",
  "state" : "NORMAL",
  "type" : "calendarInterval",
  "calendarName" : "bankHolidays",
  "startTime" : "2020-11-30T17:00:00.000+00:00",
  "endTime" : "2020-12-30T03:00:00.000+00:00",
  "previousFireTime" : "2020-12-04T03:00:00.000+00:00",
  "nextFireTime" : "2020-12-07T03:00:00.000+00:00",
  "priority" : 5,
  "finalFireTime" : "2020-12-28T17:00:00.000+00:00",
  "data" : { },
  "calendarInterval" : {
    "interval" : 604800000,
    "timeZone" : "Etc/UTC",
    "timesTriggered" : 0,
    "preserveHourOfDayAcrossDaylightSavings" : false,
    "skipDayIfHourDoesNotExist" : false
  }
}

响应的大部分内容对所有触发器类型都是通用的。 响应中通用元素的结构已在前面描述过。 下表描述了响应中特定于日历间隔触发器的部分结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

calendarIntervalspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

日历间隔触发器的具体细节。spring-doc.cadn.net.cn

calendarInterval.intervalspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

以毫秒为单位的时间间隔,添加到触发时间上,用于计算下一次触发重复的时间。spring-doc.cadn.net.cn

calendarInterval.timeZonespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

用于执行时间计算的时区(如果有的话)。spring-doc.cadn.net.cn

calendarInterval.timesTriggeredspring-doc.cadn.net.cn

Numberspring-doc.cadn.net.cn

触发器已经触发的次数。spring-doc.cadn.net.cn

calendarInterval.preserveHourOfDayAcrossDaylightSavingsspring-doc.cadn.net.cn

Booleanspring-doc.cadn.net.cn

无论是否发生夏令时转换,是否都在一天中的同一时间触发器。spring-doc.cadn.net.cn

calendarInterval.skipDayIfHourDoesNotExistspring-doc.cadn.net.cn

Booleanspring-doc.cadn.net.cn

是否在某一天的小时不存在时跳过。spring-doc.cadn.net.cn

自定义触发器响应结构

自定义触发器是指任何其他实现。 此类触发器实现所生成的响应类似于以下内容:spring-doc.cadn.net.cn

HTTP/1.1 200 OK
Content-Type: application/vnd.spring-boot.actuator.v3+json
Content-Length: 457

{
  "group" : "samples",
  "name" : "example",
  "description" : "Example trigger.",
  "state" : "NORMAL",
  "type" : "custom",
  "calendarName" : "bankHolidays",
  "startTime" : "2020-11-30T17:00:00.000+00:00",
  "endTime" : "2020-12-30T03:00:00.000+00:00",
  "previousFireTime" : "2020-12-04T03:00:00.000+00:00",
  "nextFireTime" : "2020-12-07T03:00:00.000+00:00",
  "priority" : 10,
  "custom" : {
    "trigger" : "com.example.CustomTrigger@fdsfsd"
  }
}

响应的大部分内容对所有触发器类型都是通用的。 响应中通用元素的结构已在前面描述过。 下表描述了响应中特定于自定义触发器的部分结构:spring-doc.cadn.net.cn

路径 类型 <description> </description>

customspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

自定义触发器的特定详细信息。spring-doc.cadn.net.cn

custom.triggerspring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

自定义触发器实例的 toString 表示形式。spring-doc.cadn.net.cn