open-vault/website/content/docs/commands/auth/move.mdx
Pratyoy Mukhopadhyay d222981cec
Fixes from mount move testing (#14492)
* Add validation, fix docs

* add changelog

* fmt fix

* Update vault/logical_system.go

Co-authored-by: Josh Black <raskchanky@users.noreply.github.com>

* Update vault/logical_system.go

Co-authored-by: Josh Black <raskchanky@users.noreply.github.com>

* Update vault/logical_system_test.go

Co-authored-by: Josh Black <raskchanky@users.noreply.github.com>

* Update vault/logical_system_test.go

Co-authored-by: Josh Black <raskchanky@users.noreply.github.com>

Co-authored-by: Josh Black <raskchanky@users.noreply.github.com>
2022-03-15 11:11:23 -07:00

35 lines
1.1 KiB
Plaintext

---
layout: docs
page_title: auth move - Command
description: |-
The "auth move" command moves an existing auth method to a new path. All
tokens from the old auth method are revoked, but all configurations
associated with the engine are preserved.
---
# 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.
**Moving an existing auth method will revoke any leases from the old
method.**
## Examples
Move the existing auth method at ns1/approle/ to ns2/new-approle/:
```shell-session
$ vault auth move ns1/auth/approle/ ns2/auth/new-approle/
```
## Usage
There are no flags beyond the [standard set of flags](/docs/commands)
included on all commands.