---
title: "索引状态管理元数据服务启用配置"
date: 2026-02-05
lastmod: 2026-02-05
description: "index_state_management.metadata_service.enabled 配置项用于启用或禁用索引状态管理的元数据服务。"
tags: ["索引状态管理", "ISM", "元数据服务"]
summary: "配置项作用 #  index_state_management.metadata_service.enabled 配置项用于启用或禁用索引状态管理（ISM）的元数据服务。
配置项属性 #   配置路径: index_state_management.metadata_service.enabled 数据类型: Boolean（布尔值） 默认值: true 是否可选: 是 作用域: NodeScope（节点级别） 动态更新: 是（可以动态更新，无需重启） 废弃状态: LegacyManagedIndexSettings 中标记为废弃，但 ManagedIndexSettings 中未废弃  配置建议 #  默认配置 #  index_state_management: metadata_service: enabled: true # 默认值，启用元数据服务 禁用元数据服务 #  index_state_management: metadata_service: enabled: false # 禁用元数据服务 功能说明 #  启用状态（true） #   元数据服务处于活动状态 可以处理 ISM 元数据操作 ISM 策略可以正常管理索引生命周期  禁用状态（false） #   元数据服务不可用 ISM 元数据操作将无法执行 可能影响索引生命周期管理功能  注意事项 #    动态更新: 此配置可以动态更新，无需重启节点。"
---


## 配置项作用

`index_state_management.metadata_service.enabled` 配置项用于**启用或禁用索引状态管理（ISM）的元数据服务**。

## 配置项属性

- **配置路径**: `index_state_management.metadata_service.enabled`
- **数据类型**: `Boolean`（布尔值）
- **默认值**: `true`
- **是否可选**: 是
- **作用域**: NodeScope（节点级别）
- **动态更新**: 是（可以动态更新，无需重启）
- **废弃状态**: LegacyManagedIndexSettings 中标记为废弃，但 ManagedIndexSettings 中未废弃

## 配置建议

## 默认配置

```yaml
index_state_management:
  metadata_service:
    enabled: true  # 默认值，启用元数据服务
```

## 禁用元数据服务

```yaml
index_state_management:
  metadata_service:
    enabled: false  # 禁用元数据服务
```

## 功能说明

## 启用状态（true）
- 元数据服务处于活动状态
- 可以处理 ISM 元数据操作
- ISM 策略可以正常管理索引生命周期

## 禁用状态（false）
- 元数据服务不可用
- ISM 元数据操作将无法执行
- 可能影响索引生命周期管理功能

## 注意事项

1. **动态更新**: 此配置可以动态更新，无需重启节点。

2. **生产环境**: 在生产环境中，通常应保持启用状态（默认值），以确保 ISM 功能正常工作。

3. **禁用风险**: 禁用元数据服务可能会导致：
   - ISM 策略无法执行
   - 索引生命周期管理中断
   - 已配置的策略失效

4. **废弃说明**: 此配置在 LegacyManagedIndexSettings 中标记为废弃，但在当前版本中仍然有效且未废弃。

5. **维护用途**: 禁用元数据服务主要用于维护或故障排查场景，不建议在生产环境中长期禁用。

6. **动态调整**: 如果需要临时禁用 ISM 功能，可以动态设置此选项为 `false`，完成维护后再改回 `true`。