2017-09-08 02:09:40 +00:00
|
|
|
---
|
|
|
|
layout: "docs"
|
|
|
|
page_title: "operator rotate - Command"
|
2018-10-29 19:58:37 +00:00
|
|
|
sidebar_title: "<code>rotate</code>"
|
2017-09-08 02:09:40 +00:00
|
|
|
sidebar_current: "docs-commands-operator-rotate"
|
|
|
|
description: |-
|
|
|
|
The "operator rotate" rotates the underlying encryption key which is used to
|
|
|
|
secure data written to the storage backend. This installs a new key in the key
|
|
|
|
ring. This new key is used to encrypted new data, while older keys in the ring
|
|
|
|
are used to decrypt older data.
|
|
|
|
---
|
|
|
|
|
|
|
|
# operator rotate
|
|
|
|
|
|
|
|
The `operator rotate` rotates the underlying encryption key which is used to
|
|
|
|
secure data written to the storage backend. This installs a new key in the key
|
|
|
|
ring. This new key is used to encrypted new data, while older keys in the ring
|
|
|
|
are used to decrypt older data.
|
|
|
|
|
|
|
|
This is an online operation and does not cause downtime. This command is run
|
|
|
|
per-cluster (not per-server), since Vault servers in HA mode share the same
|
|
|
|
storage backend.
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
Rotate Vault's encryption key:
|
|
|
|
|
|
|
|
```text
|
|
|
|
$ vault operator rotate
|
|
|
|
Key Term 3
|
|
|
|
Install Time 01 May 17 10:30 UTC
|
|
|
|
```
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
2018-02-12 23:12:16 +00:00
|
|
|
The following flags are available in addition to the [standard set of
|
|
|
|
flags](/docs/commands/index.html) included on all commands.
|
|
|
|
|
|
|
|
### Output Options
|
|
|
|
|
|
|
|
- `-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.
|