content/shared/influxdb-v2/reference/cli/influx/task/update.md
The influx task update command updates information related to tasks in InfluxDB.
influx task update [task literal] [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 | ||
--script-id | (InfluxDB Cloud only) Invokable script ID to execute | string | ||
--script-params | (InfluxDB Cloud only) Invokable script JSON parameters | string | ||
--status | Update task status (active or inactive) | string | ||
-t | --token | API token | string | INFLUX_TOKEN |
{{< cli/influx-creds-note >}}
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 \
--id 0001234 \
$UPDATED_FLUX_TASK
influx task update \
--id 0001234 \
--file /path/to/example-task.flux
influx task update \
--id 0001234 \
--script-id 0004567
influx task update \
--id 0001234 \
--status active
influx task update \
--id 0001234 \
--status inactive