MultipleCondition

type: "io.kestra.plugin.core.condition.MultipleCondition"

Run a flow if the list of preconditions are met in a time window.

This task is deprecated, use io.kestra.plugin.core.condition.ExecutionsWindow or io.kestra.plugin.core.condition.FilteredExecutionsWindow instead. Will trigger an executions when all the flows defined by the preconditions are successfully executed in a specific period of time. The period is defined by the timeSLA property and is by default a duration window of 24 hours.

Examples

A flow that is waiting for 2 flows to run successfully in a day

triggers:
  - id: multiple-listen-flow
    type: io.kestra.plugin.core.trigger.Flow
    conditions:
      - type: io.kestra.plugin.core.condition.ExecutionStatus
        in:
        - SUCCESS
      - id: multiple
        type: io.kestra.plugin.core.condition.MultipleCondition
        sla:
          window: PT12H
        conditions:
          flow-a:
            type: io.kestra.plugin.core.condition.ExecutionFlow
            namespace: io.kestra.demo
            flowId: multiplecondition-flow-a
          flow-b:
            type: io.kestra.plugin.core.condition.ExecutionFlow
            namespace: io.kestra.demo
            flowId: multiplecondition-flow-b

Properties

conditions

• Type: object
• SubType: Condition
• Dynamic: ❌
• Required: ✔️

The list of preconditions to wait for

The key must be unique for a trigger because it will be used to store the previous evaluation result.

id

• Type: string
• Dynamic: ❌
• Required: ✔️
• Validation regExp: ^[a-zA-Z0-9][a-zA-Z0-9_-]*
• Min length: 1

A unique id for the condition

resetOnSuccess

• Type: boolean
• Dynamic: ❌
• Required: ✔️
• Default: true

Whether to reset the evaluation results of SLA conditions after a first successful evaluation within the given time period.

By default, after a successful evaluation of the set of SLA conditions, the evaluation result is reset, so, the same set of conditions needs to be successfully evaluated again in the same time period to trigger a new execution. This means that to create multiple executions, the same set of conditions needs to be evaluated to true multiple times. You can disable this by setting this property to false so that, within the same period, each time one of the conditions is satisfied again after a successful evaluation, it will trigger a new execution.

timeWindow

• Type: TimeWindow
• Dynamic: ❌
• Required: ❌
• Default: {type=DURATION_WINDOW}

Define the time period (or window) for evaluating preconditions.

You can set the type of sla to one of the following values:

1. DURATION_WINDOW: this is the default type. It uses a start time (windowAdvance) and end time (window) that are moving forward to the next interval whenever the evaluation time reaches the end time, based on the defined duration window. For example, with a 1-day window (the default option: window: PT1D), the SLA conditions are always evaluated during 24h starting at midnight (i.e. at time 00:00:00) each day. If you set windowAdvance: PT6H, the window will start at 6 AM each day. If you set windowAdvance: PT6H and you also override the window property to PT6H, the window will start at 6 AM and last for 6 hours — as a result, Kestra will check the SLA conditions during the following time periods: 06:00 to 12:00, 12:00 to 18:00, 18:00 to 00:00, and 00:00 to 06:00, and so on.
2. SLIDING_WINDOW: this option also evaluates SLA conditions over a fixed time window, but it always goes backward from the current time. For example, a sliding window of 1 hour (window: PT1H) will evaluate executions for the past hour (so between now and one hour before now). It uses a default window of 1 day.
3. DAILY_TIME_DEADLINE: this option declares that some SLA conditions should be met "before a specific time in a day". With the string property deadline, you can configure a daily cutoff for checking conditions. For example, deadline: "09:00:00" means that the defined SLA conditions should be met from midnight until 9 AM each day; otherwise, the flow will not be triggered.
4. DAILY_TIME_WINDOW: this option declares that some SLA conditions should be met "within a given time range in a day". For example, a window from startTime: "06:00:00" to endTime: "09:00:00" evaluates executions within that interval each day. This option is particularly useful for declarative definition of freshness conditions when building data pipelines. For example, if you only need one successful execution within a given time range to guarantee that some data has been successfully refreshed in order for you to proceed with the next steps of your pipeline, this option can be more useful than a strict DAG-based approach. Usually, each failure in your flow would block the entire pipeline, whereas with this option, you can proceed with the next steps of the pipeline as soon as the data is successfully refreshed at least once within the given time range.

window

• Type: string
• Dynamic: ❌
• Required: ❌
• Format: duration

The duration of the window

Deprecated, use timeSLA.window instead.

windowAdvance

• Type: string
• Dynamic: ❌
• Required: ❌
• Format: duration

The window advance duration

Deprecated, use timeSLA.windowAdvance instead.

Definitions

io.kestra.core.models.triggers.TimeWindow

Properties

deadline

• Type: string
• Dynamic: ❌
• Required: ❌
• Format: partial-time

SLA daily deadline

Use it only for DAILY_TIME_DEADLINE SLA.

endTime

• Type: string
• Dynamic: ❌
• Required: ❌
• Format: partial-time

SLA daily end time

Use it only for DAILY_TIME_WINDOW SLA.

startTime

• Type: string
• Dynamic: ❌
• Required: ❌
• Format: partial-time

SLA daily start time

Use it only for DAILY_TIME_WINDOW SLA.

window

• Type: string
• Dynamic: ❌
• Required: ❌
• Format: duration

The duration of the window

Use it only for DURATION_WINDOW or SLIDING_WINDOW SLA. See ISO_8601 Durations for more information of available duration value. The start of the window is always based on midnight except if you set windowAdvance parameter. Eg if you have a 10 minutes (PT10M) window, the first window will be 00:00 to 00:10 and a new window will be started each 10 minutes

windowAdvance

• Type: string
• Dynamic: ❌
• Required: ❌
• Format: duration

The window advance duration

Use it only for DURATION_WINDOW SLA. Allow to specify the start time of the window Eg: you want a window of 6 hours (window=PT6H), by default the check will be done between: 00:00 and 06:00, 06:00 and 12:00, 12:00 and 18:00, and 18:00 and 00:00. If you want to check the window between 03:00 and 09:00, 09:00 and 15:00, 15:00 and 21:00, and 21:00 and 3:00, you will have to shift the window of 3 hours by settings windowAdvance: PT3H