Update rest-api-spec (#3263)

github-actions[bot] · pquentin · web-flow · commit 99a0765eb972 · 2025-01-22T09:39:10.000+04:00
Co-authored-by: pquentin &lt;42327+pquentin@users.noreply.github.com&gt;
diff --git a/output/schema/validation-errors.json b/output/schema/validation-errors.json
@@ -237,8 +237,7 @@
     },
     "indices.rollover": {
       "request": [
-        "Request: missing json spec query parameter 'lazy'",
-        "Request: missing json spec query parameter 'target_failure_store'"
+        "Request: missing json spec query parameter 'lazy'"
       ],
       "response": []
     },
@@ -264,8 +263,7 @@
     "license.post_start_trial": {
       "request": [
         "Request: query parameter 'type_query_string' does not exist in the json spec",
-        "Request: missing json spec query parameter 'type'",
-        "Request: missing json spec query parameter 'timeout'"
+        "Request: missing json spec query parameter 'type'"
       ],
       "response": []
     },
@@ -356,20 +354,6 @@
       ],
       "response": []
     },
-    "shutdown.delete_node": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
-    "shutdown.put_node": {
-      "request": [
-        "Request: query parameter 'master_timeout' does not exist in the json spec",
-        "Request: query parameter 'timeout' does not exist in the json spec"
-      ],
-      "response": []
-    },
     "snapshot.clone": {
       "request": [
         "Request: query parameter 'timeout' does not exist in the json spec"
@@ -411,7 +395,6 @@
     },
     "xpack.info": {
       "request": [
-        "Request: query parameter 'human' does not exist in the json spec",
         "request definition xpack.info:Request / query - Property 'human' is already defined in an ancestor class"
       ],
       "response": []
diff --git a/specification/_json_spec/cluster.exists_component_template.json b/specification/_json_spec/cluster.exists_component_template.json
@@ -26,9 +26,10 @@
     "params": {
       "master_timeout": {
         "type": "time",
-        "description": "Explicit operation timeout for connection to master node"
+        "description": "Timeout for waiting for new cluster state in case it is blocked"
       },
       "local": {
+        "deprecated": true,
         "type": "boolean",
         "description": "Return local information, do not retrieve the state from master node (default: false)"
       }
diff --git a/specification/_json_spec/cluster.get_component_template.json b/specification/_json_spec/cluster.get_component_template.json
@@ -30,9 +30,10 @@
     "params": {
       "master_timeout": {
         "type": "time",
-        "description": "Explicit operation timeout for connection to master node"
+        "description": "Timeout for waiting for new cluster state in case it is blocked"
       },
       "local": {
+        "deprecated": true,
         "type": "boolean",
         "description": "Return local information, do not retrieve the state from master node (default: false)"
       },
diff --git a/specification/_json_spec/cluster.get_settings.json b/specification/_json_spec/cluster.get_settings.json
@@ -24,7 +24,7 @@
       },
       "master_timeout": {
         "type": "time",
-        "description": "Explicit operation timeout for connection to master node"
+        "description": "Timeout for waiting for new cluster state in case it is blocked"
       },
       "timeout": {
         "type": "time",
diff --git a/specification/_json_spec/connector.delete.json b/specification/_json_spec/connector.delete.json
@@ -24,15 +24,15 @@
       ]
     },
     "params": {
-      "delete_sync_jobs": {
+      "hard": {
         "type": "boolean",
         "default": false,
-        "description": "Determines whether associated sync jobs are also deleted."
+        "description": "If true, the connector doc is deleted. If false, connector doc is marked as deleted (soft-deleted)."
       },
-      "hard": {
+      "delete_sync_jobs": {
         "type": "boolean",
         "default": false,
-        "description": "A flag indicating if this should be a hard delete. Defaults to false."
+        "description": "Determines whether associated sync jobs are also deleted."
       }
     }
   }
diff --git a/specification/_json_spec/connector.get.json b/specification/_json_spec/connector.get.json
@@ -27,7 +27,7 @@
       "include_deleted": {
         "type": "boolean",
         "default": false,
-        "description": "A flag to indicate if the desired connector should be fetched even if it was soft-deleted"
+        "description": "A flag indicating whether to return connectors that have been soft-deleted."
       }
     }
   }
diff --git a/specification/_json_spec/connector.list.json b/specification/_json_spec/connector.list.json
@@ -47,7 +47,7 @@
       "include_deleted": {
         "type": "boolean",
         "default": false,
-        "description": "A flag that indicates whether a soft-deleted connectors will be fetched"
+        "description": "A flag indicating whether to return connectors that have been soft-deleted."
       }
     }
   }
