Updated opensearch-php to reflect the latest OpenSearch API spec (202…

…4-07-27) Signed-off-by: GitHub <[email protected]>
opensearch-project · Jul 27, 2024 · f4b8b9d · f4b8b9d
1 parent afee32d
commit f4b8b9d
Show file tree

Hide file tree

Showing 12 changed files with 368 additions and 87 deletions.
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -11,6 +11,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 ### Removed
 ### Fixed
 ### Updated APIs
+- Updated opensearch-php APIs to reflect [opensearch-api-specification@aec3145](https://github.com/opensearch-project/opensearch-api-specification/commit/aec314547f64b13a7f57d9e8834d45ca5795e010)
 ### Security
 ### Dependencies
 

diff --git a/src/OpenSearch/Endpoints/Indices/Exists.php b/src/OpenSearch/Endpoints/Indices/Exists.php
@@ -42,6 +42,7 @@ public function getParamWhitelist(): array
     {
         return [
             'allow_no_indices',
+            'cluster_manager_timeout',
             'expand_wildcards',
             'flat_settings',
             'ignore_unavailable',

diff --git a/src/OpenSearch/Endpoints/Indices/PutAlias.php b/src/OpenSearch/Endpoints/Indices/PutAlias.php
@@ -21,7 +21,6 @@
 
 namespace OpenSearch\Endpoints\Indices;
 
-use OpenSearch\Common\Exceptions\RuntimeException;
 use OpenSearch\Endpoints\AbstractEndpoint;
 
 /**
@@ -33,19 +32,18 @@ class PutAlias extends AbstractEndpoint
 
     public function getURI(): string
     {
-        if (isset($this->index) !== true) {
-            throw new RuntimeException(
-                'index is required for put_alias'
-            );
+        $name = $this->name ?? null;
+        $index = $this->index ?? null;
+        if (isset($index) && isset($name)) {
+            return "/$index/_alias/$name";
         }
-        $index = $this->index;
-        if (isset($this->name) !== true) {
-            throw new RuntimeException(
-                'name is required for put_alias'
-            );
+        if (isset($index)) {
+            return "/$index/_alias";
         }
-        $name = $this->name;
-        return "/$index/_alias/$name";
+        if (isset($name)) {
+            return "/_alias/$name";
+        }
+        return "/_alias";
     }
 
     public function getParamWhitelist(): array

diff --git a/src/OpenSearch/Endpoints/Nodes/Info.php b/src/OpenSearch/Endpoints/Nodes/Info.php
@@ -28,22 +28,21 @@
  */
 class Info extends AbstractEndpoint
 {
+    protected $node_id_or_metric;
     protected $metric;
     protected $node_id;
 
     public function getURI(): string
     {
+        $node_id_or_metric = $this->node_id_or_metric ?? null;
         $metric = $this->metric ?? null;
         $node_id = $this->node_id ?? null;
+        if (isset($node_id_or_metric)) {
+            return "/_nodes/$node_id_or_metric";
+        }
         if (isset($node_id) && isset($metric)) {
             return "/_nodes/$node_id/$metric";
         }
-        if (isset($node_id)) {
-            return "/_nodes/$node_id";
-        }
-        if (isset($metric)) {
-            return "/_nodes/$metric";
-        }
         return "/_nodes";
     }
 
@@ -65,6 +64,16 @@ public function getMethod(): string
         return 'GET';
     }
 
+    public function setNodeIdOrMetric($node_id_or_metric): Info
+    {
+        if (isset($node_id_or_metric) !== true) {
+            return $this;
+        }
+        $this->node_id_or_metric = $node_id_or_metric;
+
+        return $this;
+    }
+
     public function setMetric($metric): Info
     {
         if (isset($metric) !== true) {

diff --git a/src/OpenSearch/Endpoints/Sql/Close.php b/src/OpenSearch/Endpoints/Sql/Close.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * The OpenSearch Contributors require contributions made to
+ * this file be licensed under the Apache-2.0 license or a
+ * compatible open source license.
+ *
+ * Modifications Copyright OpenSearch Contributors. See
+ * GitHub history for details.
+ */
+
+namespace OpenSearch\Endpoints\Sql;
+
+use OpenSearch\Endpoints\AbstractEndpoint;
+
+/**
+ * NOTE: This file is autogenerated using util/GenerateEndpoints.php
+ */
+class Close extends AbstractEndpoint
+{
+    public function getURI(): string
+    {
+        return "/_plugins/_sql/close";
+    }
+
+    public function getParamWhitelist(): array
+    {
+        return [
+            'format',
+            'sanitize',
+            'pretty',
+            'human',
+            'error_trace',
+            'source',
+            'filter_path'
+        ];
+    }
+
+    public function getMethod(): string
+    {
+        return 'POST';
+    }
+
+    public function setBody($body): Close
+    {
+        if (isset($body) !== true) {
+            return $this;
+        }
+        $this->body = $body;
+
+        return $this;
+    }
+}
diff --git a/src/OpenSearch/Endpoints/Sql/Explain.php b/src/OpenSearch/Endpoints/Sql/Explain.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 /**
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -15,20 +17,41 @@
 
 use OpenSearch\Endpoints\AbstractEndpoint;
 
+/**
+ * NOTE: This file is autogenerated using util/GenerateEndpoints.php
+ */
 class Explain extends AbstractEndpoint
 {
-    public function getParamWhitelist(): array
+    public function getURI(): string
     {
-        return [];
+        return "/_plugins/_sql/_explain";
     }
 
-    public function getURI(): string
+    public function getParamWhitelist(): array
     {
-        return '/_plugins/_sql/_explain';
+        return [
+            'format',
+            'sanitize',
+            'pretty',
+            'human',
+            'error_trace',
+            'source',
+            'filter_path'
+        ];
     }
 
     public function getMethod(): string
     {
         return 'POST';
     }
+
+    public function setBody($body): Explain
+    {
+        if (isset($body) !== true) {
+            return $this;
+        }
+        $this->body = $body;
+
+        return $this;
+    }
 }
diff --git a/src/OpenSearch/Endpoints/Sql/GetStats.php b/src/OpenSearch/Endpoints/Sql/GetStats.php
@@ -0,0 +1,47 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * The OpenSearch Contributors require contributions made to
+ * this file be licensed under the Apache-2.0 license or a
+ * compatible open source license.
+ *
+ * Modifications Copyright OpenSearch Contributors. See
+ * GitHub history for details.
+ */
+
+namespace OpenSearch\Endpoints\Sql;
+
+use OpenSearch\Endpoints\AbstractEndpoint;
+
+/**
+ * NOTE: This file is autogenerated using util/GenerateEndpoints.php
+ */
+class GetStats extends AbstractEndpoint
+{
+    public function getURI(): string
+    {
+        return "/_plugins/_sql/stats";
+    }
+
+    public function getParamWhitelist(): array
+    {
+        return [
+            'format',
+            'sanitize',
+            'pretty',
+            'human',
+            'error_trace',
+            'source',
+            'filter_path'
+        ];
+    }
+
+    public function getMethod(): string
+    {
+        return 'GET';
+    }
+}
diff --git a/src/OpenSearch/Endpoints/Sql/PostStats.php b/src/OpenSearch/Endpoints/Sql/PostStats.php
@@ -0,0 +1,57 @@
+<?php
+
+declare(strict_types=1);
+
+/**
+ * SPDX-License-Identifier: Apache-2.0
+ *
+ * The OpenSearch Contributors require contributions made to
+ * this file be licensed under the Apache-2.0 license or a
+ * compatible open source license.
+ *
+ * Modifications Copyright OpenSearch Contributors. See
+ * GitHub history for details.
+ */
+
+namespace OpenSearch\Endpoints\Sql;
+
+use OpenSearch\Endpoints\AbstractEndpoint;
+
+/**
+ * NOTE: This file is autogenerated using util/GenerateEndpoints.php
+ */
+class PostStats extends AbstractEndpoint
+{
+    public function getURI(): string
+    {
+        return "/_plugins/_sql/stats";
+    }
+
+    public function getParamWhitelist(): array
+    {
+        return [
+            'format',
+            'sanitize',
+            'pretty',
+            'human',
+            'error_trace',
+            'source',
+            'filter_path'
+        ];
+    }
+
+    public function getMethod(): string
+    {
+        return 'POST';
+    }
+
+    public function setBody($body): PostStats
+    {
+        if (isset($body) !== true) {
+            return $this;
+        }
+        $this->body = $body;
+
+        return $this;
+    }
+}
diff --git a/src/OpenSearch/Endpoints/Sql/Query.php b/src/OpenSearch/Endpoints/Sql/Query.php
@@ -1,5 +1,7 @@
 <?php
 
+declare(strict_types=1);
+
 /**
  * SPDX-License-Identifier: Apache-2.0
  *
@@ -15,20 +17,41 @@
 
 use OpenSearch\Endpoints\AbstractEndpoint;
 
+/**
+ * NOTE: This file is autogenerated using util/GenerateEndpoints.php
+ */
 class Query extends AbstractEndpoint
 {
-    public function getParamWhitelist(): array
+    public function getURI(): string
     {
-        return ['format'];
+        return "/_plugins/_sql";
     }
 
-    public function getURI(): string
+    public function getParamWhitelist(): array
     {
-        return '/_plugins/_sql';
+        return [
+            'format',
+            'sanitize',
+            'pretty',
+            'human',
+            'error_trace',
+            'source',
+            'filter_path'
+        ];
     }
 
     public function getMethod(): string
     {
         return 'POST';
     }
+
+    public function setBody($body): Query
+    {
+        if (isset($body) !== true) {
+            return $this;
+        }
+        $this->body = $body;
+
+        return $this;
+    }
 }