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

1. 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 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

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, --org or --org-id: InfluxDB organization name or ID
  • -t, --token: InfluxDB API token

Create a replication stream

  1. Create a remote connection, if you haven’t already.
  2. Use influx remote list to get the ID for the remote you want to replicate data to.

1. $ influx remote list 2. ID Name Org ID 3. 0ooxX0xxXo0x myremote [...] 3. Create the replication:

1. influx replication create \ 2. --name myreplication 3. --local-bucket example-local-bucket 4. --remote-bucket example-remote-bucket 5. --remote-id 0ooxX0xxXo0x

write