rest-api-spec: use url and description from Elasticsarch specification (#133386)

* rest-api-spec: use url and description from Elasticsarch specification

* Remove doc URLs for internal APIs

* Fix more URLs

They had a whitespace that the regex did not account for.

* Fix more URLs

* Fix JSON Schema validation

Author: pquentin

rest-api-spec/src/main/resources/rest-api-spec/api/_internal.delete_desired_balance.json

@@ -1,8 +1,8 @@
 {
   "_internal.delete_desired_balance":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/delete-desired-balance.html",
-      "description": "This API is a diagnostics API and the output should not be relied upon for building applications."
+      "url": null,
+      "description": "This API is a diagnostics API and the output should not be relied upon for building applications"
     },
     "stability":"experimental",
     "visibility":"private",

rest-api-spec/src/main/resources/rest-api-spec/api/_internal.delete_desired_nodes.json

@@ -1,8 +1,8 @@
 {
   "_internal.delete_desired_nodes":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/delete-desired-nodes.html",
-      "description": "Deletes the desired nodes. Designed for indirect use by ECE/ESS and ECK. Direct use is not supported."
+      "url": null,
+      "description": "Deletes the desired nodes"
     },
     "stability":"experimental",
     "visibility":"private",

rest-api-spec/src/main/resources/rest-api-spec/api/_internal.get_desired_balance.json

@@ -1,8 +1,8 @@
 {
   "_internal.get_desired_balance":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/get-desired-balance.html",
-      "description": "This API is a diagnostics API and the output should not be relied upon for building applications."
+      "url": null,
+      "description": "This API is a diagnostics API and the output should not be relied upon for building applications"
     },
     "stability":"experimental",
     "visibility":"private",

rest-api-spec/src/main/resources/rest-api-spec/api/_internal.get_desired_nodes.json

@@ -1,8 +1,8 @@
 {
   "_internal.get_desired_nodes":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/get-desired-nodes.html",
-      "description": "Gets the latest desired nodes. Designed for indirect use by ECE/ESS and ECK. Direct use is not supported."
+      "url": null,
+      "description": "Gets the latest desired nodes"
     },
     "stability":"experimental",
     "visibility":"private",

rest-api-spec/src/main/resources/rest-api-spec/api/_internal.prevalidate_node_removal.json

@@ -1,10 +1,10 @@
 {
   "_internal.prevalidate_node_removal": {
     "documentation":{
-      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/prevalidate-node-removal-api.html",
+      "url": null,
       "description":"Prevalidates node removal from the cluster"
     },
-    "stability":"stable",
+    "stability":"experimental",
     "visibility":"private",
     "headers":{
       "accept": [ "application/json"]

rest-api-spec/src/main/resources/rest-api-spec/api/_internal.update_desired_nodes.json

@@ -1,8 +1,8 @@
 {
   "_internal.update_desired_nodes":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/update-desired-nodes.html",
-      "description": "Updates the desired nodes. Designed for indirect use by ECE/ESS and ECK. Direct use is not supported."
+      "url": null,
+      "description": "Updates the desired nodes"
     },
     "stability":"experimental",
     "visibility":"private",

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

@@ -1,8 +1,8 @@
 {
   "async_search.delete":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/async-search.html",
-      "description": "Deletes an async search by ID. If the search is still running, the search request will be cancelled. Otherwise, the saved search results are deleted."
+      "url":"https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-async-search-submit",
+      "description": "Delete an async search"
     },
     "stability":"stable",
     "visibility":"public",

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

@@ -1,8 +1,8 @@
 {
   "async_search.get":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/async-search.html",
-      "description": "Retrieves the results of a previously submitted async search request given its ID."
+      "url":"https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-async-search-submit",
+      "description": "Get async search results"
     },
     "stability":"stable",
     "visibility":"public",

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

@@ -1,8 +1,8 @@
 {
   "async_search.status":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/async-search.html",
-      "description": "Retrieves the status of a previously submitted async search request given its ID."
+      "url":"https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-async-search-submit",
+      "description": "Get the async search status"
     },
     "stability":"stable",
     "visibility":"public",

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

@@ -1,8 +1,8 @@
 {
   "async_search.submit":{
     "documentation":{
-      "url":"https://www.elastic.co/guide/en/elasticsearch/reference/current/async-search.html",
-      "description": "Executes a search request asynchronously."
+      "url":"https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-async-search-submit",
+      "description": "Run an async search"
     },
     "stability":"stable",
     "visibility":"public",