Skip to content

Commit e6fde46

Browse files
Initial NEST code gen (#5627) (#5630)
* Initial NEST code gen * Update tests Co-authored-by: Steve Gordon <sgordon@hotmail.co.uk>
1 parent c4ed971 commit e6fde46

21 files changed

+85
-31
lines changed

src/Nest/Descriptors.Cat.cs

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -494,6 +494,8 @@ public partial class CatNodesDescriptor : RequestDescriptorBase<CatNodesDescript
494494
public CatNodesDescriptor Headers(params string[] headers) => Qs("h", headers);
495495
///<summary>Return help information</summary>
496496
public CatNodesDescriptor Help(bool? help = true) => Qs("help", help);
497+
///<summary>If set to true segment stats will include stats for segments that are not currently loaded into memory</summary>
498+
public CatNodesDescriptor IncludeUnloadedSegments(bool? includeunloadedsegments = true) => Qs("include_unloaded_segments", includeunloadedsegments);
497499
///<summary>Calculate the selected nodes using the local cluster state rather than the state from master node (default: false)</summary>
498500
[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.")]
499501
public CatNodesDescriptor Local(bool? local = true) => Qs("local", local);

src/Nest/Descriptors.Cluster.cs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ public partial class DeleteVotingConfigExclusionsDescriptor : RequestDescriptorB
5252
public DeleteVotingConfigExclusionsDescriptor WaitForRemoval(bool? waitforremoval = true) => Qs("wait_for_removal", waitforremoval);
5353
}
5454

55-
///<summary>Descriptor for GetSettings <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html</para></summary>
55+
///<summary>Descriptor for GetSettings <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html</para></summary>
5656
public partial class ClusterGetSettingsDescriptor : RequestDescriptorBase<ClusterGetSettingsDescriptor, ClusterGetSettingsRequestParameters, IClusterGetSettingsRequest>, IClusterGetSettingsRequest
5757
{
5858
internal override ApiUrls ApiUrls => ApiUrlsLookups.ClusterGetSettings;

src/Nest/Descriptors.Indices.cs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -209,7 +209,7 @@ public CloseIndexDescriptor Index<TOther>()
209209
public CloseIndexDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
210210
///<summary>Explicit operation timeout</summary>
211211
public CloseIndexDescriptor Timeout(Time timeout) => Qs("timeout", timeout);
212-
///<summary>Sets the number of active shards to wait for before the operation returns.</summary>
212+
///<summary>Sets the number of active shards to wait for before the operation returns. Set to `index-setting` to wait according to the index setting `index.write.wait_for_active_shards`, or `all` to wait for all shards, or an integer. Defaults to `0`.</summary>
213213
public CloseIndexDescriptor WaitForActiveShards(string waitforactiveshards) => Qs("wait_for_active_shards", waitforactiveshards);
214214
}
215215

src/Nest/Descriptors.Ingest.cs

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -77,6 +77,8 @@ public GetPipelineDescriptor(Id id): base(r => r.Optional("id", id))
7777
// Request parameters
7878
///<summary>Explicit operation timeout for connection to master node</summary>
7979
public GetPipelineDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
80+
///<summary>Return pipelines without their definitions (default: false)</summary>
81+
public GetPipelineDescriptor Summary(bool? summary = true) => Qs("summary", summary);
8082
}
8183

8284
///<summary>Descriptor for GrokProcessorPatterns <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/grok-processor.html#grok-processor-rest-get</para></summary>

src/Nest/Descriptors.MachineLearning.cs

