› › ›

Обновление настроек индекса безопасности

Обновляет настройки внутренних индексов безопасности.

Предварительные условия

Для использования этого API необходимо обладать по крайней мере правом доступа к кластеру manage_security.

Тело запроса

security: (Необязательно, объект) Настройки, используемые для индекса, используемого для большинства настроек безопасности, включая пользователей и роли Native realm, настроенные через API.
security-tokens: (Необязательно, объект) Настройки, используемые для индекса, хранящего токены.
security-profile: (Необязательно, объект) Настройки, используемые для индекса, хранящего информацию о профиле.

Описание

Этот API позволяет пользователю изменять настройки внутренних индексов безопасности (.security и связанных индексов). Разрешено изменять только подмножество настроек. В их число входят:

index.auto_expand_replicas
index.number_of_replicas

Если index.auto_expand_replicas установлено, index.number_of_replicas будет проигнорировано во время обновления.

Примеры

Пример изменения настроек безопасности:

resp = client.perform_request(
    "PUT",
    "/_security/settings",
    headers={"Content-Type": "application/json"},
    body={
        "security": {
            "index.auto_expand_replicas": "0-all"
        },
        "security-tokens": {
            "index.auto_expand_replicas": "0-all"
        },
        "security-profile": {
            "index.auto_expand_replicas": "0-all"
        }
    },
)
print(resp)

const response = await client.transport.request({
  method: "PUT",
  path: "/_security/settings",
  body: {
    security: {
      "index.auto_expand_replicas": "0-all",
    },
    "security-tokens": {
      "index.auto_expand_replicas": "0-all",
    },
    "security-profile": {
      "index.auto_expand_replicas": "0-all",
    },
  },
});
console.log(response);

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"
    }
}

Настроенные настройки можно получить с помощью API получения настроек индекса безопасности. Если указанный индекс не используется в системе, но для него указаны настройки, запрос будет отклонен — этот API пока не поддерживает настройку настроек для этих индексов до их использования.

© 2023-2025 Elasticsearch
As of September 2024, Elasticsearch is available under a choice of three licenses: the Server Side Public License (SSPL), the Elastic License, or the AGPLv3 (OSI approved).
Elasticsearch and the Elasticsearch logo are trademarks of Elasticsearch B.V., registered in the U.S. and in other countries.
https://www.elastic.co/guide/en/elasticsearch/reference/8.17/security-api-update-settings.html