Re-generate cat.nodes

Signed-off-by: Thomas Farr <[email protected]>

src/ApiGenerator/Configuration/CodeConfiguration.cs

@@ -52,6 +52,7 @@ public static class CodeConfiguration
 			new("cat.indices"),
 			new("cat.master"),
 			new("cat.nodeattrs"),
+			new("cat.nodes"),
 
 			new("cluster.*"),
 			new("dangling_indices.*"),

src/OpenSearch.Client/ApiUrlsLookup.cs

@@ -46,7 +46,6 @@ namespace OpenSearch.Client
 	internal static partial class ApiUrlsLookups
 	{
 		internal static ApiUrls NoNamespaceBulk = new ApiUrls(new[]{"_bulk", "{index}/_bulk"});
-		internal static ApiUrls CatNodes = new ApiUrls(new[]{"_cat/nodes"});
 		internal static ApiUrls CatPendingTasks = new ApiUrls(new[]{"_cat/pending_tasks"});
 		internal static ApiUrls CatPlugins = new ApiUrls(new[]{"_cat/plugins"});
 		internal static ApiUrls CatRecovery = new ApiUrls(new[]{"_cat/recovery", "_cat/recovery/{index}"});

src/OpenSearch.Client/Descriptors.Cat.cs

@@ -57,34 +57,6 @@
 // ReSharper disable RedundantNameQualifier
 namespace OpenSearch.Client
 {
-	///<summary>Descriptor for Nodes <para>https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/</para></summary>
-	public partial class CatNodesDescriptor : RequestDescriptorBase<CatNodesDescriptor, CatNodesRequestParameters, ICatNodesRequest>, ICatNodesRequest
-	{
-		internal override ApiUrls ApiUrls => ApiUrlsLookups.CatNodes;
-		// values part of the url path
-		// Request parameters
-		///<summary>The unit in which to display byte values</summary>
-		public CatNodesDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes);
-		///<summary>a short version of the Accept header, e.g. json, yaml</summary>
-		public CatNodesDescriptor Format(string format) => Qs("format", format);
-		///<summary>Return the full node ID instead of the shortened version (default: false)</summary>
-		public CatNodesDescriptor FullId(bool? fullid = true) => Qs("full_id", fullid);
-		///<summary>Comma-separated list of column names to display</summary>
-		public CatNodesDescriptor Headers(params string[] headers) => Qs("h", headers);
-		///<summary>Return help information</summary>
-		public CatNodesDescriptor Help(bool? help = true) => Qs("help", help);
-		///<summary>Explicit operation timeout for connection to master node</summary>
-		///<remarks>Deprecated as of OpenSearch 2.0, use <see cref="ClusterManagerTimeout"/> instead</remarks>
-		public CatNodesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout);
-		///<summary>Explicit operation timeout for connection to cluster_manager node</summary>
-		///<remarks>Introduced in OpenSearch 2.0 instead of <see cref="MasterTimeout"/></remarks>
-		public CatNodesDescriptor ClusterManagerTimeout(Time timeout) => Qs("cluster_manager_timeout", timeout);
-		///<summary>Comma-separated list of column names or column aliases to sort by</summary>
-		public CatNodesDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns);
-		///<summary>Verbose mode. Display column headers</summary>
-		public CatNodesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose);
-	}
-
 	///<summary>Descriptor for PendingTasks <para>https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-pending-tasks/</para></summary>
 	public partial class CatPendingTasksDescriptor : RequestDescriptorBase<CatPendingTasksDescriptor, CatPendingTasksRequestParameters, ICatPendingTasksRequest>, ICatPendingTasksRequest
 	{

src/OpenSearch.Client/OpenSearchClient.Cat.cs

@@ -59,30 +59,6 @@ namespace OpenSearch.Client.Specification.CatApi
 	///</summary>
 	public partial class CatNamespace : NamespacedClientProxy
 	{
-		/// <summary>
-		/// <c>GET</c> request to the <c>cat.nodes</c> API, read more about this API online:
-		/// <para></para>
-		/// <a href = "https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/">https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/</a>
-		/// </summary>
-		public CatResponse<CatNodesRecord> Nodes(Func<CatNodesDescriptor, ICatNodesRequest> selector = null) => Nodes(selector.InvokeOrDefault(new CatNodesDescriptor()));
-		/// <summary>
-		/// <c>GET</c> request to the <c>cat.nodes</c> API, read more about this API online:
-		/// <para></para>
-		/// <a href = "https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/">https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/</a>
-		/// </summary>
-		public Task<CatResponse<CatNodesRecord>> NodesAsync(Func<CatNodesDescriptor, ICatNodesRequest> selector = null, CancellationToken ct = default) => NodesAsync(selector.InvokeOrDefault(new CatNodesDescriptor()), ct);
-		/// <summary>
-		/// <c>GET</c> request to the <c>cat.nodes</c> API, read more about this API online:
-		/// <para></para>
-		/// <a href = "https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/">https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/</a>
-		/// </summary>
-		public CatResponse<CatNodesRecord> Nodes(ICatNodesRequest request) => DoCat<ICatNodesRequest, CatNodesRequestParameters, CatNodesRecord>(request);
-		/// <summary>
-		/// <c>GET</c> request to the <c>cat.nodes</c> API, read more about this API online:
-		/// <para></para>
-		/// <a href = "https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/">https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/</a>
-		/// </summary>
-		public Task<CatResponse<CatNodesRecord>> NodesAsync(ICatNodesRequest request, CancellationToken ct = default) => DoCatAsync<ICatNodesRequest, CatNodesRequestParameters, CatNodesRecord>(request, ct);
 		/// <summary>
 		/// <c>GET</c> request to the <c>cat.pending_tasks</c> API, read more about this API online:
 		/// <para></para>

src/OpenSearch.Client/Requests.Cat.cs

@@ -58,88 +58,6 @@
 // ReSharper disable RedundantNameQualifier
 namespace OpenSearch.Client
 {
-	[InterfaceDataContract]
-	public partial interface ICatNodesRequest : IRequest<CatNodesRequestParameters>
-	{
-	}
-
-	///<summary>Request for Nodes <para>https://opensearch.org/docs/latest/opensearch/rest-api/cat/cat-nodes/</para></summary>
-	public partial class CatNodesRequest : PlainRequestBase<CatNodesRequestParameters>, ICatNodesRequest
-	{
-		protected ICatNodesRequest Self => this;
-		internal override ApiUrls ApiUrls => ApiUrlsLookups.CatNodes;
-		// values part of the url path
-		// Request parameters
-		///<summary>The unit in which to display byte values</summary>
-		public Bytes? Bytes
-		{
-			get => Q<Bytes? >("bytes");
-			set => Q("bytes", value);
-		}
-
-		///<summary>a short version of the Accept header, e.g. json, yaml</summary>
-		public string Format
-		{
-			get => Q<string>("format");
-			set
-			{
-				Q("format", value);
-				SetAcceptHeader(value);
-			}
-		}
-
-		///<summary>Return the full node ID instead of the shortened version (default: false)</summary>
-		public bool? FullId
-		{
-			get => Q<bool? >("full_id");
-			set => Q("full_id", value);
-		}
-
-		///<summary>Comma-separated list of column names to display</summary>
-		public string[] Headers
-		{
-			get => Q<string[]>("h");
-			set => Q("h", value);
-		}
-
-		///<summary>Return help information</summary>
-		public bool? Help
-		{
-			get => Q<bool? >("help");
-			set => Q("help", value);
-		}
-
-		///<summary>Explicit operation timeout for connection to master node</summary>
-		///<remarks>Deprecated as of OpenSearch 2.0, use <see cref="ClusterManagerTimeout"/> instead</remarks>
-		public Time MasterTimeout
-		{
-			get => Q<Time>("master_timeout");
-			set => Q("master_timeout", value);
-		}
-
-		///<summary>Explicit operation timeout for connection to cluster_manager node</summary>
-		///<remarks>Introduced in OpenSearch 2.0 instead of <see cref="MasterTimeout"/></remarks>
-		public Time ClusterManagerTimeout
-		{
-			get => Q<Time>("cluster_manager_timeout");
-			set => Q("cluster_manager_timeout", value);
-		}
-
-		///<summary>Comma-separated list of column names or column aliases to sort by</summary>
-		public string[] SortByColumns
-		{
-			get => Q<string[]>("s");
-			set => Q("s", value);
-		}
-
-		///<summary>Verbose mode. Display column headers</summary>
-		public bool? Verbose
-		{
-			get => Q<bool? >("v");
-			set => Q("v", value);
-		}
-	}
-
 	[InterfaceDataContract]
 	public partial interface ICatPendingTasksRequest : IRequest<CatPendingTasksRequestParameters>
 	{

src/OpenSearch.Client/_Generated/ApiUrlsLookup.cs

@@ -70,6 +70,8 @@ internal static partial class ApiUrlsLookups
 
         internal static readonly ApiUrls CatNodeAttributes = new(new[] { "_cat/nodeattrs" });
 
+        internal static readonly ApiUrls CatNodes = new(new[] { "_cat/nodes" });
+
         internal static readonly ApiUrls ClusterAllocationExplain =
             new(new[] { "_cluster/allocation/explain" });
 

src/OpenSearch.Client/_Generated/Descriptors.Cat.cs

@@ -535,4 +535,54 @@ public CatNodeAttributesDescriptor SortByColumns(params string[] sortbycolumns)
         /// <summary>Verbose mode. Display column headers.</summary>
         public CatNodeAttributesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose);
     }
+
+    /// <summary>Descriptor for Nodes <para>https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/</para></summary>
+    public partial class CatNodesDescriptor
+        : RequestDescriptorBase<CatNodesDescriptor, CatNodesRequestParameters, ICatNodesRequest>,
+            ICatNodesRequest
+    {
+        internal override ApiUrls ApiUrls => ApiUrlsLookups.CatNodes;
+
+        // values part of the url path
+        // Request parameters
+        /// <summary>The unit in which to display byte values.</summary>
+        public CatNodesDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes);
+
+        /// <summary>Operation timeout for connection to cluster-manager node.</summary>
+        /// <remarks>Supported by OpenSearch servers of version 2.0.0 or greater.</remarks>
+        public CatNodesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) =>
+            Qs("cluster_manager_timeout", clustermanagertimeout);
+
+        /// <summary>A short version of the Accept header, e.g. json, yaml.</summary>
+        public CatNodesDescriptor Format(string format) => Qs("format", format);
+
+        /// <summary>Return the full node ID instead of the shortened version.</summary>
+        public CatNodesDescriptor FullId(bool? fullid = true) => Qs("full_id", fullid);
+
+        /// <summary>Comma-separated list of column names to display.</summary>
+        public CatNodesDescriptor Headers(params string[] headers) => Qs("h", headers);
+
+        /// <summary>Return help information.</summary>
+        public CatNodesDescriptor Help(bool? help = true) => Qs("help", help);
+
+        /// <summary>Return local information, do not retrieve the state from cluster-manager node.</summary>
+        [Obsolete(
+            "Deprecated as of: 1.0, reason: This parameter does not cause this API to act locally."
+        )]
+        public CatNodesDescriptor Local(bool? local = true) => Qs("local", local);
+
+        /// <summary>Operation timeout for connection to master node.</summary>
+        [Obsolete(
+            "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead."
+        )]
+        public CatNodesDescriptor MasterTimeout(Time mastertimeout) =>
+            Qs("master_timeout", mastertimeout);
+
+        /// <summary>Comma-separated list of column names or column aliases to sort by.</summary>
+        public CatNodesDescriptor SortByColumns(params string[] sortbycolumns) =>
+            Qs("s", sortbycolumns);
+
+        /// <summary>Verbose mode. Display column headers.</summary>
+        public CatNodesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose);
+    }
 }

