influx replication create
Replication remotes and replication streams can only be configured for InfluxDB OSS.
The influx replication create command creates a new InfluxDB replication stream.
Usage
influx replication create [command options] [arguments...]
Flags
| Flag | Description | Input type | Maps to ? | |
|---|---|---|---|---|
-n | --name | Replication stream name | string | |
-d | --description | Replication stream description | string | |
--org-id | Local organization ID | string | INFLUX_ORG_ID | |
-o | --org | Local organization name | string | INFLUX_ORG |
--remote-id | Remote connection ID to replicate data to | string | ||
--local-bucket-id | Local bucket ID to replicate data from | 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 | Max queue size in bytes (default: 67108860) | 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 https://127.0.0.1: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 |
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
--host: InfluxDB host-o, --orgor--org-id: InfluxDB organization name or ID-t, --token: InfluxDB API token
Create a replication stream
- Create a remote connection, if you haven’t already.
- Use
influx remote listto get the ID for the remote you want to replicate data to.$ influx remote list ID Name Org ID 0ooxX0xxXo0x myremote [...] - Create the replication
influx replication create \ --name myreplication --local-bucket example-local-bucket --remote-bucket example-remote-bucket --remote-id 0ooxX0xxXo0x
Was this page helpful?
Thank you for your feedback!
Support and feedback
Thank you for being part of our community! We welcome and encourage your feedback and bug reports for InfluxDB and this documentation. To find support, use the following resources
Customers with an annual or support contract can contact InfluxData Support.