Update rest-api-spec main (#3592)

github-actions[bot] · pquentin · l-trotta · web-flow · commit ebd729a8cd58 · 2025-02-19T15:32:17.000+01:00
* Update rest-api-spec

* master timeout to ilm migrate

* Fix server_default for allow_partial_search_results

---------

Co-authored-by: pquentin &lt;42327+pquentin@users.noreply.github.com&gt;
Co-authored-by: Laura Trotta &lt;153528055+l-trotta@users.noreply.github.com&gt;
Co-authored-by: Laura Trotta &lt;laura.trotta@elastic.co&gt;
Co-authored-by: Quentin Pradet &lt;quentin.pradet@elastic.co&gt;
diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json
diff --git a/output/schema/schema.json b/output/schema/schema.json
diff --git a/output/schema/validation-errors.json b/output/schema/validation-errors.json
@@ -38,7 +38,6 @@
     },
     "async_search.submit": {
       "request": [
-        "Request: query parameter 'keep_alive' does not exist in the json spec",
         "interface definition _types:QueryVectorBuilder - Property text_embedding is a single-variant and must be required"
       ],
       "response": []
diff --git a/output/typescript/types.ts b/output/typescript/types.ts
diff --git a/specification/_json_spec/async_search.submit.json b/specification/_json_spec/async_search.submit.json
@@ -39,6 +39,11 @@
         "description": "Control whether the response should be stored in the cluster if it completed within the provided [wait_for_completion] time (default: false)",
         "default": false
       },
+      "keep_alive": {
+        "type": "time",
+        "description": "Update the time interval in which the results (partial or final) for this search will be available",
+        "default": "5d"
+      },
       "batched_reduce_size": {
         "type": "number",
         "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as the granularity at which progress results will be made available.",
diff --git a/specification/_json_spec/enrich.get_policy.json b/specification/_json_spec/enrich.get_policy.json
@@ -30,7 +30,7 @@
     "params": {
       "master_timeout": {
         "type": "time",
-        "description": "Timeout for processing on master node"
+        "description": "Timeout for waiting for new cluster state in case it is blocked"
       }
     }
   }
diff --git a/specification/_json_spec/enrich.stats.json b/specification/_json_spec/enrich.stats.json
@@ -20,7 +20,7 @@
     "params": {
       "master_timeout": {
         "type": "time",
-        "description": "Timeout for processing on master node"
+        "description": "Timeout for waiting for new cluster state in case it is blocked"
       }
     }
   }
diff --git a/specification/_json_spec/eql.search.json b/specification/_json_spec/eql.search.json
@@ -42,7 +42,7 @@
       "allow_partial_search_results": {
         "type": "boolean",
         "description": "Control whether the query should keep running in case of shard failures, and return partial results",
-        "default": false
+        "default": true
       },
       "allow_partial_sequence_results": {
         "type": "boolean",
diff --git a/specification/_json_spec/ilm.migrate_to_data_tiers.json b/specification/_json_spec/ilm.migrate_to_data_tiers.json
@@ -19,6 +19,10 @@
       ]
     },
     "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
       "dry_run": {
         "type": "boolean",
         "description": "If set to true it will simulate the migration, providing a way to retrieve the ILM policies and indices that need to be migrated. The default is false"
diff --git a/specification/_json_spec/indices.cancel_migrate_reindex.json b/specification/_json_spec/indices.cancel_migrate_reindex.json
@@ -1,7 +1,7 @@
 {
   "indices.cancel_migrate_reindex": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex-cancel-api.html",
       "description": "This API returns the status of a migration reindex attempt for a data stream or index"
     },
     "stability": "experimental",
diff --git a/specification/_json_spec/indices.create_from.json b/specification/_json_spec/indices.create_from.json
@@ -1,7 +1,7 @@
 {
   "indices.create_from": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-create-index-from-source.html",
       "description": "This API creates a destination from a source index. It copies the mappings and settings from the source index while allowing request settings and mappings to override the source values."
     },
     "stability": "experimental",
diff --git a/specification/_json_spec/indices.get_migrate_reindex_status.json b/specification/_json_spec/indices.get_migrate_reindex_status.json
@@ -1,7 +1,7 @@
 {
   "indices.get_migrate_reindex_status": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex-status-api.html",
       "description": "This API returns the status of a migration reindex attempt for a data stream or index"
     },
     "stability": "experimental",
diff --git a/specification/_json_spec/indices.migrate_reindex.json b/specification/_json_spec/indices.migrate_reindex.json
@@ -1,7 +1,7 @@
 {
   "indices.migrate_reindex": {
     "documentation": {
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex-api.html",
       "description": "This API reindexes all legacy backing indices for a data stream. It does this in a persistent task. The persistent task id is returned immediately, and the reindexing work is completed in that task"
     },
     "stability": "experimental",
diff --git a/specification/eql/search/EqlSearchRequest.ts b/specification/eql/search/EqlSearchRequest.ts
@@ -52,7 +52,7 @@ export interface Request extends RequestBase {
     allow_no_indices?: boolean
     /**
      * If true, returns partial results if there are shard failures. If false, returns an error with no partial results.
-     * @server_default false
+     * @server_default true
      */
     allow_partial_search_results?: boolean
     /**
diff --git a/specification/ilm/migrate_to_data_tiers/Request.ts b/specification/ilm/migrate_to_data_tiers/Request.ts
@@ -18,6 +18,7 @@
  */
 
 import { RequestBase } from '@_types/Base'
+import { Duration } from '@_types/Time'
 
 /**
  * Migrate to data tiers routing.
@@ -53,6 +54,13 @@ export interface Request extends RequestBase {
      * @server_default false
      */
     dry_run?: boolean
+    /**
+     * The period to wait for a connection to the master node.
+     * If no response is received before the timeout expires, the request fails and returns an error.
+     * It can also be set to `-1` to indicate that the request should never timeout.
+     * @server_default 30s
+     */
+    master_timeout?: Duration
   }
   body: {
     legacy_template_to_delete?: string

Original file line number	Diff line number	Diff line change
`@@ -30,7 +30,7 @@`
`30`	`30`	`"params": {`
`31`	`31`	`"master_timeout": {`
`32`	`32`	`"type": "time",`
`33`		`- "description": "Timeout for processing on master node"`
	`33`	`+ "description": "Timeout for waiting for new cluster state in case it is blocked"`
`34`	`34`	`}`
`35`	`35`	`}`
`36`	`36`	`}`
Original file line number	Diff line number	Diff line change
`@@ -20,7 +20,7 @@`
`20`	`20`	`"params": {`
`21`	`21`	`"master_timeout": {`
`22`	`22`	`"type": "time",`
`23`		`- "description": "Timeout for processing on master node"`
	`23`	`+ "description": "Timeout for waiting for new cluster state in case it is blocked"`
`24`	`24`	`}`
`25`	`25`	`}`
`26`	`26`	`}`
Original file line number	Diff line number	Diff line change
`@@ -1,7 +1,7 @@`
`1`	`1`	`{`
`2`	`2`	`"indices.cancel_migrate_reindex": {`
`3`	`3`	`"documentation": {`
`4`		`- "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",`
	`4`	`+ "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex-cancel-api.html",`
`5`	`5`	`"description": "This API returns the status of a migration reindex attempt for a data stream or index"`
`6`	`6`	`},`
`7`	`7`	`"stability": "experimental",`