diff --git a/specification/_json_spec/indices.exists_template.json b/specification/_json_spec/indices.exists_template.json
@@ -30,9 +30,10 @@
       },
       "master_timeout": {
         "type": "time",
-        "description": "Explicit operation timeout for connection to master node"
+        "description": "Timeout for waiting for new cluster state in case it is blocked"
       },
       "local": {
+        "deprecated": true,
         "type": "boolean",
         "description": "Return local information, do not retrieve the state from master node (default: false)"
       }
diff --git a/specification/_json_spec/indices.get_index_template.json b/specification/_json_spec/indices.get_index_template.json
@@ -34,9 +34,10 @@
       },
       "master_timeout": {
         "type": "time",
-        "description": "Explicit operation timeout for connection to master node"
+        "description": "Timeout for waiting for new cluster state in case it is blocked"
       },
       "local": {
+        "deprecated": true,
         "type": "boolean",
         "description": "Return local information, do not retrieve the state from master node (default: false)"
       },
diff --git a/specification/_json_spec/indices.get_template.json b/specification/_json_spec/indices.get_template.json
@@ -34,9 +34,10 @@
       },
       "master_timeout": {
         "type": "time",
-        "description": "Explicit operation timeout for connection to master node"
+        "description": "Timeout for waiting for new cluster state in case it is blocked"
       },
       "local": {
+        "deprecated": true,
         "type": "boolean",
         "description": "Return local information, do not retrieve the state from master node (default: false)"
       }
diff --git a/specification/_json_spec/indices.rollover.json b/specification/_json_spec/indices.rollover.json
@@ -59,12 +59,6 @@
         "type": "boolean",
         "default": "false",
         "description": "If set to true, the rollover action will only mark a data stream to signal that it needs to be rolled over at the next write. Only allowed on data streams."
-      },
-      "target_failure_store": {
-        "type": "boolean",
-        "description": "If set to true, the rollover action will be applied on the failure store of the data stream.",
-        "visibility": "feature_flag",
-        "feature_flag": "es.failure_store_feature_flag_enabled"
       }
     },
     "body": {
diff --git a/specification/_json_spec/license.post_start_trial.json b/specification/_json_spec/license.post_start_trial.json
@@ -29,10 +29,6 @@
       "master_timeout": {
         "type": "time",
         "description": "Timeout for processing on master node"
-      },
-      "timeout": {
-        "type": "time",
-        "description": "Timeout for acknowledgement of update from all nodes in cluster"
       }
     }
   }
diff --git a/specification/_json_spec/migrate.cancel_reindex.json b/specification/_json_spec/migrate.cancel_reindex.json
@@ -2,7 +2,7 @@
   "migrate.cancel_reindex": {
     "documentation": {
       "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/data-stream-reindex.html",
-      "description": "This API cancels migration reindex attempt for a data stream or index"
+      "description": "This API returns the status of a migration reindex attempt for a data stream or index"
     },
     "stability": "experimental",
     "visibility": "private",
diff --git a/specification/_json_spec/migrate.create_from.json b/specification/_json_spec/migrate.create_from.json
@@ -29,7 +29,7 @@
       ]
     },
     "body": {
-      "description": "The body contains the fields `mappings_override` and `settings_override`.",
+      "description": "The body contains the fields `mappings_override`, `settings_override`, and `remove_index_blocks`.",
       "required": false
     }
   }
