»/sys/sealwrap/rewrap

The /sys/sealwrap/rewrap endpoint is used to rewrap all seal wrapped entries. This is useful when you want to upgrade seal wrapped entries to use the latest key, for example, after a seal migration or after rotating the remote keyring.

»Read Rewrap Status

This endpoint reports whether a seal rewrap process is currently running.

MethodPath
GET/sys/sealwrap/rewrap

»Sample Request

$ curl \
    --header "X-Vault-Token: ..." \
    http://127.0.0.1:8200/v1/sys/sealwrap/rewrap
$ curl \    --header "X-Vault-Token: ..." \    http://127.0.0.1:8200/v1/sys/sealwrap/rewrap

»Sample Response

{
  "data": {
    "entries": {
      "failed": 0,
      "processed": 30,
      "succeeded": 30
    },
    "is_running": false
  }
}
{  "data": {    "entries": {      "failed": 0,      "processed": 30,      "succeeded": 30    },    "is_running": false  }}

»Start a Seal Rewrap Process

This endpoint starts a seal rewrap process if one is not currently running. The process will run in the background. Check the vault server logs for status and progress updates.

MethodPath
POST/sys/sealwrap/rewrap

The default status codes are:

  • 200 if a seal rewrap process is already running
  • 204 if a seal rewrap process was started

»Sample Request

$ curl \
    --header "X-Vault-Token: ..." \
    --request POST \
    http://127.0.0.1:8200/v1/sys/sealwrap/rewrap
$ curl \    --header "X-Vault-Token: ..." \    --request POST \    http://127.0.0.1:8200/v1/sys/sealwrap/rewrap