5c84c36915
* Add more cli subcommands * Add metadata commands * Add more subcommands * Update cli * Move archive commands to delete * Add helpers for making http calls to the kv backend * rename cli header * Format the various maps from kv * Add list command * Update help text * Add a command to enable versioning on a backend * Rename enable-versions command * Some review feedback * Fix listing of top level keys * Fix issue when metadata is nil * Add test for lising top level keys * Fix some typos * Add a note about deleting all versions
136 lines
3 KiB
Go
136 lines
3 KiB
Go
package command
|
||
|
||
import (
|
||
"fmt"
|
||
"io"
|
||
"strings"
|
||
|
||
"github.com/mitchellh/cli"
|
||
"github.com/posener/complete"
|
||
)
|
||
|
||
var _ cli.Command = (*KVMetadataPutCommand)(nil)
|
||
var _ cli.CommandAutocomplete = (*KVMetadataPutCommand)(nil)
|
||
|
||
type KVMetadataPutCommand struct {
|
||
*BaseCommand
|
||
|
||
flagMaxVersions int
|
||
flagCASRequired bool
|
||
testStdin io.Reader // for tests
|
||
}
|
||
|
||
func (c *KVMetadataPutCommand) Synopsis() string {
|
||
return "Sets or updates key settings in the KV store"
|
||
}
|
||
|
||
func (c *KVMetadataPutCommand) Help() string {
|
||
helpText := `
|
||
Usage: vault metadata kv put [options] KEY [DATA]
|
||
|
||
This command can be used to create a blank key in the key-value store or to
|
||
update key configuration for a specified key.
|
||
|
||
Create a key in the key-value store with no data:
|
||
|
||
$ vault kv metadata put secret/foo
|
||
|
||
Set a max versions setting on the key:
|
||
|
||
$ vault kv metadata put -max-versions=5 secret/foo
|
||
|
||
Require Check-and-Set for this key:
|
||
|
||
$ vault kv metadata put -require-cas secret/foo
|
||
|
||
Additional flags and more advanced use cases are detailed below.
|
||
|
||
` + c.Flags().Help()
|
||
return strings.TrimSpace(helpText)
|
||
}
|
||
|
||
func (c *KVMetadataPutCommand) Flags() *FlagSets {
|
||
set := c.flagSet(FlagSetHTTP | FlagSetOutputFormat)
|
||
|
||
// Common Options
|
||
f := set.NewFlagSet("Common Options")
|
||
|
||
f.IntVar(&IntVar{
|
||
Name: "max-versions",
|
||
Target: &c.flagMaxVersions,
|
||
Default: 0,
|
||
Usage: `The number of versions to keep. If not set, the backend’s configured max version is used.`,
|
||
})
|
||
|
||
f.BoolVar(&BoolVar{
|
||
Name: "cas-required",
|
||
Target: &c.flagCASRequired,
|
||
Default: false,
|
||
Usage: `If true the key will require the cas parameter to be set on all write requests. If false, the backend’s configuration will be used.`,
|
||
})
|
||
|
||
return set
|
||
}
|
||
|
||
func (c *KVMetadataPutCommand) AutocompleteArgs() complete.Predictor {
|
||
return nil
|
||
}
|
||
|
||
func (c *KVMetadataPutCommand) AutocompleteFlags() complete.Flags {
|
||
return c.Flags().Completions()
|
||
}
|
||
|
||
func (c *KVMetadataPutCommand) Run(args []string) int {
|
||
f := c.Flags()
|
||
|
||
if err := f.Parse(args); err != nil {
|
||
c.UI.Error(err.Error())
|
||
return 1
|
||
}
|
||
|
||
args = f.Args()
|
||
|
||
switch {
|
||
case len(args) < 1:
|
||
c.UI.Error(fmt.Sprintf("Not enough arguments (expected 1, got %d)", len(args)))
|
||
return 1
|
||
case len(args) > 1:
|
||
c.UI.Error(fmt.Sprintf("Too many arguments (expected 1, got %d)", len(args)))
|
||
return 1
|
||
}
|
||
|
||
var err error
|
||
path := sanitizePath(args[0])
|
||
path, err = addPrefixToVKVPath(path, "metadata")
|
||
if err != nil {
|
||
c.UI.Error(err.Error())
|
||
return 2
|
||
}
|
||
|
||
data := map[string]interface{}{
|
||
"max_versions": c.flagMaxVersions,
|
||
"cas_required": c.flagCASRequired,
|
||
}
|
||
|
||
client, err := c.Client()
|
||
if err != nil {
|
||
c.UI.Error(err.Error())
|
||
return 2
|
||
}
|
||
|
||
secret, err := kvWriteRequest(client, path, data)
|
||
if err != nil {
|
||
c.UI.Error(fmt.Sprintf("Error writing data to %s: %s", path, err))
|
||
return 2
|
||
}
|
||
if secret == nil {
|
||
// Don't output anything unless using the "table" format
|
||
if Format(c.UI) == "table" {
|
||
c.UI.Info(fmt.Sprintf("Success! Data written to: %s", path))
|
||
}
|
||
return 0
|
||
}
|
||
|
||
return OutputSecret(c.UI, secret)
|
||
}
|