influx replication update
Replication remotes and replication streams can only be configured for InfluxDB OSS.
The influx replication update command updates an InfluxDB replication stream.
Usage
1. 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 |
Remote bucket name to replicate data to (mutually exclusive with —remote-bucket-id) |
string | ||
—remote-bucket-id |
Remote bucket ID to replicate data to (mutually exclusive with —remote-bucket-name) |
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 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:
--host: InfluxDB host-o, --orgor--org-id: InfluxDB organization name or ID-t, --token: InfluxDB API token
Update a replication
- Use
influx replication listto get the ID for the replication you want to update.
1. $ influx replication list
2. ID Name Org ID
3. 0ooxX0xxXo0x myreplication [...]
2. Use the following command to update the replication:
1. influx replication update \
2. --id 0ooxX0xxXo0x
3. --name new-replication-name
4. --description new-replication-description
5. --replication-url http://new-replication-url.com
6. --replication-api-token new-replication-api-token
7. --replication-org-id new-replication-org-id
