mirror of
https://github.com/elastic/elasticsearch.git
synced 2025-06-29 18:03:32 -04:00
45 lines
1.3 KiB
Text
45 lines
1.3 KiB
Text
[role="xpack"]
|
|
[[security-api-get-settings]]
|
|
=== Get Security index settings
|
|
++++
|
|
<titleabbrev>Get Security settings</titleabbrev>
|
|
++++
|
|
|
|
.New API reference
|
|
[sidebar]
|
|
--
|
|
For the most up-to-date API details, refer to {api-es}/group/endpoint-security[Security APIs].
|
|
--
|
|
|
|
Retrieves settings for the security internal indices.
|
|
|
|
[[security-api-get-settings-prereqs]]
|
|
==== {api-prereq-title}
|
|
|
|
* To use this API, you must have at least the `read_security` cluster privilege.
|
|
|
|
[[security-api-get-settings-desc]]
|
|
==== {api-description-title}
|
|
This API allows a user to retrieve the user-configurable settings for the
|
|
Security internal index (`.security` and associated indices). Only a subset of
|
|
the index settings — those that are user-configurable—will be shown. This
|
|
includes:
|
|
|
|
- `index.auto_expand_replicas`
|
|
- `index.number_of_replicas`
|
|
|
|
|
|
[[security-api-get-settings-example]]
|
|
==== {api-examples-title}
|
|
|
|
An example of retrieving the security settings:
|
|
|
|
[source,console]
|
|
-----------------------------------------------------------
|
|
GET /_security/settings
|
|
-----------------------------------------------------------
|
|
// TEST[setup:user_profiles]
|
|
// TEST[setup:service_token42]
|
|
|
|
The configurable settings can be modified using the
|
|
<<security-api-update-settings,Update Security index settings>> API.
|