/sys/step-down
The /sys/step-down
endpoint causes the node to give up active status.
Step Down Leader
This endpoint forces the node to give up active status. If the node does not
have active status, this endpoint does nothing. Note that the node will sleep
for ten seconds before attempting to grab the active lock again, but if no
standby nodes grab the active lock in the interim, the same node may become the
active node again. Requires a token with root
policy or sudo
capability on
the path.
Method | Path |
---|---|
POST | /sys/step-down |
Sample Request
$ curl \
--header "X-Vault-Token: ..." \
--request POST \
http://127.0.0.1:8200/v1/sys/step-down