归档设置

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

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

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

使用以下集群更新设置请求来检查归档的集群设置。如果请求返回一个空对象（{ }），则没有归档的集群设置。

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

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

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

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

在升级之前，请从索引和组件模板中移除任何不支持的索引设置。Elasticsearch 在升级期间不会在模板中存档不支持的索引设置。尝试使用包含不支持索引设置的模板将会失败并返回错误。这包括自动化操作，例如 ILM 滚动更新操作。

归档的索引设置不会影响索引的配置或大多数索引操作，例如索引或搜索。但是，在您可以为索引配置其他设置（例如index.hidden）之前，您需要先删除它们。

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

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

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

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