Link Search Menu Expand Document Documentation Menu

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