Code gen for NEST to support backporting APIs (#5253)

stevejgordon · web-flow · commit 246246b6914a · 2021-01-14T10:43:37.000Z
diff --git a/src/ApiGenerator/last_downloaded_version.txt b/src/ApiGenerator/last_downloaded_version.txt
@@ -1 +1 @@
-f2651e47639aba972f4ad0d653907fafcff9d316
+963c3284b354553b9097ad9e2f3cd31e411c239a
diff --git a/src/Nest/Descriptors.AsyncSearch.cs b/src/Nest/Descriptors.AsyncSearch.cs
@@ -21,8 +21,8 @@
 using System.Text;
 using System.Linq.Expressions;
 using Elastic.Transport;
-using Elasticsearch.Net;
 using Nest.Utf8Json;
+using Elasticsearch.Net;
 using Elasticsearch.Net.Specification.AsyncSearchApi;
 
 // ReSharper disable RedundantBaseConstructorCall
@@ -173,4 +173,4 @@ public AsyncSearchSubmitDescriptor<TInferDocument> Index<TOther>()
 		///<summary>Specify the time that the request should block waiting for the final response</summary>
 		public AsyncSearchSubmitDescriptor<TInferDocument> WaitForCompletionTimeout(Time waitforcompletiontimeout) => Qs("wait_for_completion_timeout", waitforcompletiontimeout);
 	}
-}
+}
diff --git a/src/Nest/Descriptors.Cat.cs b/src/Nest/Descriptors.Cat.cs
@@ -357,7 +357,8 @@ public CatDatafeedsDescriptor(Id datafeedId): base(r => r.Optional("datafeed_id"
 		///<summary>The ID of the datafeeds stats to fetch</summary>
 		public CatDatafeedsDescriptor DatafeedId(Id datafeedId) => Assign(datafeedId, (a, v) => a.RouteValues.Optional("datafeed_id", v));
 		// Request parameters
-		///<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")]
+		///<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 8.0, deprecated")]
 		public CatDatafeedsDescriptor AllowNoDatafeeds(bool? allownodatafeeds = true) => Qs("allow_no_datafeeds", allownodatafeeds);
 		///<summary>Whether to ignore if a wildcard expression matches no datafeeds. (This includes `_all` string or when no datafeeds have been specified)</summary>
 		public CatDatafeedsDescriptor AllowNoMatch(bool? allownomatch = true) => Qs("allow_no_match", allownomatch);
@@ -395,7 +396,8 @@ public CatJobsDescriptor(Id jobId): base(r => r.Optional("job_id", jobId))
 		///<summary>The ID of the jobs stats to fetch</summary>
 		public CatJobsDescriptor JobId(Id jobId) => Assign(jobId, (a, v) => a.RouteValues.Optional("job_id", v));
 		// Request parameters
-		///<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")]
+		///<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 8.0, deprecated")]
 		public CatJobsDescriptor AllowNoJobs(bool? allownojobs = true) => Qs("allow_no_jobs", allownojobs);
 		///<summary>Whether to ignore if a wildcard expression matches no jobs. (This includes `_all` string or when no jobs have been specified)</summary>
 		public CatJobsDescriptor AllowNoMatch(bool? allownomatch = true) => Qs("allow_no_match", allownomatch);
@@ -543,6 +545,8 @@ public partial class CatPluginsDescriptor : RequestDescriptorBase<CatPluginsDesc
 		public CatPluginsDescriptor Headers(params string[] headers) => Qs("h", headers);
 		///<summary>Return help information</summary>
 		public CatPluginsDescriptor Help(bool? help = true) => Qs("help", help);
+		///<summary>Include bootstrap plugins in the response</summary>
+		public CatPluginsDescriptor IncludeBootstrap(bool? includebootstrap = true) => Qs("include_bootstrap", includebootstrap);
 		///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
 		public CatPluginsDescriptor Local(bool? local = true) => Qs("local", local);
 		///<summary>Explicit operation timeout for connection to master node</summary>
@@ -763,9 +767,9 @@ public partial class CatTasksDescriptor : RequestDescriptorBase<CatTasksDescript
 		///<summary>Return help information</summary>
 		public CatTasksDescriptor Help(bool? help = true) => Qs("help", help);
 		///<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>
-		public CatTasksDescriptor NodeId(params string[] nodeid) => Qs("node_id", nodeid);
-		///<summary>Return tasks with specified parent task id. Set to -1 to return all.</summary>
-		public CatTasksDescriptor ParentTask(long? parenttask) => Qs("parent_task", parenttask);
+		public CatTasksDescriptor Nodes(params string[] nodes) => Qs("nodes", nodes);
+		///<summary>Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all.</summary>
+		public CatTasksDescriptor ParentTaskId(string parenttaskid) => Qs("parent_task_id", parenttaskid);
 		///<summary>Comma-separated list of column names or column aliases to sort by</summary>
 		public CatTasksDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);
 		///<summary>Verbose mode. Display column headers</summary>
diff --git a/src/Nest/Requests.Cat.cs b/src/Nest/Requests.Cat.cs
@@ -1254,6 +1254,13 @@ public bool? Help
 			set => Q("help", value);
 		}
 
