5.5 (#2807)

* Code generation of elasticsearch's 5.5 branch

* Update existing XPack API spec files

* Add ml xpack api spec and new security endpoints

* Add CRUD support for the new role mapping security API's

* Add support for security token API's

* fix failing codestandards tests after implementing xpack security 5.5 new features

* fix overal bg_count now gets returned for sig_terms

* fix stats matrix now also returns overal doc_count

* fix change in GetAlias behavior, since 5.5 now returns 404 when some aliases suplied are not found

* Sampler agg test for bg count should only be asserted 5.5.0 and up

* Array.Empty not available for .NET 4.5

* Add force + operation_threading to RefreshRequest

Removed in REST API spec elastic/elasticsearch#25234 - patched in to maintain binary compatibility

* Set tests.default.yaml ES version to 5.5.0

* Update XML comments for LazyDocument

* Minor language tweaks

* Fix spelling

* update SkipVersion for PutRoleMapping to <5.5.0

Author: Mpdreamz

build/Clients.Common.targets

@@ -28,6 +28,7 @@
     <Prefer32Bit>false</Prefer32Bit>
     <DefineConstants Condition="'$(TargetFramework)'=='netstandard1.3' OR '$(DotNetCoreOnly)'=='1'">$(DefineConstants);DOTNETCORE</DefineConstants>
     <DebugType Condition="'$(DotNetCoreOnly)'==''">embedded</DebugType>
+    <DebugType Condition="'$(Configuration)'=='Debug'">full</DebugType>
     <SourceLink Condition="'$(DoSourceLink)'!=''">$(BaseIntermediateOutputPath)\sl-$(MsBuildProjectName)-$(TargetFramework).json</SourceLink>
     <RepoUri>https://raw.githubusercontent.com/elastic/elasticsearch-net</RepoUri>
   </PropertyGroup>

src/CodeGeneration/ApiGenerator/ApiGenerator.csproj

@@ -15,5 +15,6 @@
   </ItemGroup>
   <ItemGroup>
     <Folder Include="RestSpecification\XPack\Info" />
+    <Folder Include="RestSpecification\XPack\MachineLearning" />
   </ItemGroup>
 </Project>

src/CodeGeneration/ApiGenerator/Overrides/Descriptors/RefreshDescriptorOverrides.cs

@@ -0,0 +1,23 @@
+using ApiGenerator.Domain;
+
+namespace ApiGenerator.Overrides.Descriptors
+{
+	public class RefreshDescriptorOverrides : DescriptorOverridesBase
+	{
+		public override CsharpMethod PatchMethod(CsharpMethod method)
+		{
+			method.Url.Params.Add("force", new NoopApiQueryParameters() { Type = "boolean" });
+			method.Url.Params.Add("operation_threading", new NoopApiQueryParameters());
+			return method;
+		}
+
+		private class NoopApiQueryParameters : ApiQueryParameters
+		{
+			public NoopApiQueryParameters()
+			{
+				this.Obsolete = "calling this is a noop";
+				this.FluentGenerator = (queryStringParamName, mm, original, setter) => $"public {queryStringParamName} {mm.ToPascalCase()}({CsharpType(mm)} {mm}) => this;";
+			}
+		}
+	}
+}

src/CodeGeneration/ApiGenerator/RestSpecification/Core/exists_source.json

@@ -1,6 +1,6 @@
 {
   "exists_source": {
-    "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/docs-get.html",
+    "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/5.5/docs-get.html",
     "methods": ["HEAD"],
     "url": {
       "path": "/{index}/{type}/{id}/_source",

src/CodeGeneration/ApiGenerator/RestSpecification/Core/field_caps.json

@@ -1,6 +1,6 @@
 {
   "field_caps": {
-    "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/search-field-caps.html",
+    "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/5.5/search-field-caps.html",
     "methods": ["GET", "POST"],
     "url": {
       "path": "/_field_caps",

src/CodeGeneration/ApiGenerator/RestSpecification/Core/indices.refresh.json

@@ -25,14 +25,6 @@
             "options" : ["open","closed","none","all"],
             "default" : "open",
             "description" : "Whether to expand wildcard expression to concrete indices that are open, closed or both."
-        },
-        "force": {
-            "type" : "boolean",
-            "description" : "Force a refresh even if not required",
-            "default": false
-        },
-        "operation_threading": {
-          "description" : "TODO: ?"
         }
       }
     },

src/CodeGeneration/ApiGenerator/RestSpecification/Core/msearch_template.json

@@ -24,6 +24,10 @@
         "typed_keys": {
           "type" : "boolean",
           "description" : "Specify whether aggregation and suggester names should be prefixed by their respective types in the response"
+        },
+        "max_concurrent_searches" : {
+          "type" : "number",
+          "description" : "Controls the maximum number of concurrent searches the multi search api will execute"
         }
       }
     },

src/CodeGeneration/ApiGenerator/RestSpecification/Core/remote.info.json

@@ -1,6 +1,6 @@
 {
   "remote.info": {
-    "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/master/remote-info.html",
+    "documentation": "http://www.elastic.co/guide/en/elasticsearch/reference/5.5/cluster-remote-info.html",
     "methods": ["GET"],
     "url": {
       "path": "/_remote/info",

src/CodeGeneration/ApiGenerator/RestSpecification/Core/root.html

@@ -25,6 +25,10 @@
         "ignore_unavailable": {
           "type": "boolean",
           "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown"
+        },
+        "verbose": {
+          "type": "boolean",
+          "description": "Whether to show verbose snapshot info or only show the basic info found in the repository index blob"
         }
       }
     },