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

Quartz (quartz)

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

检索已注册的组

作业和触发器在组中进行管理。 要检索已注册的作业组和触发器组列表，请向 /actuator/quartz 发送一个 GET 请求，如下方基于 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

路径 类型 描述

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

检索已注册的作业名称

要检索已注册的作业名称列表，请向 /actuator/quartz/jobs 发送一个 GET 请求，如下方基于 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

路径 类型 描述

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

检索已注册的触发器名称

要检索已注册触发器名称的列表，请向 /actuator/quartz/triggers 发送一个 GET 请求，如下方基于 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

路径 类型 描述

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

检索作业组概览

要检索特定组中作业的概览，请向 /actuator/quartz/jobs/{groupName} 发送一个 GET 请求，如下方基于 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

路径 类型 描述

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

获取触发器组的概览

要检索特定组中触发器的概览，请向 /actuator/quartz/triggers/{groupName} 发送一个 GET 请求，如下方基于 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: 1233

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

响应结构

响应包含特定组中触发器的概览。 触发器实现的具体详情可用。 下表描述了响应的结构：spring-doc.cadn.net.cn

路径 类型 描述

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

用于计算下一次触发重复时间的间隔（毫秒），该间隔将被加到触发时间（fire time）上。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

用于计算下一次触发重复时间的间隔（毫秒），该间隔将被加到触发时间（fire time）上。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

获取作业的详细信息

要检索特定作业的详细信息，请向 /actuator/quartz/jobs/{groupName}/{jobName} 发送一个 GET 请求，如下方基于 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: 594

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

如果数据映射（data map）中的某个键被标识为敏感信息，则其对应的值将被清理。spring-doc.cadn.net.cn

响应结构

响应包含作业的完整详细信息，包括与其关联的触发器摘要（如果存在）。 触发器按下次触发时间及优先级排序。 下表描述了响应的结构：spring-doc.cadn.net.cn

路径 类型 描述

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

作业数据映射（键/值对形式），如有。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 任务，请向 /actuator/quartz/jobs/{groupName}/{jobName} 发送一个 POST 请求，如下方基于 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

{
  "className" : "org.springframework.scheduling.quartz.DelegatingJob",
  "group" : "samples",
  "name" : "jobOne",
  "triggerTime" : "2026-03-19T18:21:48.181006356Z"
}

请求结构

该请求指定了与特定作业相关联的所需 state。 发送带有 "state": "running" 主体的 HTTP 请求，表示应立即运行该作业。 下表描述了请求的结构：spring-doc.cadn.net.cn

路径 类型 描述

statespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

作业的期望状态，必须为 running。spring-doc.cadn.net.cn

响应结构

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

路径 类型 描述

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

检索触发器的详细信息

要检索特定触发器的详细信息，请向 /actuator/quartz/triggers/{groupName}/{triggerName} 发送一个 GET 请求，如下方基于 curl 的示例所示：spring-doc.cadn.net.cn

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

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

通用响应结构

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

下表描述了响应中通用元素的结构：spring-doc.cadn.net.cn

路径 类型 描述

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

触发器的状态（NONE、NORMAL、PAUSED、COMPLETE、ERROR、BLOCKED）。spring-doc.cadn.net.cn

typespring-doc.cadn.net.cn

Stringspring-doc.cadn.net.cn

触发器类型（calendarInterval、cron、custom、dailyTimeInterval、simple）。用于确定包含类型特定详细信息的对象的键。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

日历时间间隔触发器的详细信息（如有）。当 type 为 calendarInterval 时显示。spring-doc.cadn.net.cn

customspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

自定义触发器详情（如有）。当 type 为 custom 时存在。spring-doc.cadn.net.cn

cronspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

Cron 触发器详细信息（如果存在）。当 type 为 cron 时显示。spring-doc.cadn.net.cn

dailyTimeIntervalspring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

每日时间间隔触发器的详细信息（如果存在）。当 type 为 dailyTimeInterval 时显示。spring-doc.cadn.net.cn

simplespring-doc.cadn.net.cn

Objectspring-doc.cadn.net.cn

简单的触发器详细信息（如果存在）。当 type 为 simple 时显示。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: 518

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

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

路径 类型 描述

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

简单触发器响应结构

简单触发器用于在指定的时间点触发一个任务（Job），并可选择按指定间隔重复执行。 此类触发器实现所产生的响应类似于以下内容：spring-doc.cadn.net.cn

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

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

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

路径 类型 描述

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: 642

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

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

路径 类型 描述

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

用于计算下一次触发重复时间的间隔（毫秒），该间隔将被加到触发时间（fire time）上。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: 644

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

响应的大部分内容对所有触发器类型都是通用的。 响应中通用元素的结构已在前文描述。 下表描述了日历间隔触发器（calendar interval triggers）特有响应部分的结构：spring-doc.cadn.net.cn

路径 类型 描述

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

用于计算下一次触发重复时间的间隔（毫秒），该间隔将被加到触发时间（fire time）上。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: 437

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

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

路径 类型 描述

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