influx task retry-failed

  • influx CLI 2.0.5+
  • InfluxDB 2.0.5+

This page documents an earlier version of InfluxDB. InfluxDB v2.7 is the latest stable version. View this page in the v2.7 documentation.

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

Usage

  1. influx task retry-failed [flags]

Flags

FlagDescriptionInput typeMaps to ?
—afterRetry task runs that occurred after this time (RFC3339 timestamp)string
-c—active-configCLI configuration to use for commandstring
—configs-pathPath to influx CLI configurations (default ~/.influxdbv2/configs)stringINFLUX_CONFIGS_PATH
—beforeRetry task runs that occurred before this time (RFC3339 timestamp)string
—dry-runPrint information about task runs that would be retried
-h—helpHelp for the list command
—hide-headersHide table headers (default false)INFLUX_HIDE_HEADERS
—hostHTTP address of InfluxDB (default http://localhost:8086)stringINFLUX_HOST
—http-debugInspect communication with InfluxDB servers.string
-i—idTask IDstring
—jsonOutput data as JSON (default false)INFLUX_OUTPUT_JSON
-o—orgTask organization namestringINFLUX_ORG
—org-idTask organization IDstringINFLUX_ORG_ID
—run-limitMaximum number of failed runs to retry per task (1-500, default 100)integer
—skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
—task-limitMaximum number of tasks to retry failed runs for (1-500, default 100)integer
-t—tokenAPI tokenstringINFLUX_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

Required permissions

Use an Operator or All-Access token to retry failed tasks.

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