This version of the OpenSearch documentation 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

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

  1. POST _nodes/reload_secure_settings
  2. POST _nodes/<nodeId>/reload_secure_settings

Path parameter

You can include the following optional path parameter in your request.

ParameterTypeDescription
nodeIdStringA comma-separated list of nodeIds used to filter results. Supports node filters. Defaults to _all.

Request fields

The request may include an optional object containing the password for the OpenSearch keystore.

  1. {
  2.   "secure_settings_password": "keystore_password"
  3. }

Example request

The following is an example API request:

  1. POST _nodes/reload_secure_settings

copy

Example response

The following is an example response:

  1. {
  2.   "_nodes" : {
  3.     "total" : 1,
  4.     "successful" : 1,
  5.     "failed" : 0
  6.   },
  7.   "cluster_name" : "opensearch-cluster",
  8.   "nodes" : {
  9.     "t7uqHu4SSuWObK3ElkCRfw" : {
  10.       "name" : "opensearch-node1"
  11.     }
  12.   }
  13. }

Required permissions

If you use the Security plugin, make sure you set the following permissions: cluster:manage/nodes.