+		///<summary>Include bootstrap plugins in the response</summary>
+		public bool? IncludeBootstrap
+		{
+			get => Q<bool? >("include_bootstrap");
+			set => Q("include_bootstrap", value);
+		}
+
 		///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>
 		public bool? Local
 		{
@@ -1701,6 +1708,7 @@ public partial interface ICatTasksRequest : IRequest<CatTasksRequestParameters>
 	}
 
 	///<summary>Request for Tasks <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html</para></summary>
+	///<remarks>Note: Experimental within the Elasticsearch server, this functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.</remarks>
 	public partial class CatTasksRequest : PlainRequestBase<CatTasksRequestParameters>, ICatTasksRequest
 	{
 		protected ICatTasksRequest Self => this;
@@ -1752,17 +1760,17 @@ public bool? Help
 		/// 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>
-		public string[] NodeId
+		public string[] Nodes
 		{
-			get => Q<string[]>("node_id");
-			set => Q("node_id", value);
+			get => Q<string[]>("nodes");
+			set => Q("nodes", value);
 		}
 
-		///<summary>Return tasks with specified parent task id. Set to -1 to return all.</summary>
-		public long? ParentTask
+		///<summary>Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all.</summary>
+		public string ParentTaskId
 		{
-			get => Q<long? >("parent_task");
-			set => Q("parent_task", value);
+			get => Q<string>("parent_task_id");
+			set => Q("parent_task_id", value);
 		}
 
 		///<summary>Comma-separated list of column names or column aliases to sort by</summary>
diff --git a/src/Nest/Requests.Indices.cs b/src/Nest/Requests.Indices.cs
@@ -2643,7 +2643,7 @@ public IndicesStatsRequest(Indices index, Metrics metric): base(r => r.Optional(
 		[IgnoreDataMember]
 		Indices IIndicesStatsRequest.Index => Self.RouteValues.Get<Indices>("index");
 		// Request parameters
-		///<summary>A comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)</summary>
+		///<summary>A comma-separated list of fields for the `completion` index metric (supports wildcards)</summary>
 		public Fields CompletionFields
 		{
 			get => Q<Fields>("completion_fields");
@@ -2657,7 +2657,7 @@ public ExpandWildcards? ExpandWildcards
 			set => Q("expand_wildcards", value);
 		}
 
-		///<summary>A comma-separated list of fields for `fielddata` index metric (supports wildcards)</summary>
+		///<summary>A comma-separated list of fields for the `fielddata` index metric (supports wildcards)</summary>
 		public Fields FielddataFields
 		{
 			get => Q<Fields>("fielddata_fields");
diff --git a/src/Nest/Requests.Nodes.cs b/src/Nest/Requests.Nodes.cs
@@ -291,14 +291,14 @@ public NodesStatsRequest(NodeIds nodeId, Metrics metric, IndexMetrics indexMetri
 		[IgnoreDataMember]
 		IndexMetrics INodesStatsRequest.IndexMetric => Self.RouteValues.Get<IndexMetrics>("index_metric");
 		// Request parameters
-		///<summary>A comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)</summary>
+		///<summary>A comma-separated list of fields for the `completion` index metric (supports wildcards)</summary>
 		public Fields CompletionFields
 		{
 			get => Q<Fields>("completion_fields");
 			set => Q("completion_fields", value);
 		}
 
-		///<summary>A comma-separated list of fields for `fielddata` index metric (supports wildcards)</summary>
+		///<summary>A comma-separated list of fields for the `fielddata` index metric (supports wildcards)</summary>
 		public Fields FielddataFields
 		{
 			get => Q<Fields>("fielddata_fields");
diff --git a/src/Nest/Requests.Tasks.cs b/src/Nest/Requests.Tasks.cs
@@ -43,6 +43,7 @@ TaskId TaskId
 	}
 
 	///<summary>Request for Cancel <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html</para></summary>
+	///<remarks>Note: Experimental within the Elasticsearch server, this functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.</remarks>
 	public partial class CancelTasksRequest : PlainRequestBase<CancelTasksRequestParameters>, ICancelTasksRequest
 	{
 		protected ICancelTasksRequest Self => this;
@@ -107,6 +108,7 @@ TaskId TaskId
 	}
 
 	///<summary>Request for GetTask <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html</para></summary>
+	///<remarks>Note: Experimental within the Elasticsearch server, this functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.</remarks>
 	public partial class GetTaskRequest : PlainRequestBase<GetTaskRequestParameters>, IGetTaskRequest
 	{
 		protected IGetTaskRequest Self => this;
@@ -150,6 +152,7 @@ public partial interface IListTasksRequest : IRequest<ListTasksRequestParameters
 	}
 
 	///<summary>Request for List <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html</para></summary>
+	///<remarks>Note: Experimental within the Elasticsearch server, this functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.</remarks>
 	public partial class ListTasksRequest : PlainRequestBase<ListTasksRequestParameters>, IListTasksRequest
 	{
 		protected IListTasksRequest Self => this;

Original file line number	Diff line number	Diff line change
`@@ -1 +1 @@`
`1`		`-f2651e47639aba972f4ad0d653907fafcff9d316`
	`1`	`+963c3284b354553b9097ad9e2f3cd31e411c239a`
Original file line number	Diff line number	Diff line change
`@@ -1254,6 +1254,13 @@ public bool? Help`
`1254`	`1254`	`set => Q("help", value);`
`1255`	`1255`	`}`
`1256`	`1256`
	`1257`	`+ ///<summary>Include bootstrap plugins in the response</summary>`
	`1258`	`+ public bool? IncludeBootstrap`
	`1259`	`+ {`
	`1260`	`+ get => Q<bool? >("include_bootstrap");`
	`1261`	`+ set => Q("include_bootstrap", value);`
	`1262`	`+ }`
	`1263`	`+`
`1257`	`1264`	`///<summary>Return local information, do not retrieve the state from master node (default: false)</summary>`
`1258`	`1265`	`public bool? Local`
`1259`	`1266`	`{`
`@@ -1701,6 +1708,7 @@ public partial interface ICatTasksRequest : IRequest<CatTasksRequestParameters>`
`1701`	`1708`	`}`
`1702`	`1709`
`1703`	`1710`	`///<summary>Request for Tasks <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html</para></summary>`
	`1711`	`+ ///<remarks>Note: Experimental within the Elasticsearch server, this functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.</remarks>`
`1704`	`1712`	`public partial class CatTasksRequest : PlainRequestBase<CatTasksRequestParameters>, ICatTasksRequest`
`1705`	`1713`	`{`
`1706`	`1714`	`protected ICatTasksRequest Self => this;`
`@@ -1752,17 +1760,17 @@ public bool? Help`
`1752`	`1760`	/// A comma-separated list of node IDs or names to limit the returned information; use `_local` to return information from the node you're
`1753`	`1761`	`/// connecting to, leave empty to get information from all nodes`
`1754`	`1762`	`///</summary>`
`1755`		`- public string[] NodeId`
	`1763`	`+ public string[] Nodes`
`1756`	`1764`	`{`
`1757`		`- get => Q<string[]>("node_id");`
`1758`		`- set => Q("node_id", value);`
	`1765`	`+ get => Q<string[]>("nodes");`
	`1766`	`+ set => Q("nodes", value);`
`1759`	`1767`	`}`
`1760`	`1768`
`1761`		`- ///<summary>Return tasks with specified parent task id. Set to -1 to return all.</summary>`
`1762`		`- public long? ParentTask`
	`1769`	`+ ///<summary>Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all.</summary>`
	`1770`	`+ public string ParentTaskId`
`1763`	`1771`	`{`
`1764`		`- get => Q<long? >("parent_task");`
`1765`		`- set => Q("parent_task", value);`
	`1772`	`+ get => Q<string>("parent_task_id");`
	`1773`	`+ set => Q("parent_task_id", value);`
`1766`	`1774`	`}`
`1767`	`1775`
`1768`	`1776`	`///<summary>Comma-separated list of column names or column aliases to sort by</summary>`
Original file line number	Diff line number	Diff line change
`@@ -2643,7 +2643,7 @@ public IndicesStatsRequest(Indices index, Metrics metric): base(r => r.Optional(`
`2643`	`2643`	`[IgnoreDataMember]`
`2644`	`2644`	`Indices IIndicesStatsRequest.Index => Self.RouteValues.Get<Indices>("index");`
`2645`	`2645`	`// Request parameters`
`2646`		- ///<summary>A comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)</summary>
	`2646`	+ ///<summary>A comma-separated list of fields for the `completion` index metric (supports wildcards)</summary>
`2647`	`2647`	`public Fields CompletionFields`
`2648`	`2648`	`{`
`2649`	`2649`	`get => Q<Fields>("completion_fields");`
`@@ -2657,7 +2657,7 @@ public ExpandWildcards? ExpandWildcards`
`2657`	`2657`	`set => Q("expand_wildcards", value);`
`2658`	`2658`	`}`
`2659`	`2659`
`2660`		- ///<summary>A comma-separated list of fields for `fielddata` index metric (supports wildcards)</summary>
	`2660`	+ ///<summary>A comma-separated list of fields for the `fielddata` index metric (supports wildcards)</summary>
`2661`	`2661`	`public Fields FielddataFields`
`2662`	`2662`	`{`
`2663`	`2663`	`get => Q<Fields>("fielddata_fields");`
Original file line number	Diff line number	Diff line change
`@@ -291,14 +291,14 @@ public NodesStatsRequest(NodeIds nodeId, Metrics metric, IndexMetrics indexMetri`
`291`	`291`	`[IgnoreDataMember]`
`292`	`292`	`IndexMetrics INodesStatsRequest.IndexMetric => Self.RouteValues.Get<IndexMetrics>("index_metric");`
`293`	`293`	`// Request parameters`
`294`		- ///<summary>A comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)</summary>
	`294`	+ ///<summary>A comma-separated list of fields for the `completion` index metric (supports wildcards)</summary>
`295`	`295`	`public Fields CompletionFields`
`296`	`296`	`{`
`297`	`297`	`get => Q<Fields>("completion_fields");`
`298`	`298`	`set => Q("completion_fields", value);`
`299`	`299`	`}`
`300`	`300`
`301`		- ///<summary>A comma-separated list of fields for `fielddata` index metric (supports wildcards)</summary>
	`301`	+ ///<summary>A comma-separated list of fields for the `fielddata` index metric (supports wildcards)</summary>
`302`	`302`	`public Fields FielddataFields`
`303`	`303`	`{`
`304`	`304`	`get => Q<Fields>("fielddata_fields");`
Original file line number	Diff line number	Diff line change
`@@ -43,6 +43,7 @@ TaskId TaskId`
`43`	`43`	`}`
`44`	`44`
`45`	`45`	`///<summary>Request for Cancel <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html</para></summary>`
	`46`	`+ ///<remarks>Note: Experimental within the Elasticsearch server, this functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.</remarks>`
`46`	`47`	`public partial class CancelTasksRequest : PlainRequestBase<CancelTasksRequestParameters>, ICancelTasksRequest`
`47`	`48`	`{`
`48`	`49`	`protected ICancelTasksRequest Self => this;`
`@@ -107,6 +108,7 @@ TaskId TaskId`
`107`	`108`	`}`
`108`	`109`
`109`	`110`	`///<summary>Request for GetTask <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html</para></summary>`
	`111`	`+ ///<remarks>Note: Experimental within the Elasticsearch server, this functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.</remarks>`
`110`	`112`	`public partial class GetTaskRequest : PlainRequestBase<GetTaskRequestParameters>, IGetTaskRequest`
`111`	`113`	`{`
`112`	`114`	`protected IGetTaskRequest Self => this;`
`@@ -150,6 +152,7 @@ public partial interface IListTasksRequest : IRequest<ListTasksRequestParameters`
`150`	`152`	`}`
`151`	`153`
`152`	`154`	`///<summary>Request for List <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/tasks.html</para></summary>`
	`155`	`+ ///<remarks>Note: Experimental within the Elasticsearch server, this functionality is experimental and may be changed or removed completely in a future release. Elastic will take a best effort approach to fix any issues, but experimental features are not subject to the support SLA of official GA features.</remarks>`
`153`	`156`	`public partial class ListTasksRequest : PlainRequestBase<ListTasksRequestParameters>, IListTasksRequest`
`154`	`157`	`{`
`155`	`158`	`protected IListTasksRequest Self => this;`