Add reindex examples

Author: lcawl

output/openapi/elasticsearch-openapi.json

@@ -148,7 +148,6 @@ docs-multi-termvectors,https://www.elastic.co/guide/en/elasticsearch/reference/{
 docs-reindex,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/docs-reindex.html
 docs-termvectors,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/docs-termvectors.html
 docs-update-by-query,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/docs-update-by-query.html
-docs-update-by-query,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/docs-update-by-query.html
 docs-update,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/docs-update.html
 document-input-parameters,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/query-dsl-mlt-query.html#_document_input_parameters
 dot-expand-processor,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/dot-expand-processor.html
@@ -680,6 +679,7 @@ set-processor,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/s
 shape,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/shape.html
 simulate-ingest-api,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/simulate-ingest-api.html
 simulate-pipeline-api,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/simulate-pipeline-api.html
+slice-scroll,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/paginate-search-results.html#slice-scroll
 slm-api-delete-policy,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/slm-api-delete-policy.html
 slm-api-execute-lifecycle,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/slm-api-execute-lifecycle.html
 slm-api-execute-retention,https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/slm-api-execute-retention.html

output/openapi/elasticsearch-serverless-openapi.json

@@ -25,21 +25,68 @@ import { DurationValue, EpochTime, UnitMillis } from '@_types/Time'
 
 export class Response {
   body: {
+    /**
+     * The number of scroll responses that were pulled back by the reindex.
+     */
     batches?: long
+    /**
+     * The number of documents that were successfully created.
+     */
     created?: long
+    /**
+     * The number of documents that were successfully deleted.
+     */
     deleted?: long
+    /**
+     * If there were any unrecoverable errors during the process, it is an array of those failures.
+     * If this array is not empty, the request ended because of those failures.
+     * Reindex is implemented using batches and any failure causes the entire process to end but all failures in the current batch are collected into the array.
+     * You can use the `conflicts` option to prevent the reindex from ending on version conflicts.
+     */
     failures?: BulkIndexByScrollFailure[]
+    /**
+     * The number of documents that were ignored because the script used for the reindex returned a `noop` value for `ctx.op`.
+     */
     noops?: long
+    /**
+     * The number of retries attempted by reindex.
+     */
     retries?: Retries
+    /**
+     * The number of requests per second effectively run during the reindex.
+     */
     requests_per_second?: float
     slice_id?: integer
     task?: TaskId
+    /**
+     * The number of milliseconds the request slept to conform to `requests_per_second`.
+     */
     throttled_millis?: EpochTime<UnitMillis>
+    /**
+     * This field should always be equal to zero in a reindex response.
+     * It has meaning only when using the task API, where it indicates the next time (in milliseconds since epoch) that a throttled request will be run again in order to conform to `requests_per_second`.
+     */
     throttled_until_millis?: EpochTime<UnitMillis>
+    /**
+     * If any of the requests that ran during the reindex timed out, it is `true`.
+     */
     timed_out?: boolean
+    /**
+     * The total milliseconds the entire operation took.
+     */
     took?: DurationValue<UnitMillis>
+    /**
+     * The number of documents that were successfully processed.
+     */
     total?: long
+    /**
+     * The number of documents that were successfully updated.
+     * That is to say, a document with the same ID already existed before the reindex updated it.
+     */
     updated?: long
+    /**
+     * The number of version conflicts that occurred.
+     */
     version_conflicts?: long
   }
 }

output/schema/schema.json

@@ -0,0 +1,16 @@
+summary: Reindex multiple sources
+# method_request: POST _reindex
+description: >
+  Run `POST _reindex` to reindex from multiple sources.
+  The `index` attribute in source can be a list, which enables you to copy from lots of sources in one request.
+  This example copies documents from the `my-index-000001` and `my-index-000002` indices.
+# type: request
+value: |-
+  {
+    "source": {
+      "index": ["my-index-000001", "my-index-000002"]
+    },
+    "dest": {
+      "index": "my-new-index-000002"
+    }
+  }

specification/_doc_ids/table.csv

@@ -0,0 +1,12 @@
+summary: Reindex with Painless
+# method_request: POST _reindex
+description: >
+  You can use Painless to reindex daily indices to apply a new template to the existing documents.
+  The script extracts the date from the index name and creates a new index with `-1` appended.
+  For example, all data from `metricbeat-2016.05.31` will be reindexed into `metricbeat-2016.05.31-1`.
+# type: request
+value:
+  "{\n  \"source\": {\n    \"index\": \"metricbeat-*\"\n  },\n  \"dest\": {\n\
+  \    \"index\": \"metricbeat\"\n  },\n  \"script\": {\n    \"lang\": \"painless\"\
+  ,\n    \"source\": \"ctx._index = 'metricbeat-' + (ctx._index.substring('metricbeat-'.length(),\
+  \ ctx._index.length())) + '-1'\"\n  }\n}"

specification/_global/reindex/ReindexRequest.ts

@@ -0,0 +1,11 @@
+summary: Reindex a random subset
+# method_request: POST _reindex
+description: >
+  Run `POST _reindex` to extract a random subset of the source for testing.
+  You might need to adjust the `min_score` value depending on the relative amount of data extracted from source.
+# type: request
+value:
+  "{\n  \"max_docs\": 10,\n  \"source\": {\n    \"index\": \"my-index-000001\"\
+  ,\n    \"query\": {\n      \"function_score\" : {\n        \"random_score\" : {},\n\
+  \        \"min_score\" : 0.9\n      }\n    }\n  },\n  \"dest\": {\n    \"index\"\
+  : \"my-new-index-000001\"\n  }\n}"

specification/_global/reindex/ReindexResponse.ts

@@ -0,0 +1,11 @@
+summary: Reindex modified documents
+# method_request: POST _reindex
+description: >
+  Run `POST _reindex` to modify documents during reindexing.
+  This example bumps the version of the source document.
+# type: request
+value:
+  "{\n  \"source\": {\n    \"index\": \"my-index-000001\"\n  },\n  \"dest\":\
+  \ {\n    \"index\": \"my-new-index-000001\",\n    \"version_type\": \"external\"\
+  \n  },\n  \"script\": {\n    \"source\": \"if (ctx._source.foo == 'bar') {ctx._version++;\
+  \ ctx._source.remove('foo')}\",\n    \"lang\": \"painless\"\n  }\n}"