› › ›

API очистки кэша пользователей

Удаляет пользователей из кэша пользователей. Можно полностью очистить кэш или удалить определённых пользователей.

Запрос

POST /_security/realm/<realms>/_clear_cache

POST /_security/realm/<realms>/_clear_cache?usernames=<usernames>

Описание

Учётные данные пользователей кэшируются в памяти на каждом узле, чтобы избежать подключения к удалённой службе аутентификации или обращения к диску для каждого входящего запроса. Существуют параметры realm, которые можно использовать для настройки кэша пользователей. Дополнительную информацию см. в разделе Управление кэшем пользователей.

Чтобы удалить роли из кэша ролей, см. API очистки кэша ролей. Чтобы удалить привилегии из кэша привилегий, см. API очистки кэша привилегий. Чтобы удалить API-ключи из кэша API-ключей, см. API очистки кэша API-ключей.

Параметры пути

<realms>: (Обязательный, строка) Список realm, разделённых запятыми, которые нужно очистить. Чтобы очистить все realm, используйте *. Не поддерживает другие шаблоны подстановок.
usernames: (Необязательный, список) Список пользователей, разделённых запятыми, которые нужно удалить из кэша. Если этот параметр не указан, API удалит всех пользователей из кэша пользователей.

Примеры

Например, чтобы удалить всех пользователей, кэшированных realm file:

resp = client.security.clear_cached_realms(
    realms="default_file",
)
print(resp)

const response = await client.security.clearCachedRealms({
  realms: "default_file",
});
console.log(response);

POST /_security/realm/default_file/_clear_cache

Чтобы удалить выбранных пользователей, укажите параметр usernames:

resp = client.security.clear_cached_realms(
    realms="default_file",
    usernames="rdeniro,alpacino",
)
print(resp)

const response = await client.security.clearCachedRealms({
  realms: "default_file",
  usernames: "rdeniro,alpacino",
});
console.log(response);

POST /_security/realm/default_file/_clear_cache?usernames=rdeniro,alpacino

Чтобы очистить кэши для нескольких realm, укажите realm в виде списка, разделённого запятыми:

resp = client.security.clear_cached_realms(
    realms="default_file,ldap1",
)
print(resp)

const response = await client.security.clearCachedRealms({
  realms: "default_file,ldap1",
});
console.log(response);

POST /_security/realm/default_file,ldap1/_clear_cache

Чтобы очистить кэши для всех realm, используйте *.

resp = client.security.clear_cached_realms(
    realms="*",
)
print(resp)

const response = await client.security.clearCachedRealms({
  realms: "*",
});
console.log(response);

POST /_security/realm/*/_clear_cache

© 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-clear-cache.html