From 0ca2338050c88741de54a56e179b8b6d024bcdb7 Mon Sep 17 00:00:00 2001 From: Quentin Pradet Date: Wed, 5 Nov 2025 17:56:58 +0400 Subject: [PATCH 1/2] Fix and expand deprecation information --- .../_global/delete_by_query/DeleteByQueryRequest.ts | 2 +- specification/_global/msearch/MultiSearchRequest.ts | 1 + .../ClusterComponentTemplateExistsRequest.ts | 1 + .../ClusterGetComponentTemplateRequest.ts | 1 + specification/cluster/state/ClusterStateRequest.ts | 6 ++++-- .../indices/exists_template/IndicesExistsTemplateRequest.ts | 1 + .../get_index_template/IndicesGetIndexTemplateRequest.ts | 1 + .../indices/get_settings/IndicesGetSettingsRequest.ts | 1 + .../indices/get_template/IndicesGetTemplateRequest.ts | 1 + specification/xpack/info/XPackInfoRequest.ts | 3 +++ 10 files changed, 15 insertions(+), 3 deletions(-) diff --git a/specification/_global/delete_by_query/DeleteByQueryRequest.ts b/specification/_global/delete_by_query/DeleteByQueryRequest.ts index 11b7d67f50..09e4db4233 100644 --- a/specification/_global/delete_by_query/DeleteByQueryRequest.ts +++ b/specification/_global/delete_by_query/DeleteByQueryRequest.ts @@ -258,7 +258,7 @@ export interface Request extends RequestBase { slices?: Slices /** * A comma-separated list of `:` pairs. - * @deprecated 9.0.0 this query parameter is not supported and will be removed + * @deprecated 9.0.0 This query parameter is not supported and will be removed in a future version */ sort?: string[] /** diff --git a/specification/_global/msearch/MultiSearchRequest.ts b/specification/_global/msearch/MultiSearchRequest.ts index 888b94ffba..f8b6e37734 100644 --- a/specification/_global/msearch/MultiSearchRequest.ts +++ b/specification/_global/msearch/MultiSearchRequest.ts @@ -87,6 +87,7 @@ export interface Request extends RequestBase { expand_wildcards?: ExpandWildcards /** * If true, concrete, expanded or aliased indices are ignored when frozen. + * @deprecated 7.16.0 * @server_default false */ ignore_throttled?: boolean diff --git a/specification/cluster/exists_component_template/ClusterComponentTemplateExistsRequest.ts b/specification/cluster/exists_component_template/ClusterComponentTemplateExistsRequest.ts index 047c49401b..413567e5a3 100644 --- a/specification/cluster/exists_component_template/ClusterComponentTemplateExistsRequest.ts +++ b/specification/cluster/exists_component_template/ClusterComponentTemplateExistsRequest.ts @@ -55,6 +55,7 @@ export interface Request extends RequestBase { /** * If true, the request retrieves information from the local node only. * Defaults to false, which means information is retrieved from the master node. + * @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will be removed in a future version. * @server_default false */ local?: boolean diff --git a/specification/cluster/get_component_template/ClusterGetComponentTemplateRequest.ts b/specification/cluster/get_component_template/ClusterGetComponentTemplateRequest.ts index 4cb810c3d7..aff980511b 100644 --- a/specification/cluster/get_component_template/ClusterGetComponentTemplateRequest.ts +++ b/specification/cluster/get_component_template/ClusterGetComponentTemplateRequest.ts @@ -68,6 +68,7 @@ export interface Request extends RequestBase { /** * If `true`, the request retrieves information from the local node only. * If `false`, information is retrieved from the master node. + * @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will be removed in a future version. * @server_default false */ local?: boolean diff --git a/specification/cluster/state/ClusterStateRequest.ts b/specification/cluster/state/ClusterStateRequest.ts index 29772d76eb..009bcb2de2 100644 --- a/specification/cluster/state/ClusterStateRequest.ts +++ b/specification/cluster/state/ClusterStateRequest.ts @@ -79,11 +79,13 @@ export interface Request extends RequestBase { flat_settings?: boolean /** @server_default false */ ignore_unavailable?: boolean - /** @server_default false */ + /** + * @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will be removed in a future version. + * @server_default false + */ local?: boolean /** * Timeout for waiting for new cluster state in case it is blocked - * @deprecated 9.2.0 * @server_default 30s * */ master_timeout?: Duration diff --git a/specification/indices/exists_template/IndicesExistsTemplateRequest.ts b/specification/indices/exists_template/IndicesExistsTemplateRequest.ts index ffbaeace38..73e9858d6b 100644 --- a/specification/indices/exists_template/IndicesExistsTemplateRequest.ts +++ b/specification/indices/exists_template/IndicesExistsTemplateRequest.ts @@ -55,6 +55,7 @@ export interface Request extends RequestBase { flat_settings?: boolean /** * Indicates whether to get information from the local node only. + * @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will be removed in a future version. * @server_default false */ local?: boolean diff --git a/specification/indices/get_index_template/IndicesGetIndexTemplateRequest.ts b/specification/indices/get_index_template/IndicesGetIndexTemplateRequest.ts index a81e93bcc9..fc63dd8af8 100644 --- a/specification/indices/get_index_template/IndicesGetIndexTemplateRequest.ts +++ b/specification/indices/get_index_template/IndicesGetIndexTemplateRequest.ts @@ -48,6 +48,7 @@ export interface Request extends RequestBase { query_parameters: { /** * If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. + * @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will be removed in a future version. * @server_default false */ local?: boolean diff --git a/specification/indices/get_settings/IndicesGetSettingsRequest.ts b/specification/indices/get_settings/IndicesGetSettingsRequest.ts index eb08671e64..d5cdfbf1dd 100644 --- a/specification/indices/get_settings/IndicesGetSettingsRequest.ts +++ b/specification/indices/get_settings/IndicesGetSettingsRequest.ts @@ -97,6 +97,7 @@ export interface Request extends RequestBase { /** * If `true`, the request retrieves information from the local node only. If * `false`, information is retrieved from the master node. + * @deprecated 9.1.0 This parameter is a no-op and settings are always retrieved locally. * @server_default false */ local?: boolean diff --git a/specification/indices/get_template/IndicesGetTemplateRequest.ts b/specification/indices/get_template/IndicesGetTemplateRequest.ts index ce65f8ac0c..a9ba95bbb0 100644 --- a/specification/indices/get_template/IndicesGetTemplateRequest.ts +++ b/specification/indices/get_template/IndicesGetTemplateRequest.ts @@ -60,6 +60,7 @@ export interface Request extends RequestBase { flat_settings?: boolean /** * If `true`, the request retrieves information from the local node only. + * @deprecated 9.0.0 This parameter is a no-op and templates are always retrieved locally. * @server_default false */ local?: boolean diff --git a/specification/xpack/info/XPackInfoRequest.ts b/specification/xpack/info/XPackInfoRequest.ts index cb7bd32a17..bd28c66fe7 100644 --- a/specification/xpack/info/XPackInfoRequest.ts +++ b/specification/xpack/info/XPackInfoRequest.ts @@ -45,6 +45,9 @@ export interface Request extends RequestBase { * For example, `build,license,features`. */ categories?: XPackCategory[] + /** + * @deprecated 8.0.0 + */ accept_enterprise?: boolean /** * Defines whether additional human-readable information is included in the response. From 2a8c26645c214912e0f214274ebd00fbc4b9c758 Mon Sep 17 00:00:00 2001 From: Quentin Pradet Date: Fri, 7 Nov 2025 17:04:52 +0400 Subject: [PATCH 2/2] Add reasons --- specification/_global/msearch/MultiSearchRequest.ts | 2 +- specification/xpack/info/XPackInfoRequest.ts | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/specification/_global/msearch/MultiSearchRequest.ts b/specification/_global/msearch/MultiSearchRequest.ts index f8b6e37734..0ef17d39f9 100644 --- a/specification/_global/msearch/MultiSearchRequest.ts +++ b/specification/_global/msearch/MultiSearchRequest.ts @@ -87,7 +87,7 @@ export interface Request extends RequestBase { expand_wildcards?: ExpandWildcards /** * If true, concrete, expanded or aliased indices are ignored when frozen. - * @deprecated 7.16.0 + * @deprecated 7.16.0 This parameter is deprecated because frozen indices have been deprecated. * @server_default false */ ignore_throttled?: boolean diff --git a/specification/xpack/info/XPackInfoRequest.ts b/specification/xpack/info/XPackInfoRequest.ts index bd28c66fe7..7b193c9196 100644 --- a/specification/xpack/info/XPackInfoRequest.ts +++ b/specification/xpack/info/XPackInfoRequest.ts @@ -46,7 +46,7 @@ export interface Request extends RequestBase { */ categories?: XPackCategory[] /** - * @deprecated 8.0.0 + * @deprecated 8.0.0 Supported for backwards compatibility with 7.x */ accept_enterprise?: boolean /**