更新安全索引设置

编辑

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

前提条件

编辑
  • 要使用此 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 还不支持在这些索引使用之前配置其设置。