elasticsearch/docs/reference/enrich-processor/rename-processor.md
Colleen McGinnis 9bcd59596d
[docs] Prepare for docs-assembler (#125118)
* reorg files for docs-assembler and create toc.yml files

* fix build error, add redirects

* only toc

* move images
2025-03-20 12:09:12 -05:00

1.9 KiB
Raw Permalink Blame History

navigation_title mapped_pages
Rename
https://www.elastic.co/guide/en/elasticsearch/reference/current/rename-processor.html

Rename processor [rename-processor]

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

$$$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"
  }
}