open-vault/website/content/docs/commands/secrets/move.mdx
Pratyoy Mukhopadhyay a85d4fe128
[VAULT-5268] Add mount move docs (#14314)
* add mount move docs

* add missed word

* Update website/content/api-docs/system/remount.mdx

Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com>

* one clarification

* docs changes from feedback

* couple things i missed

Co-authored-by: Loann Le <84412881+taoism4504@users.noreply.github.com>
2022-03-04 14:38:15 -08:00

35 lines
1.1 KiB
Plaintext

---
layout: docs
page_title: secrets move - Command
description: |-
The "secrets move" command moves an existing secrets engine to a new path. All
leases from the old secrets engine are revoked, but all configurations
associated with the engine are preserved.
---
# secrets move
The `secrets move` command moves an existing secrets engine to a new path. Any
leases from the old secrets engine are revoked, but all configuration associated
with the engine is preserved. The command can be issued for a move within or across
namespaces, using namespace prefixes in the arguments.
The command will trigger a remount operation and uses the returned migration ID to poll the
status of the operation until a terminal state of `success` or `failure` is reached.
**Moving an existing secrets engine will revoke any leases from the old
engine.**
## Examples
Move the existing secrets engine at ns1/secret/ to ns2/kv/:
```shell-session
$ vault secrets move ns1/secret/ ns2/kv/
```
## Usage
There are no flags beyond the [standard set of flags](/docs/commands)
included on all commands.