[codegen] update to latest spec (#1115)

Co-authored-by: Laura Trotta <[email protected]>

Author: elastic-vault-github-plugin-prod[bot]

java-client/src/main/java/co/elastic/clients/elasticsearch/ElasticsearchAsyncClient.java

@@ -3102,15 +3102,21 @@ public CompletableFuture<HealthReportResponse> healthReport() {
 	 *     &quot;id&quot;: &quot;elkbee&quot;
 	 *   }
 	 * }
-	 *
-	 * In this example, the operation will succeed since the supplied version of 2 is higher than the current document version of 1.
-	 * If the document was already updated and its version was set to 2 or higher, the indexing command will fail and result in a conflict (409 HTTP status code).
-	 *
-	 * A nice side effect is that there is no need to maintain strict ordering of async indexing operations run as a result of changes to a source database, as long as version numbers from the source database are used.
-	 * Even the simple case of updating the Elasticsearch index using data from a database is simplified if external versioning is used, as only the latest version will be used if the index operations arrive out of order.
 	 * </code>
 	 * </pre>
-	 *
+	 * <p>
+	 * In this example, the operation will succeed since the supplied version of 2
+	 * is higher than the current document version of 1. If the document was already
+	 * updated and its version was set to 2 or higher, the indexing command will
+	 * fail and result in a conflict (409 HTTP status code).
+	 * <p>
+	 * A nice side effect is that there is no need to maintain strict ordering of
+	 * async indexing operations run as a result of changes to a source database, as
+	 * long as version numbers from the source database are used. Even the simple
+	 * case of updating the Elasticsearch index using data from a database is
+	 * simplified if external versioning is used, as only the latest version will be
+	 * used if the index operations arrive out of order.
+	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-create">Documentation
 	 *      on elastic.co</a>
@@ -3305,15 +3311,21 @@ public <TDocument> CompletableFuture<IndexResponse> index(IndexRequest<TDocument
 	 *     &quot;id&quot;: &quot;elkbee&quot;
 	 *   }
 	 * }
-	 *
-	 * In this example, the operation will succeed since the supplied version of 2 is higher than the current document version of 1.
-	 * If the document was already updated and its version was set to 2 or higher, the indexing command will fail and result in a conflict (409 HTTP status code).
-	 *
-	 * A nice side effect is that there is no need to maintain strict ordering of async indexing operations run as a result of changes to a source database, as long as version numbers from the source database are used.
-	 * Even the simple case of updating the Elasticsearch index using data from a database is simplified if external versioning is used, as only the latest version will be used if the index operations arrive out of order.
 	 * </code>
 	 * </pre>
-	 *
+	 * <p>
+	 * In this example, the operation will succeed since the supplied version of 2
+	 * is higher than the current document version of 1. If the document was already
+	 * updated and its version was set to 2 or higher, the indexing command will
+	 * fail and result in a conflict (409 HTTP status code).
+	 * <p>
+	 * A nice side effect is that there is no need to maintain strict ordering of
+	 * async indexing operations run as a result of changes to a source database, as
+	 * long as version numbers from the source database are used. Even the simple
+	 * case of updating the Elasticsearch index using data from a database is
+	 * simplified if external versioning is used, as only the latest version will be
+	 * used if the index operations arrive out of order.
+	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
 	 *            {@link IndexRequest}

java-client/src/main/java/co/elastic/clients/elasticsearch/ElasticsearchClient.java

@@ -3121,15 +3121,21 @@ public HealthReportResponse healthReport() throws IOException, ElasticsearchExce
 	 *     "id": "elkbee"
 	 *   }
 	 * }
-	 *
-	 * In this example, the operation will succeed since the supplied version of 2 is higher than the current document version of 1.
-	 * If the document was already updated and its version was set to 2 or higher, the indexing command will fail and result in a conflict (409 HTTP status code).
-	 *
-	 * A nice side effect is that there is no need to maintain strict ordering of async indexing operations run as a result of changes to a source database, as long as version numbers from the source database are used.
-	 * Even the simple case of updating the Elasticsearch index using data from a database is simplified if external versioning is used, as only the latest version will be used if the index operations arrive out of order.
 	 * </code>
 	 * </pre>
