Skip to main content

auth move

The auth move command moves an existing auth method to a new path. Any leases from the old auth method 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 auth method will revoke any leases from the old method.

warning

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

Examples

Move the existing auth method at ns1/approle/ to ns2/new-approle/:

$ bao auth move ns1/auth/approle/ ns2/auth/new-approle/

Usage

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