src/OpenSearch.Client/_Generated/OpenSearchClient.Cat.cs

@@ -489,5 +489,42 @@ public Task<CatResponse<CatNodeAttributesRecord>> NodeAttributesAsync(
                 CatNodeAttributesRequestParameters,
                 CatNodeAttributesRecord
             >(request, ct);
+
+        /// <summary>
+        /// <c>GET</c> request to the <c>cat.nodes</c> API, read more about this API online:
+        /// <para></para>
+        /// <a href="https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/">https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/</a>
+        /// </summary>
+        public CatResponse<CatNodesRecord> Nodes(
+            Func<CatNodesDescriptor, ICatNodesRequest> selector = null
+        ) => Nodes(selector.InvokeOrDefault(new CatNodesDescriptor()));
+
+        /// <summary>
+        /// <c>GET</c> request to the <c>cat.nodes</c> API, read more about this API online:
+        /// <para></para>
+        /// <a href="https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/">https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/</a>
+        /// </summary>
+        public Task<CatResponse<CatNodesRecord>> NodesAsync(
+            Func<CatNodesDescriptor, ICatNodesRequest> selector = null,
+            CancellationToken ct = default
+        ) => NodesAsync(selector.InvokeOrDefault(new CatNodesDescriptor()), ct);
+
+        /// <summary>
+        /// <c>GET</c> request to the <c>cat.nodes</c> API, read more about this API online:
+        /// <para></para>
+        /// <a href="https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/">https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/</a>
+        /// </summary>
+        public CatResponse<CatNodesRecord> Nodes(ICatNodesRequest request) =>
+            DoCat<ICatNodesRequest, CatNodesRequestParameters, CatNodesRecord>(request);
+
+        /// <summary>
+        /// <c>GET</c> request to the <c>cat.nodes</c> API, read more about this API online:
+        /// <para></para>
+        /// <a href="https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/">https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/</a>
+        /// </summary>
+        public Task<CatResponse<CatNodesRecord>> NodesAsync(
+            ICatNodesRequest request,
+            CancellationToken ct = default
+        ) => DoCatAsync<ICatNodesRequest, CatNodesRequestParameters, CatNodesRecord>(request, ct);
     }
 }