-	 *
+	 * <p>
+	 * In this example, the operation will succeed since the supplied version of 2
+	 * is higher than the current document version of 1. If the document was already
+	 * updated and its version was set to 2 or higher, the indexing command will
+	 * fail and result in a conflict (409 HTTP status code).
+	 * <p>
+	 * A nice side effect is that there is no need to maintain strict ordering of
+	 * async indexing operations run as a result of changes to a source database, as
+	 * long as version numbers from the source database are used. Even the simple
+	 * case of updating the Elasticsearch index using data from a database is
+	 * simplified if external versioning is used, as only the latest version will be
+	 * used if the index operations arrive out of order.
+	 * 
 	 * @see <a href=
 	 *      "https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-create">Documentation
 	 *      on elastic.co</a>
@@ -3324,15 +3330,21 @@ public <TDocument> IndexResponse index(IndexRequest<TDocument> request) throws I
 	 *     &quot;id&quot;: &quot;elkbee&quot;
 	 *   }
 	 * }
-	 *
-	 * In this example, the operation will succeed since the supplied version of 2 is higher than the current document version of 1.
-	 * If the document was already updated and its version was set to 2 or higher, the indexing command will fail and result in a conflict (409 HTTP status code).
-	 *
-	 * A nice side effect is that there is no need to maintain strict ordering of async indexing operations run as a result of changes to a source database, as long as version numbers from the source database are used.
-	 * Even the simple case of updating the Elasticsearch index using data from a database is simplified if external versioning is used, as only the latest version will be used if the index operations arrive out of order.
 	 * </code>
 	 * </pre>
-	 *
+	 * <p>
+	 * In this example, the operation will succeed since the supplied version of 2
+	 * is higher than the current document version of 1. If the document was already
+	 * updated and its version was set to 2 or higher, the indexing command will
+	 * fail and result in a conflict (409 HTTP status code).
+	 * <p>
+	 * A nice side effect is that there is no need to maintain strict ordering of
+	 * async indexing operations run as a result of changes to a source database, as
+	 * long as version numbers from the source database are used. Even the simple
+	 * case of updating the Elasticsearch index using data from a database is
+	 * simplified if external versioning is used, as only the latest version will be
+	 * used if the index operations arrive out of order.
+	 * 
 	 * @param fn
 	 *            a function that initializes a builder to create the
 	 *            {@link IndexRequest}

java-client/src/main/java/co/elastic/clients/elasticsearch/async_search/SubmitRequest.java

@@ -366,8 +366,7 @@ public final Boolean allowPartialSearchResults() {
 	}
 
 	/**
-	 * Specify whether wildcard and prefix queries should be analyzed (default:
-	 * false)
+	 * Specify whether wildcard and prefix queries should be analyzed
 	 * <p>
 	 * API name: {@code analyze_wildcard}
 	 */
