influx task create

• influx CLI 2.0.0+
• InfluxDB 2.0.0+

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version. View this page in the v2.7 documentation.

The influx task create command creates a task in InfluxDB.

Usage

influx task create [task literal] [flags]

Flags

Example

Authentication credentials

The examples below assume your InfluxDB host, organization, and token are provided by either the active influx CLI configuration or by environment variables (INFLUX_HOST, INFLUX_ORG, and INFLUX_TOKEN). If you do not have a CLI configuration set up or the environment variables set, include these required credentials for each command with the following flags:

• --host: InfluxDB host
• -o, --org or --org-id: InfluxDB organization name or ID
• -t, --token: InfluxDB API token

Create a task using raw Flux

export FLUX_TASK='
  option task = {
    name: "Example Task",
    every: 1d
  }
  from(bucket: "example-bucket")
    |> range(start: -task.every)
    |> filter(fn: (r) => r._measurement == "m")
    |> aggregateWindow(every: 1h, fn: mean)
    |> to(bucket: "default-ds-1d", org: "my-org")
'
influx task create $FLUX_TASK

Create a task from a file

influx task create --file /path/to/example-task.flux

Related

• Process data with InfluxDB tasks
• influx CLI—Provide required authentication credentials
• influx CLI—Flag patterns and conventions