42 lines
945 B
Markdown
42 lines
945 B
Markdown
|
---
|
||
|
|
layout: "http"
|
||
|
|
page_title: "HTTP API: /sys/seal-unseal"
|
||
|
|
sidebar_current: "docs-http-seal-unseal"
|
||
|
|
description: |-
|
||
|
|
The '/sys/seal-unseal' endpoint is used to unseal the Vault.
|
||
|
|
---
|
||
|
|
|
||
|
|
# /sys/unseal
|
||
|
|
|
||
|
|
<dl>
|
||
|
|
<dt>Description</dt>
|
||
|
|
<dd>
|
||
|
|
Enter a single master key share to progress the unsealing of the Vault.
|
||
|
|
If the threshold number of master key shares is reached, Vault
|
||
|
|
will attempt to unseal the Vault. Otherwise, this API must be
|
||
|
|
called multiple times until that threshold is met.
|
||
|
|
</dd>
|
||
|
|
|
||
|
|
<dt>Method</dt>
|
||
|
|
<dd>PUT</dd>
|
||
|
|
|
||
|
|
<dt>Parameters</dt>
|
||
|
|
<dd>
|
||
|
|
<ul>
|
||
|
|
<li>
|
||
|
|
<span class="param">secret_shares</span>
|
||
|
|
<span class="param-flags">required</span>
|
||
|
|
The number of shares to split the master key into.
|
||
|
|
</li>
|
||
|
|
<li>
|
||
|
|
<span class="param">key</span>
|
||
|
|
<span class="param-flags">required</span>
|
||
|
|
A single master share key.
|
||
|
|
</li>
|
||
|
|
</ul>
|
||
|
|
</dd>
|
||
|
|
<dt>Returns</dt>
|
||
|
|
<dd>The same result as `/sys/seal-status`.
|
||
|
|
</dd>
|
||
|
|
</dl>
|