2113ae1021
* Add explanation to help text and flag usage text * KV get with new mount flag * Clearer naming * KV Put, Patch, Metadata Get + corresponding tests * KV Delete, Destroy, Rollback, Undelete, MetadataDelete, MetadataPatch, MetadataPut * Update KV-v2 docs to use mount flag syntax * Add changelog * Run make fmt * Clarify deprecation message in help string * Address style comments
55 lines
1.4 KiB
Go
55 lines
1.4 KiB
Go
package command
|
|
|
|
import (
|
|
"strings"
|
|
|
|
"github.com/mitchellh/cli"
|
|
)
|
|
|
|
var _ cli.Command = (*KVMetadataCommand)(nil)
|
|
|
|
type KVMetadataCommand struct {
|
|
*BaseCommand
|
|
}
|
|
|
|
func (c *KVMetadataCommand) Synopsis() string {
|
|
return "Interact with Vault's Key-Value storage"
|
|
}
|
|
|
|
func (c *KVMetadataCommand) Help() string {
|
|
helpText := `
|
|
Usage: vault kv metadata <subcommand> [options] [args]
|
|
|
|
This command has subcommands for interacting with the metadata endpoint in
|
|
Vault's key-value store. Here are some simple examples, and more detailed
|
|
examples are available in the subcommands or the documentation.
|
|
|
|
Create or update a metadata entry for a key:
|
|
|
|
$ vault kv metadata put -mount=secret -max-versions=5 -delete-version-after=3h25m19s foo
|
|
|
|
Get the metadata for a key, this provides information about each existing
|
|
version:
|
|
|
|
$ vault kv metadata get -mount=secret foo
|
|
|
|
Delete a key and all existing versions:
|
|
|
|
$ vault kv metadata delete -mount=secret foo
|
|
|
|
The deprecated path-like syntax can also be used, but this should be avoided
|
|
for KV v2, as the fact that it is not actually the full API path to
|
|
the secret (secret/metadata/foo) can cause confusion:
|
|
|
|
$ vault kv metadata get secret/foo
|
|
|
|
Please see the individual subcommand help for detailed usage information.
|
|
`
|
|
|
|
return strings.TrimSpace(helpText)
|
|
}
|
|
|
|
func (c *KVMetadataCommand) Run(args []string) int {
|
|
return cli.RunResultHelp
|
|
}
|