docs-v2/content/influxdb/v2.2/reference/cli/influx/task/update.md

3.1 KiB

title description menu weight
influx task update The `influx task update` command updates information related to tasks in InfluxDB.
influxdb_2_2_ref
name parent
influx task update influx task
201

The influx task update command updates information related to tasks in InfluxDB.

Usage

influx task update [task literal] [flags]

Flags

Flag Description Input type {{< cli/mapped >}}
-c --active-config CLI configuration to use for command string
--configs-path Path to influx CLI configurations (default ~/.influxdbv2/configs) string INFLUX_CONFIGS_PATH
-f --file Path to Flux script file string
-h --help Help for the update command
--hide-headers Hide table headers (default false) INFLUX_HIDE_HEADERS
--host HTTP address of InfluxDB (default http://localhost:8086) string INFLUX_HOST
--http-debug Inspect communication with InfluxDB servers. string
-i --id ({{< req >}}) Task ID string
--json Output data as JSON (default false) INFLUX_OUTPUT_JSON
--skip-verify Skip TLS certificate verification INFLUX_SKIP_VERIFY
--status Update task status (active or inactive) string
-t --token API token string INFLUX_TOKEN

Example

{{< cli/influx-creds-note >}}

Update a task from a Flux string
export UPDATED_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 update $UPDATED_FLUX_TASK
Update a task from a Flux file
influx task update --file /path/to/example-task.flux
Enable a task
influx task update --status active
Disable a task
influx task update --status inactive