influx telegrafs update

  • influx CLI 2.0.0+
  • InfluxDB 2.0.0+

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 telegrafs update command updates a Telegraf configuration to match the specified parameters. If a name or description are not provided, they are set to an empty string.

Usage

  1. influx telegrafs update [flags]

Flags

FlagDescriptionInput typeMaps to ?
-c—active-configCLI configuration to use for commandstring
—configs-pathPath to influx CLI configurations (default ~/.influxdbv2/configs)stringINFLUX_CONFIGS_PATH
-d—descriptionTelegraf configuration descriptionstring
-f—filePath to Telegraf configurationstring
-h—helpHelp for the update command
—hide-headersHide table headersINFLUX_HIDE_HEADERS
—jsonOutput data as JSONINFLUX_OUTPUT_JSON
-n—nameTelegraf configuration namestring
-o—orgOrganization name (mutually exclusive with —org-id)stringINFLUX_ORG
—org-idOrganization ID (mutually exclusive with —org)stringINFLUX_ORG_ID
—skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
-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
Update a Telegraf configuration
  1. influx telegrafs update \
  2. --id 0Xx0oox00XXoxxoo1 \
  3. --name "Example configuration name" \
  4. --description "Example Telegraf configuration description" \
  5. --file /path/to/telegraf.conf
Update a Telegraf configuration via stdin
  1. cat /path/to/telegraf.conf | influx telegrafs update \
  2. --id 0Xx0oox00XXoxxoo1 \
  3. --name "Example configuration name" \
  4. --description "Example Telegraf configuration description" \