mirror of
https://github.com/status-im/consul.git
synced 2025-01-09 13:26:07 +00:00
eab88bf92a
This commit fixes numerous spelling errors across the site and also removes unnecessary whitespace that was present in the edited files.
89 lines
2.2 KiB
Plaintext
89 lines
2.2 KiB
Plaintext
---
|
|
layout: commands
|
|
page_title: 'Commands: KV'
|
|
description: >-
|
|
The `consul kv` command interacts with Consul's key/value store. It exposes top level commands to insert, update, read, and delete data from the store.
|
|
---
|
|
|
|
# Consul KV
|
|
|
|
Command: `consul kv`
|
|
|
|
The `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
|
|
later.
|
|
|
|
The KV store is also accessible via the
|
|
[HTTP API](/consul/api-docs/kv).
|
|
|
|
## Usage
|
|
|
|
Usage: `consul kv <subcommand>`
|
|
|
|
For the exact documentation for your Consul version, run `consul kv -h` to view
|
|
the complete list of subcommands.
|
|
|
|
```text
|
|
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:
|
|
|
|
- [delete](/consul/commands/kv/delete)
|
|
- [export](/consul/commands/kv/export)
|
|
- [get](/consul/commands/kv/get)
|
|
- [import](/consul/commands/kv/import)
|
|
- [put](/consul/commands/kv/put)
|
|
|
|
## Basic Examples
|
|
|
|
To create or update the key named "redis/config/connections" to the value "5" in
|
|
Consul's KV store:
|
|
|
|
```shell-session
|
|
$ consul kv put redis/config/connections 5
|
|
Success! Data written to: redis/config/connections
|
|
```
|
|
|
|
To read a value back from Consul:
|
|
|
|
```shell-session
|
|
$ consul kv get redis/config/connections
|
|
5
|
|
```
|
|
|
|
Or you can query for detailed information:
|
|
|
|
```shell-session
|
|
$ consul kv get -detailed redis/config/connections
|
|
CreateIndex 336
|
|
Flags 0
|
|
Key redis/config/connections
|
|
LockIndex 0
|
|
ModifyIndex 336
|
|
Session -
|
|
Value 5
|
|
```
|
|
|
|
Finally, deleting a key is just as easy:
|
|
|
|
```shell-session
|
|
$ consul kv delete redis/config/connections
|
|
Success! 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.
|