Re-generate client code using latest OpenSearch API specification (2025-05-26) (#1575) (#1576) (#1594)

(cherry picked from commit 5fb0d57)





(cherry picked from commit 152bda4)

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Signed-off-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: opensearch-trigger-bot[bot] <98922864+opensearch-trigger-bot[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: 3 people

CHANGELOG.md

@@ -5,6 +5,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 ### Added
 - Added support for the `template` query type ([#1586](https://github.com/opensearch-project/opensearch-java/pull/1586))
 - Added support for Search Shards request `slice` property ([#1586](https://github.com/opensearch-project/opensearch-java/pull/1586))
+- Added support for ML tool attributes ([#1594](https://github.com/opensearch-project/opensearch-java/pull/1594))
 
 ### Dependencies
 - Bump `org.junit:junit-bom` from 5.12.2 to 5.13.0 ([#1587](https://github.com/opensearch-project/opensearch-java/pull/1587))
@@ -16,6 +17,7 @@ Inspired from [Keep a Changelog](https://keepachangelog.com/en/1.0.0/)
 ### Removed
 
 ### Fixed
+- Fixed ScoreCombination's `parameters` structure ([#1594](https://github.com/opensearch-project/opensearch-java/pull/1594))
 
 ### Security
 

java-client/src/generated/java/org/opensearch/client/opensearch/_types/NodeAttributes.java

@@ -100,7 +100,7 @@ public static NodeAttributes of(Function<NodeAttributes.Builder, ObjectBuilder<N
     }
 
     /**
-     * Required - Lists node attributes.
+     * Required - A list of node attributes.
      * <p>
      * API name: {@code attributes}
      * </p>
@@ -119,7 +119,10 @@ public final String ephemeralId() {
     }
 
     /**
+     * The roles of the node.
+     * <p>
      * API name: {@code external_id}
+     * </p>
      */
     @Nullable
     public final String externalId() {
@@ -263,7 +266,7 @@ public Builder copy() {
         }
 
         /**
-         * Required - Lists node attributes.
+         * Required - A list of node attributes.
          * <p>
          * API name: {@code attributes}
          * </p>
@@ -279,7 +282,7 @@ public final Builder attributes(Map<String, String> map) {
         }
 
         /**
-         * Required - Lists node attributes.
+         * Required - A list of node attributes.
          * <p>
          * API name: {@code attributes}
          * </p>
@@ -304,7 +307,10 @@ public final Builder ephemeralId(String value) {
         }
 
         /**
+         * The roles of the node.
+         * <p>
          * API name: {@code external_id}
+         * </p>
          */
         @Nonnull
         public final Builder externalId(@Nullable String value) {

java-client/src/generated/java/org/opensearch/client/opensearch/_types/NodeRole.java

@@ -45,35 +45,77 @@
 @JsonpDeserializable
 @Generated("org.opensearch.client.codegen.CodeGenerator")
 public enum NodeRole implements JsonEnum {
+    /**
+     * The node can act as a client node.
+     */
     Client("client"),
 
+    /**
+     * The node can act as a cluster manager.
+     */
     ClusterManager("cluster_manager"),
 
+    /**
+     * The node only performs coordination tasks.
+     */
     CoordinatingOnly("coordinating_only"),
 
+    /**
+     * The node can store data.
+     */
     Data("data"),
 
+    /**
+     * The node can store cold data.
+     */
     DataCold("data_cold"),
 
+    /**
+     * The node can store content data.
+     */
     DataContent("data_content"),
 
+    /**
+     * The node can store frozen data.
+     */
     DataFrozen("data_frozen"),
 
+    /**
+     * The node can store hot data.
+     */
     DataHot("data_hot"),
 
+    /**
+     * The node can store warm data.
+     */
     DataWarm("data_warm"),
 
+    /**
+     * The node can perform ingest operations.
+     */
     Ingest("ingest"),
 
     @Deprecated
     Master("master"),
 
+    /**
+     * The node can perform machine learning operations.
+     */
     Ml("ml"),
 
+    /**
+     * The node can act as a remote cluster client.
+     */
     RemoteClusterClient("remote_cluster_client"),
 
+    /**
+     * The node can perform transform operations.
+     */
     Transform("transform"),
 
+    /**
+     * The node can only vote in cluster decisions.
+     */
     VotingOnly("voting_only");
 
     private final String jsonValue;

java-client/src/generated/java/org/opensearch/client/opensearch/_types/NodeShard.java

@@ -59,6 +59,9 @@
 
 // typedef: _types.NodeShard
 
+/**
+ * The information about a shard on a node.
+ */
 @JsonpDeserializable
 @Generated("org.opensearch.client.codegen.CodeGenerator")
 public class NodeShard implements PlainJsonSerializable, ToCopyableBuilder<NodeShard.Builder, NodeShard> {
@@ -80,6 +83,9 @@ public class NodeShard implements PlainJsonSerializable, ToCopyableBuilder<NodeS
     @Nullable
     private final String relocatingNode;
 
+    @Nullable
+    private final Boolean searchOnly;
+
     private final int shard;
 
     @Nonnull
@@ -97,6 +103,7 @@ private NodeShard(Builder builder) {
         this.primary = ApiTypeHelper.requireNonNull(builder.primary, this, "primary");
         this.recoverySource = ApiTypeHelper.unmodifiable(builder.recoverySource);
         this.relocatingNode = builder.relocatingNode;
+        this.searchOnly = builder.searchOnly;
         this.shard = ApiTypeHelper.requireNonNull(builder.shard, this, "shard");
         this.state = ApiTypeHelper.requireNonNull(builder.state, this, "state");
         this.unassignedInfo = builder.unassignedInfo;
@@ -138,7 +145,10 @@ public final boolean primary() {
     }
 
     /**
+     * The recovery source information for this shard.
+     * <p>
      * API name: {@code recovery_source}
+     * </p>
      */
     @Nonnull
     public final Map<String, String> recoverySource() {
@@ -153,6 +163,17 @@ public final String relocatingNode() {
         return this.relocatingNode;
     }
 
+    /**
+     * Indicates if this shard is configured for search operations only
+     * <p>
+     * API name: {@code searchOnly}
+     * </p>
+     */
+    @Nullable
+    public final Boolean searchOnly() {
+        return this.searchOnly;
+    }
+
     /**
      * Required - API name: {@code shard}
      */
@@ -223,6 +244,11 @@ protected void serializeInternal(JsonGenerator generator, JsonpMapper mapper) {
             generator.write(this.relocatingNode);
         }
 
+        if (this.searchOnly != null) {
+            generator.writeKey("searchOnly");
+            generator.write(this.searchOnly);
+        }
+
         generator.writeKey("shard");
         generator.write(this.shard);
 
@@ -262,6 +288,8 @@ public static class Builder extends ObjectBuilderBase implements CopyableBuilder
         private Map<String, String> recoverySource;
         @Nullable
         private String relocatingNode;
+        @Nullable
+        private Boolean searchOnly;
         private Integer shard;
         private ShardRoutingState state;
         @Nullable
@@ -276,6 +304,7 @@ private Builder(NodeShard o) {
             this.primary = o.primary;
             this.recoverySource = _mapCopy(o.recoverySource);
             this.relocatingNode = o.relocatingNode;
+            this.searchOnly = o.searchOnly;
             this.shard = o.shard;
             this.state = o.state;
             this.unassignedInfo = o.unassignedInfo;
@@ -288,6 +317,7 @@ private Builder(Builder o) {
             this.primary = o.primary;
             this.recoverySource = _mapCopy(o.recoverySource);
             this.relocatingNode = o.relocatingNode;
+            this.searchOnly = o.searchOnly;
             this.shard = o.shard;
             this.state = o.state;
             this.unassignedInfo = o.unassignedInfo;
@@ -353,7 +383,10 @@ public final Builder primary(boolean value) {
         }
 
         /**
+         * The recovery source information for this shard.
+         * <p>
          * API name: {@code recovery_source}
+         * </p>
          *
          * <p>
          * Adds all elements of <code>map</code> to <code>recoverySource</code>.
@@ -366,7 +399,10 @@ public final Builder recoverySource(Map<String, String> map) {
         }
 
         /**
+         * The recovery source information for this shard.
+         * <p>
          * API name: {@code recovery_source}
+         * </p>
          *
          * <p>
          * Adds an entry to <code>recoverySource</code>.
@@ -387,6 +423,18 @@ public final Builder relocatingNode(@Nullable String value) {
             return this;
         }
 
+        /**
+         * Indicates if this shard is configured for search operations only
+         * <p>
+         * API name: {@code searchOnly}
+         * </p>
+         */
+        @Nonnull
+        public final Builder searchOnly(@Nullable Boolean value) {
+            this.searchOnly = value;
+            return this;
+        }
+
         /**
          * Required - API name: {@code shard}
          */
@@ -453,6 +501,7 @@ protected static void setupNodeShardDeserializer(ObjectDeserializer<NodeShard.Bu
         op.add(Builder::primary, JsonpDeserializer.booleanDeserializer(), "primary");
         op.add(Builder::recoverySource, JsonpDeserializer.stringMapDeserializer(JsonpDeserializer.stringDeserializer()), "recovery_source");
         op.add(Builder::relocatingNode, JsonpDeserializer.stringDeserializer(), "relocating_node");
+        op.add(Builder::searchOnly, JsonpDeserializer.booleanDeserializer(), "searchOnly");
         op.add(Builder::shard, JsonpDeserializer.integerDeserializer(), "shard");
         op.add(Builder::state, ShardRoutingState._DESERIALIZER, "state");
         op.add(Builder::unassignedInfo, UnassignedInformation._DESERIALIZER, "unassigned_info");
@@ -467,6 +516,7 @@ public int hashCode() {
         result = 31 * result + Boolean.hashCode(this.primary);
         result = 31 * result + Objects.hashCode(this.recoverySource);
         result = 31 * result + Objects.hashCode(this.relocatingNode);
+        result = 31 * result + Objects.hashCode(this.searchOnly);
         result = 31 * result + Integer.hashCode(this.shard);
         result = 31 * result + this.state.hashCode();
         result = 31 * result + Objects.hashCode(this.unassignedInfo);
@@ -484,6 +534,7 @@ public boolean equals(Object o) {
             && this.primary == other.primary
             && Objects.equals(this.recoverySource, other.recoverySource)
             && Objects.equals(this.relocatingNode, other.relocatingNode)
+            && Objects.equals(this.searchOnly, other.searchOnly)
             && this.shard == other.shard
             && this.state.equals(other.state)
             && Objects.equals(this.unassignedInfo, other.unassignedInfo);