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
1. 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, --orgor--org-id: InfluxDB organization name or ID-t, --token: InfluxDB API token- List all runs of a task
- List a specific run of a task
- Limit the number of returned task runs to 20
List all runs of a task
1. influx task run list --task-id 0Xx0oox00XXoxxoo1
List a specific run of a task
1. influx task run list \
2. --task-id 0Xx0oox00XXoxxoo1 \
3. --run-id ox0Xx0ooxx00XXoo2
Limit the number of returned task runs to 20
1. influx task run list \
2. --task-id 0Xx0oox00XXoxxoo1 \
3. --limit 20
Related
- Process data with InfluxDB tasks
- influx CLI—Provide required authentication credentials
- influx CLI—Flag patterns and conventions