Lines changed: 6 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -756,19 +756,20 @@ public partial class PreviewDatafeedDescriptor : RequestDescriptorBase<PreviewDa
756756
{
757757
internal override ApiUrls ApiUrls => ApiUrlsLookups.MachineLearningPreviewDatafeed;
758758
///<summary>/_ml/datafeeds/{datafeed_id}/_preview</summary>
759-
///<param name = "datafeedId">this parameter is required</param>
760-
public PreviewDatafeedDescriptor(Id datafeedId): base(r => r.Required("datafeed_id", datafeedId))
759+
///<param name = "datafeedId">Optional, accepts null</param>
760+
public PreviewDatafeedDescriptor(Id datafeedId): base(r => r.Optional("datafeed_id", datafeedId))
761761
{
762762
}
763763

764-
///<summary>Used for serialization purposes, making sure we have a parameterless constructor</summary>
765-
[SerializationConstructor]
766-
protected PreviewDatafeedDescriptor(): base()
764+
///<summary>/_ml/datafeeds/_preview</summary>
765+
public PreviewDatafeedDescriptor(): base()
767766
{
768767
}
769768

770769
// values part of the url path
771770
Id IPreviewDatafeedRequest.DatafeedId => Self.RouteValues.Get<Id>("datafeed_id");
771+
///<summary>The ID of the datafeed to preview</summary>
772+
public PreviewDatafeedDescriptor DatafeedId(Id datafeedId) => Assign(datafeedId, (a, v) => a.RouteValues.Optional("datafeed_id", v));
772773
// Request parameters
773774
}
774775

src/Nest/Descriptors.NoNamespace.cs

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1323,6 +1323,8 @@ public SearchDescriptor<TInferDocument> Index<TOther>()
13231323
public SearchDescriptor<TInferDocument> Lenient(bool? lenient = true) => Qs("lenient", lenient);
13241324
///<summary>The number of concurrent shard requests per node this search executes concurrently. This value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests</summary>
13251325
public SearchDescriptor<TInferDocument> MaxConcurrentShardRequests(long? maxconcurrentshardrequests) => Qs("max_concurrent_shard_requests", maxconcurrentshardrequests);
1326+
///<summary>The minimum compatible version that all shards involved in search should have for this request to be successful</summary>
1327+
public SearchDescriptor<TInferDocument> MinCompatibleShardNode(string mincompatibleshardnode) => Qs("min_compatible_shard_node", mincompatibleshardnode);
13261328
///<summary>A threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter roundtrip can limit the number of shards significantly if for instance a shard can not match any documents based on its rewrite method ie. if date filters are mandatory to match but the shard bounds and the query are disjoint.</summary>
13271329
public SearchDescriptor<TInferDocument> PreFilterShardSize(long? prefiltershardsize) => Qs("pre_filter_shard_size", prefiltershardsize);
13281330
///<summary>Specify the node or shard the operation should be performed on (default: random)</summary>

