[DOCS]: Move _reindex API examples to ES reference documentation (#129341) (#129607)

* Add Reindex indices examples

* Update docs/reference/elasticsearch/rest-apis/reindex-indices.md



* Update section structure and add TOC

* Add back the TEST snippets

---------

Co-authored-by: Liam Thompson <[email protected]>

Author: charlotte-hoblik