open-vault/website/content/docs/commands/version-history.mdx
Chris Capurso f9e9b4d327
Add sys/version-history endpoint and associated command (#13766)
* store version history as utc; add self-heal logic

* add sys/version-history endpoint

* change version history from GET to LIST, require auth

* add "vault version-history" CLI command

* add vault-version CLI error message for version string parsing

* adding version-history API and CLI docs

* add changelog entry

* some version-history command fixes

* remove extraneous cmd args

* fix version-history command help text

* specify in docs that endpoint was added in 1.10.0

Co-authored-by: Nick Cabatoff <ncabatoff@hashicorp.com>

* enforce UTC within storeVersionTimestamp directly

* fix improper use of %w in logger.Warn

* remove extra err check and erroneous return from loadVersionTimestamps

* add >= 1.10.0 warning to version-history cmd

* move sys/version-history tests

Co-authored-by: Nick Cabatoff <ncabatoff@hashicorp.com>
2022-02-14 15:26:57 -05:00

32 lines
905 B
Plaintext

---
layout: docs
page_title: version-history - Command
description: |-
The "version-history" command prints the historical list of installed Vault versions in chronological order.
---
# version-history
The `version-history` command prints the historical list of installed Vault versions in chronological order.
```shell-session
Note: Version tracking was added in 1.9.0. Earlier versions have not been tracked.
Version Installation Time
------- -----------------
1.9.0 2021-11-18T10:23:16Z
1.9.1 2022-12-13T11:09:52Z
1.9.2 2021-12-23T10:56:37Z
```
## Usage
The following flags are available in addition to the [standard set of
flags](/docs/commands) included on all commands.
### Output Options
- `-format` `(string: "table")` - Print the output in the given format. Valid
formats are "table" or json". This can also be specified via the
`VAULT_FORMAT` environment variable.