package command import ( "fmt" "io" "strings" "time" "github.com/mitchellh/cli" "github.com/posener/complete" ) var ( _ cli.Command = (*KVMetadataPutCommand)(nil) _ cli.CommandAutocomplete = (*KVMetadataPutCommand)(nil) ) type KVMetadataPutCommand struct { *BaseCommand flagMaxVersions int flagCASRequired bool flagDeleteVersionAfter time.Duration flagCustomMetadata map[string]string 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 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 Set delete-version-after on the key: $ vault kv metadata put -delete-version-after=3h25m19s secret/foo Require Check-and-Set for this key: $ vault kv metadata put -cas-required secret/foo Set custom metadata on the key: $ vault kv metadata put -custom-metadata=foo=abc -custom-metadata=bar=123 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.`, }) f.DurationVar(&DurationVar{ Name: "delete-version-after", Target: &c.flagDeleteVersionAfter, Default: -1, EnvVar: "", Completion: complete.PredictAnything, Usage: `Specifies the length of time before a version is deleted. If not set, the backend's configured delete-version-after is used. Cannot be greater than the backend's delete-version-after. The delete-version-after is specified as a numeric string with a suffix like "30s" or "3h25m19s".`, }) f.StringMapVar(&StringMapVar{ Name: "custom-metadata", Target: &c.flagCustomMetadata, Default: map[string]string{}, Usage: "Specifies arbitrary version-agnostic key=value metadata meant to describe a secret." + "This can be specified multiple times to add multiple pieces of metadata.", }) 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 } client, err := c.Client() if err != nil { c.UI.Error(err.Error()) return 2 } path := sanitizePath(args[0]) mountPath, v2, err := isKVv2(path, client) if err != nil { c.UI.Error(err.Error()) return 2 } if !v2 { c.UI.Error("Metadata not supported on KV Version 1") return 1 } path = addPrefixToVKVPath(path, mountPath, "metadata") data := map[string]interface{}{ "max_versions": c.flagMaxVersions, "cas_required": c.flagCASRequired, "custom_metadata": c.flagCustomMetadata, } if c.flagDeleteVersionAfter >= 0 { data["delete_version_after"] = c.flagDeleteVersionAfter.String() } secret, err := client.Logical().Write(path, data) if err != nil { c.UI.Error(fmt.Sprintf("Error writing data to %s: %s", path, err)) if secret != nil { OutputSecret(c.UI, secret) } 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) }