Update to latest spec

Author: swallez

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

@@ -85,6 +85,8 @@
 import co.elastic.clients.elasticsearch._global.ReindexRethrottleResponse;
 import co.elastic.clients.elasticsearch._global.ScriptsPainlessExecuteRequest;
 import co.elastic.clients.elasticsearch._global.ScriptsPainlessExecuteResponse;
+import co.elastic.clients.elasticsearch._global.SearchMvtRequest;
+import co.elastic.clients.elasticsearch._global.SearchMvtResponse;
 import co.elastic.clients.elasticsearch._global.SearchRequest;
 import co.elastic.clients.elasticsearch._global.SearchResponse;
 import co.elastic.clients.elasticsearch._global.SearchShardsRequest;
@@ -1255,6 +1257,39 @@ public final <TDocument> CompletableFuture<SearchResponse<TDocument>> search(
 		return search(fn.apply(new SearchRequest.Builder()).build(), tDocumentClass);
 	}
 
+	// ----- Endpoint: search_mvt
+
+	/**
+	 * Searches a vector tile for geospatial values. Returns results as a binary
+	 * Mapbox vector tile.
+	 * 
+	 * @see <a href=
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/master/search-vector-tile-api.html">Documentation
+	 *      on elastic.co</a>
+	 */
+
+	public CompletableFuture<SearchMvtResponse> searchMvt(SearchMvtRequest request) throws IOException {
+		return this.transport.performRequestAsync(request, SearchMvtRequest.ENDPOINT, this.requestOptions);
+	}
+
+	/**
+	 * Searches a vector tile for geospatial values. Returns results as a binary
+	 * Mapbox vector tile.
+	 * 
+	 * @param fn
+	 *            a function that initializes a freshly created builder. This
+	 *            function can either return its builder argument after having set
+	 *            its properties or return another builder.
+	 * @see <a href=
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/master/search-vector-tile-api.html">Documentation
+	 *      on elastic.co</a>
+	 */
+
+	public final CompletableFuture<SearchMvtResponse> searchMvt(
+			Function<SearchMvtRequest.Builder, ObjectBuilder<SearchMvtRequest>> fn) throws IOException {
+		return searchMvt(fn.apply(new SearchMvtRequest.Builder()).build());
+	}
+
 	// ----- Endpoint: search_shards
 
 	/**

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

@@ -85,6 +85,8 @@
 import co.elastic.clients.elasticsearch._global.ReindexRethrottleResponse;
 import co.elastic.clients.elasticsearch._global.ScriptsPainlessExecuteRequest;
 import co.elastic.clients.elasticsearch._global.ScriptsPainlessExecuteResponse;
+import co.elastic.clients.elasticsearch._global.SearchMvtRequest;
+import co.elastic.clients.elasticsearch._global.SearchMvtResponse;
 import co.elastic.clients.elasticsearch._global.SearchRequest;
 import co.elastic.clients.elasticsearch._global.SearchResponse;
 import co.elastic.clients.elasticsearch._global.SearchShardsRequest;
@@ -1248,6 +1250,39 @@ public final <TDocument> SearchResponse<TDocument> search(
 		return search(fn.apply(new SearchRequest.Builder()).build(), tDocumentClass);
 	}
 
+	// ----- Endpoint: search_mvt
+
+	/**
+	 * Searches a vector tile for geospatial values. Returns results as a binary
+	 * Mapbox vector tile.
+	 * 
+	 * @see <a href=
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/master/search-vector-tile-api.html">Documentation
+	 *      on elastic.co</a>
+	 */
+
+	public SearchMvtResponse searchMvt(SearchMvtRequest request) throws IOException {
+		return this.transport.performRequest(request, SearchMvtRequest.ENDPOINT, this.requestOptions);
+	}
+
+	/**
+	 * Searches a vector tile for geospatial values. Returns results as a binary
+	 * Mapbox vector tile.
+	 * 
+	 * @param fn
+	 *            a function that initializes a freshly created builder. This
+	 *            function can either return its builder argument after having set
+	 *            its properties or return another builder.
+	 * @see <a href=
+	 *      "https://www.elastic.co/guide/en/elasticsearch/reference/master/search-vector-tile-api.html">Documentation
+	 *      on elastic.co</a>
+	 */
+
+	public final SearchMvtResponse searchMvt(Function<SearchMvtRequest.Builder, ObjectBuilder<SearchMvtRequest>> fn)
+			throws IOException {
+		return searchMvt(fn.apply(new SearchMvtRequest.Builder()).build());
+	}
+
 	// ----- Endpoint: search_shards
 
 	/**

java-client/src/main/java/co/elastic/clients/elasticsearch/_global/BulkRequest.java

@@ -63,7 +63,7 @@ public final class BulkRequest<TSource> extends RequestBase implements ToJsonp {
 	private final JsonValue refresh;
 
 	@Nullable
-	private final JsonValue routing;
+	private final String routing;
 
 	@Nullable
 	private final JsonValue source;
@@ -109,8 +109,7 @@ protected BulkRequest(Builder<TSource> builder) {
 	}
 
 	/**
-	 * A comma-separated list of index names to search; use <code>_all</code> or
-	 * empty string to perform the operation on all indices
+	 * Default index for items which don't provide one
 	 * <p>
 	 * API name: {@code index}
 	 */
