› › ›

重命名处理器

重命名现有字段。如果该字段不存在或新名称已被使用，将抛出异常。

表 38. 重命名选项

名称	必需	默认值	描述
`field`	是	-	要重命名的字段。支持模板片段。
`target_field`	是	-	字段的新名称。支持模板片段。
`ignore_missing`	否	`false`	如果 `true` 且 `field` 不存在，则处理器将静默退出，而不修改文档。
`override`	否	`false`	如果为 `true`，则处理器将更新预先存在的非空值字段。当设置为 `false` 时，将不会触及此类字段。
`description`	否	-	处理器的描述。用于描述处理器的目的或其配置。
`if`	否	-	有条件地执行处理器。请参阅有条件地运行处理器。
`ignore_failure`	否	`false`	忽略处理器的失败。请参阅处理管道失败。
`on_failure`	否	-	处理处理器的失败。请参阅处理管道失败。
`tag`	否	-	处理器的标识符。用于调试和指标。

{
  "rename": {
    "field": "provider",
    "target_field": "cloud.provider"
  }
}