src/Nest/Descriptors.Nodes.cs

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -203,6 +203,8 @@ public NodesStatsDescriptor Fields<T>(params Expression<Func<T, object>>[] field
203203
public NodesStatsDescriptor Groups(bool? groups = true) => Qs("groups", groups);
204204
///<summary>Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)</summary>
205205
public NodesStatsDescriptor IncludeSegmentFileSizes(bool? includesegmentfilesizes = true) => Qs("include_segment_file_sizes", includesegmentfilesizes);
206+
///<summary>If set to true segment stats will include stats for segments that are not currently loaded into memory</summary>
207+
public NodesStatsDescriptor IncludeUnloadedSegments(bool? includeunloadedsegments = true) => Qs("include_unloaded_segments", includeunloadedsegments);
206208
///<summary>Return indices stats aggregated at index, node or shard level</summary>
207209
public NodesStatsDescriptor Level(Level? level) => Qs("level", level);
208210
///<summary>Explicit operation timeout</summary>

src/Nest/Descriptors.Snapshot.cs

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -209,6 +209,8 @@ protected GetSnapshotDescriptor(): base()
209209
// Request parameters
210210
///<summary>Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown</summary>
211211
public GetSnapshotDescriptor IgnoreUnavailable(bool? ignoreunavailable = true) => Qs("ignore_unavailable", ignoreunavailable);
212+
///<summary>Whether to include details of each index in the snapshot, if those details are available. Defaults to false.</summary>
213+
public GetSnapshotDescriptor IndexDetails(bool? indexdetails = true) => Qs("index_details", indexdetails);
212214
///<summary>Explicit operation timeout for connection to master node</summary>
213215
public GetSnapshotDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
214216
///<summary>Whether to show verbose snapshot info or only show the basic info found in the repository index blob</summary>

src/Nest/ElasticClient.Cluster.cs

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -87,25 +87,25 @@ internal ClusterNamespace(ElasticClient client): base(client)
8787
/// <summary>
8888
/// <c>GET</c> request to the <c>cluster.get_settings</c> API, read more about this API online:
8989
/// <para></para>
90-
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html">https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html</a>
90+
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html">https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html</a>
9191
/// </summary>
9292
public ClusterGetSettingsResponse GetSettings(Func<ClusterGetSettingsDescriptor, IClusterGetSettingsRequest> selector = null) => GetSettings(selector.InvokeOrDefault(new ClusterGetSettingsDescriptor()));
9393
/// <summary>
9494
/// <c>GET</c> request to the <c>cluster.get_settings</c> API, read more about this API online:
9595
/// <para></para>
96-
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html">https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html</a>
96+
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html">https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html</a>
9797
/// </summary>
9898
public Task<ClusterGetSettingsResponse> GetSettingsAsync(Func<ClusterGetSettingsDescriptor, IClusterGetSettingsRequest> selector = null, CancellationToken ct = default) => GetSettingsAsync(selector.InvokeOrDefault(new ClusterGetSettingsDescriptor()), ct);
9999
/// <summary>
100100
/// <c>GET</c> request to the <c>cluster.get_settings</c> API, read more about this API online:
101101
/// <para></para>
102-
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html">https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html</a>
102+
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html">https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html</a>
103103
/// </summary>
104104
public ClusterGetSettingsResponse GetSettings(IClusterGetSettingsRequest request) => DoRequest<IClusterGetSettingsRequest, ClusterGetSettingsResponse>(request, request.RequestParameters);
105105
/// <summary>
106106
/// <c>GET</c> request to the <c>cluster.get_settings</c> API, read more about this API online:
107107
/// <para></para>
108-
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html">https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html</a>
108+
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html">https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html</a>
109109
/// </summary>
110110
public Task<ClusterGetSettingsResponse> GetSettingsAsync(IClusterGetSettingsRequest request, CancellationToken ct = default) => DoRequestAsync<IClusterGetSettingsRequest, ClusterGetSettingsResponse>(request, request.RequestParameters, ct);
111111
/// <summary>

src/Nest/ElasticClient.MachineLearning.cs

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -759,28 +759,28 @@ public Task<EstimateModelMemoryResponse> EstimateModelMemoryAsync<TDocument>(Fun
759759
/// </summary>
760760
public Task<PostJobDataResponse> PostJobDataAsync(IPostJobDataRequest request, CancellationToken ct = default) => DoRequestAsync<IPostJobDataRequest, PostJobDataResponse>(request, request.RequestParameters, ct);
761761
/// <summary>
762-
/// <c>GET</c> request to the <c>ml.preview_datafeed</c> API, read more about this API online:
762+
/// <c>POST</c> request to the <c>ml.preview_datafeed</c> API, read more about this API online:
763763
/// <para></para>
764764
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html">https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html</a>
765765
/// </summary>
766-
public PreviewDatafeedResponse<TDocument> PreviewDatafeed<TDocument>(Id datafeedId, Func<PreviewDatafeedDescriptor, IPreviewDatafeedRequest> selector = null)
767-
where TDocument : class => PreviewDatafeed<TDocument>(selector.InvokeOrDefault(new PreviewDatafeedDescriptor(datafeedId: datafeedId)));
766+
public PreviewDatafeedResponse<TDocument> PreviewDatafeed<TDocument>(Func<PreviewDatafeedDescriptor, IPreviewDatafeedRequest> selector = null)
767+
where TDocument : class => PreviewDatafeed<TDocument>(selector.InvokeOrDefault(new PreviewDatafeedDescriptor()));
768768
/// <summary>
769-
/// <c>GET</c> request to the <c>ml.preview_datafeed</c> API, read more about this API online:
769+
/// <c>POST</c> request to the <c>ml.preview_datafeed</c> API, read more about this API online:
770770
/// <para></para>
771771
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html">https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html</a>
772772
/// </summary>
773-
public Task<PreviewDatafeedResponse<TDocument>> PreviewDatafeedAsync<TDocument>(Id datafeedId, Func<PreviewDatafeedDescriptor, IPreviewDatafeedRequest> selector = null, CancellationToken ct = default)
774-
where TDocument : class => PreviewDatafeedAsync<TDocument>(selector.InvokeOrDefault(new PreviewDatafeedDescriptor(datafeedId: datafeedId)), ct);
773+
public Task<PreviewDatafeedResponse<TDocument>> PreviewDatafeedAsync<TDocument>(Func<PreviewDatafeedDescriptor, IPreviewDatafeedRequest> selector = null, CancellationToken ct = default)
774+
where TDocument : class => PreviewDatafeedAsync<TDocument>(selector.InvokeOrDefault(new PreviewDatafeedDescriptor()), ct);
775775
/// <summary>
776-
/// <c>GET</c> request to the <c>ml.preview_datafeed</c> API, read more about this API online:
776+
/// <c>POST</c> request to the <c>ml.preview_datafeed</c> API, read more about this API online:
777777
/// <para></para>
778778
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html">https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html</a>
779779
/// </summary>
780780
public PreviewDatafeedResponse<TDocument> PreviewDatafeed<TDocument>(IPreviewDatafeedRequest request)
781781
where TDocument : class => DoRequest<IPreviewDatafeedRequest, PreviewDatafeedResponse<TDocument>>(request, ResponseBuilder(request.RequestParameters, PreviewDatafeedResponseBuilder<TDocument>.Instance));
782782
/// <summary>
783-
/// <c>GET</c> request to the <c>ml.preview_datafeed</c> API, read more about this API online:
783+
/// <c>POST</c> request to the <c>ml.preview_datafeed</c> API, read more about this API online:
784784
/// <para></para>
785785
/// <a href = "https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html">https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-preview-datafeed.html</a>
786786
/// </summary>

src/Nest/Requests.Cat.cs

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1160,6 +1160,13 @@ public bool? Help
11601160
set => Q("help", value);
11611161
}
11621162

1163+
///<summary>If set to true segment stats will include stats for segments that are not currently loaded into memory</summary>
1164+
public bool? IncludeUnloadedSegments
1165+
{
1166+
get => Q<bool? >("include_unloaded_segments");
1167+
set => Q("include_unloaded_segments", value);
1168+
}
1169+
11631170
///<summary>Calculate the selected nodes using the local cluster state rather than the state from master node (default: false)</summary>
11641171
[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.")]
11651172
public bool? Local

src/Nest/Requests.Cluster.cs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -83,7 +83,7 @@ public partial interface IClusterGetSettingsRequest : IRequest<ClusterGetSetting
8383
{
8484
}
8585

86-
///<summary>Request for GetSettings <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-update-settings.html</para></summary>
86+
///<summary>Request for GetSettings <para>https://www.elastic.co/guide/en/elasticsearch/reference/master/cluster-get-settings.html</para></summary>
8787
public partial class ClusterGetSettingsRequest : PlainRequestBase<ClusterGetSettingsRequestParameters>, IClusterGetSettingsRequest
8888
{
8989
protected IClusterGetSettingsRequest Self => this;

src/Nest/Requests.Indices.cs

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -356,7 +356,10 @@ public Time Timeout
356356
set => Q("timeout", value);
357357
}
358358

359-
///<summary>Sets the number of active shards to wait for before the operation returns.</summary>
359+
///<summary>
360+
/// Sets the number of active shards to wait for before the operation returns. Set to `index-setting` to wait according to the index setting
361+
/// `index.write.wait_for_active_shards`, or `all` to wait for all shards, or an integer. Defaults to `0`.
362+
///</summary>
360363
public string WaitForActiveShards
361364
{
362365
get => Q<string>("wait_for_active_shards");

src/Nest/Requests.Ingest.cs

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -113,6 +113,13 @@ public Time MasterTimeout
113113
get => Q<Time>("master_timeout");
114114
set => Q("master_timeout", value);
115115
}
116+
117+
///<summary>Return pipelines without their definitions (default: false)</summary>
118+
public bool? Summary
119+
{
120+
get => Q<bool? >("summary");
121+
set => Q("summary", value);
122+
}
116123
}
117124

118125
[InterfaceDataContract]

src/Nest/Requests.MachineLearning.cs

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1289,14 +1289,13 @@ public partial class PreviewDatafeedRequest : PlainRequestBase<PreviewDatafeedRe
12891289
protected IPreviewDatafeedRequest Self => this;
12901290
internal override ApiUrls ApiUrls => ApiUrlsLookups.MachineLearningPreviewDatafeed;
12911291
///<summary>/_ml/datafeeds/{datafeed_id}/_preview</summary>
1292-
///<param name = "datafeedId">this parameter is required</param>
1293-
public PreviewDatafeedRequest(Id datafeedId): base(r => r.Required("datafeed_id", datafeedId))
1292+
///<param name = "datafeedId">Optional, accepts null</param>
1293+
public PreviewDatafeedRequest(Id datafeedId): base(r => r.Optional("datafeed_id", datafeedId))
12941294
{
12951295
}
12961296

1297-
///<summary>Used for serialization purposes, making sure we have a parameterless constructor</summary>
1298-
[SerializationConstructor]
1299-
protected PreviewDatafeedRequest(): base()
1297+
///<summary>/_ml/datafeeds/_preview</summary>
1298+
public PreviewDatafeedRequest(): base()
13001299
{
13011300
}
13021301

src/Nest/Requests.NoNamespace.cs

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2825,6 +2825,13 @@ public long? MaxConcurrentShardRequests
28252825
set => Q("max_concurrent_shard_requests", value);
28262826
}
28272827

