Skip to content

Commit e60aeee

Browse files
authored
Manual backport of b125288 from #5225 (#5236)
1 parent 7eb3097 commit e60aeee

11 files changed

+120
-38
lines changed

src/ApiGenerator/Views/HighLevel/Descriptors/Descriptor.cshtml

+3-2
Original file line numberDiff line numberDiff line change
@@ -57,8 +57,9 @@
5757
await IncludeAsync("HighLevel/Descriptors/XmlDocs.cshtml", desc);
5858
if(!string.IsNullOrWhiteSpace(param.Obsolete))
5959
{
60-
<text> [Obsolete("Scheduled to be removed in 7.0, @param.Obsolete")]
61-
</text>
60+
<text>
61+
[Obsolete("Scheduled to be removed in 8.0, @param.Obsolete")]
62+
</text>
6263
}
6364
<text>
6465
public @Raw(type) @(param.ClsName)(@param.DescriptorArgumentType @param.ClsArgumentName@tSuffix) => Qs("@original", @(param.ClsArgumentName));
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
c2521f2e747027f7dce03a20200002d6e8513e41
1+
c5c9c1b14918f852399c86da53181f4b6a82e948

src/Nest/Descriptors.Cat.cs

+31-15
Original file line numberDiff line numberDiff line change
@@ -60,7 +60,8 @@ public CatAliasesDescriptor(Names name): base(r => r.Optional("name", name))
6060
public CatAliasesDescriptor Help(bool? help = true) => Qs("help", help);
6161
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
6262
public CatAliasesDescriptor Local(bool? local = true) => Qs("local", local);
63-
///<summary>Explicit operation timeout for connection to master node</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
63+
///<summary>Explicit operation timeout for connection to master node</summary>
64+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
6465
public CatAliasesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
6566
///<summary>Comma-separated list of column names or column aliases to sort by</summary>
6667
public CatAliasesDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);
@@ -137,9 +138,11 @@ public CatCountDescriptor Index<TOther>()
137138
public CatCountDescriptor Headers(params string[] headers) => Qs("h", headers);
138139
///<summary>Return help information</summary>
139140
public CatCountDescriptor Help(bool? help = true) => Qs("help", help);
140-
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
141+
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
142+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
141143
public CatCountDescriptor Local(bool? local = true) => Qs("local", local);
142-
///<summary>Explicit operation timeout for connection to master node</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
144+
///<summary>Explicit operation timeout for connection to master node</summary>
145+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
143146
public CatCountDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
144147
///<summary>Comma-separated list of column names or column aliases to sort by</summary>
145148
public CatCountDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);
@@ -177,9 +180,11 @@ public CatFielddataDescriptor(Fields fields): base(r => r.Optional("fields", fie
177180
public CatFielddataDescriptor Headers(params string[] headers) => Qs("h", headers);
178181
///<summary>Return help information</summary>
179182
public CatFielddataDescriptor Help(bool? help = true) => Qs("help", help);
180-
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
183+
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
184+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
181185
public CatFielddataDescriptor Local(bool? local = true) => Qs("local", local);
182-
///<summary>Explicit operation timeout for connection to master node</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
186+
///<summary>Explicit operation timeout for connection to master node</summary>
187+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
183188
public CatFielddataDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
184189
///<summary>Comma-separated list of column names or column aliases to sort by</summary>
185190
public CatFielddataDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);
@@ -201,9 +206,11 @@ public partial class CatHealthDescriptor : RequestDescriptorBase<CatHealthDescri
201206
public CatHealthDescriptor Help(bool? help = true) => Qs("help", help);
202207
///<summary>Set to false to disable timestamping</summary>
203208
public CatHealthDescriptor IncludeTimestamp(bool? includetimestamp = true) => Qs("ts", includetimestamp);
204-
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
209+
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
210+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
205211
public CatHealthDescriptor Local(bool? local = true) => Qs("local", local);
206-
///<summary>Explicit operation timeout for connection to master node</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
212+
///<summary>Explicit operation timeout for connection to master node</summary>
213+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
207214
public CatHealthDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
208215
///<summary>Comma-separated list of column names or column aliases to sort by</summary>
209216
public CatHealthDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);
@@ -263,6 +270,7 @@ public CatIndicesDescriptor Index<TOther>()
263270
///<summary>If set to true segment stats will include stats for segments that are not currently loaded into memory</summary>
264271
public CatIndicesDescriptor IncludeUnloadedSegments(bool? includeunloadedsegments = true) => Qs("include_unloaded_segments", includeunloadedsegments);
265272
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
273+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.11.0, reason: This parameter does not affect the request. It will be removed in a future release.")]
266274
public CatIndicesDescriptor Local(bool? local = true) => Qs("local", local);
267275
///<summary>Explicit operation timeout for connection to master node</summary>
268276
public CatIndicesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
@@ -352,7 +360,8 @@ public CatDatafeedsDescriptor(Id datafeedId): base(r => r.Optional("datafeed_id"
352360
///<summary>The ID of the datafeeds stats to fetch</summary>
353361
public CatDatafeedsDescriptor DatafeedId(Id datafeedId) => Assign(datafeedId, (a, v) => a.RouteValues.Optional("datafeed_id", v));
354362
// Request parameters
355-
///<summary>Whether to ignore if a wildcard expression matches no datafeeds. (This includes `_all` string or when no datafeeds have been specified)</summary> [Obsolete("Scheduled to be removed in 7.0, deprecated")]
363+
///<summary>Whether to ignore if a wildcard expression matches no datafeeds. (This includes `_all` string or when no datafeeds have been specified)</summary>
364+
[Obsolete("Scheduled to be removed in 8.0, deprecated")]
356365
public CatDatafeedsDescriptor AllowNoDatafeeds(bool? allownodatafeeds = true) => Qs("allow_no_datafeeds", allownodatafeeds);
357366
///<summary>Whether to ignore if a wildcard expression matches no datafeeds. (This includes `_all` string or when no datafeeds have been specified)</summary>
358367
public CatDatafeedsDescriptor AllowNoMatch(bool? allownomatch = true) => Qs("allow_no_match", allownomatch);
@@ -388,7 +397,8 @@ public CatJobsDescriptor(Id jobId): base(r => r.Optional("job_id", jobId))
388397
///<summary>The ID of the jobs stats to fetch</summary>
389398
public CatJobsDescriptor JobId(Id jobId) => Assign(jobId, (a, v) => a.RouteValues.Optional("job_id", v));
390399
// Request parameters
391-
///<summary>Whether to ignore if a wildcard expression matches no jobs. (This includes `_all` string or when no jobs have been specified)</summary> [Obsolete("Scheduled to be removed in 7.0, deprecated")]
400+
///<summary>Whether to ignore if a wildcard expression matches no jobs. (This includes `_all` string or when no jobs have been specified)</summary>
401+
[Obsolete("Scheduled to be removed in 8.0, deprecated")]
392402
public CatJobsDescriptor AllowNoJobs(bool? allownojobs = true) => Qs("allow_no_jobs", allownojobs);
393403
///<summary>Whether to ignore if a wildcard expression matches no jobs. (This includes `_all` string or when no jobs have been specified)</summary>
394404
public CatJobsDescriptor AllowNoMatch(bool? allownomatch = true) => Qs("allow_no_match", allownomatch);
@@ -484,7 +494,8 @@ public partial class CatNodesDescriptor : RequestDescriptorBase<CatNodesDescript
484494
public CatNodesDescriptor Headers(params string[] headers) => Qs("h", headers);
485495
///<summary>Return help information</summary>
486496
public CatNodesDescriptor Help(bool? help = true) => Qs("help", help);
487-
///<summary>Calculate the selected nodes using the local cluster state rather than the state from master node (default: false)</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.6.0, reason: This parameter does not cause this API to act locally.")]
497+
///<summary>Calculate the selected nodes using the local cluster state rather than the state from master node (default: false)</summary>
498+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.6.0, reason: This parameter does not cause this API to act locally.")]
488499
public CatNodesDescriptor Local(bool? local = true) => Qs("local", local);
489500
///<summary>Explicit operation timeout for connection to master node</summary>
490501
public CatNodesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
@@ -528,6 +539,8 @@ public partial class CatPluginsDescriptor : RequestDescriptorBase<CatPluginsDesc
528539
public CatPluginsDescriptor Headers(params string[] headers) => Qs("h", headers);
529540
///<summary>Return help information</summary>
530541
public CatPluginsDescriptor Help(bool? help = true) => Qs("help", help);
542+
///<summary>Include bootstrap plugins in the response</summary>
543+
public CatPluginsDescriptor IncludeBootstrap(bool? includebootstrap = true) => Qs("include_bootstrap", includebootstrap);
531544
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
532545
public CatPluginsDescriptor Local(bool? local = true) => Qs("local", local);
533546
///<summary>Explicit operation timeout for connection to master node</summary>
@@ -575,7 +588,8 @@ public CatRecoveryDescriptor Index<TOther>()
575588
public CatRecoveryDescriptor Headers(params string[] headers) => Qs("h", headers);
576589
///<summary>Return help information</summary>
577590
public CatRecoveryDescriptor Help(bool? help = true) => Qs("help", help);
578-
///<summary>Explicit operation timeout for connection to master node</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
591+
///<summary>Explicit operation timeout for connection to master node</summary>
592+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.5.0, reason: Removed from the server as it was never a valid option")]
579593
public CatRecoveryDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
580594
///<summary>Comma-separated list of column names or column aliases to sort by</summary>
581595
public CatRecoveryDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);
@@ -678,6 +692,7 @@ public CatShardsDescriptor Index<TOther>()
678692
///<summary>Return help information</summary>
679693
public CatShardsDescriptor Help(bool? help = true) => Qs("help", help);
680694
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
695+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.11.0, reason: This parameter does not affect the request. It will be removed in a future release.")]
681696
public CatShardsDescriptor Local(bool? local = true) => Qs("local", local);
682697
///<summary>Explicit operation timeout for connection to master node</summary>
683698
public CatShardsDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
@@ -740,9 +755,9 @@ public partial class CatTasksDescriptor : RequestDescriptorBase<CatTasksDescript
740755
///<summary>Return help information</summary>
741756
public CatTasksDescriptor Help(bool? help = true) => Qs("help", help);
742757
///<summary>A comma-separated list of node IDs or names to limit the returned information; use `_local` to return information from the node you're connecting to, leave empty to get information from all nodes</summary>
743-
public CatTasksDescriptor NodeId(params string[] nodeid) => Qs("node_id", nodeid);
744-
///<summary>Return tasks with specified parent task id. Set to -1 to return all.</summary>
745-
public CatTasksDescriptor ParentTask(long? parenttask) => Qs("parent_task", parenttask);
758+
public CatTasksDescriptor Nodes(params string[] nodes) => Qs("nodes", nodes);
759+
///<summary>Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all.</summary>
760+
public CatTasksDescriptor ParentTaskId(string parenttaskid) => Qs("parent_task_id", parenttaskid);
746761
///<summary>Comma-separated list of column names or column aliases to sort by</summary>
747762
public CatTasksDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);
748763
///<summary>Verbose mode. Display column headers</summary>
@@ -815,7 +830,8 @@ public CatThreadPoolDescriptor(Names threadPoolPatterns): base(r => r.Optional("
815830
public CatThreadPoolDescriptor Local(bool? local = true) => Qs("local", local);
816831
///<summary>Explicit operation timeout for connection to master node</summary>
817832
public CatThreadPoolDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
818-
///<summary>The multiplier in which to display values</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.7.0, reason: Setting this value has no effect and will be removed from the specification.")]
833+
///<summary>The multiplier in which to display values</summary>
834+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.7.0, reason: Setting this value has no effect and will be removed from the specification.")]
819835
public CatThreadPoolDescriptor Size(Size? size) => Qs("size", size);
820836
///<summary>Comma-separated list of column names or column aliases to sort by</summary>
821837
public CatThreadPoolDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);

src/Nest/Descriptors.Indices.cs

+12-5
Original file line numberDiff line numberDiff line change
@@ -380,7 +380,9 @@ protected DeleteDataStreamDescriptor(): base()
380380

381381
// values part of the url path
382382
Names IDeleteDataStreamRequest.Name => Self.RouteValues.Get<Names>("name");
383-
// Request parameters
383+
// Request parameters
384+
///<summary>Whether wildcard expressions should get expanded to open or closed indices (default: open)</summary>
385+
public DeleteDataStreamDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards);
384386
}
385387

