Re-generate client code using latest OpenSearch API specification (2025-03-17)

Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

Author: github-actions[bot]

java-client/src/generated/java/org/opensearch/client/opensearch/tasks/CancelRequest.java

@@ -92,7 +92,7 @@ public static CancelRequest of(Function<CancelRequest.Builder, ObjectBuilder<Can
     }
 
     /**
-     * Comma-separated list or wildcard expression of actions used to limit the request.
+     * A comma-separated list of actions that should be returned. Keep empty to return all.
      * <p>
      * API name: {@code actions}
      * </p>
@@ -103,7 +103,9 @@ public final List<String> actions() {
     }
 
     /**
-     * Comma-separated list of node IDs or names used to limit the request.
+     * A comma-separated list of node IDs or names to limit the returned information. Use <code>_local</code> to return information from the
+     * node you're connecting to, specify the node name to get information from specific nodes, or keep the parameter empty to get
+     * information from all nodes.
      * <p>
      * API name: {@code nodes}
      * </p>
@@ -114,7 +116,7 @@ public final List<String> nodes() {
     }
 
     /**
-     * Parent task ID used to limit the tasks.
+     * Returns tasks with a specified parent task ID (node_id:task_number). Keep empty or set to -1 to return all.
      * <p>
      * API name: {@code parent_task_id}
      * </p>
@@ -125,7 +127,7 @@ public final String parentTaskId() {
     }
 
     /**
-     * ID of the task.
+     * The ID of the task.
      * <p>
      * API name: {@code task_id}
      * </p>
@@ -136,7 +138,7 @@ public final String taskId() {
     }
 
     /**
-     * Should the request block until the cancellation of the task and its descendant tasks is completed. Defaults to false
+     * Waits for the matching task to complete. When <code>true</code>, the request is blocked until the task has completed.
      * <p>
      * API name: {@code wait_for_completion}
      * </p>
@@ -207,7 +209,7 @@ protected Builder self() {
         }
 
         /**
-         * Comma-separated list or wildcard expression of actions used to limit the request.
+         * A comma-separated list of actions that should be returned. Keep empty to return all.
          * <p>
          * API name: {@code actions}
          * </p>
@@ -223,7 +225,7 @@ public final Builder actions(List<String> list) {
         }
 
         /**
-         * Comma-separated list or wildcard expression of actions used to limit the request.
+         * A comma-separated list of actions that should be returned. Keep empty to return all.
          * <p>
          * API name: {@code actions}
          * </p>
@@ -239,7 +241,9 @@ public final Builder actions(String value, String... values) {
         }
 
         /**
-         * Comma-separated list of node IDs or names used to limit the request.
+         * A comma-separated list of node IDs or names to limit the returned information. Use <code>_local</code> to return information from
+         * the node you're connecting to, specify the node name to get information from specific nodes, or keep the parameter empty to get
+         * information from all nodes.
          * <p>
          * API name: {@code nodes}
          * </p>
@@ -255,7 +259,9 @@ public final Builder nodes(List<String> list) {
         }
 
         /**
-         * Comma-separated list of node IDs or names used to limit the request.
+         * A comma-separated list of node IDs or names to limit the returned information. Use <code>_local</code> to return information from
+         * the node you're connecting to, specify the node name to get information from specific nodes, or keep the parameter empty to get
+         * information from all nodes.
          * <p>
          * API name: {@code nodes}
          * </p>
@@ -271,7 +277,7 @@ public final Builder nodes(String value, String... values) {
         }
 
         /**
-         * Parent task ID used to limit the tasks.
+         * Returns tasks with a specified parent task ID (node_id:task_number). Keep empty or set to -1 to return all.
          * <p>
          * API name: {@code parent_task_id}
          * </p>
@@ -283,7 +289,7 @@ public final Builder parentTaskId(@Nullable String value) {
         }
 
         /**
-         * ID of the task.
+         * The ID of the task.
          * <p>
          * API name: {@code task_id}
          * </p>
@@ -295,7 +301,7 @@ public final Builder taskId(@Nullable String value) {
         }
 
         /**
-         * Should the request block until the cancellation of the task and its descendant tasks is completed. Defaults to false
+         * Waits for the matching task to complete. When <code>true</code>, the request is blocked until the task has completed.
          * <p>
          * API name: {@code wait_for_completion}
          * </p>

java-client/src/generated/java/org/opensearch/client/opensearch/tasks/GetTasksRequest.java

@@ -84,7 +84,7 @@ public static GetTasksRequest of(Function<GetTasksRequest.Builder, ObjectBuilder
     }
 
     /**
-     * Required - ID of the task.
+     * Required - The ID of the task.
      * <p>
      * API name: {@code task_id}
      * </p>
@@ -95,7 +95,7 @@ public final String taskId() {
     }
 
     /**
-     * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
+     * The amount of time to wait for a response.
      * <p>
      * API name: {@code timeout}
      * </p>
@@ -106,7 +106,7 @@ public final Time timeout() {
     }
 
     /**
-     * If <code>true</code>, the request blocks until the task has completed.
+     * Waits for the matching task to complete. When <code>true</code>, the request is blocked until the task has completed.
      * <p>
      * API name: {@code wait_for_completion}
      * </p>
@@ -168,7 +168,7 @@ protected Builder self() {
         }
 
         /**
-         * Required - ID of the task.
+         * Required - The ID of the task.
          * <p>
          * API name: {@code task_id}
          * </p>
@@ -180,7 +180,7 @@ public final Builder taskId(String value) {
         }
 
         /**
-         * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
+         * The amount of time to wait for a response.
          * <p>
          * API name: {@code timeout}
          * </p>
@@ -192,7 +192,7 @@ public final Builder timeout(@Nullable Time value) {
         }
 
         /**
-         * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
+         * The amount of time to wait for a response.
          * <p>
          * API name: {@code timeout}
          * </p>
@@ -203,7 +203,7 @@ public final Builder timeout(Function<Time.Builder, ObjectBuilder<Time>> fn) {
         }
 
         /**
-         * If <code>true</code>, the request blocks until the task has completed.
+         * Waits for the matching task to complete. When <code>true</code>, the request is blocked until the task has completed.
          * <p>
          * API name: {@code wait_for_completion}
          * </p>

java-client/src/generated/java/org/opensearch/client/opensearch/tasks/ListRequest.java

@@ -101,7 +101,7 @@ public static ListRequest of(Function<ListRequest.Builder, ObjectBuilder<ListReq
     }
 
     /**
-     * Comma-separated list or wildcard expression of actions used to limit the request.
+     * A comma-separated list of actions that should be returned. Keep empty to return all.
      * <p>
      * API name: {@code actions}
      * </p>
@@ -112,7 +112,7 @@ public final List<String> actions() {
     }
 
     /**
-     * If <code>true</code>, the response includes detailed information about shard recoveries.
+     * When <code>true</code>, the response includes detailed information about shard recoveries.
      * <p>
      * API name: {@code detailed}
      * </p>
@@ -123,7 +123,7 @@ public final Boolean detailed() {
     }
 
     /**
-     * Key used to group tasks in the response.
+     * Groups tasks by parent/child relationships or nodes.
      * <p>
      * API name: {@code group_by}
      * </p>
@@ -134,8 +134,9 @@ public final GroupBy groupBy() {
     }
 
     /**
-     * Comma-separated list of node IDs or names to limit the returned information; use <code>_local</code> to return information from the
-     * node you're connecting to, leave empty to get information from all nodes.
+     * A comma-separated list of node IDs or names to limit the returned information. Use <code>_local</code> to return information from the
+     * node you're connecting to, specify the node name to get information from specific nodes, or keep the parameter empty to get
+     * information from all nodes.
      * <p>
      * API name: {@code nodes}
      * </p>
@@ -146,7 +147,7 @@ public final List<String> nodes() {
     }
 
     /**
-     * Parent task ID used to limit returned information. To return all tasks, omit this parameter or use a value of <code>-1</code>.
+     * Returns tasks with a specified parent task ID (node_id:task_number). Keep empty or set to -1 to return all.
      * <p>
      * API name: {@code parent_task_id}
      * </p>
@@ -157,7 +158,7 @@ public final String parentTaskId() {
     }
 
     /**
-     * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
+     * The amount of time to wait for a response.
      * <p>
      * API name: {@code timeout}
      * </p>
@@ -168,7 +169,7 @@ public final Time timeout() {
     }
 
     /**
-     * If <code>true</code>, the request blocks until the operation is complete.
+     * Waits for the matching task to complete. When <code>true</code>, the request is blocked until the task has completed.
      * <p>
      * API name: {@code wait_for_completion}
      * </p>
@@ -247,7 +248,7 @@ protected Builder self() {
         }
 
         /**
-         * Comma-separated list or wildcard expression of actions used to limit the request.
+         * A comma-separated list of actions that should be returned. Keep empty to return all.
          * <p>
          * API name: {@code actions}
          * </p>
@@ -263,7 +264,7 @@ public final Builder actions(List<String> list) {
         }
 
         /**
-         * Comma-separated list or wildcard expression of actions used to limit the request.
+         * A comma-separated list of actions that should be returned. Keep empty to return all.
          * <p>
          * API name: {@code actions}
          * </p>
@@ -279,7 +280,7 @@ public final Builder actions(String value, String... values) {
         }
 
         /**
-         * If <code>true</code>, the response includes detailed information about shard recoveries.
+         * When <code>true</code>, the response includes detailed information about shard recoveries.
          * <p>
          * API name: {@code detailed}
          * </p>
@@ -291,7 +292,7 @@ public final Builder detailed(@Nullable Boolean value) {
         }
 
         /**
-         * Key used to group tasks in the response.
+         * Groups tasks by parent/child relationships or nodes.
          * <p>
          * API name: {@code group_by}
          * </p>
@@ -303,8 +304,9 @@ public final Builder groupBy(@Nullable GroupBy value) {
         }
 
         /**
-         * Comma-separated list of node IDs or names to limit the returned information; use <code>_local</code> to return information from
-         * the node you're connecting to, leave empty to get information from all nodes.
+         * A comma-separated list of node IDs or names to limit the returned information. Use <code>_local</code> to return information from
+         * the node you're connecting to, specify the node name to get information from specific nodes, or keep the parameter empty to get
+         * information from all nodes.
          * <p>
          * API name: {@code nodes}
          * </p>
@@ -320,8 +322,9 @@ public final Builder nodes(List<String> list) {
         }
 
         /**
-         * Comma-separated list of node IDs or names to limit the returned information; use <code>_local</code> to return information from
-         * the node you're connecting to, leave empty to get information from all nodes.
+         * A comma-separated list of node IDs or names to limit the returned information. Use <code>_local</code> to return information from
+         * the node you're connecting to, specify the node name to get information from specific nodes, or keep the parameter empty to get
+         * information from all nodes.
          * <p>
          * API name: {@code nodes}
          * </p>
@@ -337,7 +340,7 @@ public final Builder nodes(String value, String... values) {
         }
 
         /**
-         * Parent task ID used to limit returned information. To return all tasks, omit this parameter or use a value of <code>-1</code>.
+         * Returns tasks with a specified parent task ID (node_id:task_number). Keep empty or set to -1 to return all.
          * <p>
          * API name: {@code parent_task_id}
          * </p>
@@ -349,7 +352,7 @@ public final Builder parentTaskId(@Nullable String value) {
         }
 
         /**
-         * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
+         * The amount of time to wait for a response.
          * <p>
          * API name: {@code timeout}
          * </p>
@@ -361,7 +364,7 @@ public final Builder timeout(@Nullable Time value) {
         }
 
         /**
-         * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.
+         * The amount of time to wait for a response.
          * <p>
          * API name: {@code timeout}
          * </p>
@@ -372,7 +375,7 @@ public final Builder timeout(Function<Time.Builder, ObjectBuilder<Time>> fn) {
         }
 
         /**
-         * If <code>true</code>, the request blocks until the operation is complete.
+         * Waits for the matching task to complete. When <code>true</code>, the request is blocked until the task has completed.
          * <p>
          * API name: {@code wait_for_completion}
          * </p>