已归档设置

如果您将具有已弃用持久集群设置的集群升级到不再支持该设置的版本，Elasticsearch 会自动归档该设置。同样，如果您升级包含具有不受支持的索引设置的索引的集群，Elasticsearch 会归档该索引设置。

我们建议您在升级后删除所有已归档的设置。已归档的设置被视为无效，并且可能会干扰您配置其他设置的能力。

已归档设置以 archived. 前缀开头。

已归档集群设置编辑

使用以下 集群更新设置 请求来检查已归档的集群设置。如果请求返回空对象 ({ })，则表示没有已归档的集群设置。

resp = client.cluster.get_settings(
    flat_settings="true",
    filter_path="persistent.archived*",
)
print(resp)

response = client.cluster.get_settings(
  flat_settings: true,
  filter_path: 'persistent.archived*'
)
puts response

GET _cluster/settings?flat_settings=true&filter_path=persistent.archived*

要删除任何已归档的集群设置，请使用以下 集群更新设置 请求。

resp = client.cluster.put_settings(
    body={"persistent": {"archived.*": None}},
)
print(resp)

response = client.cluster.put_settings(
  body: {
    persistent: {
      "archived.*": nil
    }
  }
)
puts response

PUT _cluster/settings
{
  "persistent": {
    "archived.*": null
  }
}

Elasticsearch 不会归档 elasticsearch.yml 中的瞬态集群设置或设置。如果节点在 elasticsearch.yml 中包含不受支持的设置，它将在启动时返回错误。

已归档索引设置编辑

已归档的索引设置不会影响索引的配置或大多数索引操作，例如索引或搜索。但是，您需要先删除它们，然后才能为索引配置其他设置，例如 index.hidden。

使用以下 获取索引设置 请求来获取具有已归档设置的索引列表。如果请求返回空对象 ({ })，则表示没有已归档的索引设置。

resp = client.indices.get_settings(
    index="*",
    flat_settings="true",
    filter_path="**.settings.archived*",
)
print(resp)

response = client.indices.get_settings(
  index: '*',
  flat_settings: true,
  filter_path: '**.settings.archived*'
)
puts response

GET */_settings?flat_settings=true&filter_path=**.settings.archived*

要删除任何已归档的索引设置，请使用以下 索引更新设置 请求。

resp = client.indices.put_settings(
    index="my-index",
    body={"archived.*": None},
)
print(resp)

response = client.indices.put_settings(
  index: 'my-index',
  body: {
    "archived.*": nil
  }
)
puts response

PUT /my-index/_settings
{
  "archived.*": null
}