更新设置
1.0 版引入
您可以使用更新设置 API 操作来更新索引级设置。动态索引设置可以随时更改，但静态设置在索引创建后无法更改。有关静态和动态索引设置的更多信息，请参阅配置 OpenSearch。
除了静态和动态索引设置外，您还可以更新各个插件的设置。要获取可更新设置的完整列表，请运行 GET <target-index>/_settings?include_defaults=true。
端点
PUT /<index>/_settings
路径参数
| 参数 | 类型 | 描述 |
|---|---|---|
| <索引> | 字符串 | 要更新的索引。可以是多个索引名称的逗号分隔列表。使用 _all 或 * 来指定所有索引。 |
查询参数
所有更新设置参数均为可选。
| 参数 | 数据类型 | 描述 |
|---|---|---|
| allow_no_indices | 布尔型 | 是否忽略不匹配任何索引的通配符。默认值为 true。 |
| expand_wildcards | 字符串 | 将通配符表达式扩展到不同的索引。多个值用逗号分隔。可用值包括 all (匹配所有索引)、open (匹配开放索引)、closed (匹配关闭索引)、hidden (匹配隐藏索引) 和 none (不接受通配符表达式)，none 必须与 open、closed 或两者结合使用。默认为 open。 |
| cluster_manager_timeout | 时间 | 等待连接到集群管理器节点的时间。默认值为 30s。 |
| preserve_existing | 布尔型 | 是否保留现有索引设置。默认为 false。 |
| timeout | 时间 | 等待连接返回的时间。默认为 30s。 |
请求正文
请求正文必须包含所有要更新的索引设置。
{
"index.plugins.index_state_management.rollover_skip": true,
"index": {
"number_of_replicas": 4
}
}
请求示例
PUT /sample-index1/_settings
{
"index.plugins.index_state_management.rollover_skip": true,
"index": {
"number_of_replicas": 4
}
}
示例响应
{
"acknowledged": true
}