influx stacks update

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

The influx stacks update command updates an InfluxDB stack.

Usage

1. influx stacks update [flags]

Flags

Flag Description Input type Maps to ?
—addResource Associate an existing resource with a stack 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
-f —export-file Destination for exported template string
-h —help Help for the update 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 —stack-id The stack ID to update string
—json Output data as JSON (default false) INFLUX_OUTPUT_JSON
—skip-verify Skip TLS certificate verification INFLUX_SKIP_VERIFY
-d —stack-description Stack description string
-n —stack-name Stack name string
-u —template-url Template URLs to associate with a stack list of strings
-t —token API token string INFLUX_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