› › ›

Rename processor

Renames an existing field. If the field doesn’t exist or the new name is already used, an exception will be thrown.

Table 37. Rename Options

Name	Required	Default	Description
`field`	yes	-	The field to be renamed. Supports template snippets.
`target_field`	yes	-	The new name of the field. Supports template snippets.
`ignore_missing`	no	`false`	If `true` and `field` does not exist, the processor quietly exits without modifying the document.
`override`	no	`false`	If `true`, the processor will update pre-existing non-null-valued fields. When set to `false`, such fields will not be touched.
`description`	no	-	Description of the processor. Useful for describing the purpose of the processor or its configuration.
`if`	no	-	Conditionally execute the processor. See Conditionally run a processor.
`ignore_failure`	no	`false`	Ignore failures for the processor. See Handling pipeline failures.
`on_failure`	no	-	Handle failures for the processor. See Handling pipeline failures.
`tag`	no	-	Identifier for the processor. Useful for debugging and metrics.

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