Company
Contact Us

Cluster settings

Introduced 1.0 {: .label .label-purple }

The cluster settings operation lets you check the current settings for your cluster, review default settings, and change settings. When you update a setting using the API, OpenSearch applies it to all nodes in the cluster.

Examples

GET _cluster/settings?include_defaults=true
PUT _cluster/settings
{
   "persistent":{
      "action.auto_create_index": false
   }
}

Path and HTTP methods

GET _cluster/settings
PUT _cluster/settings

URL parameters

All cluster settings parameters are optional.

ParameterTypeDescription
flat_settingsBooleanWhether to return settings in the flat form, which can improve readability, especially for heavily nested settings. For example, the flat form of "cluster": { "max_shards_per_node": 500 } is "cluster.max_shards_per_node": "500".
include_defaults (GET only)BooleanWhether to include default settings as part of the response. This parameter is useful for identifying the names and current values of settings you want to update.
cluster_manager_timeoutTimeThe amount of time to wait for a response from the cluster manager node. Default is 30 seconds.
timeout (PUT only)TimeThe amount of time to wait for a response from the cluster. Default is 30 seconds.

Request body

The GET operation has no request body options.

For a PUT operation, the request body must contain transient or persistent, along with the setting you want to update:

PUT _cluster/settings
{
   "persistent":{
      "cluster.max_shards_per_node": 500
   }
}

For more information about transient settings, persistent settings, and precedence, see OpenSearch configuration.

Response

{
   "acknowledged":true,
   "persistent":{
      "cluster":{
         "max_shards_per_node":"500"
      }
   },
   "transient":{}
}
© 2021-2023 Mach5 Software, Inc. All rights reserved

When you visit or interact with our sites, services or tools, we or our authorised service providers may use cookies for storing information to help provide you with a better, faster and safer experience and for marketing purposes.