influx task create

  • influx CLI 2.0.0+
  • InfluxDB 2.0.0+

The influx task create command creates a task in InfluxDB.

Usage

  1. influx task create [task literal] [flags]

Flags

FlagDescriptionInput typeMaps to ?
-c—active-configCLI configuration to use for commandstring
—configs-pathPath to influx CLI configurations (default ~/.influxdbv2/configs)stringINFLUX_CONFIGS_PATH
-f—filePath to Flux script filestring
-h—helpHelp for the create command
—hide-headersHide table headers (default false)INFLUX_HIDE_HEADERS
—hostHTTP address of InfluxDB (default http://localhost:8086)stringINFLUX_HOST
—http-debugInspect communication with InfluxDB servers.string
—jsonOutput data as JSON (default false)INFLUX_OUTPUT_JSON
-o—orgOrganization name (mutually exclusive with —org-id)stringINFLUX_ORG
—org-idOrganization ID (mutually exclusive with —org)stringINFLUX_ORG_ID
—skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
-t—tokenAPI tokenstringINFLUX_TOKEN

Example

Authentication credentials

The examples below assume your InfluxDB host, organization, and token are provided by the active influx CLI configuration. If you do not have a CLI configuration set up, use the appropriate flags to provide these required credentials.

Create a task using raw Flux
  1. export FLUX_TASK='
  2. option task = {
  3. name: "Example Task",
  4. every: 1d
  5. }
  6. from(bucket: "example-bucket")
  7. |> range(start: -task.every)
  8. |> filter(fn: (r) => (r._measurement == "m")
  9. |> aggregateWindow(every: 1h, fn: mean)
  10. |> to(bucket: "default-ds-1d", org: "my-org")
  11. '
  12. influx task create $FLUX_TASK
Create a task from a file
  1. influx task create --file /path/to/example-task.flux