diff --git a/specification/_json_spec/migrate.reindex.json b/specification/_json_spec/migrate.reindex.json
@@ -19,7 +19,7 @@
       ]
     },
     "body": {
-      "description": "The body contains the fields `mode` and `source.index`, where the only mode currently supported is `upgrade`, and the `source.index` must be a data stream name",
+      "description": "The body contains the fields `mode` and `source.index, where the only mode currently supported is `upgrade`, and the `source.index` must be a data stream name",
       "required": true
     }
   }
diff --git a/specification/_json_spec/shutdown.delete_node.json b/specification/_json_spec/shutdown.delete_node.json
@@ -24,6 +24,15 @@
         }
       ]
     },
-    "params": {}
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    }
   }
 }
diff --git a/specification/_json_spec/shutdown.put_node.json b/specification/_json_spec/shutdown.put_node.json
@@ -24,7 +24,16 @@
         }
       ]
     },
-    "params": {},
+    "params": {
+      "master_timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout for connection to master node"
+      },
+      "timeout": {
+        "type": "time",
+        "description": "Explicit operation timeout"
+      }
+    },
     "body": {
       "description": "The shutdown type definition to register",
       "required": true
diff --git a/specification/_json_spec/xpack.info.json b/specification/_json_spec/xpack.info.json
@@ -18,6 +18,12 @@
       ]
     },
     "params": {
+      "human": {
+        "type": "boolean",
+        "required": false,
+        "description": "Defines whether additional human-readable information is included in the response. In particular, it adds descriptions and a tag line. The default value is true.",
+        "default": true
+      },
       "categories": {
         "type": "list",
         "description": "Comma-separated list of info categories. Can be any of: build, license, features"

Original file line number	Diff line number	Diff line change
`@@ -24,15 +24,15 @@`
`24`	`24`	`]`
`25`	`25`	`},`
`26`	`26`	`"params": {`
`27`		`- "delete_sync_jobs": {`
	`27`	`+ "hard": {`
`28`	`28`	`"type": "boolean",`
`29`	`29`	`"default": false,`
`30`		`- "description": "Determines whether associated sync jobs are also deleted."`
	`30`	`+ "description": "If true, the connector doc is deleted. If false, connector doc is marked as deleted (soft-deleted)."`
`31`	`31`	`},`
`32`		`- "hard": {`
	`32`	`+ "delete_sync_jobs": {`
`33`	`33`	`"type": "boolean",`
`34`	`34`	`"default": false,`
`35`		`- "description": "A flag indicating if this should be a hard delete. Defaults to false."`
	`35`	`+ "description": "Determines whether associated sync jobs are also deleted."`
`36`	`36`	`}`
`37`	`37`	`}`
`38`	`38`	`}`
Original file line number	Diff line number	Diff line change
`@@ -27,7 +27,7 @@`
`27`	`27`	`"include_deleted": {`
`28`	`28`	`"type": "boolean",`
`29`	`29`	`"default": false,`
`30`		`- "description": "A flag to indicate if the desired connector should be fetched even if it was soft-deleted"`
	`30`	`+ "description": "A flag indicating whether to return connectors that have been soft-deleted."`
`31`	`31`	`}`
`32`	`32`	`}`
`33`	`33`	`}`
Original file line number	Diff line number	Diff line change
`@@ -47,7 +47,7 @@`
`47`	`47`	`"include_deleted": {`
`48`	`48`	`"type": "boolean",`
`49`	`49`	`"default": false,`
`50`		`- "description": "A flag that indicates whether a soft-deleted connectors will be fetched"`
	`50`	`+ "description": "A flag indicating whether to return connectors that have been soft-deleted."`
`51`	`51`	`}`
`52`	`52`	`}`
`53`	`53`	`}`