influx stacks update

  • influx CLI 2.0.1+
  • InfluxDB 2.0.1+
  • Updated in CLI v2.0.4

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 stacks update command updates an InfluxDB stack.

Usage

  1. influx stacks update [flags]

Flags

FlagDescriptionInput typeMaps to ?
—addResourceAssociate an existing resource with a stackstring
-c—active-configCLI configuration to use for commandstring
—configs-pathPath to influx CLI configurations (default ~/.influxdbv2/configs)stringINFLUX_CONFIGS_PATH
-f—export-fileDestination for exported templatestring
-h—helpHelp for the update 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—stack-idThe stack ID to updatestring
—jsonOutput data as JSON (default false)INFLUX_OUTPUT_JSON
—skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
-d—stack-descriptionStack descriptionstring
-n—stack-nameStack namestring
-u—template-urlTemplate URLs to associate with a stacklist of strings
-t—tokenAPI tokenstringINFLUX_TOKEN

Export an updated template

To prevent accidental changes, we strongly recommend exporting a new template any time you add additional resources to a stack using the --addResource flag with the influx stack update command. The updated stack will differ from the previous template. If you apply the outdated template, InfluxDB will revert the updates and remove the added resources.

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:

Update a stack with a name and description
  1. influx stack update \
  2.   -i ab12cd34ef56 \
  3.   -n "New stack name" \
  4.   -d "New stack description"
Update a stack with a name and URLs to associate with stack
  1. influx stack update \
  2.   -i ab12cd34ef56 \
  3.   -n "New stack name" \
  4.   --template-url https://example.com/template-1.yml \
  5.   --template-url https://example.com/template-2.yml
Update a stack with new resources to manage
  1. influx stacks update \
  2.     --stack-id ab12cd34ef56 \
  3.     --addResource=Bucket=12ab34cd56ef \
  4.     --addResource=Dashboard=98zy76xw54vu
Update a stack with new resources and export the stack as a template
  1. influx stacks update \
  2.     --stack-id ab12cd34ef56 \
  3.     --addResource=Bucket=12ab34cd56ef \
  4.     --export-file /path/to/template-file.yml

templates