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

4.9 KiB

title description menu weight metadata
influx task retry-failed The `influx task retry-failed` command retries failed InfluxDB task runs.
influxdb_2_2_ref
name parent
influx task retry-failed influx task
201
influx CLI 2.0.5+
InfluxDB 2.0.5+

The influx task retry-failed command retries failed InfluxDB task runs.

Usage

influx task retry-failed [flags]

Flags

Flag Description Input type {{< cli/mapped >}}
--after Retry task runs that occurred after this time (RFC3339 timestamp) string
-c --active-config CLI configuration to use for command string
--configs-path Path to influx CLI configurations (default ~/.influxdbv2/configs) string INFLUX_CONFIGS_PATH
--before Retry task runs that occurred before this time (RFC3339 timestamp) string
--dry-run Print information about task runs that would be retried
-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
-i --id Task ID string
--json Output data as JSON (default false) INFLUX_OUTPUT_JSON
-o --org Task organization name string INFLUX_ORG
--org-id Task organization ID string INFLUX_ORG_ID
--run-limit Maximum number of failed runs to retry per task (1-500, default 100) integer
--skip-verify Skip TLS certificate verification INFLUX_SKIP_VERIFY
--task-limit Maximum number of tasks to retry failed runs for (1-500, default 100) integer
-t --token API token string INFLUX_TOKEN

Examples

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

{{% note %}}

Required permissions

Use an {{% oss-only %}}Operator or{{% /oss-only %}} All-Access token to retry failed tasks. {{% /note %}}

Retry failed task runs for a specific task ID
influx task retry-failed \
  --id 0Xx0oox00XXoxxoo1
Retry failed task runs that occurred before a specific time
influx task retry-failed \
  --before 2021-01-01T00:00:00Z
Retry failed task runs that occurred after a specific time
influx task retry-failed \
  --after 2021-01-01T00:00:00Z
Retry failed task runs that occurred in a specific time range
influx task retry-failed \
  --after 2021-01-01T00:00:00Z \
  --before 2021-01-01T23:59:59Z
Retry failed runs for a limited number of tasks
influx task retry-failed \
  --task-limit 5
Retry a limited number of failed runs for a task
influx task retry-failed \
  --id 0Xx0oox00XXoxxoo1 \
  --run-limit 5
Print information about runs that will be retried
influx task retry-failed \
  --dry-run