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

  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 body 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.