Add documentation for GET snapshots state query parameter. (#4597)

* Add GET snapshots state query parameter.

Adds documentation for the SnapshotState enum and state
query parameter added in elasticsearch PR #128635.

* Allow SnapshotState or SnapshotState[]

* Regenerate output for updated SnapshotState definition

Author: JeremyDahlgren

output/openapi/elasticsearch-openapi.json

@@ -119,12 +119,6 @@
       ],
       "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/schema.json

@@ -0,0 +1,31 @@
+/*
+ * Licensed to Elasticsearch B.V. under one or more contributor
+ * license agreements. See the NOTICE file distributed with
+ * this work for additional information regarding copyright
+ * ownership. Elasticsearch B.V. licenses this file to you under
+ * the Apache License, Version 2.0 (the "License"); you may
+ * not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *    http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing,
+ * software distributed under the License is distributed on an
+ * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
+ * KIND, either express or implied.  See the License for the
+ * specific language governing permissions and limitations
+ * under the License.
+ */
+
+export enum SnapshotState {
+  /** The snapshot process has started. */
+  IN_PROGRESS,
+  /** The snapshot process completed successfully. */
+  SUCCESS,
+  /** The snapshot failed. */
+  FAILED,
+  /** The snapshot was partially successful. */
+  PARTIAL,
+  /** The snapshot is incompatible with the current version of the cluster. */
+  INCOMPATIBLE
+}

output/schema/validation-errors.json

@@ -23,6 +23,7 @@ import { integer } from '@_types/Numeric'
 import { SortOrder } from '@_types/sort'
 import { Duration } from '@_types/Time'
 import { SnapshotSort } from '@snapshot/_types/SnapshotInfo'
+import { SnapshotState } from '@snapshot/_types/SnapshotState'
 
 /**
  * Get snapshot information.
@@ -147,6 +148,13 @@ export interface Request extends RequestBase {
      * @availability serverless
      */
     sort?: SnapshotSort
+    /**
+     * Only return snapshots with a state found in the given comma-separated list of snapshot states.
+     * The default is all snapshot states.
+     * @availability stack since=9.1.0
+     * @availability serverless
+     */
+    state?: SnapshotState | SnapshotState[]
     /**
      * If `true`, returns additional information about each snapshot such as the version of Elasticsearch which took the snapshot, the start and end times of the snapshot, and the number of shards snapshotted.
      *