@@ -120,8 +119,7 @@ public String index() {
 	}
 
 	/**
-	 * A comma-separated list of document types to search; leave empty to perform
-	 * the operation on all types
+	 * Default document type for items which don't provide one
 	 * <p>
 	 * API name: {@code type}
 	 */
@@ -131,6 +129,8 @@ public String type() {
 	}
 
 	/**
+	 * The pipeline id to preprocess incoming documents with
+	 * <p>
 	 * API name: {@code pipeline}
 	 */
 	@Nullable
@@ -139,6 +139,11 @@ public String pipeline() {
 	}
 
 	/**
+	 * If <code>true</code> then refresh the affected shards to make this operation
+	 * visible to search, if <code>wait_for</code> then wait for a refresh to make
+	 * this operation visible to search, if <code>false</code> (the default) then do
+	 * nothing with refreshes.
+	 * <p>
 	 * API name: {@code refresh}
 	 */
 	@Nullable
@@ -147,14 +152,19 @@ public JsonValue refresh() {
 	}
 
 	/**
+	 * Specific routing value
+	 * <p>
 	 * API name: {@code routing}
 	 */
 	@Nullable
-	public JsonValue routing() {
+	public String routing() {
 		return this.routing;
 	}
 
 	/**
+	 * True or false to return the _source field or not, or default list of fields
+	 * to return, can be overridden on each sub-request
+	 * <p>
 	 * API name: {@code _source}
 	 */
 	@Nullable
@@ -163,6 +173,9 @@ public JsonValue source() {
 	}
 
 	/**
+	 * Default list of fields to exclude from the returned _source field, can be
+	 * overridden on each sub-request
+	 * <p>
 	 * API name: {@code _source_excludes}
 	 */
 	@Nullable
@@ -171,6 +184,9 @@ public List<String> sourceExcludes() {
 	}
 
 	/**
+	 * Default list of fields to extract and return from the _source field, can be
+	 * overridden on each sub-request
+	 * <p>
 	 * API name: {@code _source_includes}
 	 */
 	@Nullable
@@ -179,6 +195,8 @@ public List<String> sourceIncludes() {
 	}
 
 	/**
+	 * Explicit operation timeout
+	 * <p>
 	 * API name: {@code timeout}
 	 */
 	@Nullable
@@ -187,6 +205,12 @@ public JsonValue timeout() {
 	}
 
 	/**
+	 * Sets the number of shard copies that must be active before proceeding with
+	 * the bulk operation. Defaults to 1, meaning the primary shard only. Set to
+	 * <code>all</code> for all shard copies, otherwise set to any non-negative
+	 * value less than or equal to the total number of copies for the shard (number
+	 * of replicas + 1)
+	 * <p>
 	 * API name: {@code wait_for_active_shards}
 	 */
 	@Nullable
@@ -195,6 +219,8 @@ public JsonValue waitForActiveShards() {
 	}
 
 	/**
+	 * Sets require_alias for all incoming documents. Defaults to unset (false)
+	 * <p>
 	 * API name: {@code require_alias}
 	 */
 	@Nullable
@@ -243,7 +269,7 @@ public static class Builder<TSource> implements ObjectBuilder<BulkRequest<TSourc
 		private JsonValue refresh;
 
 		@Nullable
-		private JsonValue routing;
+		private String routing;
 
 		@Nullable
 		private JsonValue source;
@@ -269,8 +295,7 @@ public static class Builder<TSource> implements ObjectBuilder<BulkRequest<TSourc
 		private JsonpSerializer<TSource> tSourceSerializer;
 
 		/**
-		 * A comma-separated list of index names to search; use <code>_all</code> or
-		 * empty string to perform the operation on all indices
+		 * Default index for items which don't provide one
 		 * <p>
 		 * API name: {@code index}
 		 */
@@ -280,8 +305,7 @@ public Builder<TSource> index(@Nullable String value) {
 		}
 
 		/**
-		 * A comma-separated list of document types to search; leave empty to perform
-		 * the operation on all types
+		 * Default document type for items which don't provide one
 		 * <p>
 		 * API name: {@code type}
 		 */
@@ -291,6 +315,8 @@ public Builder<TSource> type(@Nullable String value) {
 		}
 
 		/**
+		 * The pipeline id to preprocess incoming documents with
+		 * <p>
 		 * API name: {@code pipeline}
 		 */
 		public Builder<TSource> pipeline(@Nullable String value) {
@@ -299,6 +325,11 @@ public Builder<TSource> pipeline(@Nullable String value) {
 		}
 
 		/**
+		 * If <code>true</code> then refresh the affected shards to make this operation
+		 * visible to search, if <code>wait_for</code> then wait for a refresh to make
+		 * this operation visible to search, if <code>false</code> (the default) then do
+		 * nothing with refreshes.
+		 * <p>
 		 * API name: {@code refresh}
 		 */
 		public Builder<TSource> refresh(@Nullable JsonValue value) {
@@ -307,14 +338,19 @@ public Builder<TSource> refresh(@Nullable JsonValue value) {
 		}
 
 		/**
+		 * Specific routing value
+		 * <p>
 		 * API name: {@code routing}
 		 */
-		public Builder<TSource> routing(@Nullable JsonValue value) {
+		public Builder<TSource> routing(@Nullable String value) {
 			this.routing = value;
 			return this;
 		}
 
 		/**
+		 * True or false to return the _source field or not, or default list of fields
+		 * to return, can be overridden on each sub-request
+		 * <p>
 		 * API name: {@code _source}
 		 */
 		public Builder<TSource> source(@Nullable JsonValue value) {
@@ -323,6 +359,9 @@ public Builder<TSource> source(@Nullable JsonValue value) {
 		}
 
 		/**
+		 * Default list of fields to exclude from the returned _source field, can be
+		 * overridden on each sub-request
+		 * <p>
 		 * API name: {@code _source_excludes}
 		 */
 		public Builder<TSource> sourceExcludes(@Nullable List<String> value) {
@@ -331,6 +370,9 @@ public Builder<TSource> sourceExcludes(@Nullable List<String> value) {
 		}
 
 		/**
+		 * Default list of fields to exclude from the returned _source field, can be
+		 * overridden on each sub-request
+		 * <p>
 		 * API name: {@code _source_excludes}
 		 */
 		public Builder<TSource> sourceExcludes(String... value) {
@@ -350,6 +392,9 @@ public Builder<TSource> addSourceExcludes(String value) {
 		}
 
 		/**
+		 * Default list of fields to extract and return from the _source field, can be
+		 * overridden on each sub-request
+		 * <p>
 		 * API name: {@code _source_includes}
 		 */
 		public Builder<TSource> sourceIncludes(@Nullable List<String> value) {
@@ -358,6 +403,9 @@ public Builder<TSource> sourceIncludes(@Nullable List<String> value) {
 		}
 
 		/**
+		 * Default list of fields to extract and return from the _source field, can be
+		 * overridden on each sub-request
+		 * <p>
 		 * API name: {@code _source_includes}
 		 */
 		public Builder<TSource> sourceIncludes(String... value) {
@@ -377,6 +425,8 @@ public Builder<TSource> addSourceIncludes(String value) {
 		}
 
 		/**
+		 * Explicit operation timeout
+		 * <p>
 		 * API name: {@code timeout}
 		 */
 		public Builder<TSource> timeout(@Nullable JsonValue value) {
@@ -385,6 +435,12 @@ public Builder<TSource> timeout(@Nullable JsonValue value) {
 		}
 
 		/**
+		 * Sets the number of shard copies that must be active before proceeding with
+		 * the bulk operation. Defaults to 1, meaning the primary shard only. Set to
+		 * <code>all</code> for all shard copies, otherwise set to any non-negative
+		 * value less than or equal to the total number of copies for the shard (number
+		 * of replicas + 1)
+		 * <p>
 		 * API name: {@code wait_for_active_shards}
 		 */
 		public Builder<TSource> waitForActiveShards(@Nullable JsonValue value) {
@@ -393,6 +449,8 @@ public Builder<TSource> waitForActiveShards(@Nullable JsonValue value) {
 		}
 
 		/**
+		 * Sets require_alias for all incoming documents. Defaults to unset (false)
+		 * <p>
 		 * API name: {@code require_alias}
 		 */
 		public Builder<TSource> requireAlias(@Nullable Boolean value) {
@@ -529,7 +587,7 @@ protected static <TSource> void setupBulkRequestDeserializer(
 					params.put("refresh", request.refresh.toString());
 				}
 				if (request.routing != null) {
-					params.put("routing", request.routing.toString());
+					params.put("routing", request.routing);
 				}
 				if (request.source != null) {
 					params.put("_source", request.source.toString());

java-client/src/main/java/co/elastic/clients/elasticsearch/_global/ClearScrollRequest.java

@@ -56,6 +56,8 @@ protected ClearScrollRequest(Builder builder) {
 	}
 
 	/**
+	 * A comma-separated list of scroll IDs to clear
+	 * <p>
 	 * API name: {@code scroll_id}
 	 */
 	@Nullable
@@ -86,6 +88,8 @@ public static class Builder implements ObjectBuilder<ClearScrollRequest> {
 		private List<String> scrollId;
 
 		/**
+		 * A comma-separated list of scroll IDs to clear
+		 * <p>
 		 * API name: {@code scroll_id}
 		 */
 		public Builder scrollId(@Nullable List<String> value) {
@@ -94,6 +98,8 @@ public Builder scrollId(@Nullable List<String> value) {
 		}
 
 		/**
+		 * A comma-separated list of scroll IDs to clear
+		 * <p>
 		 * API name: {@code scroll_id}
 		 */
 		public Builder scrollId(String... value) {