docs-v2/content/flux/v0.x/stdlib/influxdata/influxdb/tasks/lastsuccess.md

1.1 KiB

title description aliases menu weight flux/v0.x/tags introduced
tasks.lastSuccess() function The `tasks.lastSuccess()` function returns the time of last successful run of the InfluxDB task or the value of the `orTime` parameter if the task has never successfully run.
/influxdb/v2.0/reference/flux/stdlib/influxdb-tasks/lastsuccess/
/influxdb/cloud/reference/flux/stdlib/influxdb-tasks/lastsuccess/
flux_0_x_ref
name parent
tasks.lastSuccess tasks
301
metadata
0.84.0

The tasks.lastSuccess() function returns the time of last successful run of the InfluxDB task or the value of the orTime parameter if the task has never successfully run.

import "influxdata/influxdb/tasks"

tasks.lastSuccess(orTime: 2020-01-01T00:00:00Z)

Parameters

orTime

The default time value returned if the task has never successfully run.

Examples

Query data since the last successful task run
import "influxdata/influxdb/tasks"

option task = {name: "Example task", every: 30m}

from(bucket: "example-bucket")
    |> range(start: tasks.lastSuccess(orTime: -task.every))
    // ...