2017-08-08 16:39:19 +00:00
|
|
|
|
---
|
2020-01-18 00:18:09 +00:00
|
|
|
|
layout: api
|
|
|
|
|
page_title: /sys/plugins/reload/backend - HTTP API
|
|
|
|
|
sidebar_title: <code>/sys/plugins/reload/backend</code>
|
|
|
|
|
description: The `/sys/plugins/reload/backend` endpoint is used to reload plugin backends.
|
2017-08-08 16:39:19 +00:00
|
|
|
|
---
|
|
|
|
|
|
2017-08-16 16:40:38 +00:00
|
|
|
|
# `/sys/plugins/reload/backend`
|
2017-08-08 16:39:19 +00:00
|
|
|
|
|
2017-08-16 16:40:38 +00:00
|
|
|
|
The `/sys/plugins/reload/backend` endpoint is used to reload mounted plugin
|
2017-08-08 16:39:19 +00:00
|
|
|
|
backends. Either the plugin name (`plugin`) or the desired plugin backend mounts
|
|
|
|
|
(`mounts`) must be provided, but not both. In the case that the plugin name is
|
|
|
|
|
provided, all mounted paths that use that plugin backend will be reloaded.
|
|
|
|
|
|
|
|
|
|
## Reload Plugins
|
|
|
|
|
|
|
|
|
|
This endpoint reloads mounted plugin backends.
|
|
|
|
|
|
2020-01-18 00:18:09 +00:00
|
|
|
|
| Method | Path - |
|
|
|
|
|
| :----- | :---------------------------- |
|
|
|
|
|
| `PUT` | `/sys/plugins/reload/backend` |
|
2017-08-08 16:39:19 +00:00
|
|
|
|
|
|
|
|
|
### Parameters
|
|
|
|
|
|
2018-07-11 19:52:22 +00:00
|
|
|
|
- `plugin` `(string: "")` – The name of the plugin to reload, as
|
2017-08-08 16:39:19 +00:00
|
|
|
|
registered in the plugin catalog.
|
|
|
|
|
|
2018-07-11 19:52:22 +00:00
|
|
|
|
- `mounts` `(array: [])` – Array or comma-separated string mount paths
|
2017-08-08 16:39:19 +00:00
|
|
|
|
of the plugin backends to reload.
|
|
|
|
|
|
|
|
|
|
### Sample Payload
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
{
|
|
|
|
|
"plugin": "mock-plugin"
|
|
|
|
|
}
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Sample Request
|
|
|
|
|
|
|
|
|
|
```
|
|
|
|
|
$ curl \
|
|
|
|
|
--header "X-Vault-Token: ..." \
|
2020-02-21 12:01:59 +00:00
|
|
|
|
--request PUT \
|
|
|
|
|
--data @payload.json \
|
2018-03-23 15:41:51 +00:00
|
|
|
|
http://127.0.0.1:8200/v1/sys/plugins/reload/backend
|
2017-08-16 16:40:38 +00:00
|
|
|
|
```
|