2017-09-08 02:07:21 +00:00
|
|
|
---
|
2020-01-18 00:18:09 +00:00
|
|
|
layout: docs
|
|
|
|
|
page_title: lease renew - Command
|
2017-09-08 02:07:21 +00:00
|
|
|
description: |-
|
|
|
|
|
The "lease renew" command renews the lease on a secret, extending the time
|
|
|
|
|
that it can be used before it is revoked by Vault.
|
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
# lease renew
|
|
|
|
|
|
|
|
|
|
The `lease renew` command renews the lease on a secret, extending the time that
|
|
|
|
|
it can be used before it is revoked by Vault.
|
|
|
|
|
|
|
|
|
|
Every secret in Vault has a lease associated with it. If the owner of the secret
|
|
|
|
|
wants to use it longer than the lease, then it must be renewed. Renewing the
|
|
|
|
|
lease does not change the contents of the secret.
|
|
|
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
|
|
|
|
|
Renew a lease:
|
|
|
|
|
|
2020-05-21 17:18:17 +00:00
|
|
|
```shell-session
|
2017-09-08 02:07:21 +00:00
|
|
|
$ vault lease renew database/creds/readonly/27e1b9a1-27b8-83d9-9fe0-d99d786bdc83
|
2021-09-13 18:57:10 +00:00
|
|
|
Key Value
|
|
|
|
|
--- -----
|
|
|
|
|
lease_id database/creds/readonly/27e1b9a1-27b8-83d9-9fe0-d99d786bdc83
|
|
|
|
|
lease_duration 5m
|
|
|
|
|
lease_renewable true
|
2017-09-08 02:07:21 +00:00
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Usage
|
|
|
|
|
|
|
|
|
|
The following flags are available in addition to the [standard set of
|
2020-01-22 20:05:41 +00:00
|
|
|
flags](/docs/commands) included on all commands.
|
2017-09-08 02:07:21 +00:00
|
|
|
|
|
|
|
|
- `-increment` `(duration: "")` - Request a specific increment in seconds. Vault
|
|
|
|
|
is not required to honor this request.
|