src/OpenSearch.Client/_Generated/Requests.Cat.cs

@@ -844,4 +844,100 @@ public bool? Verbose
             set => Q("v", value);
         }
     }
+
+    [InterfaceDataContract]
+    public partial interface ICatNodesRequest : IRequest<CatNodesRequestParameters> { }
+
+    /// <summary>Request for Nodes <para>https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/</para></summary>
+    public partial class CatNodesRequest
+        : PlainRequestBase<CatNodesRequestParameters>,
+            ICatNodesRequest
+    {
+        protected ICatNodesRequest Self => this;
+        internal override ApiUrls ApiUrls => ApiUrlsLookups.CatNodes;
+
+        // values part of the url path
+
+        // Request parameters
+        /// <summary>The unit in which to display byte values.</summary>
+        public Bytes? Bytes
+        {
+            get => Q<Bytes?>("bytes");
+            set => Q("bytes", value);
+        }
+
+        /// <summary>Operation timeout for connection to cluster-manager node.</summary>
+        /// <remarks>Supported by OpenSearch servers of version 2.0.0 or greater.</remarks>
+        public Time ClusterManagerTimeout
+        {
+            get => Q<Time>("cluster_manager_timeout");
+            set => Q("cluster_manager_timeout", value);
+        }
+
+        /// <summary>A short version of the Accept header, e.g. json, yaml.</summary>
+        public string Format
+        {
+            get => Q<string>("format");
+            set
+            {
+                Q("format", value);
+                SetAcceptHeader(value);
+            }
+        }
+
+        /// <summary>Return the full node ID instead of the shortened version.</summary>
+        public bool? FullId
+        {
+            get => Q<bool?>("full_id");
+            set => Q("full_id", value);
+        }
+
+        /// <summary>Comma-separated list of column names to display.</summary>
+        public string[] Headers
+        {
+            get => Q<string[]>("h");
+            set => Q("h", value);
+        }
+
+        /// <summary>Return help information.</summary>
+        public bool? Help
+        {
+            get => Q<bool?>("help");
+            set => Q("help", value);
+        }
+
+        /// <summary>Return local information, do not retrieve the state from cluster-manager node.</summary>
+        [Obsolete(
+            "Deprecated as of: 1.0, reason: This parameter does not cause this API to act locally."
+        )]
+        public bool? Local
+        {
+            get => Q<bool?>("local");
+            set => Q("local", value);
+        }
+
+        /// <summary>Operation timeout for connection to master node.</summary>
+        [Obsolete(
+            "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead."
+        )]
+        public Time MasterTimeout
+        {
+            get => Q<Time>("master_timeout");
+            set => Q("master_timeout", value);
+        }
+
+        /// <summary>Comma-separated list of column names or column aliases to sort by.</summary>
+        public string[] SortByColumns
+        {
+            get => Q<string[]>("s");
+            set => Q("s", value);
+        }
+
+        /// <summary>Verbose mode. Display column headers.</summary>
+        public bool? Verbose
+        {
+            get => Q<bool?>("v");
+            set => Q("v", value);
+        }
+    }
 }