@@ -450,7 +449,7 @@ public final List<FieldAndFormat> docvalueFields() {
 
 	/**
 	 * Whether to expand wildcard expression to concrete indices that are open,
-	 * closed or both.
+	 * closed or both
 	 * <p>
 	 * API name: {@code expand_wildcards}
 	 */
@@ -634,8 +633,7 @@ public final Query postFilter() {
 	}
 
 	/**
-	 * Specify the node or shard the operation should be performed on (default:
-	 * random)
+	 * Specify the node or shard the operation should be performed on
 	 * <p>
 	 * API name: {@code preference}
 	 */
@@ -1399,8 +1397,7 @@ public final Builder allowPartialSearchResults(@Nullable Boolean value) {
 		}
 
 		/**
-		 * Specify whether wildcard and prefix queries should be analyzed (default:
-		 * false)
+		 * Specify whether wildcard and prefix queries should be analyzed
 		 * <p>
 		 * API name: {@code analyze_wildcard}
 		 */
@@ -1518,7 +1515,7 @@ public final Builder docvalueFields(Function<FieldAndFormat.Builder, ObjectBuild
 
 		/**
 		 * Whether to expand wildcard expression to concrete indices that are open,
-		 * closed or both.
+		 * closed or both
 		 * <p>
 		 * API name: {@code expand_wildcards}
 		 * <p>
@@ -1531,7 +1528,7 @@ public final Builder expandWildcards(List<ExpandWildcard> list) {
 
 		/**
 		 * Whether to expand wildcard expression to concrete indices that are open,
-		 * closed or both.
+		 * closed or both
 		 * <p>
 		 * API name: {@code expand_wildcards}
 		 * <p>
@@ -1861,8 +1858,7 @@ public final Builder postFilter(QueryVariant value) {
 		}
 
 		/**
-		 * Specify the node or shard the operation should be performed on (default:
-		 * random)
+		 * Specify the node or shard the operation should be performed on
 		 * <p>
 		 * API name: {@code preference}
 		 */

java-client/src/main/java/co/elastic/clients/elasticsearch/autoscaling/DeleteAutoscalingPolicyRequest.java

@@ -103,7 +103,7 @@ public final Time masterTimeout() {
 	}
 
 	/**
-	 * Required - the name of the autoscaling policy
+	 * Required - Name of the autoscaling policy
 	 * <p>
 	 * API name: {@code name}
 	 */
@@ -161,7 +161,7 @@ public final Builder masterTimeout(Function<Time.Builder, ObjectBuilder<Time>> f
 		}
 
 		/**
-		 * Required - the name of the autoscaling policy
+		 * Required - Name of the autoscaling policy
 		 * <p>
 		 * API name: {@code name}
 		 */

java-client/src/main/java/co/elastic/clients/elasticsearch/autoscaling/GetAutoscalingPolicyRequest.java

@@ -98,7 +98,7 @@ public final Time masterTimeout() {
 	}
 
 	/**
-	 * Required - the name of the autoscaling policy
+	 * Required - Name of the autoscaling policy
 	 * <p>
 	 * API name: {@code name}
 	 */
@@ -142,7 +142,7 @@ public final Builder masterTimeout(Function<Time.Builder, ObjectBuilder<Time>> f
 		}
 
 		/**
-		 * Required - the name of the autoscaling policy
+		 * Required - Name of the autoscaling policy
 		 * <p>
 		 * API name: {@code name}
 		 */

java-client/src/main/java/co/elastic/clients/elasticsearch/autoscaling/PutAutoscalingPolicyRequest.java

@@ -108,7 +108,7 @@ public final Time masterTimeout() {
 	}
 
 	/**
-	 * Required - the name of the autoscaling policy
+	 * Required - Name of the autoscaling policy
 	 * <p>
 	 * API name: {@code name}
 	 */
@@ -183,7 +183,7 @@ public final Builder masterTimeout(Function<Time.Builder, ObjectBuilder<Time>> f
 		}
 
 		/**
-		 * Required - the name of the autoscaling policy
+		 * Required - Name of the autoscaling policy
 		 * <p>
 		 * API name: {@code name}
 		 */

java-client/src/main/java/co/elastic/clients/elasticsearch/ccr/ForgetFollowerRequest.java

@@ -146,8 +146,8 @@ public final String followerIndexUuid() {
 	}
 
 	/**
-	 * Required - the name of the leader index for which specified follower
-	 * retention leases should be removed
+	 * Required - Name of the leader index for which specified follower retention
+	 * leases should be removed
 	 * <p>
 	 * API name: {@code index}
 	 */
@@ -259,8 +259,8 @@ public final Builder followerIndexUuid(@Nullable String value) {
 		}
 
 		/**
-		 * Required - the name of the leader index for which specified follower
-		 * retention leases should be removed
+		 * Required - Name of the leader index for which specified follower retention
+		 * leases should be removed
 		 * <p>
 		 * API name: {@code index}
 		 */

java-client/src/main/java/co/elastic/clients/elasticsearch/ccr/ResumeFollowRequest.java

@@ -131,7 +131,7 @@ public static ResumeFollowRequest of(Function<Builder, ObjectBuilder<ResumeFollo
 	}
 
 	/**
-	 * Required - The name of the follow index to resume following.
+	 * Required - Name of the follow index to resume following
 	 * <p>
 	 * API name: {@code index}
 	 */
@@ -338,7 +338,7 @@ public static class Builder extends RequestBase.AbstractBuilder<Builder>
 		private Time readPollTimeout;
 
 		/**
-		 * Required - The name of the follow index to resume following.
+		 * Required - Name of the follow index to resume following
 		 * <p>
 		 * API name: {@code index}
 		 */

java-client/src/main/java/co/elastic/clients/elasticsearch/cluster/GetComponentTemplateRequest.java

@@ -114,7 +114,7 @@ public final Boolean flatSettings() {
 	}
 
 	/**
-	 * Return all default configurations for the component template (default: false)
+	 * Return all default configurations for the component template
 	 * <p>
 	 * API name: {@code include_defaults}
 	 */
@@ -208,7 +208,7 @@ public final Builder flatSettings(@Nullable Boolean value) {
 		}
 
 		/**
-		 * Return all default configurations for the component template (default: false)
+		 * Return all default configurations for the component template
 		 * <p>
 		 * API name: {@code include_defaults}
 		 */

java-client/src/main/java/co/elastic/clients/elasticsearch/cluster/PutClusterSettingsRequest.java

@@ -126,7 +126,7 @@ public static PutClusterSettingsRequest of(Function<Builder, ObjectBuilder<PutCl
 	}
 
 	/**
-	 * Return settings in flat format (default: false)
+	 * Return settings in flat format
 	 * <p>
 	 * API name: {@code flat_settings}
 	 */
@@ -136,7 +136,7 @@ public final Boolean flatSettings() {
 	}
 
 	/**
-	 * Explicit operation timeout for connection to master node
+	 * The period to wait for a connection to the master node.
 	 * <p>
 	 * API name: {@code master_timeout}
 	 */
@@ -155,7 +155,7 @@ public final Map<String, JsonData> persistent() {
 	}
 
 	/**
-	 * Explicit operation timeout
+	 * The period to wait for a response.
 	 * <p>
 	 * API name: {@code timeout}
 	 */
@@ -234,7 +234,7 @@ public static class Builder extends RequestBase.AbstractBuilder<Builder>
 		private Map<String, JsonData> transient_;
 
 		/**
-		 * Return settings in flat format (default: false)
+		 * Return settings in flat format
 		 * <p>
 		 * API name: {@code flat_settings}
 		 */
@@ -244,7 +244,7 @@ public final Builder flatSettings(@Nullable Boolean value) {
 		}
 
 		/**
-		 * Explicit operation timeout for connection to master node
+		 * The period to wait for a connection to the master node.
 		 * <p>
 		 * API name: {@code master_timeout}
 		 */
@@ -254,7 +254,7 @@ public final Builder masterTimeout(@Nullable Time value) {
 		}
 
 		/**
-		 * Explicit operation timeout for connection to master node
+		 * The period to wait for a connection to the master node.
 		 * <p>
 		 * API name: {@code master_timeout}
 		 */
@@ -287,7 +287,7 @@ public final Builder persistent(String key, JsonData value) {
 		}
 
 		/**
-		 * Explicit operation timeout
+		 * The period to wait for a response.
 		 * <p>
 		 * API name: {@code timeout}
 		 */
@@ -297,7 +297,7 @@ public final Builder timeout(@Nullable Time value) {
 		}
 
 		/**
-		 * Explicit operation timeout
+		 * The period to wait for a response.
 		 * <p>
 		 * API name: {@code timeout}
 		 */