更新安全索引设置

编辑

更新安全内部索引的设置。

先决条件

编辑
  • 要使用此 API,您必须至少拥有 manage_security 集群特权。

请求正文

编辑
security
(可选,对象)用于大多数安全配置(包括通过 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 尚不支持在这些索引使用之前为其配置设置。