Skip to content

Commit 1e352d7

Browse files
committed
[codegen] update to latest spec
1 parent 485d324 commit 1e352d7

13 files changed

+130
-42
lines changed

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

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -98,7 +98,11 @@ public static ExistsComponentTemplateRequest of(
9898
* to false, which means information is retrieved from the master node.
9999
* <p>
100100
* API name: {@code local}
101+
*
102+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
103+
* be removed in a future version.
101104
*/
105+
@Deprecated
102106
@Nullable
103107
public final Boolean local() {
104108
return this.local;
@@ -147,7 +151,11 @@ public static class Builder extends RequestBase.AbstractBuilder<Builder>
147151
* to false, which means information is retrieved from the master node.
148152
* <p>
149153
* API name: {@code local}
154+
*
155+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
156+
* be removed in a future version.
150157
*/
158+
@Deprecated
151159
public final Builder local(@Nullable Boolean value) {
152160
this.local = value;
153161
return this;

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

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,7 +126,11 @@ public final Boolean includeDefaults() {
126126
* only. If <code>false</code>, information is retrieved from the master node.
127127
* <p>
128128
* API name: {@code local}
129+
*
130+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
131+
* be removed in a future version.
129132
*/
133+
@Deprecated
130134
@Nullable
131135
public final Boolean local() {
132136
return this.local;
@@ -216,7 +220,11 @@ public final Builder includeDefaults(@Nullable Boolean value) {
216220
* only. If <code>false</code>, information is retrieved from the master node.
217221
* <p>
218222
* API name: {@code local}
223+
*
224+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
225+
* be removed in a future version.
219226
*/
227+
@Deprecated
220228
public final Builder local(@Nullable Boolean value) {
221229
this.local = value;
222230
return this;

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

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -203,14 +203,18 @@ public final List<String> index() {
203203
* (default: false)
204204
* <p>
205205
* API name: {@code local}
206+
*
207+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
208+
* be removed in a future version.
206209
*/
210+
@Deprecated
207211
@Nullable
208212
public final Boolean local() {
209213
return this.local;
210214
}
211215

212216
/**
213-
* Specify timeout for connection to master
217+
* Timeout for waiting for new cluster state in case it is blocked
214218
* <p>
215219
* API name: {@code master_timeout}
216220
*/
@@ -376,14 +380,18 @@ public final Builder index(String value, String... values) {
376380
* (default: false)
377381
* <p>
378382
* API name: {@code local}
383+
*
384+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
385+
* be removed in a future version.
379386
*/
387+
@Deprecated
380388
public final Builder local(@Nullable Boolean value) {
381389
this.local = value;
382390
return this;
383391
}
384392

385393
/**
386-
* Specify timeout for connection to master
394+
* Timeout for waiting for new cluster state in case it is blocked
387395
* <p>
388396
* API name: {@code master_timeout}
389397
*/
@@ -393,7 +401,7 @@ public final Builder masterTimeout(@Nullable Time value) {
393401
}
394402

395403
/**
396-
* Specify timeout for connection to master
404+
* Timeout for waiting for new cluster state in case it is blocked
397405
* <p>
398406
* API name: {@code master_timeout}
399407
*/

java-client/src/main/java/co/elastic/clients/elasticsearch/connector/ElasticsearchConnectorAsyncClient.java

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1021,7 +1021,7 @@ public final CompletableFuture<UpdateFilteringResponse> updateFiltering(
10211021
* Update the draft filtering validation info for a connector.
10221022
*
10231023
* @see <a href=
1024-
* "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/update-connector-filtering-validation-api.html">Documentation
1024+
* "https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-connector-update-filtering-validation">Documentation
10251025
* on elastic.co</a>
10261026
*/
10271027

@@ -1042,7 +1042,7 @@ public CompletableFuture<UpdateFilteringValidationResponse> updateFilteringValid
10421042
* a function that initializes a builder to create the
10431043
* {@link UpdateFilteringValidationRequest}
10441044
* @see <a href=
1045-
* "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/update-connector-filtering-validation-api.html">Documentation
1045+
* "https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-connector-update-filtering-validation">Documentation
10461046
* on elastic.co</a>
10471047
*/
10481048

@@ -1129,7 +1129,7 @@ public final CompletableFuture<UpdateNameResponse> updateName(
11291129
* Update the connector is_native flag.
11301130
*
11311131
* @see <a href=
1132-
* "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/update-connector-native-api.html">Documentation
1132+
* "https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-connector-update-native">Documentation
11331133
* on elastic.co</a>
11341134
*/
11351135

@@ -1147,7 +1147,7 @@ public CompletableFuture<UpdateNativeResponse> updateNative(UpdateNativeRequest
11471147
* a function that initializes a builder to create the
11481148
* {@link UpdateNativeRequest}
11491149
* @see <a href=
1150-
* "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/update-connector-native-api.html">Documentation
1150+
* "https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-connector-update-native">Documentation
11511151
* on elastic.co</a>
11521152
*/
11531153

java-client/src/main/java/co/elastic/clients/elasticsearch/connector/ElasticsearchConnectorClient.java

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1045,7 +1045,7 @@ public final UpdateFilteringResponse updateFiltering(
10451045
* Update the draft filtering validation info for a connector.
10461046
*
10471047
* @see <a href=
1048-
* "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/update-connector-filtering-validation-api.html">Documentation
1048+
* "https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-connector-update-filtering-validation">Documentation
10491049
* on elastic.co</a>
10501050
*/
10511051

@@ -1066,7 +1066,7 @@ public UpdateFilteringValidationResponse updateFilteringValidation(UpdateFilteri
10661066
* a function that initializes a builder to create the
10671067
* {@link UpdateFilteringValidationRequest}
10681068
* @see <a href=
1069-
* "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/update-connector-filtering-validation-api.html">Documentation
1069+
* "https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-connector-update-filtering-validation">Documentation
10701070
* on elastic.co</a>
10711071
*/
10721072

@@ -1156,7 +1156,7 @@ public final UpdateNameResponse updateName(Function<UpdateNameRequest.Builder, O
11561156
* Update the connector is_native flag.
11571157
*
11581158
* @see <a href=
1159-
* "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/update-connector-native-api.html">Documentation
1159+
* "https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-connector-update-native">Documentation
11601160
* on elastic.co</a>
11611161
*/
11621162

@@ -1174,7 +1174,7 @@ public UpdateNativeResponse updateNative(UpdateNativeRequest request) throws IOE
11741174
* a function that initializes a builder to create the
11751175
* {@link UpdateNativeRequest}
11761176
* @see <a href=
1177-
* "https://www.elastic.co/guide/en/elasticsearch/reference/8.19/update-connector-native-api.html">Documentation
1177+
* "https://www.elastic.co/docs/api/doc/elasticsearch/v8/operation/operation-connector-update-native">Documentation
11781178
* on elastic.co</a>
11791179
*/
11801180

java-client/src/main/java/co/elastic/clients/elasticsearch/core/MsearchRequest.java

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -193,7 +193,11 @@ public final List<ExpandWildcard> expandWildcards() {
193193
* If true, concrete, expanded or aliased indices are ignored when frozen.
194194
* <p>
195195
* API name: {@code ignore_throttled}
196+
*
197+
* @deprecated 7.16.0 This parameter is deprecated because frozen indices have
198+
* been deprecated.
196199
*/
200+
@Deprecated
197201
@Nullable
198202
public final Boolean ignoreThrottled() {
199203
return this.ignoreThrottled;
@@ -394,7 +398,11 @@ public final Builder expandWildcards(ExpandWildcard value, ExpandWildcard... val
394398
* If true, concrete, expanded or aliased indices are ignored when frozen.
395399
* <p>
396400
* API name: {@code ignore_throttled}
401+
*
402+
* @deprecated 7.16.0 This parameter is deprecated because frozen indices have
403+
* been deprecated.
397404
*/
405+
@Deprecated
398406
public final Builder ignoreThrottled(@Nullable Boolean value) {
399407
this.ignoreThrottled = value;
400408
return this;

java-client/src/main/java/co/elastic/clients/elasticsearch/doc-files/api-spec.html

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@
2727
'_global.create.Response': '_global/create/CreateResponse.ts#L22-L24',
2828
'_global.delete.Request': '_global/delete/DeleteRequest.ts#L34-L146',
2929
'_global.delete.Response': '_global/delete/DeleteResponse.ts#L22-L34',
30-
'_global.delete_by_query.Request': '_global/delete_by_query/DeleteByQueryRequest.ts#L37-L319',
30+
'_global.delete_by_query.Request': '_global/delete_by_query/DeleteByQueryRequest.ts#L37-L320',
3131
'_global.delete_by_query.Response': '_global/delete_by_query/DeleteByQueryResponse.ts#L26-L88',
3232
'_global.delete_by_query_rethrottle.Request': '_global/delete_by_query_rethrottle/DeleteByQueryRethrottleRequest.ts#L24-L55',
3333
'_global.delete_by_query_rethrottle.Response': '_global/delete_by_query_rethrottle/DeleteByQueryRethrottleResponse.ts#L22-L24',
@@ -104,7 +104,7 @@
104104
'_global.msearch.MultiSearchResult': '_global/msearch/types.ts#L206-L209',
105105
'_global.msearch.MultisearchBody': '_global/msearch/types.ts#L70-L204',
106106
'_global.msearch.MultisearchHeader': '_global/msearch/types.ts#L52-L67',
107-
'_global.msearch.Request': '_global/msearch/MultiSearchRequest.ts#L25-L139',
107+
'_global.msearch.Request': '_global/msearch/MultiSearchRequest.ts#L25-L140',
108108
'_global.msearch.Response': '_global/msearch/MultiSearchResponse.ts#L25-L27',
109109
'_global.msearch.ResponseItem': '_global/msearch/types.ts#L211-L214',
110110
'_global.msearch_template.Request': '_global/msearch_template/MultiSearchTemplateRequest.ts#L25-L116',
@@ -1237,8 +1237,8 @@
12371237
'cluster.delete_component_template.Request': 'cluster/delete_component_template/ClusterDeleteComponentTemplateRequest.ts#L24-L61',
12381238
'cluster.delete_component_template.Response': 'cluster/delete_component_template/ClusterDeleteComponentTemplateResponse.ts#L22-L24',
12391239
'cluster.delete_voting_config_exclusions.Request': 'cluster/delete_voting_config_exclusions/ClusterDeleteVotingConfigExclusionsRequest.ts#L23-L55',
1240-
'cluster.exists_component_template.Request': 'cluster/exists_component_template/ClusterComponentTemplateExistsRequest.ts#L24-L62',
1241-
'cluster.get_component_template.Request': 'cluster/get_component_template/ClusterGetComponentTemplateRequest.ts#L24-L81',
1240+
'cluster.exists_component_template.Request': 'cluster/exists_component_template/ClusterComponentTemplateExistsRequest.ts#L24-L63',
1241+
'cluster.get_component_template.Request': 'cluster/get_component_template/ClusterGetComponentTemplateRequest.ts#L24-L82',
12421242
'cluster.get_component_template.Response': 'cluster/get_component_template/ClusterGetComponentTemplateResponse.ts#L22-L24',
12431243
'cluster.get_settings.Request': 'cluster/get_settings/ClusterGetSettingsRequest.ts#L23-L69',
12441244
'cluster.get_settings.Response': 'cluster/get_settings/ClusterGetSettingsResponse.ts#L23-L32',
@@ -1272,7 +1272,7 @@
12721272
'cluster.reroute.RerouteExplanation': 'cluster/reroute/types.ts#L92-L96',
12731273
'cluster.reroute.RerouteParameters': 'cluster/reroute/types.ts#L98-L105',
12741274
'cluster.reroute.Response': 'cluster/reroute/ClusterRerouteResponse.ts#L23-L34',
1275-
'cluster.state.Request': 'cluster/state/ClusterStateRequest.ts#L29-L89',
1275+
'cluster.state.Request': 'cluster/state/ClusterStateRequest.ts#L29-L95',
12761276
'cluster.state.Response': 'cluster/state/ClusterStateResponse.ts#L22-L29',
12771277
'cluster.stats.CCSStats': 'cluster/stats/types.ts#L769-L784',
12781278
'cluster.stats.CCSUsageClusterStats': 'cluster/stats/types.ts#L855-L862',
@@ -1648,7 +1648,7 @@
16481648
'indices.exists.Request': 'indices/exists/IndicesExistsRequest.ts#L23-L79',
16491649
'indices.exists_alias.Request': 'indices/exists_alias/IndicesExistsAliasRequest.ts#L23-L80',
16501650
'indices.exists_index_template.Request': 'indices/exists_index_template/IndicesExistsIndexTemplateRequest.ts#L24-L62',
1651-
'indices.exists_template.Request': 'indices/exists_template/IndicesExistsTemplateRequest.ts#L24-L69',
1651+
'indices.exists_template.Request': 'indices/exists_template/IndicesExistsTemplateRequest.ts#L24-L70',
16521652
'indices.explain_data_lifecycle.DataStreamLifecycleExplain': 'indices/explain_data_lifecycle/IndicesExplainDataLifecycleResponse.ts#L31-L41',
16531653
'indices.explain_data_lifecycle.Request': 'indices/explain_data_lifecycle/IndicesExplainDataLifecycleRequest.ts#L24-L51',
16541654
'indices.explain_data_lifecycle.Response': 'indices/explain_data_lifecycle/IndicesExplainDataLifecycleResponse.ts#L25-L29',
@@ -1686,7 +1686,7 @@
16861686
'indices.get_field_mapping.Response': 'indices/get_field_mapping/IndicesGetFieldMappingResponse.ts#L24-L27',
16871687
'indices.get_field_mapping.TypeFieldMappings': 'indices/get_field_mapping/types.ts#L24-L26',
16881688
'indices.get_index_template.IndexTemplateItem': 'indices/get_index_template/IndicesGetIndexTemplateResponse.ts#L29-L32',
1689-
'indices.get_index_template.Request': 'indices/get_index_template/IndicesGetIndexTemplateRequest.ts#L24-L72',
1689+
'indices.get_index_template.Request': 'indices/get_index_template/IndicesGetIndexTemplateRequest.ts#L24-L73',
16901690
'indices.get_index_template.Response': 'indices/get_index_template/IndicesGetIndexTemplateResponse.ts#L23-L27',
16911691
'indices.get_mapping.IndexMappingRecord': 'indices/get_mapping/IndicesGetMappingResponse.ts#L29-L32',
16921692
'indices.get_mapping.Request': 'indices/get_mapping/IndicesGetMappingRequest.ts#L24-L84',
@@ -1695,9 +1695,9 @@
16951695
'indices.get_migrate_reindex_status.Response': 'indices/get_migrate_reindex_status/MigrateGetReindexStatusResponse.ts#L23-L36',
16961696
'indices.get_migrate_reindex_status.StatusError': 'indices/get_migrate_reindex_status/MigrateGetReindexStatusResponse.ts#L44-L47',
16971697
'indices.get_migrate_reindex_status.StatusInProgress': 'indices/get_migrate_reindex_status/MigrateGetReindexStatusResponse.ts#L38-L42',
1698-
'indices.get_settings.Request': 'indices/get_settings/IndicesGetSettingsRequest.ts#L24-L111',
1698+
'indices.get_settings.Request': 'indices/get_settings/IndicesGetSettingsRequest.ts#L24-L112',
16991699
'indices.get_settings.Response': 'indices/get_settings/IndicesGetSettingsResponse.ts#L24-L27',
1700-
'indices.get_template.Request': 'indices/get_template/IndicesGetTemplateRequest.ts#L24-L73',
1700+
'indices.get_template.Request': 'indices/get_template/IndicesGetTemplateRequest.ts#L24-L74',
17011701
'indices.get_template.Response': 'indices/get_template/IndicesGetTemplateResponse.ts#L23-L26',
17021702
'indices.migrate_reindex.MigrateReindex': 'indices/migrate_reindex/MigrateReindexRequest.ts#L39-L48',
17031703
'indices.migrate_reindex.ModeEnum': 'indices/migrate_reindex/MigrateReindexRequest.ts#L54-L56',
@@ -3286,9 +3286,9 @@
32863286
'xpack.info.Features': 'xpack/info/types.ts#L42-L83',
32873287
'xpack.info.MinimalLicenseInformation': 'xpack/info/types.ts#L34-L40',
32883288
'xpack.info.NativeCodeInformation': 'xpack/info/types.ts#L29-L32',
3289-
'xpack.info.Request': 'xpack/info/XPackInfoRequest.ts#L22-L56',
3289+
'xpack.info.Request': 'xpack/info/XPackInfoRequest.ts#L22-L59',
32903290
'xpack.info.Response': 'xpack/info/XPackInfoResponse.ts#L22-L29',
3291-
'xpack.info.XPackCategory': 'xpack/info/XPackInfoRequest.ts#L58-L62',
3291+
'xpack.info.XPackCategory': 'xpack/info/XPackInfoRequest.ts#L61-L65',
32923292
'xpack.usage.Analytics': 'xpack/usage/types.ts#L340-L342',
32933293
'xpack.usage.AnalyticsStatistics': 'xpack/usage/types.ts#L58-L68',
32943294
'xpack.usage.Archive': 'xpack/usage/types.ts#L45-L47',
@@ -3362,10 +3362,10 @@
33623362
if (hash.length > 1) {
33633363
hash = hash.substring(1);
33643364
}
3365-
window.location = "https://github.com/elastic/elasticsearch-specification/tree/2e9286dab0ca61aa24f1e157bcf25bd5e954293c/specification/" + (paths[hash] || "");
3365+
window.location = "https://github.com/elastic/elasticsearch-specification/tree/6dc6c54097683e671b85dad72d2bc5604a815ff4/specification/" + (paths[hash] || "");
33663366
</script>
33673367
</head>
33683368
<body>
3369-
Please see the <a href="https://github.com/elastic/elasticsearch-specification/tree/2e9286dab0ca61aa24f1e157bcf25bd5e954293c/specification/">Elasticsearch API specification</a>.
3369+
Please see the <a href="https://github.com/elastic/elasticsearch-specification/tree/6dc6c54097683e671b85dad72d2bc5604a815ff4/specification/">Elasticsearch API specification</a>.
33703370
</body>
33713371
</html>

java-client/src/main/java/co/elastic/clients/elasticsearch/indices/ExistsTemplateRequest.java

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -114,7 +114,11 @@ public final Boolean flatSettings() {
114114
* Indicates whether to get information from the local node only.
115115
* <p>
116116
* API name: {@code local}
117+
*
118+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
119+
* be removed in a future version.
117120
*/
121+
@Deprecated
118122
@Nullable
119123
public final Boolean local() {
120124
return this.local;
@@ -176,7 +180,11 @@ public final Builder flatSettings(@Nullable Boolean value) {
176180
* Indicates whether to get information from the local node only.
177181
* <p>
178182
* API name: {@code local}
183+
*
184+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
185+
* be removed in a future version.
179186
*/
187+
@Deprecated
180188
public final Builder local(@Nullable Boolean value) {
181189
this.local = value;
182190
return this;

java-client/src/main/java/co/elastic/clients/elasticsearch/indices/GetIndexTemplateRequest.java

Lines changed: 10 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -120,7 +120,11 @@ public final Boolean includeDefaults() {
120120
* to false, which means information is retrieved from the master node.
121121
* <p>
122122
* API name: {@code local}
123+
*
124+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
125+
* be removed in a future version.
123126
*/
127+
@Deprecated
124128
@Nullable
125129
public final Boolean local() {
126130
return this.local;
@@ -138,8 +142,7 @@ public final Time masterTimeout() {
138142
}
139143

140144
/**
141-
* Comma-separated list of index template names used to limit the request.
142-
* Wildcard (*) expressions are supported.
145+
* Name of index template to retrieve. Wildcard (*) expressions are supported.
143146
* <p>
144147
* API name: {@code name}
145148
*/
@@ -197,7 +200,11 @@ public final Builder includeDefaults(@Nullable Boolean value) {
197200
* to false, which means information is retrieved from the master node.
198201
* <p>
199202
* API name: {@code local}
203+
*
204+
* @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will
205+
* be removed in a future version.
200206
*/
207+
@Deprecated
201208
public final Builder local(@Nullable Boolean value) {
202209
this.local = value;
203210
return this;
@@ -225,8 +232,7 @@ public final Builder masterTimeout(Function<Time.Builder, ObjectBuilder<Time>> f
225232
}
226233

227234
/**
228-
* Comma-separated list of index template names used to limit the request.
229-
* Wildcard (*) expressions are supported.
235+
* Name of index template to retrieve. Wildcard (*) expressions are supported.
230236
* <p>
231237
* API name: {@code name}
232238
*/

java-client/src/main/java/co/elastic/clients/elasticsearch/indices/GetIndicesSettingsRequest.java

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -185,7 +185,11 @@ public final List<String> index() {
185185
* only. If <code>false</code>, information is retrieved from the master node.
186186
* <p>
187187
* API name: {@code local}
188+
*
189+
* @deprecated 9.1.0 This parameter is a no-op and settings are always retrieved
190+
* locally.
188191
*/
192+
@Deprecated
189193
@Nullable
190194
public final Boolean local() {
191195
return this.local;
@@ -355,7 +359,11 @@ public final Builder index(String value, String... values) {
355359
* only. If <code>false</code>, information is retrieved from the master node.
356360
* <p>
357361
* API name: {@code local}
362+
*
363+
* @deprecated 9.1.0 This parameter is a no-op and settings are always retrieved
364+
* locally.
358365
*/
366+
@Deprecated
359367
public final Builder local(@Nullable Boolean value) {
360368
this.local = value;
361369
return this;

0 commit comments

Comments
 (0)