kv command is used to interact with Consul's KV store via the
command line. It exposes top-level commands for inserting, updating, reading,
and deleting from the store. This command is available in Consul 0.7.1 and
The KV store is also accessible via the HTTP API.
consul kv <subcommand>
For the exact documentation for your Consul version, run
consul kv -h to view
the complete list of subcommands.
Usage: consul kv <subcommand> [options] [args] # ... Subcommands: delete Removes data from the KV store export Exports part of the KV tree in JSON format get Retrieves or lists data from the KV store import Imports part of the KV tree in JSON format put Sets or updates data in the KV store
For more information, examples, and usage about a subcommand, click on the name of the subcommand in the sidebar or one of the links below:
To create or update the key named "redis/config/connections" to the value "5" in Consul's KV store:
$ consul kv put redis/config/connections 5Success! Data written to: redis/config/connections
To read a value back from Consul:
$ consul kv get redis/config/connections5
Or you can query for detailed information:
$ consul kv get -detailed redis/config/connectionsCreateIndex 336Flags 0Key redis/config/connectionsLockIndex 0ModifyIndex 336Session -Value 5
Finally, deleting a key is just as easy:
$ consul kv delete redis/config/connectionsSuccess! Data deleted at key: redis/config/connections
For more examples, ask for subcommand help or view the subcommand documentation by clicking on one of the links in the sidebar.