Skip to main content

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.

warning

Moving an existing secrets engine will revoke any leases from the old engine.

warning

Before moving an engine to a new path, one should ensure it is currently not actively used. Using an engine while it's being moved will lead to inconsistent reads on standby nodes.

Examples

Move the existing secrets engine at ns1/secret/ to ns2/kv/:

$ bao secrets move ns1/secret/ ns2/kv/

Usage

There are no flags beyond the standard set of flags included on all commands.