Upgrades all transforms Added in 7.16.0

POST /_transform/_upgrade

This API identifies transforms that have a legacy configuration format and upgrades them to the latest version. It also cleans up the internal data structures that store the transform state and checkpoints. The upgrade does not affect the source and destination indices. The upgrade also does not affect the roles that transforms use when Elasticsearch security features are enabled; the role used to read source data and write to the destination index remains unchanged.

Query parameters

  • dry_run boolean

    When true, the request checks for updates but does not run them.

  • timeout string

    Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.

Responses

  • 200 application/json
    Hide response attributes Show response attributes object
    • needs_update number Required

      The number of transforms that need to be upgraded.

    • no_action number Required

      The number of transforms that don’t require upgrading.

    • updated number Required

      The number of transforms that have been upgraded.

POST /_transform/_upgrade
curl \
 -X POST http://api.example.com/_transform/_upgrade
Response examples (200)
{
  "needs_update": 42.0,
  "no_action": 42.0,
  "updated": 42.0
}