Documentation

influx replication update

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

Replication remotes and replication streams can only be configured for InfluxDB OSS.

The influx replication update command updates an InfluxDB replication stream.

Usage

influx replication update [command options] [arguments...]

Flag

Flag Description Input type Maps to ?
-i --id Replication stream ID to update string
-n --name New replication stream name string
-d --description New replication stream description string
--remote-id New remote connection ID to send data to string
--remote-bucket-id New remote bucket ID to replicate data to string
--max-queue-bytes New max queue size in bytes (default: 0) integer
--drop-non-retryable-data Drop data when a non-retryable error is encountered
--no-drop-non-retryable-data Do not drop data when a non-retryable error is encountered
--max-age Specify a maximum age (in seconds) for data before it is dropped integer
--host InfluxDB HTTP address (default http://localhost:8086) string INFLUX_HOST
--skip-verify Skip TLS certificate verification INFLUX_SKIP_VERIFY
--configs-path Path to influx CLI configurations (default ~/.influxdbv2/configs) string INFLUX_CONFIGS_PATH
-c --active-config CLI configuration to use for command string
--http-debug Inspect communication with InfluxDB servers string
--json Output data as JSON (default false) INFLUX_OUTPUT_JSON
--hide-headers Hide table headers (default false) INFLUX_HIDE_HEADERS
-t --token InfluxDB API token string INFLUX_TOKEN

Example

Authentication credentials

The examples below assume your InfluxDB host, organization, and token are provided by the active influx CLI configuration. If you do not have a CLI configuration set up, use the appropriate flags to provide these required credentials.

Update a replication

  1. Use influx replication list to get the ID for the replication you want to update.
    $ influx replication list
    ID			        Name		Org ID
    0ooxX0xxXo0x      	    myreplication    [...]
    
  2. Use the following command to update the replication:
    influx replication update \
      --id 0ooxX0xxXo0x
      --name new-replication-name
      --description new-replication-description
      --replication-url http://new-replication-url.com
      --replication-api-token new-replication-api-token
      --replication-org-id new-replication-org-id
    

Was this page helpful?

Thank you for your feedback!


Set your InfluxDB URL

Upgrade to InfluxDB Cloud or InfluxDB 2.0!

InfluxDB Cloud and InfluxDB OSS 2.0 ready for production.