ContextQMD
Back to Influxdb

Update

content/shared/influxdb-v2/reference/cli/influx/stacks/update.md

latest4.2 KB
Original Source

The influx stacks update command updates an InfluxDB stack.

Usage

influx stacks update [flags]

Flags

FlagDescriptionInput type{{< cli/mapped >}}
--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

{{% warn %}}

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. {{% /warn %}}

Examples

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

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