2828+
///<summary>The minimum compatible version that all shards involved in search should have for this request to be successful</summary>
2829+
public string MinCompatibleShardNode
2830+
{
2831+
get => Q<string>("min_compatible_shard_node");
2832+
set => Q("min_compatible_shard_node", value);
2833+
}
2834+
28282835
///<summary>
28292836
/// A threshold that enforces a pre-filter roundtrip to prefilter search shards based on query rewriting if the number of shards the search
28302837
/// request expands to exceeds the threshold. This filter roundtrip can limit the number of shards significantly if for instance a shard can

src/Nest/Requests.Nodes.cs

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -317,6 +317,13 @@ public bool? IncludeSegmentFileSizes
317317
set => Q("include_segment_file_sizes", value);
318318
}
319319

320+
///<summary>If set to true segment stats will include stats for segments that are not currently loaded into memory</summary>
321+
public bool? IncludeUnloadedSegments
322+
{
323+
get => Q<bool? >("include_unloaded_segments");
324+
set => Q("include_unloaded_segments", value);
325+
}
326+
320327
///<summary>Return indices stats aggregated at index, node or shard level</summary>
321328
public Level? Level
322329
{

src/Nest/Requests.Snapshot.cs

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -383,6 +383,13 @@ public bool? IgnoreUnavailable
383383
set => Q("ignore_unavailable", value);
384384
}
385385

386+
///<summary>Whether to include details of each index in the snapshot, if those details are available. Defaults to false.</summary>
387+
public bool? IndexDetails
388+
{
389+
get => Q<bool? >("index_details");
390+
set => Q("index_details", value);
391+
}
392+
386393
///<summary>Explicit operation timeout for connection to master node</summary>
387394
public Time MasterTimeout
388395
{

0 commit comments

Comments
 (0)