influx task run list
- influx CLI 2.0.0+
- InfluxDB 2.0.0+
The influx task run list
command outputs information related to runs of a task.
Usage
influx task run list [flags]
Command aliases
list
, ls
, find
Flags
Flag | Description | Input type | Maps to ? | |
---|---|---|---|---|
-c | —active-config | CLI configuration to use for command | string | |
—after | After-time for filtering | string | ||
—before | Before-time for filtering | string | ||
—configs-path | Path to influx CLI configurations (default ~/.influxdbv2/configs ) | string | INFLUX_CONFIGS_PATH | |
-h | —help | Help for the list 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 | ||
—json | Output data as JSON (default false ) | INFLUX_OUTPUT_JSON | ||
—limit | Limit the number of results | integer | ||
—run-id | Run ID | string | ||
—skip-verify | Skip TLS certificate verification | INFLUX_SKIP_VERIFY | ||
—task-id | (Required) Task ID | string | ||
-t | —token | API token | string | INFLUX_TOKEN |
Examples
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- List a specific run of a task
- Limit the number of returned task runs to 20
List all runs of a task
influx task run list --task-id 0Xx0oox00XXoxxoo1
List a specific run of a task
influx task run list \
--task-id 0Xx0oox00XXoxxoo1 \
--run-id ox0Xx0ooxx00XXoo2
Limit the number of returned task runs to 20
influx task run list \
--task-id 0Xx0oox00XXoxxoo1 \
--limit 20
Related
- Process data with InfluxDB tasks
- influx CLI—Provide required authentication credentials
- influx CLI—Flag patterns and conventions