Cron binding spec
Detailed documentation on the cron binding component
Component format
To setup cron binding create a component of type bindings.cron. See this guide on how to create and apply a binding configuration.
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
name: <NAME>
namespace: <NAMESPACE>
spec:
type: bindings.cron
version: v1
metadata:
- name: schedule
value: "@every 15m" # valid cron schedule
Spec metadata fields
| Field | Required | Binding support | Details | Example |
|---|---|---|---|---|
| schedule | Y | Input/Output | The valid cron schedule to use. See this for more details | "@every 15m" |
Schedule Format
The Dapr cron binding supports following formats:
| Character | Descriptor | Acceptable values |
|---|---|---|
| 1 | Second | 0 to 59, or * |
| 2 | Minute | 0 to 59, or * |
| 3 | Hour | 0 to 23, or * (UTC) |
| 4 | Day of the month | 1 to 31, or * |
| 5 | Month | 1 to 12, or * |
| 6 | Day of the week | 0 to 7 (where 0 and 7 represent Sunday), or * |
For example:
30 * * * * *- every 30 seconds0 15 * * * *- every 15 minutes0 30 3-6,20-23 * * *- every hour on the half hour in the range 3-6am, 8-11pmCRON_TZ=America/New_York 0 0 30 04 * * *- every day at 4:30am New York time
You can learn more about cron and the supported formats here
For ease of use, the Dapr cron binding also supports few shortcuts:
@every 15swheresis seconds,mminutes, andhhours@dailyor@hourlywhich runs at that period from the time the binding is initialized
Binding support
This component supports both input and output binding interfaces.
This component supports output binding with the following operations:
delete
Related links
- Basic schema for a Dapr component
- Bindings building block
- How-To: Trigger application with input binding
- How-To: Use bindings to interface with external resources
- Bindings API reference
Last modified May 22, 2021: docs: clean up white noise (#1491) (fe1ab8eb)