New

The executive guide to generative AI

Read more
About usPartnersSupport|Login
IMPORTANT: No additional bug fixes or documentation updates will be released for this version. For the latest information, see the current release documentation.
« Update API key API Bulk update API keys API »
Elastic Docs ›Elasticsearch Guide [8.13] ›REST APIs ›Security APIs

Update Security index settings

edit
IMPORTANT: This documentation is no longer updated. Refer to Elastic's version policy and the latest documentation.

Update Security index settings

edit

Updates the settings of the security internal indices.

Prerequisites

edit
  • To use this API, you must have at least the manage_security cluster privilege.

Request body

edit
security
(Optional, object) Settings to be used for the index used for most security configuration, including Native realm users and roles configured via the API.
security-tokens
(Optional, object) Settings to be used for the index used to store tokens.
security
(Optional, object) Settings to be used for the index used to store profile information.

Description

edit

This API allows a user to modify the settings for the Security internal indices (.security and associated indices). Only a subset of settings are allowed to be modified. This includes:

  • index.auto_expand_replicas
  • index.number_of_replicas

Examples

edit

An example of modifying the Security settings:

PUT /_security/settings
{
    "security": {
        "index.auto_expand_replicas": "0-all"
    },
    "security-tokens": {
        "index.auto_expand_replicas": "0-all"
    },
    "security-profile": {
        "index.auto_expand_replicas": "0-all"
    }
}
Copy as curlTry in Elastic 

The configured settings can be retrieved using the Get Security index settings API. If a given index is not in use on the system, but settings are provided for it, the request will be rejected - this API does not yet support configuring the settings for these indices before they are in use.

« Update API key API Bulk update API keys API »
Was this helpful?
Feedback