You're viewing version 2.12 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.

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