Back to Influxdb

Update

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

latest4.2 KB
Original Source

[!Important] 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

FlagDescriptionInput type{{< cli/mapped >}}
-i--idReplication stream ID to updatestring
-n--nameNew replication stream namestring
-d--descriptionNew replication stream descriptionstring
--remote-idNew remote connection ID to send data tostring
--remote-bucketRemote bucket name to replicate data to (mutually exclusive with --remote-bucket-id)string
--remote-bucket-idRemote bucket ID to replicate data to (mutually exclusive with --remote-bucket-name)string
--max-queue-bytesNew max queue size in bytes (default: 0)integer
--drop-non-retryable-dataDrop data when a non-retryable error is encountered
--no-drop-non-retryable-dataDo not drop data when a non-retryable error is encountered
--max-ageSpecify a maximum age (in seconds) for data before it is droppedinteger
--hostInfluxDB HTTP address (default http://localhost:8086)stringINFLUX_HOST
--skip-verifySkip TLS certificate verificationINFLUX_SKIP_VERIFY
--configs-pathPath to influx CLI configurations (default ~/.influxdbv2/configs)stringINFLUX_CONFIGS_PATH
-c--active-configCLI configuration to use for commandstring
--http-debugInspect communication with InfluxDB serversstring
--jsonOutput data as JSON (default false)INFLUX_OUTPUT_JSON
--hide-headersHide table headers (default false)INFLUX_HIDE_HEADERS
-t--tokenInfluxDB API tokenstringINFLUX_TOKEN

Example

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

Update a replication

  1. Use influx replication list to get the ID for the replication you want to update.
    sh
    $ influx replication list
    ID			        Name		Org ID
    0ooxX0xxXo0x      	    myreplication    [...]
    
  2. Use the following command to update the replication:
    sh
    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