› › ›

API получения встроенных привилегий

Возвращает список кластерных привилегий и привилегий к индексам, доступных в этой версии Elasticsearch.

Запрос

GET /_security/privilege/_builtin

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

Для использования этого API необходимо иметь - привилегию manage_security к кластеру (или более широкую привилегию, например, all).

Описание

Этот API возвращает набор имён привилегий кластера и индекса, доступных в версии Elasticsearch, к которой осуществляется запрос.

Чтобы проверить, обладает ли пользователь определёнными привилегиями, используйте API проверки привилегий.

Тело ответа

Ответ — объект с двумя полями:

cluster: (массив строк) Список кластерных привилегий, поддерживаемых этой версией Elasticsearch.
index: (массив строк) Список привилегий к индексам, поддерживаемых этой версией Elasticsearch.

Примеры

Следующий пример получает имена всех встроенных привилегий:

GET /_security/privilege/_builtin

Успешный вызов возвращает объект с полями "cluster" и "index".

{
  "cluster" : [
    "all",
    "cancel_task",
    "create_snapshot",
    "delegate_pki",
    "grant_api_key",
    "manage",
    "manage_api_key",
    "manage_autoscaling",
    "manage_ccr",
    "manage_data_frame_transforms",
    "manage_enrich",
    "manage_ilm",
    "manage_index_templates",
    "manage_ingest_pipelines",
    "manage_logstash_pipelines",
    "manage_ml",
    "manage_oidc",
    "manage_own_api_key",
    "manage_pipeline",
    "manage_rollup",
    "manage_saml",
    "manage_security",
    "manage_service_account",
    "manage_slm",
    "manage_token",
    "manage_transform",
    "manage_watcher",
    "monitor",
    "monitor_data_frame_transforms",
    "monitor_ml",
    "monitor_rollup",
    "monitor_snapshot",
    "monitor_text_structure",
    "monitor_transform",
    "monitor_watcher",
    "none",
    "read_ccr",
    "read_ilm",
    "read_pipeline",
    "read_slm",
    "transport_client"
  ],
  "index" : [
    "all",
    "auto_configure",
    "create",
    "create_doc",
    "create_index",
    "delete",
    "delete_index",
    "index",
    "maintenance",
    "manage",
    "manage_follow_index",
    "manage_ilm",
    "manage_leader_index",
    "monitor",
    "none",
    "read",
    "read_cross_cluster",
    "view_index_metadata",
    "write"
  ]
}

© 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/7.17/security-api-get-builtin-privileges.html