386388
///<summary>Descriptor for DeleteTemplate <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates.html</para></summary>
@@ -818,7 +820,9 @@ public GetDataStreamDescriptor(Names name): base(r => r.Optional("name", name))
818820
Names IGetDataStreamRequest.Name => Self.RouteValues.Get<Names>("name");
819821
///<summary>A comma-separated list of data streams to get; use `*` to get all data streams</summary>
820822
public GetDataStreamDescriptor Name(Names name) => Assign(name, (a, v) => a.RouteValues.Optional("name", v));
821-
// Request parameters
823+
// Request parameters
824+
///<summary>Whether wildcard expressions should get expanded to open or closed indices (default: open)</summary>
825+
public GetDataStreamDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards);
822826
}
823827

824828
///<summary>Descriptor for GetFieldMapping <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-field-mapping.html</para></summary>
@@ -902,7 +906,8 @@ public GetMappingDescriptor<TDocument> Index<TOther>()
902906
public GetMappingDescriptor<TDocument> IgnoreUnavailable(bool? ignoreunavailable = true) => Qs("ignore_unavailable", ignoreunavailable);
903907
///<summary>Whether to add the type name to the response (default: false)</summary>
904908
public GetMappingDescriptor<TDocument> IncludeTypeName(bool? includetypename = true) => Qs("include_type_name", includetypename);
905-
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.8.0, reason: This parameter is a no-op and field mappings are always retrieved locally.")]
909+
///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
910+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.8.0, reason: This parameter is a no-op and field mappings are always retrieved locally.")]
906911
public GetMappingDescriptor<TDocument> Local(bool? local = true) => Qs("local", local);
907912
///<summary>Specify timeout for connection to master</summary>
908913
public GetMappingDescriptor<TDocument> MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
@@ -1172,13 +1177,15 @@ protected PutIndexTemplateDescriptor(): base()
11721177
// Request parameters
11731178
///<summary>Whether the index template should only be added if new or can also replace an existing one</summary>
11741179
public PutIndexTemplateDescriptor Create(bool? create = true) => Qs("create", create);
1175-
///<summary>Return settings in flat format (default: false)</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.7.0, reason: Removed from the server as it was never a valid option")]
1180+
///<summary>Return settings in flat format (default: false)</summary>
1181+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.7.0, reason: Removed from the server as it was never a valid option")]
11761182
public PutIndexTemplateDescriptor FlatSettings(bool? flatsettings = true) => Qs("flat_settings", flatsettings);
11771183
///<summary>Whether a type should be returned in the body of the mappings.</summary>
11781184
public PutIndexTemplateDescriptor IncludeTypeName(bool? includetypename = true) => Qs("include_type_name", includetypename);
11791185
///<summary>Specify timeout for connection to master</summary>
11801186
public PutIndexTemplateDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
1181-
///<summary>Explicit operation timeout</summary> [Obsolete("Scheduled to be removed in 7.0, Deprecated as of: 7.7.0, reason: Removed from the server as it was never a valid option")]
1187+
///<summary>Explicit operation timeout</summary>
1188+
[Obsolete("Scheduled to be removed in 8.0, Deprecated as of: 7.7.0, reason: Removed from the server as it was never a valid option")]
11821189
public PutIndexTemplateDescriptor Timeout(Time timeout) => Qs("timeout", timeout);
11831190
}
11841191

0 commit comments

Comments
 (0)