2019-06-10 17:41:55 +00:00
|
|
|
---
|
2020-01-18 00:18:09 +00:00
|
|
|
layout: docs
|
|
|
|
page_title: kv list - Command
|
2019-06-10 17:41:55 +00:00
|
|
|
description: |-
|
|
|
|
The "kv list" command lists data from Vault's K/V secrets engine at the given
|
|
|
|
path.
|
|
|
|
---
|
|
|
|
|
|
|
|
# kv list
|
|
|
|
|
|
|
|
The `kv list` command returns a list of key names at the specified location.
|
|
|
|
Folders are suffixed with /. The input must be a folder; list on a file will not
|
|
|
|
return a value. Note that no policy-based filtering is performed on keys; do not
|
|
|
|
encode sensitive information in key names. The values themselves are not
|
|
|
|
accessible via this command.
|
|
|
|
|
|
|
|
Use this command to list all existing key names at a specific path.
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
List values under the key "my-app":
|
|
|
|
|
2020-05-21 17:18:17 +00:00
|
|
|
```shell-session
|
2023-03-20 20:26:21 +00:00
|
|
|
$ vault kv list -mount=secret my-app/
|
2019-06-10 17:41:55 +00:00
|
|
|
Keys
|
|
|
|
----
|
|
|
|
admin_creds
|
|
|
|
domain
|
|
|
|
eng_creds
|
|
|
|
qa_creds
|
|
|
|
release
|
|
|
|
```
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
2023-01-26 00:12:15 +00:00
|
|
|
There are no flags beyond the [standard set of flags](/vault/docs/commands)
|
2019-06-10 17:41:55 +00:00
|
|
|
included on all commands.
|
|
|
|
|
2023-07-18 21:07:55 +00:00
|
|
|
### Output options
|
2019-06-10 17:41:55 +00:00
|
|
|
|
2023-03-20 20:26:21 +00:00
|
|
|
- `-mount` `(string: "")` - Specifies the path where the KV backend is mounted.
|
|
|
|
If specified, the next argument will be interpreted as the secret path. If
|
|
|
|
this flag is not specified, the next argument will be interpreted as the
|
|
|
|
combined mount path and secret path, with /data/ automatically inserted for
|
|
|
|
KV v2 secrets.
|
|
|
|
|
2019-06-10 17:41:55 +00:00
|
|
|
- `-format` `(string: "table")` - Print the output in the given format. Valid
|
|
|
|
formats are "table", "json", or "yaml". This can also be specified via the
|
|
|
|
`VAULT_FORMAT` environment variable.
|