docs-v2/content/influxdb/v2.2/reference/cli/influx/remote/update.md

title	description	menu	weight	influxdb/v2.2/tags	related
influx remote update	Update remote InfluxDB connections used for for replicating data.	influxdb_2_2_ref name parent influx remote update influx remote	102	write replication	/influxdb/v2.2/reference/cli/influx/replication

{{% cloud %}} Replication remotes and replication streams can only be configured for InfluxDB OSS. {{% /cloud %}}

The influx remote update command updates an existing InfluxDB remote connection used for replicating data.

Usage

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

Flags

Flag		Description	Input type	{{< cli/mapped >}}
-i	--id	Remote connection ID to update	string
-n	--name	New name for the remote connection	string
-d	--description	New remote connection description	string
	--remote-url	New remote InfluxDB URL	string
	--remote-api-token	New remote InfluxDB API token	string
	--remote-org-id	New remote organization ID	string
	--allow-insecure-tls	Allows insecure TLS connections
	--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

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

Update a remote

1. Use influx remote list to get the ID for the remote you want to update.

   $ influx remote list
   ID			        Name		Org ID
   0ooxX0xxXo0x 	    myremote    [...]
   

2. Use the following command to update the remote:

   influx remote remote \
     --id 0ooxX0xxXo0x
     --name new-example-name
     --description new-examle-description
     --remote-url http://new-example-url.com
     --remote-api-token myN3wS3crE7t0k3n==
     --remote-org-id new-example-org-id