rest-api-spec: Enforce body "required" field (#136356) (#136370)

* rest-api-spec: Enforce body "required" field

* Fix required status after YAML test run

(cherry picked from commit cb779fc)

# Conflicts:
#	rest-api-spec/src/main/resources/rest-api-spec/api/inference.put_ai21.json
#	rest-api-spec/src/main/resources/rest-api-spec/api/inference.put_contextualai.json
#	rest-api-spec/src/main/resources/rest-api-spec/api/inference.put_llama.json

Author: pquentin

rest-api-spec/src/main/resources/rest-api-spec/api/async_search.submit.json

@@ -243,7 +243,8 @@
       }
     },
     "body": {
-      "description": "The search definition using the Query DSL"
+      "description": "The search definition using the Query DSL",
+      "required": false
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/clear_scroll.json

@@ -44,7 +44,8 @@
     },
     "params": {},
     "body": {
-      "description": "A comma-separated list of scroll IDs to clear if none was specified via the scroll_id parameter"
+      "description": "A comma-separated list of scroll IDs to clear if none was specified via the scroll_id parameter",
+      "required": false
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/close_point_in_time.json

@@ -26,7 +26,8 @@
     },
     "params": {},
     "body": {
-      "description": "a point-in-time id to close"
+      "description": "a point-in-time id to close",
+      "required": true
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/cluster.allocation_explain.json

@@ -43,7 +43,8 @@
       }
     },
     "body": {
-      "description": "The index, shard, and primary flag to explain. Empty means 'explain a randomly-chosen unassigned shard'"
+      "description": "The index, shard, and primary flag to explain. Empty means 'explain a randomly-chosen unassigned shard'",
+      "required": false
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/cluster.reroute.json

@@ -67,7 +67,8 @@
       }
     },
     "body": {
-      "description": "The definition of `commands` to perform (`move`, `cancel`, `allocate`)"
+      "description": "The definition of `commands` to perform (`move`, `cancel`, `allocate`)",
+      "required": false
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/count.json

@@ -115,7 +115,8 @@
       }
     },
     "body": {
-      "description": "A query to restrict the results specified with the Query DSL (optional)"
+      "description": "A query to restrict the results specified with the Query DSL (optional)",
+      "required": false
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/explain.json

@@ -93,7 +93,8 @@
       }
     },
     "body": {
-      "description": "The query definition using the Query DSL"
+      "description": "The query definition using the Query DSL",
+      "required": false
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/field_caps.json

@@ -85,7 +85,8 @@
       }
     },
     "body": {
-      "description": "An index filter specified with the Query DSL"
+      "description": "An index filter specified with the Query DSL",
+      "required": false
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/fleet.search.json

@@ -48,7 +48,8 @@
       }
     },
     "body": {
-      "description": "The search definition using the Query DSL"
+      "description": "The search definition using the Query DSL",
+      "required": true
     }
   }
 }

rest-api-spec/src/main/resources/rest-api-spec/api/graph.explore.json

@@ -42,7 +42,8 @@
       }
     },
     "body": {
-      "description": "Graph Query DSL"
+      "description": "Graph Query DSL",
+      "required": true
     }
   }
 }