Update rest-api-spec

Author: timgrein

output/schema/schema.json

@@ -127,6 +127,12 @@
       ],
       "response": []
     },
+    "snapshot.get": {
+      "request": [
+        "Request: missing json spec query parameter 'state'"
+      ],
+      "response": []
+    },
     "snapshot.repository_analyze": {
       "request": [
         "Request: query parameter 'register_operation_count' does not exist in the json spec"

output/schema/validation-errors.json

@@ -7,7 +7,7 @@
     "stability": "experimental",
     "visibility": "public",
     "headers": {
-      "accept": [],
+      "accept": ["application/json"],
       "content_type": ["application/json"]
     },
     "url": {

specification/_json_spec/esql.list_queries.json

@@ -5,8 +5,7 @@
       "description": "Gets a data stream's settings"
     },
     "stability": "stable",
-    "visibility": "feature_flag",
-    "feature_flag": "logs_stream",
+    "visibility": "public",
     "headers": {
       "accept": ["application/json"]
     },
@@ -18,20 +17,16 @@
           "parts": {
             "name": {
               "type": "string",
-              "description": "The name of the data stream or data stream pattern"
+              "description": "Comma-separated list of data streams or data stream patterns"
             }
           }
         }
       ]
     },
     "params": {
-      "timeout": {
-        "type": "time",
-        "description": "Specify timeout for acknowledging the cluster state update"
-      },
       "master_timeout": {
         "type": "time",
-        "description": "Specify timeout for connection to master"
+        "description": "Period to wait for a connection to the master node"
       }
     }
   }

specification/_json_spec/indices.get_data_stream_settings.json

@@ -5,8 +5,7 @@
       "description": "Updates a data stream's settings"
     },
     "stability": "stable",
-    "visibility": "feature_flag",
-    "feature_flag": "logs_stream",
+    "visibility": "public",
     "headers": {
       "accept": ["application/json"]
     },
@@ -18,7 +17,7 @@
           "parts": {
             "name": {
               "type": "string",
-              "description": "The name of the data stream or data stream pattern"
+              "description": "Comma-separated list of data streams or data stream patterns"
             }
           }
         }
@@ -27,16 +26,16 @@
     "params": {
       "dry_run": {
         "type": "boolean",
-        "description": "Perform a dry run but do not actually change any settings",
+        "description": "Whether this request should only be a dry run rather than actually applying settings",
         "default": false
       },
       "timeout": {
         "type": "time",
-        "description": "Specify timeout for acknowledging the cluster state update"
+        "description": "Period to wait for a response"
       },
       "master_timeout": {
         "type": "time",
-        "description": "Specify timeout for connection to master"
+        "description": "Period to wait for a connection to the master node"
       }
     },
     "body": {

specification/_json_spec/indices.put_data_stream_settings.json

@@ -91,6 +91,10 @@
       "verbose": {
         "type": "boolean",
         "description": "Whether to show verbose snapshot info or only show the basic info found in the repository index blob"
+      },
+      "state": {
+        "type": "list",
+        "description": "Filter snapshots by a comma-separated list of states. Valid state values are 'SUCCESS', 'IN_PROGRESS', 'FAILED', 'PARTIAL', or 'INCOMPATIBLE'."
       }
     }
   }

specification/_json_spec/snapshot.get.json

@@ -0,0 +1,32 @@
+{
+  "streams.logs_disable": {
+    "documentation": {
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/streams-logs-disable.html",
+      "description": "Disable the Logs Streams feature for this cluster"
+    },
+    "stability": "stable",
+    "visibility": "feature_flag",
+    "feature_flag": "logs_stream",
+    "headers": {
+      "accept": ["application/json", "text/plain"]
+    },
+    "url": {
+      "paths": [
+        {
+          "path": "/_streams/logs/_disable",
+          "methods": ["POST"]
+        }
+      ]
+    },
+    "params": {
+      "timeout": {
+        "type": "time",
+        "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error."
+      },
+      "master_timeout": {
+        "type": "time",
+        "description": "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."
+      }
+    }
+  }
+}

specification/_json_spec/streams.logs_disable.json

@@ -0,0 +1,32 @@
+{
+  "streams.logs_enable": {
+    "documentation": {
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/streams-logs-enable.html",
+      "description": "Enable the Logs Streams feature for this cluster"
+    },
+    "stability": "stable",
+    "visibility": "feature_flag",
+    "feature_flag": "logs_stream",
+    "headers": {
+      "accept": ["application/json", "text/plain"]
+    },
+    "url": {
+      "paths": [
+        {
+          "path": "/_streams/logs/_enable",
+          "methods": ["POST"]
+        }
+      ]
+    },
+    "params": {
+      "timeout": {
+        "type": "time",
+        "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error."
+      },
+      "master_timeout": {
+        "type": "time",
+        "description": "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."
+      }
+    }
+  }
+}

specification/_json_spec/streams.logs_enable.json

@@ -0,0 +1,28 @@
+{
+  "streams.status": {
+    "documentation": {
+      "url": "https://www.elastic.co/guide/en/elasticsearch/reference/master/streams-status.html",
+      "description": "Return the current status of the streams feature for each streams type"
+    },
+    "stability": "stable",
+    "visibility": "feature_flag",
+    "feature_flag": "logs_stream",
+    "headers": {
+      "accept": ["application/json"]
+    },
+    "url": {
+      "paths": [
+        {
+          "path": "/_streams/status",
+          "methods": ["GET"]
+        }
+      ]
+    },
+    "params": {
+      "mater_timeout": {
+        "type": "time",
+        "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error."
+      }
+    }
+  }
+}