You're viewing version 2.17 of the OpenSearch documentation. This version is no longer maintained. For the latest version, see the current documentation. For information about OpenSearch version maintenance, see Release Schedule and Maintenance Policy.
Nodes reload secure settings
Introduced 1.0
The nodes reload secure settings endpoint allows you to change secure settings on a node and reload the secure settings without restarting the node.
Path and HTTP methods
POST _nodes/reload_secure_settings
POST _nodes/<nodeId>/reload_secure_settings
Path parameter
You can include the following optional path parameter in your request.
| Parameter | Type | Description |
|---|---|---|
| nodeId | String | A comma-separated list of nodeIds used to filter results. Supports node filters. Defaults to _all. |
Request body fields
The request may include an optional object containing the password for the OpenSearch keystore.
{
"secure_settings_password": "keystore_password"
}
Example request
The following is an example API request:
POST _nodes/reload_secure_settings
Example response
The following is an example response:
{
"_nodes" : {
"total" : 1,
"successful" : 1,
"failed" : 0
},
"cluster_name" : "opensearch-cluster",
"nodes" : {
"t7uqHu4SSuWObK3ElkCRfw" : {
"name" : "opensearch-node1"
}
}
}
Required permissions
If you use the Security plugin, make sure you set the following permissions: cluster:manage/nodes.