diff --git a/.editorconfig b/.editorconfig index 9968717e38..63a79b9250 100644 --- a/.editorconfig +++ b/.editorconfig @@ -3,31 +3,19 @@ root=true [*] charset = utf-8 end_of_line = lf -indent_style = tab -indent_size = 4 -insert_final_newline=true - -[*.cs] -trim_trailing_whitespace=true - -[*.cshtml] -indent_style = tab -indent_size = 4 - -[*.{fs,fsx}] indent_style = space indent_size = 4 +insert_final_newline=true [*.yml] -indent_style = space indent_size = 2 -[*.{md,markdown,json,js,csproj,fsproj,targets,targets,props}] -indent_style = space +[*.{md,markdown,json,js,csproj,fsproj,targets,props}] indent_size = 2 # Dotnet code style settings: [*.{cs,vb}] +trim_trailing_whitespace = true # --- # naming conventions https://docs.microsoft.com/en-us/visualstudio/ide/editorconfig-naming-conventions @@ -171,7 +159,7 @@ csharp_new_line_before_else = true csharp_new_line_before_catch = true csharp_new_line_before_finally = true csharp_new_line_before_members_in_object_initializers = true -# just a suggestion do to our JSON tests that use anonymous types to +# just a suggestion do to our JSON tests that use anonymous types to # represent json quite a bit (makes copy paste easier). csharp_new_line_before_members_in_anonymous_types = true csharp_new_line_between_query_expression_clauses = true diff --git a/src/ApiGenerator/ApiGenerator.csproj b/src/ApiGenerator/ApiGenerator.csproj index 25b9546a0e..64ed0d5220 100644 --- a/src/ApiGenerator/ApiGenerator.csproj +++ b/src/ApiGenerator/ApiGenerator.csproj @@ -4,7 +4,7 @@ Exe net6.0 false - + CS1591;NU1701 true @@ -12,7 +12,8 @@ - + + diff --git a/src/ApiGenerator/Configuration/GeneratorLocations.cs b/src/ApiGenerator/Configuration/GeneratorLocations.cs index f97b7d80df..8032c3df93 100644 --- a/src/ApiGenerator/Configuration/GeneratorLocations.cs +++ b/src/ApiGenerator/Configuration/GeneratorLocations.cs @@ -31,44 +31,42 @@ namespace ApiGenerator.Configuration { - public static class GeneratorLocations - { - // @formatter:off — disable formatter after this line - public static string OpenApiSpecFile { get; } = $@"{Root}OpenSearch.openapi.json"; + public static class GeneratorLocations + { + public static string OpenApiSpecFile { get; } = $"{Root}opensearch-openapi.yaml"; - public static string OpenSearchNetFolder { get; } = $@"{Root}../../src/OpenSearch.Net/"; + public static string OpenSearchNetFolder { get; } = $"{Root}../../src/OpenSearch.Net/"; - public static string OpenSearchClientFolder { get; } = $@"{Root}../../src/OpenSearch.Client/"; + public static string OpenSearchClientFolder { get; } = $"{Root}../../src/OpenSearch.Client/"; public static string LowLevelGeneratedFolder { get; } = $"{OpenSearchNetFolder}_Generated/"; public static string HighLevelGeneratedFolder { get; } = $"{OpenSearchClientFolder}_Generated/"; - // @formatter:on — enable formatter after this line + public static string HighLevel(params string[] paths) => HighLevelGeneratedFolder + string.Join("/", paths); - public static string HighLevel(params string[] paths) => HighLevelGeneratedFolder + string.Join("/", paths); - public static string LowLevel(params string[] paths) => LowLevelGeneratedFolder + string.Join("/", paths); + public static string LowLevel(params string[] paths) => LowLevelGeneratedFolder + string.Join("/", paths); - public static readonly Assembly Assembly = typeof(Generator.ApiGenerator).Assembly; + public static readonly Assembly Assembly = typeof(Generator.ApiGenerator).Assembly; - private static string _root; - public static string Root - { - get - { - if (_root != null) return _root; + private static string _root; - var directoryInfo = new DirectoryInfo(Directory.GetCurrentDirectory()); + public static string Root + { + get + { + if (_root != null) return _root; - var dotnetRun = - directoryInfo.Name == "ApiGenerator" && - directoryInfo.Parent != null && - directoryInfo.Parent.Name == "src"; + var directoryInfo = new DirectoryInfo(Directory.GetCurrentDirectory()); - _root = dotnetRun ? "" : @"../../../"; - return _root; - } - } + var dotnetRun = + directoryInfo.Name == "ApiGenerator" && + directoryInfo.Parent != null && + directoryInfo.Parent.Name == "src"; - } + _root = dotnetRun ? "" : "../../../"; + return _root; + } + } + } } diff --git a/src/ApiGenerator/Configuration/Overrides/GlobalOverrides.cs b/src/ApiGenerator/Configuration/Overrides/GlobalOverrides.cs index 22fa44eb5e..f543df3231 100644 --- a/src/ApiGenerator/Configuration/Overrides/GlobalOverrides.cs +++ b/src/ApiGenerator/Configuration/Overrides/GlobalOverrides.cs @@ -36,10 +36,10 @@ public class GlobalOverrides : EndpointOverridesBase private GlobalOverrides() { } - public IDictionary> ObsoleteEnumMembers { get; set; } = new Dictionary>() - { - { "VersionType", new Dictionary() { { "force", "Force is no longer accepted by the server as of 7.5.0 and will result in an error when used" } } } - }; + public IDictionary RenameEnums { get; } = new Dictionary + { + { "ExpandWildcard", "ExpandWildcards" } + }; public override IDictionary ObsoleteQueryStringParams { get; set; } = new Dictionary { diff --git a/src/ApiGenerator/Domain/ApiRequestParametersPatcher.cs b/src/ApiGenerator/Domain/ApiRequestParametersPatcher.cs index e4be8819ac..94eba43012 100644 --- a/src/ApiGenerator/Domain/ApiRequestParametersPatcher.cs +++ b/src/ApiGenerator/Domain/ApiRequestParametersPatcher.cs @@ -97,18 +97,8 @@ private static string CreateCSharpName(string queryStringKey, string endpointNam if (queryStringKey == "format" && endpointName == "text_structure.find_structure") return "TextStructureFindStructureFormat"; - var cased = queryStringKey.ToPascalCase(); - switch (cased) - { - case "Type": - case "Index": - case "Source": - case "Script": - return cased + "QueryString"; - default: - return cased; - } - } + return queryStringKey.ToPascalCase(); + } private static IList CreateSkipList(IEndpointOverrides local, ICollection declaredKeys) => CreateList(local, "skip", e => e.SkipQueryStringParams, declaredKeys); diff --git a/src/ApiGenerator/Domain/Code/CsharpNames.cs b/src/ApiGenerator/Domain/Code/CsharpNames.cs index 46a77cbabe..ea9b23d2ea 100644 --- a/src/ApiGenerator/Domain/Code/CsharpNames.cs +++ b/src/ApiGenerator/Domain/Code/CsharpNames.cs @@ -30,6 +30,7 @@ using System.Collections.Generic; using System.Linq; using ApiGenerator.Configuration; +using ApiGenerator.Configuration.Overrides; using ApiGenerator.Generator; namespace ApiGenerator.Domain.Code @@ -103,6 +104,7 @@ public string ResponseName public const string LowLevelClientNamespacePrefix = "LowLevel"; public const string HighLevelClientNamespacePrefix = ""; public const string ClientNamespaceSuffix = "Namespace"; + private static string CreateCSharpNamespace(string endpointNamespace) { switch (endpointNamespace) @@ -203,5 +205,12 @@ public string GenericOrNonGenericResponseName : RequestName; public bool CustomResponseBuilderPerRequestOverride(out string call) => CodeConfiguration.ResponseBuilderInClientCalls.TryGetValue(RequestName, out call); + + public static string GetEnumName(string schemaKey) + { + var enumName = schemaKey.Replace("_common", "").SplitPascalCase().ToPascalCase(); + if (GlobalOverrides.Instance.RenameEnums.TryGetValue(enumName, out var renamed)) enumName = renamed; + return enumName; + } } } diff --git a/src/ApiGenerator/Domain/RestApiSpec.cs b/src/ApiGenerator/Domain/RestApiSpec.cs index 042910cefb..47568fa6a2 100644 --- a/src/ApiGenerator/Domain/RestApiSpec.cs +++ b/src/ApiGenerator/Domain/RestApiSpec.cs @@ -38,6 +38,7 @@ namespace ApiGenerator.Domain public class EnumDescription { public string Name { get; set; } + public bool IsFlag { get; set; } public IEnumerable Options { get; set; } } @@ -55,48 +56,6 @@ public class RestApiSpec .GroupBy(e => e.CsharpNames.Namespace) .ToImmutableSortedDictionary(kv => kv.Key, kv => kv.ToList().AsReadOnly()); - - private IEnumerable _enumDescriptions; - public IEnumerable EnumsInTheSpec - { - get - { - if (_enumDescriptions != null) return _enumDescriptions; - - var urlParameterEnums = Endpoints - .Values - .SelectMany(e => e.Url.Params.Values) - .Where(p => !p.Skip && p.Options != null && p.Options.Any()) - .Select(p => new EnumDescription - { - Name = p.ClsName, - Options = p.Options - }) - .ToList(); - - var urlPartEnums = Endpoints - .Values - .SelectMany(e => e.Url.Parts, (e, part) => new { e, part }) - .Where(p => p.part.Options != null && p.part.Options.Any()) - .Select(p => - { - var ns = p.e.CsharpNames.Namespace; - var m = p.e.CsharpNames.MethodName; - return new EnumDescription - { - Name = (!m.StartsWith(ns) ? ns : string.Empty) + m + p.part.Name.ToPascalCase(), - Options = p.part.Options - }; - }). - ToList(); - - _enumDescriptions = urlPartEnums - .Concat(urlParameterEnums) - .DistinctBy(e => e.Name) - .ToList(); - - return _enumDescriptions; - } - } + public ImmutableList EnumsInTheSpec { get; set; } } } diff --git a/src/ApiGenerator/Domain/Specification/QueryParameters.cs b/src/ApiGenerator/Domain/Specification/QueryParameters.cs index 71fae53ebd..e0a11b35ea 100644 --- a/src/ApiGenerator/Domain/Specification/QueryParameters.cs +++ b/src/ApiGenerator/Domain/Specification/QueryParameters.cs @@ -106,7 +106,6 @@ public string Obsolete public Deprecation Deprecated { get; set; } - public IEnumerable Options { get; set; } public string QueryStringKey { get; set; } public bool RenderPartial { get; set; } diff --git a/src/ApiGenerator/Domain/Specification/UrlPart.cs b/src/ApiGenerator/Domain/Specification/UrlPart.cs index 08a3d02089..4f3450af85 100644 --- a/src/ApiGenerator/Domain/Specification/UrlPart.cs +++ b/src/ApiGenerator/Domain/Specification/UrlPart.cs @@ -145,7 +145,6 @@ public string Description public string Name { get; set; } public string NameAsArgument => Name.ToCamelCase(); - public IEnumerable Options { get; set; } public bool Required { get; set; } public bool Deprecated { get; set; } public string Type { get; set; } diff --git a/src/ApiGenerator/Extensions.cs b/src/ApiGenerator/Extensions.cs index 9484b5b428..9062eeb15a 100644 --- a/src/ApiGenerator/Extensions.cs +++ b/src/ApiGenerator/Extensions.cs @@ -39,7 +39,7 @@ public static class Extensions /// /// Removes _ . but not an underscore at the start of the string, unless the string is _all or removeLeadingUnderscore == true. /// - private static readonly Regex RemovePunctuationExceptFirstUnderScore = new Regex(@"(?!^_(?!All$))[_\.]"); + private static readonly Regex RemovePunctuationExceptFirstUnderScore = new(@"(?!^_(?!All$))[_\-\.: ]"); public static IEnumerable DistinctBy(this IEnumerable items, Func property) => items.GroupBy(property).Select(x => x.First()); diff --git a/src/ApiGenerator/Generator/ApiEndpointFactory.cs b/src/ApiGenerator/Generator/ApiEndpointFactory.cs index bb6915f39f..76f7e1eed4 100644 --- a/src/ApiGenerator/Generator/ApiEndpointFactory.cs +++ b/src/ApiGenerator/Generator/ApiEndpointFactory.cs @@ -30,6 +30,7 @@ using System.Collections.Generic; using System.Linq; using System.Net.Mime; +using System.Text.RegularExpressions; using ApiGenerator.Configuration; using ApiGenerator.Configuration.Overrides; using ApiGenerator.Domain; @@ -42,49 +43,50 @@ namespace ApiGenerator.Generator { - public static class ApiEndpointFactory - { - public static ApiEndpoint From(string name, List<(string HttpPath, OpenApiPathItem Path, string HttpMethod, OpenApiOperation Operation)> variants) - { - var tokens = name.Split("."); - var methodName = tokens[^1]; - var ns = tokens.Length > 1 ? tokens[0] : null; + public static class ApiEndpointFactory + { + public static ApiEndpoint From( + string name, + List<(string HttpPath, OpenApiPathItem Path, string HttpMethod, OpenApiOperation Operation)> variants, + Action trackEnumToGenerate + ) + { + var tokens = name.Split("."); + var methodName = tokens[^1]; + var ns = tokens.Length > 1 ? tokens[0] : null; var names = new CsharpNames(name, methodName, ns); var overrides = LoadOverrides(name, names.MethodName); - HashSet requiredPathParts = null; - var allParts = new Dictionary(); + HashSet requiredPathParts = null; + var allParts = new Dictionary(); var canonicalPaths = new Dictionary, UrlPath>(HashSet.CreateSetComparer()); var deprecatedPaths = new Dictionary, UrlPath>(HashSet.CreateSetComparer()); - var overloads = new List<(UrlPath Path, List<(string From, string To)> Renames)>(); - foreach (var (httpPath, path, _, operation) in variants.DistinctBy(v => v.HttpPath)) + foreach (var (httpPath, path, _, operation) in variants.DistinctBy(v => v.HttpPath)) { var parts = new List(); var partNames = new HashSet(); - var overloadedParts = new List<(string From, string To)>(); foreach (var param in path.Parameters .Concat(operation.Parameters) + .Select(p => p.ActualParameter) .Where(p => p.Kind == OpenApiParameterKind.Path)) { var partName = param.Name; if (!allParts.TryGetValue(partName, out var part)) { + var type = GetOpenSearchType(param.Schema, trackEnumToGenerate); part = allParts[partName] = new UrlPart { ClrTypeNameOverride = null, Deprecated = param.IsDeprecated, - Description = param.Description, + Description = param.Description?.SanitizeDescription(), Name = partName, - Type = GetOpenSearchType(param.Schema), - Options = GetEnumOptions(param.Schema) + Type = type }; } partNames.Add(partName); parts.Add(part); - - if (param.Schema.XOverloadedParam() is {} overloadedParam) overloadedParts.Add((partName, overloadedParam)); } parts.SortBy(p => httpPath.IndexOf($"{{{p.Name}}}", StringComparison.Ordinal)); @@ -92,33 +94,18 @@ public static ApiEndpoint From(string name, List<(string HttpPath, OpenApiPathIt var urlPath = new UrlPath(httpPath, parts, GetDeprecation(operation), operation.XVersionAdded()); (urlPath.Deprecation == null ? canonicalPaths : deprecatedPaths).TryAdd(partNames, urlPath); - if (overloadedParts.Count > 0) - overloads.Add((urlPath, overloadedParts)); - if (requiredPathParts != null) - requiredPathParts.IntersectWith(partNames); - else - requiredPathParts = partNames; - } - - foreach (var (path, renames) in overloads) - { - foreach (var (from, to) in renames) - { - var newPath = path.Path.Replace($"{{{from}}}", $"{{{to}}}"); - var newParts = path.Parts.Select(p => p.Name == from ? allParts[to] : p).ToList(); - var newPartNames = newParts.Select(p => p.Name).ToHashSet(); - var newUrlPath = new UrlPath(newPath, newParts, path.Deprecation, path.VersionAdded); - (newUrlPath.Deprecation == null ? canonicalPaths : deprecatedPaths).TryAdd(newPartNames, newUrlPath); - } + requiredPathParts.IntersectWith(partNames); + else + requiredPathParts = partNames; } //some deprecated paths describe aliases to the canonical using the same path e.g - // PUT /{index}/_mapping/{type} - // PUT /{index}/{type}/_mappings - // - //The following routine dedups these occasions and prefers either the canonical path - //or the first duplicate deprecated path + // PUT /{index}/_mapping/{type} + // PUT /{index}/{type}/_mappings + // + //The following routine dedups these occasions and prefers either the canonical path + //or the first duplicate deprecated path var paths = canonicalPaths.Values .Concat(deprecatedPaths @@ -129,36 +116,30 @@ public static ApiEndpoint From(string name, List<(string HttpPath, OpenApiPathIt ApiRequestParametersPatcher.PatchUrlPaths(name, paths, overrides); paths.Sort((p1, p2) => p1.Parts - .Zip(p2.Parts) - .Select(t => string.Compare(t.First.Name, t.Second.Name, StringComparison.Ordinal)) - .SkipWhile(c => c == 0) - .FirstOrDefault()); - - // // now, check for and prefer deprecated URLs - // - // var finalPathsWithDeprecations = new List(_pathsWithDeprecation.Count); - // - // foreach (var path in _pathsWithDeprecation) - // { - // if (path.Deprecation is null && - // DeprecatedPaths.SingleOrDefault(p => p.Path.Equals(path.Path, StringComparison.OrdinalIgnoreCase)) is { } match) - // { - // finalPathsWithDeprecations.Add(new UrlPath(match, OriginalParts, Paths)); - // } - // else - // { - // finalPathsWithDeprecations.Add(path); - // } - // } + .Zip(p2.Parts) + .Select(t => string.Compare(t.First.Name, t.Second.Name, StringComparison.Ordinal)) + .SkipWhile(c => c == 0) + .FirstOrDefault()); foreach (var partName in requiredPathParts ?? Enumerable.Empty()) allParts[partName].Required = true; IDictionary queryParams = variants.SelectMany(v => v.Path.Parameters.Concat(v.Operation.Parameters)) + .Select(p => p.ActualParameter) .Where(p => p.Kind == OpenApiParameterKind.Query) .DistinctBy(p => p.Name) - .ToDictionary(p => p.Name, BuildQueryParam); + .ToDictionary(p => p.Name, p => BuildQueryParam(p, trackEnumToGenerate)); queryParams = ApiRequestParametersPatcher.PatchQueryParameters(name, queryParams, overrides); + Body body = null; + if (variants.Select(v => v.Operation.RequestBody).FirstOrDefault() is {} requestBody) + { + body = new Body + { + Description = GetDescription(requestBody)?.SanitizeDescription(), + Required = requestBody.IsRequired + }; + } + return new ApiEndpoint { Name = name, @@ -169,78 +150,89 @@ public static ApiEndpoint From(string name, List<(string HttpPath, OpenApiPathIt Stability = Stability.Stable, // TODO: for realsies OfficialDocumentationLink = new Documentation { - Description = variants[0].Operation.Description, + Description = variants[0].Operation.Description?.SanitizeDescription(), Url = variants[0].Operation.ExternalDocumentation?.Url }, - Url = new UrlInformation - { - AllPaths = paths, - Params = queryParams - }, - Body = variants - .Select(v => v.Operation.RequestBody) - .FirstOrDefault(b => b != null) is { } reqBody - ? new Body { Description = GetDescription(reqBody), Required = reqBody.IsRequired } - : null, + Url = new UrlInformation { AllPaths = paths, Params = queryParams }, + Body = body, HttpMethods = variants.Select(v => v.HttpMethod.ToString().ToUpper()).Distinct().ToList(), }; - } + } - private static IEndpointOverrides LoadOverrides(string endpointName, string methodName) - { - if (CodeConfiguration.ApiNameMapping.TryGetValue(endpointName, out var mapsApiMethodName)) - methodName = mapsApiMethodName; + private static IEndpointOverrides LoadOverrides(string endpointName, string methodName) + { + if (CodeConfiguration.ApiNameMapping.TryGetValue(endpointName, out var mapsApiMethodName)) + methodName = mapsApiMethodName; - var namespacePrefix = $"{typeof(GlobalOverrides).Namespace}.Endpoints."; - var typeName = $"{namespacePrefix}{methodName}Overrides"; - var type = GeneratorLocations.Assembly.GetType(typeName); + var namespacePrefix = $"{typeof(GlobalOverrides).Namespace}.Endpoints."; + var typeName = $"{namespacePrefix}{methodName}Overrides"; + var type = GeneratorLocations.Assembly.GetType(typeName); return type != null && Activator.CreateInstance(type) is IEndpointOverrides overrides ? overrides : null; } - private static QueryParameters BuildQueryParam(OpenApiParameter p) - { - var param = new QueryParameters - { - Type = GetOpenSearchType(p.Schema), - Description = p.Description, - Options = GetEnumOptions(p.Schema), - Deprecated = GetDeprecation(p.Schema), - VersionAdded = p.Schema.XVersionAdded(), - }; - - if (param.Type == "enum" && p.Schema.HasReference) - param.ClsName = ((IJsonReference)p.Schema).ReferencePath.Split('/').Last(); - - return param; - } + private static QueryParameters BuildQueryParam(OpenApiParameter p, Action trackEnumToGenerate) => + new() + { + Type = GetOpenSearchType(p.Schema, trackEnumToGenerate), + Description = p.Description?.SanitizeDescription(), + Deprecated = GetDeprecation(p) ?? GetDeprecation(p.ActualSchema), + VersionAdded = p.XVersionAdded(), + }; - private static string GetOpenSearchType(JsonSchema schema) + private static string GetOpenSearchType(JsonSchema schema, Action trackEnumToGenerate, bool isListContext = false) { + var schemaKey = ((IJsonReference)schema).ReferencePath?.Split('/').Last(); schema = schema.ActualSchema; - if (schema.XDataType() is {} dataType) + if (schema.OneOf is { Count: > 0 }) + { + var oneOf = schema.OneOf.ToArray(); + + if (oneOf.Length == 2) + { + var first = GetOpenSearchType(oneOf[0], trackEnumToGenerate); + var second = GetOpenSearchType(oneOf[1], trackEnumToGenerate); + if (first.EndsWith("?")) return first; + if (first == second) return first; + + switch (first, second) + { + case ("string", "list"): return second; + case ("boolean", "string"): return first; + case ("string", "number"): return first; + case ("number", _): return "string"; + } + } + } + + if (schema.XDataType() is { } dataType) return dataType == "array" ? "list" : dataType; - return schema.Type switch - { - JsonObjectType.String when schema.Enumeration is { Count: > 0 } => "enum", - JsonObjectType.Integer => "number", - JsonObjectType.Array => "list", - var t => t.ToString().ToLowerInvariant() - }; - } + var enumOptions = schema.Enumeration.Where(e => e != null).Select(e => e.ToString()).ToList(); + + if (schemaKey != null && schema.Type == JsonObjectType.String && enumOptions.Count > 0) + { + trackEnumToGenerate(schemaKey, isListContext); + return CsharpNames.GetEnumName(schemaKey) + "?"; + } + + if (schema.Type == JsonObjectType.Array && (schema.Item?.HasReference ?? false)) + _ = GetOpenSearchType(schema.Item, trackEnumToGenerate, true); - private static IEnumerable GetEnumOptions(JsonSchema schema) => - schema.ActualSchema.XEnumOptions() - ?? schema.ActualSchema.Enumeration?.Select(e => e.ToString()) - ?? Enumerable.Empty(); + return schema.Type switch + { + JsonObjectType.Integer => "number", + JsonObjectType.Array => "list", + var t => t.ToString().ToLowerInvariant() + }; + } private static Deprecation GetDeprecation(IJsonExtensionObject schema) => (schema.XDeprecationMessage(), schema.XVersionDeprecated()) switch { (null, null) => null, - var (m, v) => new Deprecation { Description = m, Version = v } + var (m, v) => new Deprecation { Description = m?.SanitizeDescription(), Version = v } }; private static string GetDescription(OpenApiRequestBody requestBody) @@ -253,6 +245,17 @@ private static string GetDescription(OpenApiRequestBody requestBody) : null; } + private static string SanitizeDescription(this string description) + { + if (string.IsNullOrWhiteSpace(description)) return null; + + description = Regex.Replace(description, @"\s+", " "); + + if (!description.EndsWith('.')) description += '.'; + + return description; + } + private static string XDeprecationMessage(this IJsonExtensionObject schema) => schema.GetExtension("x-deprecation-message") as string; @@ -261,24 +264,18 @@ private static string XVersionDeprecated(this IJsonExtensionObject schema) => private static Version XVersionAdded(this IJsonExtensionObject schema) => schema.GetExtension("x-version-added") is string s - ? s.Split('.').Length switch - { - 1 => new Version($"{s}.0.0"), - 2 => new Version($"{s}.0"), - _ => new Version(s), - } - : null; + ? s.Split('.').Length switch + { + 1 => new Version($"{s}.0.0"), + 2 => new Version($"{s}.0"), + _ => new Version(s), + } + : null; private static string XDataType(this IJsonExtensionObject schema) => schema.GetExtension("x-data-type") as string; - private static string XOverloadedParam(this IJsonExtensionObject schema) => - schema.GetExtension("x-overloaded-param") as string; - - private static IEnumerable XEnumOptions(this IJsonExtensionObject schema) => - schema.GetExtension("x-enum-options") is object[] opts ? opts.Cast() : null; - - private static object GetExtension(this IJsonExtensionObject schema, string key) => - schema.ExtensionData?.TryGetValue(key, out var value) ?? false ? value : null; + private static object GetExtension(this IJsonExtensionObject schema, string key) => + schema.ExtensionData?.TryGetValue(key, out var value) ?? false ? value : null; } } diff --git a/src/ApiGenerator/Generator/ApiGenerator.cs b/src/ApiGenerator/Generator/ApiGenerator.cs index 9b0d7d4f13..dfa87f38ed 100644 --- a/src/ApiGenerator/Generator/ApiGenerator.cs +++ b/src/ApiGenerator/Generator/ApiGenerator.cs @@ -29,16 +29,20 @@ using System; using System.Collections.Generic; using System.Collections.Immutable; +using System.Dynamic; using System.IO; using System.Linq; using System.Threading; using System.Threading.Tasks; using ApiGenerator.Configuration; using ApiGenerator.Domain; +using ApiGenerator.Domain.Code; +using ApiGenerator.Domain.Specification; using ApiGenerator.Generator.Razor; using NJsonSchema; using NSwag; using ShellProgressBar; +using YamlDotNet.Serialization; namespace ApiGenerator.Generator { @@ -92,18 +96,64 @@ await DoGenerate( public static async Task CreateRestApiSpecModel(CancellationToken token = default) { - var document = await OpenApiYamlDocument.FromFileAsync(GeneratorLocations.OpenApiSpecFile, token); + var json = PreprocessRawOpenApiSpec(await File.ReadAllTextAsync(GeneratorLocations.OpenApiSpecFile, token)); + var document = await OpenApiDocument.FromJsonAsync(json, token); JsonSchemaReferenceUtilities.UpdateSchemaReferencePaths(document); + var enumsToGenerate = new Dictionary(); + var endpoints = document.Paths .Select(kv => new { HttpPath = kv.Key, PathItem = kv.Value }) - .SelectMany(p => p.PathItem.Select(kv => new { p.HttpPath, p.PathItem, HttpMethod = kv.Key, Operation = kv.Value })) - .GroupBy(o => o.Operation.ExtensionData["x-operation-group"].ToString()) + .SelectMany(p => p.PathItem.Select(kv => new + { + p.HttpPath, p.PathItem, HttpMethod = kv.Key, Operation = kv.Value + })) + .GroupBy(o => o.Operation.ExtensionData!["x-operation-group"]!.ToString()) .Where(o => CodeConfiguration.IncludeOperation(o.Key)) - .Select(o => ApiEndpointFactory.From(o.Key, o.Select(i => (i.HttpPath, i.PathItem, i.HttpMethod, i.Operation)).ToList())) + .Select(o => ApiEndpointFactory.From( + o.Key, + o.Select(i => (i.HttpPath, i.PathItem, i.HttpMethod, i.Operation)).ToList(), + (e, isFlag) => + { + if (enumsToGenerate.TryGetValue(e, out var f)) isFlag |= f; + enumsToGenerate[e] = isFlag; + })) .ToImmutableSortedDictionary(e => e.Name, e => e); - return new RestApiSpec { Endpoints = endpoints }; + var enumsInSpec = enumsToGenerate.Select(kvp => new EnumDescription + { + Name = CsharpNames.GetEnumName(kvp.Key), + IsFlag = kvp.Value, + Options = document.Components.Schemas[kvp.Key].Enumeration.Where(e => e != null).Select(e => e.ToString()).ToImmutableList() + }) + .OrderBy(e => e.Name) + .ToImmutableList(); + + return new RestApiSpec { Endpoints = endpoints, EnumsInTheSpec = enumsInSpec }; + } + + private static string PreprocessRawOpenApiSpec(string yaml) + { + // FIXME: work-around until NSwag adds support for requestBody references: https://github.com/RicoSuter/NSwag/pull/4747 + dynamic doc = new DeserializerBuilder().Build().Deserialize(yaml)!; + var requestBodies = doc["components"]["requestBodies"]; + foreach (KeyValuePair pathPair in doc["paths"]) + { + foreach (KeyValuePair operationPair in pathPair.Value) + { + var operation = (Dictionary) operationPair.Value; + if (!operation.TryGetValue("requestBody", out var rb)) continue; + + var requestBody = (Dictionary) rb; + if (!requestBody.TryGetValue("$ref", out var reference)) continue; + + operation["requestBody"] = requestBodies[((string) reference).Split('/').Last()]; + } + } + return new SerializerBuilder() + .JsonCompatible() + .Build() + .Serialize(doc); } private static void RecursiveDelete(string path) diff --git a/src/ApiGenerator/OpenSearch.openapi.json b/src/ApiGenerator/OpenSearch.openapi.json deleted file mode 100644 index bb15270ef1..0000000000 --- a/src/ApiGenerator/OpenSearch.openapi.json +++ /dev/null @@ -1,33136 +0,0 @@ -{ - "openapi": "3.0.2", - "info": { - "title": "OpenSearch", - "version": "2021-11-23" - }, - "paths": { - "/": { - "get": { - "description": "Returns basic information about the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "Info", - "responses": { - "200": { - "description": "Info 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/InfoResponseContent" - } - } - } - } - }, - "x-operation-group": "info", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns whether the cluster is running.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "Ping", - "responses": { - "200": { - "description": "Ping 200 response" - } - }, - "x-operation-group": "ping", - "x-version-added": "1.0" - } - }, - "/_alias": { - "get": { - "description": "Returns an alias.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-alias/" - }, - "operationId": "IndicesGetAlias", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetAlias 200 response" - } - }, - "x-operation-group": "indices.get_alias", - "x-version-added": "1.0" - } - }, - "/_alias/{name}": { - "get": { - "description": "Returns an alias.", - "operationId": "IndicesGetAlias_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated list of alias names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of alias names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetAlias_WithName 200 response" - } - }, - "x-operation-group": "indices.get_alias", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns information about whether a particular alias exists.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesExistsAlias", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated list of alias names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of alias names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesExistsAlias 200 response" - } - }, - "x-operation-group": "indices.exists_alias", - "x-version-added": "1.0" - } - }, - "/_aliases": { - "post": { - "description": "Updates index aliases.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/alias/" - }, - "operationId": "IndicesUpdateAliases", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesUpdateAliases_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesUpdateAliases 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesUpdateAliasesResponseContent" - } - } - } - } - }, - "x-operation-group": "indices.update_aliases", - "x-version-added": "1.0" - } - }, - "/_analyze": { - "get": { - "description": "Performs the analysis process on a text and return the tokens breakdown of the text.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/analyze-apis/perform-text-analysis/" - }, - "operationId": "IndicesAnalyze_Get", - "parameters": [ - { - "name": "index", - "in": "query", - "description": "The name of the index to scope the operation.", - "schema": { - "type": "string", - "description": "The name of the index to scope the operation." - } - } - ], - "responses": { - "200": { - "description": "IndicesAnalyze_Get 200 response" - } - }, - "x-operation-group": "indices.analyze", - "x-version-added": "1.0" - }, - "post": { - "description": "Performs the analysis process on a text and return the tokens breakdown of the text.", - "operationId": "IndicesAnalyze_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesAnalyze_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "query", - "description": "The name of the index to scope the operation.", - "schema": { - "type": "string", - "description": "The name of the index to scope the operation." - } - } - ], - "responses": { - "200": { - "description": "IndicesAnalyze_Post 200 response" - } - }, - "x-operation-group": "indices.analyze", - "x-version-added": "1.0" - } - }, - "/_bulk": { - "post": { - "description": "Allows to perform multiple index/update/delete operations in a single request.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/bulk/" - }, - "operationId": "Bulk_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Bulk_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "type", - "in": "query", - "description": "Default document type for items which don't provide one.", - "schema": { - "type": "string", - "description": "Default document type for items which don't provide one." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or default list of fields to return, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or default list of fields to return, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "Default list of fields to exclude from the returned _source field, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Default list of fields to exclude from the returned _source field, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "Default list of fields to extract and return from the _source field, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Default list of fields to extract and return from the _source field, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - }, - { - "name": "require_alias", - "in": "query", - "description": "Sets require_alias for all incoming documents.", - "schema": { - "type": "boolean", - "default": false, - "description": "Sets require_alias for all incoming documents." - } - } - ], - "responses": { - "200": { - "description": "Bulk_Post 200 response" - } - }, - "x-operation-group": "bulk", - "x-version-added": "1.0" - }, - "put": { - "description": "Allows to perform multiple index/update/delete operations in a single request.", - "operationId": "Bulk_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Bulk_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "type", - "in": "query", - "description": "Default document type for items which don't provide one.", - "schema": { - "type": "string", - "description": "Default document type for items which don't provide one." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or default list of fields to return, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or default list of fields to return, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "Default list of fields to exclude from the returned _source field, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Default list of fields to exclude from the returned _source field, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "Default list of fields to extract and return from the _source field, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Default list of fields to extract and return from the _source field, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - }, - { - "name": "require_alias", - "in": "query", - "description": "Sets require_alias for all incoming documents.", - "schema": { - "type": "boolean", - "default": false, - "description": "Sets require_alias for all incoming documents." - } - } - ], - "responses": { - "200": { - "description": "Bulk_Put 200 response" - } - }, - "x-operation-group": "bulk", - "x-version-added": "1.0" - } - }, - "/_cache/clear": { - "post": { - "description": "Clears all or specific caches for one or more indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/clear-index-cache/" - }, - "operationId": "IndicesClearCache", - "parameters": [ - { - "name": "fielddata", - "in": "query", - "description": "Clear field data.", - "schema": { - "type": "boolean", - "description": "Clear field data." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to clear when using the `fielddata` parameter (default: all).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to clear when using the `fielddata` parameter (default: all)." - }, - "explode": true - }, - { - "name": "query", - "in": "query", - "description": "Clear query caches.", - "schema": { - "type": "boolean", - "description": "Clear query caches." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "index", - "in": "query", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices." - }, - "explode": true - }, - { - "name": "request", - "in": "query", - "description": "Clear request cache.", - "schema": { - "type": "boolean", - "description": "Clear request cache." - } - } - ], - "responses": { - "200": { - "description": "IndicesClearCache 200 response" - } - }, - "x-operation-group": "indices.clear_cache", - "x-version-added": "1.0" - } - }, - "/_cat": { - "get": { - "description": "Returns help for the Cat APIs.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/index/" - }, - "operationId": "CatHelp", - "parameters": [ - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "CatHelp 200 response" - } - }, - "x-operation-group": "cat.help", - "x-version-added": "1.0" - } - }, - "/_cat/aliases": { - "get": { - "description": "Shows information about currently configured aliases to indices including filter and routing infos.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-aliases/" - }, - "operationId": "CatAliases", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "CatAliases 200 response" - } - }, - "x-operation-group": "cat.aliases", - "x-version-added": "1.0" - } - }, - "/_cat/aliases/{name}": { - "get": { - "description": "Shows information about currently configured aliases to indices including filter and routing infos.", - "operationId": "CatAliases_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated list of alias names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of alias names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "CatAliases_WithName 200 response" - } - }, - "x-operation-group": "cat.aliases", - "x-version-added": "1.0" - } - }, - "/_cat/allocation": { - "get": { - "description": "Provides a snapshot of how many shards are allocated to each data node and how much disk space they are using.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-allocation/" - }, - "operationId": "CatAllocation", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatAllocation 200 response" - } - }, - "x-operation-group": "cat.allocation", - "x-version-added": "1.0" - } - }, - "/_cat/allocation/{node_id}": { - "get": { - "description": "Provides a snapshot of how many shards are allocated to each data node and how much disk space they are using.", - "operationId": "CatAllocation_WithNodeId", - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "Comma-separated list of node IDs or names to limit the returned information.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of node IDs or names to limit the returned information.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatAllocation_WithNodeId 200 response" - } - }, - "x-operation-group": "cat.allocation", - "x-version-added": "1.0" - } - }, - "/_cat/cluster_manager": { - "get": { - "description": "Returns information about the cluster-manager node.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-cluster_manager/" - }, - "operationId": "CatClusterManager", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatClusterManager 200 response" - } - }, - "x-operation-group": "cat.cluster_manager", - "x-version-added": "2.0" - } - }, - "/_cat/count": { - "get": { - "description": "Provides quick access to the document count of the entire cluster, or individual indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-count/" - }, - "operationId": "CatCount", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatCount 200 response" - } - }, - "x-operation-group": "cat.count", - "x-version-added": "1.0" - } - }, - "/_cat/count/{index}": { - "get": { - "description": "Provides quick access to the document count of the entire cluster, or individual indices.", - "operationId": "CatCount_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to limit the returned information.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to limit the returned information.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatCount_WithIndex 200 response" - } - }, - "x-operation-group": "cat.count", - "x-version-added": "1.0" - } - }, - "/_cat/fielddata": { - "get": { - "description": "Shows how much heap memory is currently being used by fielddata on every data node in the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-field-data/" - }, - "operationId": "CatFielddata", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return in the output.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return in the output." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "CatFielddata 200 response" - } - }, - "x-operation-group": "cat.fielddata", - "x-version-added": "1.0" - } - }, - "/_cat/fielddata/{fields}": { - "get": { - "description": "Shows how much heap memory is currently being used by fielddata on every data node in the cluster.", - "operationId": "CatFielddata_WithFields", - "parameters": [ - { - "name": "fields", - "in": "path", - "description": "Comma-separated list of fields to return the fielddata size.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of fields to return the fielddata size.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return in the output.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return in the output." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "CatFielddata_WithFields 200 response" - } - }, - "x-operation-group": "cat.fielddata", - "x-version-added": "1.0" - } - }, - "/_cat/health": { - "get": { - "description": "Returns a concise representation of the cluster health.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-health/" - }, - "operationId": "CatHealth", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "ts", - "in": "query", - "description": "Set to false to disable timestamping.", - "schema": { - "type": "boolean", - "default": true, - "description": "Set to false to disable timestamping." - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatHealth 200 response" - } - }, - "x-operation-group": "cat.health", - "x-version-added": "1.0" - } - }, - "/_cat/indices": { - "get": { - "description": "Returns information about indices: number of primaries and replicas, document counts, disk size, ...", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-indices/" - }, - "operationId": "CatIndices", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "health", - "in": "query", - "description": "Health status ('green', 'yellow', or 'red') to filter only indices matching the specified health status.", - "schema": { - "$ref": "#/components/schemas/Health" - } - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "pri", - "in": "query", - "description": "Set to true to return stats only for primary shards.", - "schema": { - "type": "boolean", - "default": false, - "description": "Set to true to return stats only for primary shards." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "include_unloaded_segments", - "in": "query", - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory.", - "schema": { - "type": "boolean", - "default": false, - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "CatIndices 200 response" - } - }, - "x-operation-group": "cat.indices", - "x-version-added": "1.0" - } - }, - "/_cat/indices/{index}": { - "get": { - "description": "Returns information about indices: number of primaries and replicas, document counts, disk size, ...", - "operationId": "CatIndices_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to limit the returned information.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to limit the returned information.", - "x-data-type": "array" - }, - "required": true, - "examples": { - "CatIndices_WithIndex_example1": { - "summary": "Examples for Cat indices with Index Operation.", - "description": "", - "value": "books" - } - } - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "health", - "in": "query", - "description": "Health status ('green', 'yellow', or 'red') to filter only indices matching the specified health status.", - "schema": { - "$ref": "#/components/schemas/Health" - } - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "pri", - "in": "query", - "description": "Set to true to return stats only for primary shards.", - "schema": { - "type": "boolean", - "default": false, - "description": "Set to true to return stats only for primary shards." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "include_unloaded_segments", - "in": "query", - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory.", - "schema": { - "type": "boolean", - "default": false, - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "CatIndices_WithIndex 200 response" - } - }, - "x-operation-group": "cat.indices", - "x-version-added": "1.0" - } - }, - "/_cat/master": { - "get": { - "description": "Returns information about the cluster-manager node.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-cluster_manager/" - }, - "operationId": "CatMaster", - "deprecated": true, - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatMaster 200 response" - } - }, - "x-deprecation-message": "To promote inclusive language, please use '/_cat/cluster_manager' instead.", - "x-operation-group": "cat.master", - "x-version-added": "1.0", - "x-version-deprecated": "2.0" - } - }, - "/_cat/nodeattrs": { - "get": { - "description": "Returns information about custom node attributes.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-nodeattrs/" - }, - "operationId": "CatNodeattrs", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatNodeattrs 200 response" - } - }, - "x-operation-group": "cat.nodeattrs", - "x-version-added": "1.0" - } - }, - "/_cat/nodes": { - "get": { - "description": "Returns basic statistics about performance of cluster nodes.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/" - }, - "operationId": "CatNodes", - "parameters": [ - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "full_id", - "in": "query", - "description": "Return the full node ID instead of the shortened version.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return the full node ID instead of the shortened version." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "x-version-deprecated": "1.0", - "x-deprecation-message": "This parameter does not cause this API to act locally.", - "deprecated": true - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatNodes 200 response" - } - }, - "x-operation-group": "cat.nodes", - "x-version-added": "1.0" - } - }, - "/_cat/pending_tasks": { - "get": { - "description": "Returns a concise representation of the cluster pending tasks.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-pending-tasks/" - }, - "operationId": "CatPendingTasks", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatPendingTasks 200 response" - } - }, - "x-operation-group": "cat.pending_tasks", - "x-version-added": "1.0" - } - }, - "/_cat/pit_segments": { - "get": { - "description": "List segments for one or several PITs.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/point-in-time-api/" - }, - "operationId": "CatPitSegments", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CatPitSegments_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - } - ], - "responses": { - "200": { - "description": "CatPitSegments 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CatPitSegmentsOutputPayload" - } - } - } - } - }, - "x-operation-group": "cat.pit_segments", - "x-version-added": "2.4" - } - }, - "/_cat/pit_segments/_all": { - "get": { - "description": "Lists all active point-in-time segments.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/point-in-time-api/" - }, - "operationId": "CatAllPitSegments", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - } - ], - "responses": { - "200": { - "description": "CatAllPitSegments 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CatAllPitSegmentsOutputPayload" - } - } - } - } - }, - "x-operation-group": "cat.all_pit_segments", - "x-version-added": "2.4" - } - }, - "/_cat/plugins": { - "get": { - "description": "Returns information about installed plugins across nodes node.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-plugins/" - }, - "operationId": "CatPlugins", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatPlugins 200 response" - } - }, - "x-operation-group": "cat.plugins", - "x-version-added": "1.0" - } - }, - "/_cat/recovery": { - "get": { - "description": "Returns information about index shard recoveries, both on-going completed.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-plugins/" - }, - "operationId": "CatRecovery", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "active_only", - "in": "query", - "description": "If `true`, the response only includes ongoing shard recoveries.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response only includes ongoing shard recoveries." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "detailed", - "in": "query", - "description": "If `true`, the response includes detailed information about shard recoveries.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response includes detailed information about shard recoveries." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "index", - "in": "query", - "description": "Comma-separated list or wildcard expression of index names to limit the returned information.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list or wildcard expression of index names to limit the returned information." - }, - "explode": true - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatRecovery 200 response" - } - }, - "x-operation-group": "cat.recovery", - "x-version-added": "1.0" - } - }, - "/_cat/recovery/{index}": { - "get": { - "description": "Returns information about index shard recoveries, both on-going completed.", - "operationId": "CatRecovery_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list or wildcard expression of index names to limit the returned information.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list or wildcard expression of index names to limit the returned information.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "active_only", - "in": "query", - "description": "If `true`, the response only includes ongoing shard recoveries.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response only includes ongoing shard recoveries." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "detailed", - "in": "query", - "description": "If `true`, the response includes detailed information about shard recoveries.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response includes detailed information about shard recoveries." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "index", - "in": "query", - "description": "Comma-separated list or wildcard expression of index names to limit the returned information.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list or wildcard expression of index names to limit the returned information." - }, - "explode": true - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatRecovery_WithIndex 200 response" - } - }, - "x-operation-group": "cat.recovery", - "x-version-added": "1.0" - } - }, - "/_cat/repositories": { - "get": { - "description": "Returns information about snapshot repositories registered in the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-repositories/" - }, - "operationId": "CatRepositories", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatRepositories 200 response" - } - }, - "x-operation-group": "cat.repositories", - "x-version-added": "1.0" - } - }, - "/_cat/segment_replication": { - "get": { - "description": "Returns information about both on-going and latest completed Segment Replication events.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-segment-replication/" - }, - "operationId": "CatSegmentReplication", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "active_only", - "in": "query", - "description": "If `true`, the response only includes ongoing segment replication events.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response only includes ongoing segment replication events." - } - }, - { - "name": "completed_only", - "in": "query", - "description": "If `true`, the response only includes latest completed segment replication events.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response only includes latest completed segment replication events." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "detailed", - "in": "query", - "description": "If `true`, the response includes detailed information about segment replications.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response includes detailed information about segment replications." - } - }, - { - "name": "shards", - "in": "query", - "description": "Comma-separated list of shards to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of shards to display." - }, - "explode": true - }, - { - "name": "index", - "in": "query", - "description": "Comma-separated list or wildcard expression of index names to limit the returned information.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list or wildcard expression of index names to limit the returned information." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "CatSegmentReplication 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CatSegmentReplicationOutputPayload" - } - } - } - } - }, - "x-operation-group": "cat.segment_replication", - "x-version-added": "2.6.0" - } - }, - "/_cat/segment_replication/{index}": { - "get": { - "description": "Returns information about both on-going and latest completed Segment Replication events.", - "operationId": "CatSegmentReplication_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list or wildcard expression of index names to limit the returned information.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list or wildcard expression of index names to limit the returned information.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "active_only", - "in": "query", - "description": "If `true`, the response only includes ongoing segment replication events.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response only includes ongoing segment replication events." - } - }, - { - "name": "completed_only", - "in": "query", - "description": "If `true`, the response only includes latest completed segment replication events.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response only includes latest completed segment replication events." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "detailed", - "in": "query", - "description": "If `true`, the response includes detailed information about segment replications.", - "schema": { - "type": "boolean", - "default": false, - "description": "If `true`, the response includes detailed information about segment replications." - } - }, - { - "name": "shards", - "in": "query", - "description": "Comma-separated list of shards to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of shards to display." - }, - "explode": true - }, - { - "name": "index", - "in": "query", - "description": "Comma-separated list or wildcard expression of index names to limit the returned information.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list or wildcard expression of index names to limit the returned information." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "CatSegmentReplication_WithIndex 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CatSegmentReplication_WithIndexOutputPayload" - } - } - } - } - }, - "x-operation-group": "cat.segment_replication", - "x-version-added": "2.6.0" - } - }, - "/_cat/segments": { - "get": { - "description": "Provides low-level information about the segments in the shards of an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-segments/" - }, - "operationId": "CatSegments", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatSegments 200 response" - } - }, - "x-operation-group": "cat.segments", - "x-version-added": "1.0" - } - }, - "/_cat/segments/{index}": { - "get": { - "description": "Provides low-level information about the segments in the shards of an index.", - "operationId": "CatSegments_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to limit the returned information.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to limit the returned information.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatSegments_WithIndex 200 response" - } - }, - "x-operation-group": "cat.segments", - "x-version-added": "1.0" - } - }, - "/_cat/shards": { - "get": { - "description": "Provides a detailed view of shard allocation on nodes.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-shards/" - }, - "operationId": "CatShards", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatShards 200 response" - } - }, - "x-operation-group": "cat.shards", - "x-version-added": "1.0" - } - }, - "/_cat/shards/{index}": { - "get": { - "description": "Provides a detailed view of shard allocation on nodes.", - "operationId": "CatShards_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to limit the returned information.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to limit the returned information.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "bytes", - "in": "query", - "description": "The unit in which to display byte values.", - "schema": { - "$ref": "#/components/schemas/Bytes" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatShards_WithIndex 200 response" - } - }, - "x-operation-group": "cat.shards", - "x-version-added": "1.0" - } - }, - "/_cat/snapshots": { - "get": { - "description": "Returns all snapshots in a specific repository.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-snapshots/" - }, - "operationId": "CatSnapshots", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatSnapshots 200 response" - } - }, - "x-operation-group": "cat.snapshots", - "x-version-added": "1.0" - } - }, - "/_cat/snapshots/{repository}": { - "get": { - "description": "Returns all snapshots in a specific repository.", - "operationId": "CatSnapshots_WithRepository", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Comma-separated list of repository names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of repository names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatSnapshots_WithRepository 200 response" - } - }, - "x-operation-group": "cat.snapshots", - "x-version-added": "1.0" - } - }, - "/_cat/tasks": { - "get": { - "description": "Returns information about the tasks currently executing on one or more nodes in the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-tasks/" - }, - "operationId": "CatTasks", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "nodes", - "in": "query", - "description": "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.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "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." - }, - "explode": true - }, - { - "name": "actions", - "in": "query", - "description": "Comma-separated list of actions that should be returned. Leave empty to return all.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of actions that should be returned. Leave empty to return all." - }, - "explode": true - }, - { - "name": "detailed", - "in": "query", - "description": "Return detailed task information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return detailed task information." - } - }, - { - "name": "parent_task_id", - "in": "query", - "description": "Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all.", - "schema": { - "type": "string", - "description": "Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all." - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "time", - "in": "query", - "description": "The unit in which to display time values.", - "schema": { - "$ref": "#/components/schemas/Time" - } - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatTasks 200 response" - } - }, - "x-operation-group": "cat.tasks", - "x-version-added": "1.0" - } - }, - "/_cat/templates": { - "get": { - "description": "Returns information about existing templates.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-templates/" - }, - "operationId": "CatTemplates", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatTemplates 200 response" - } - }, - "x-operation-group": "cat.templates", - "x-version-added": "1.0" - } - }, - "/_cat/templates/{name}": { - "get": { - "description": "Returns information about existing templates.", - "operationId": "CatTemplates_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatTemplates_WithName 200 response" - } - }, - "x-operation-group": "cat.templates", - "x-version-added": "1.0" - } - }, - "/_cat/thread_pool": { - "get": { - "description": "Returns cluster-wide thread pool statistics per node.\nBy default the active, queue and rejected statistics are returned for all thread pools.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cat/cat-thread-pool/" - }, - "operationId": "CatThreadPool", - "parameters": [ - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "size", - "in": "query", - "description": "The multiplier in which to display values.", - "schema": { - "type": "integer", - "description": "The multiplier in which to display values.", - "format": "int32" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatThreadPool 200 response" - } - }, - "x-operation-group": "cat.thread_pool", - "x-version-added": "1.0" - } - }, - "/_cat/thread_pool/{thread_pool_patterns}": { - "get": { - "description": "Returns cluster-wide thread pool statistics per node.\nBy default the active, queue and rejected statistics are returned for all thread pools.", - "operationId": "CatThreadPool_WithThreadPoolPatterns", - "parameters": [ - { - "name": "thread_pool_patterns", - "in": "path", - "description": "Comma-separated list of regular-expressions to filter the thread pools in the output.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of regular-expressions to filter the thread pools in the output.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "format", - "in": "query", - "description": "A short version of the Accept header, e.g. json, yaml.", - "schema": { - "type": "string", - "description": "A short version of the Accept header, e.g. json, yaml." - } - }, - { - "name": "size", - "in": "query", - "description": "The multiplier in which to display values.", - "schema": { - "type": "integer", - "description": "The multiplier in which to display values.", - "format": "int32" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "h", - "in": "query", - "description": "Comma-separated list of column names to display.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names to display." - }, - "explode": true - }, - { - "name": "help", - "in": "query", - "description": "Return help information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return help information." - } - }, - { - "name": "s", - "in": "query", - "description": "Comma-separated list of column names or column aliases to sort by.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of column names or column aliases to sort by." - }, - "explode": true - }, - { - "name": "v", - "in": "query", - "description": "Verbose mode. Display column headers.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display column headers." - } - } - ], - "responses": { - "200": { - "description": "CatThreadPool_WithThreadPoolPatterns 200 response" - } - }, - "x-operation-group": "cat.thread_pool", - "x-version-added": "1.0" - } - }, - "/_cluster/allocation/explain": { - "get": { - "description": "Provides explanations for shard allocations in the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-allocation/" - }, - "operationId": "ClusterAllocationExplain_Get", - "parameters": [ - { - "name": "include_yes_decisions", - "in": "query", - "description": "Return 'YES' decisions in explanation.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return 'YES' decisions in explanation." - } - }, - { - "name": "include_disk_info", - "in": "query", - "description": "Return information about disk usage and shard sizes.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return information about disk usage and shard sizes." - } - } - ], - "responses": { - "200": { - "description": "ClusterAllocationExplain_Get 200 response" - } - }, - "x-operation-group": "cluster.allocation_explain", - "x-version-added": "1.0" - }, - "post": { - "description": "Provides explanations for shard allocations in the cluster.", - "operationId": "ClusterAllocationExplain_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClusterAllocationExplain_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "include_yes_decisions", - "in": "query", - "description": "Return 'YES' decisions in explanation.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return 'YES' decisions in explanation." - } - }, - { - "name": "include_disk_info", - "in": "query", - "description": "Return information about disk usage and shard sizes.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return information about disk usage and shard sizes." - } - } - ], - "responses": { - "200": { - "description": "ClusterAllocationExplain_Post 200 response" - } - }, - "x-operation-group": "cluster.allocation_explain", - "x-version-added": "1.0" - } - }, - "/_cluster/decommission/awareness/": { - "delete": { - "description": "Delete any existing decommission.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-decommission/#example-decommissioning-and-recommissioning-a-zone" - }, - "operationId": "ClusterDeleteDecommissionAwareness", - "responses": { - "200": { - "description": "ClusterDeleteDecommissionAwareness 200 response" - } - }, - "x-operation-group": "cluster.delete_decommission_awareness", - "x-version-added": "1.0" - } - }, - "/_cluster/decommission/awareness/{awareness_attribute_name}/_status": { - "get": { - "description": "Get details and status of decommissioned attribute.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-decommission/#example-getting-zone-decommission-status" - }, - "operationId": "ClusterGetDecommissionAwareness", - "parameters": [ - { - "name": "awareness_attribute_name", - "in": "path", - "description": "Awareness attribute name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Awareness attribute name." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "ClusterGetDecommissionAwareness 200 response" - } - }, - "x-operation-group": "cluster.get_decommission_awareness", - "x-version-added": "1.0" - } - }, - "/_cluster/decommission/awareness/{awareness_attribute_name}/{awareness_attribute_value}": { - "put": { - "description": "Decommissions an awareness attribute.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-decommission/#example-decommissioning-and-recommissioning-a-zone" - }, - "operationId": "ClusterPutDecommissionAwareness", - "parameters": [ - { - "name": "awareness_attribute_name", - "in": "path", - "description": "Awareness attribute name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Awareness attribute name." - }, - "required": true - }, - { - "name": "awareness_attribute_value", - "in": "path", - "description": "Awareness attribute value.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Awareness attribute value." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "ClusterPutDecommissionAwareness 200 response" - } - }, - "x-operation-group": "cluster.put_decommission_awareness", - "x-version-added": "1.0" - } - }, - "/_cluster/health": { - "get": { - "description": "Returns basic information about the health of the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-health/" - }, - "operationId": "ClusterHealth", - "parameters": [ - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "level", - "in": "query", - "description": "Specify the level of detail for returned information.", - "schema": { - "$ref": "#/components/schemas/ClusterHealthLevel" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Wait until the specified number of shards is active.", - "schema": { - "type": "string", - "description": "Wait until the specified number of shards is active." - } - }, - { - "name": "wait_for_nodes", - "in": "query", - "description": "Wait until the specified number of nodes is available.", - "schema": { - "type": "string", - "description": "Wait until the specified number of nodes is available." - } - }, - { - "name": "wait_for_events", - "in": "query", - "description": "Wait until all currently queued events with the given priority are processed.", - "schema": { - "$ref": "#/components/schemas/WaitForEvents" - } - }, - { - "name": "wait_for_no_relocating_shards", - "in": "query", - "description": "Whether to wait until there are no relocating shards in the cluster.", - "schema": { - "type": "boolean", - "description": "Whether to wait until there are no relocating shards in the cluster." - } - }, - { - "name": "wait_for_no_initializing_shards", - "in": "query", - "description": "Whether to wait until there are no initializing shards in the cluster.", - "schema": { - "type": "boolean", - "description": "Whether to wait until there are no initializing shards in the cluster." - } - }, - { - "name": "wait_for_status", - "in": "query", - "description": "Wait until cluster is in a specific state.", - "schema": { - "$ref": "#/components/schemas/WaitForStatus" - } - }, - { - "name": "awareness_attribute", - "in": "query", - "description": "The awareness attribute for which the health is required.", - "schema": { - "type": "string", - "description": "The awareness attribute for which the health is required." - } - } - ], - "responses": { - "200": { - "description": "ClusterHealth 200 response" - } - }, - "x-operation-group": "cluster.health", - "x-version-added": "1.0" - } - }, - "/_cluster/health/{index}": { - "get": { - "description": "Returns basic information about the health of the cluster.", - "operationId": "ClusterHealth_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Limit the information returned to specific indicies.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to specific indicies.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "level", - "in": "query", - "description": "Specify the level of detail for returned information.", - "schema": { - "$ref": "#/components/schemas/ClusterHealthLevel" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Wait until the specified number of shards is active.", - "schema": { - "type": "string", - "description": "Wait until the specified number of shards is active." - } - }, - { - "name": "wait_for_nodes", - "in": "query", - "description": "Wait until the specified number of nodes is available.", - "schema": { - "type": "string", - "description": "Wait until the specified number of nodes is available." - } - }, - { - "name": "wait_for_events", - "in": "query", - "description": "Wait until all currently queued events with the given priority are processed.", - "schema": { - "$ref": "#/components/schemas/WaitForEvents" - } - }, - { - "name": "wait_for_no_relocating_shards", - "in": "query", - "description": "Whether to wait until there are no relocating shards in the cluster.", - "schema": { - "type": "boolean", - "description": "Whether to wait until there are no relocating shards in the cluster." - } - }, - { - "name": "wait_for_no_initializing_shards", - "in": "query", - "description": "Whether to wait until there are no initializing shards in the cluster.", - "schema": { - "type": "boolean", - "description": "Whether to wait until there are no initializing shards in the cluster." - } - }, - { - "name": "wait_for_status", - "in": "query", - "description": "Wait until cluster is in a specific state.", - "schema": { - "$ref": "#/components/schemas/WaitForStatus" - } - }, - { - "name": "awareness_attribute", - "in": "query", - "description": "The awareness attribute for which the health is required.", - "schema": { - "type": "string", - "description": "The awareness attribute for which the health is required." - } - } - ], - "responses": { - "200": { - "description": "ClusterHealth_WithIndex 200 response" - } - }, - "x-operation-group": "cluster.health", - "x-version-added": "1.0" - } - }, - "/_cluster/nodes/hot_threads": { - "get": { - "description": "Returns information about hot threads on each node in the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-hot-threads/" - }, - "operationId": "NodesHotThreads_DeprecatedDash", - "deprecated": true, - "parameters": [ - { - "name": "interval", - "in": "query", - "description": "The interval for the second sampling of threads.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The interval for the second sampling of threads.", - "x-data-type": "time" - } - }, - { - "name": "snapshots", - "in": "query", - "description": "Number of samples of thread stacktrace.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of samples of thread stacktrace.", - "format": "int32" - } - }, - { - "name": "threads", - "in": "query", - "description": "Specify the number of threads to provide information for.", - "schema": { - "type": "integer", - "default": 3, - "description": "Specify the number of threads to provide information for.", - "format": "int32" - } - }, - { - "name": "ignore_idle_threads", - "in": "query", - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue.", - "schema": { - "type": "boolean", - "default": true, - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue." - } - }, - { - "name": "type", - "in": "query", - "description": "The type to sample.", - "schema": { - "$ref": "#/components/schemas/SampleType" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesHotThreads_DeprecatedDash 200 response" - } - }, - "x-deprecation-message": "The hot accepts /_cluster/nodes as prefix for backwards compatibility reasons", - "x-ignorable": true, - "x-operation-group": "nodes.hot_threads", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - } - }, - "/_cluster/nodes/hotthreads": { - "get": { - "description": "Returns information about hot threads on each node in the cluster.", - "operationId": "NodesHotThreads_DeprecatedCluster", - "deprecated": true, - "parameters": [ - { - "name": "interval", - "in": "query", - "description": "The interval for the second sampling of threads.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The interval for the second sampling of threads.", - "x-data-type": "time" - } - }, - { - "name": "snapshots", - "in": "query", - "description": "Number of samples of thread stacktrace.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of samples of thread stacktrace.", - "format": "int32" - } - }, - { - "name": "threads", - "in": "query", - "description": "Specify the number of threads to provide information for.", - "schema": { - "type": "integer", - "default": 3, - "description": "Specify the number of threads to provide information for.", - "format": "int32" - } - }, - { - "name": "ignore_idle_threads", - "in": "query", - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue.", - "schema": { - "type": "boolean", - "default": true, - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue." - } - }, - { - "name": "type", - "in": "query", - "description": "The type to sample.", - "schema": { - "$ref": "#/components/schemas/SampleType" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesHotThreads_DeprecatedCluster 200 response" - } - }, - "x-deprecation-message": "The hot threads API accepts `hotthreads` but only `hot_threads` is documented", - "x-ignorable": true, - "x-operation-group": "nodes.hot_threads", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - } - }, - "/_cluster/nodes/{node_id}/hot_threads": { - "get": { - "description": "Returns information about hot threads on each node in the cluster.", - "operationId": "NodesHotThreads_WithNodeId_DeprecatedDash", - "deprecated": true, - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "interval", - "in": "query", - "description": "The interval for the second sampling of threads.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The interval for the second sampling of threads.", - "x-data-type": "time" - } - }, - { - "name": "snapshots", - "in": "query", - "description": "Number of samples of thread stacktrace.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of samples of thread stacktrace.", - "format": "int32" - } - }, - { - "name": "threads", - "in": "query", - "description": "Specify the number of threads to provide information for.", - "schema": { - "type": "integer", - "default": 3, - "description": "Specify the number of threads to provide information for.", - "format": "int32" - } - }, - { - "name": "ignore_idle_threads", - "in": "query", - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue.", - "schema": { - "type": "boolean", - "default": true, - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue." - } - }, - { - "name": "type", - "in": "query", - "description": "The type to sample.", - "schema": { - "$ref": "#/components/schemas/SampleType" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesHotThreads_WithNodeId_DeprecatedDash 200 response" - } - }, - "x-deprecation-message": "The hot accepts /_cluster/nodes as prefix for backwards compatibility reasons", - "x-ignorable": true, - "x-operation-group": "nodes.hot_threads", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - } - }, - "/_cluster/nodes/{node_id}/hotthreads": { - "get": { - "description": "Returns information about hot threads on each node in the cluster.", - "operationId": "NodesHotThreads_WithNodeId_DeprecatedCluster", - "deprecated": true, - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "interval", - "in": "query", - "description": "The interval for the second sampling of threads.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The interval for the second sampling of threads.", - "x-data-type": "time" - } - }, - { - "name": "snapshots", - "in": "query", - "description": "Number of samples of thread stacktrace.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of samples of thread stacktrace.", - "format": "int32" - } - }, - { - "name": "threads", - "in": "query", - "description": "Specify the number of threads to provide information for.", - "schema": { - "type": "integer", - "default": 3, - "description": "Specify the number of threads to provide information for.", - "format": "int32" - } - }, - { - "name": "ignore_idle_threads", - "in": "query", - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue.", - "schema": { - "type": "boolean", - "default": true, - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue." - } - }, - { - "name": "type", - "in": "query", - "description": "The type to sample.", - "schema": { - "$ref": "#/components/schemas/SampleType" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesHotThreads_WithNodeId_DeprecatedCluster 200 response" - } - }, - "x-deprecation-message": "The hot threads API accepts `hotthreads` but only `hot_threads` is documented", - "x-ignorable": true, - "x-operation-group": "nodes.hot_threads", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - } - }, - "/_cluster/pending_tasks": { - "get": { - "description": "Returns a list of any cluster-level changes (e.g. create index, update mapping,\nallocate or fail shard) which have not yet been executed.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ClusterPendingTasks", - "parameters": [ - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterPendingTasks 200 response" - } - }, - "x-operation-group": "cluster.pending_tasks", - "x-version-added": "1.0" - } - }, - "/_cluster/reroute": { - "post": { - "description": "Allows to manually change the allocation of individual shards in the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ClusterReroute", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClusterReroute_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "dry_run", - "in": "query", - "description": "Simulate the operation only and return the resulting state.", - "schema": { - "type": "boolean", - "description": "Simulate the operation only and return the resulting state." - } - }, - { - "name": "explain", - "in": "query", - "description": "Return an explanation of why the commands can or cannot be executed.", - "schema": { - "type": "boolean", - "description": "Return an explanation of why the commands can or cannot be executed." - } - }, - { - "name": "retry_failed", - "in": "query", - "description": "Retries allocation of shards that are blocked due to too many subsequent allocation failures.", - "schema": { - "type": "boolean", - "description": "Retries allocation of shards that are blocked due to too many subsequent allocation failures." - } - }, - { - "name": "metric", - "in": "query", - "description": "Limit the information returned to the specified metrics. Defaults to all but metadata.", - "style": "form", - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/ClusterRerouteMetric_Member" - }, - "description": "Limit the information returned to the specified metrics. Defaults to all but metadata." - }, - "explode": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterReroute 200 response" - } - }, - "x-operation-group": "cluster.reroute", - "x-version-added": "1.0" - } - }, - "/_cluster/routing/awareness/weights": { - "delete": { - "description": "Delete weighted shard routing weights.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-awareness/#example-deleting-weights" - }, - "operationId": "ClusterDeleteWeightedRouting", - "responses": { - "200": { - "description": "ClusterDeleteWeightedRouting 200 response" - } - }, - "x-operation-group": "cluster.delete_weighted_routing", - "x-version-added": "1.0" - } - }, - "/_cluster/routing/awareness/{attribute}/weights": { - "get": { - "description": "Fetches weighted shard routing weights.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-awareness/#example-getting-weights-for-all-zones" - }, - "operationId": "ClusterGetWeightedRouting", - "parameters": [ - { - "name": "attribute", - "in": "path", - "description": "Awareness attribute name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Awareness attribute name." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "ClusterGetWeightedRouting 200 response" - } - }, - "x-operation-group": "cluster.get_weighted_routing", - "x-version-added": "1.0" - }, - "put": { - "description": "Updates weighted shard routing weights.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-awareness/#example-weighted-round-robin-search" - }, - "operationId": "ClusterPutWeightedRouting", - "parameters": [ - { - "name": "attribute", - "in": "path", - "description": "Awareness attribute name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Awareness attribute name." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "ClusterPutWeightedRouting 200 response" - } - }, - "x-operation-group": "cluster.put_weighted_routing", - "x-version-added": "1.0" - } - }, - "/_cluster/settings": { - "get": { - "description": "Returns cluster settings.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-settings/" - }, - "operationId": "ClusterGetSettings", - "parameters": [ - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether to return all default clusters setting.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to return all default clusters setting." - }, - "examples": { - "ClusterGetSettings_example1": { - "summary": "Examples for Get cluster settings Operation.", - "description": "", - "value": true - } - } - } - ], - "responses": { - "200": { - "description": "ClusterGetSettings 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClusterGetSettingsResponseContent" - }, - "examples": { - "ClusterGetSettings_example1": { - "summary": "Examples for Get cluster settings Operation.", - "description": "", - "value": {} - } - } - } - } - } - }, - "x-operation-group": "cluster.get_settings", - "x-version-added": "1.0" - }, - "put": { - "description": "Updates the cluster settings.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-settings/" - }, - "operationId": "ClusterPutSettings", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClusterPutSettings_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterPutSettings 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClusterPutSettingsResponseContent" - } - } - } - } - }, - "x-operation-group": "cluster.put_settings", - "x-version-added": "1.0" - } - }, - "/_cluster/state": { - "get": { - "description": "Returns a comprehensive information about the state of the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ClusterState", - "parameters": [ - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "wait_for_metadata_version", - "in": "query", - "description": "Wait for the metadata version to be equal or greater than the specified metadata version.", - "schema": { - "type": "integer", - "description": "Wait for the metadata version to be equal or greater than the specified metadata version.", - "format": "int32" - } - }, - { - "name": "wait_for_timeout", - "in": "query", - "description": "The maximum time to wait for wait_for_metadata_version before timing out.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The maximum time to wait for wait_for_metadata_version before timing out.", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "ClusterState 200 response" - } - }, - "x-operation-group": "cluster.state", - "x-version-added": "1.0" - } - }, - "/_cluster/state/{metric}": { - "get": { - "description": "Returns a comprehensive information about the state of the cluster.", - "operationId": "ClusterState_WithMetric", - "parameters": [ - { - "name": "metric", - "in": "path", - "description": "Limit the information returned to the specified metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to the specified metrics.", - "x-enum-options": [ - "_all", - "blocks", - "metadata", - "nodes", - "routing_table", - "routing_nodes", - "master_node", - "cluster_manager_node", - "version" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "wait_for_metadata_version", - "in": "query", - "description": "Wait for the metadata version to be equal or greater than the specified metadata version.", - "schema": { - "type": "integer", - "description": "Wait for the metadata version to be equal or greater than the specified metadata version.", - "format": "int32" - } - }, - { - "name": "wait_for_timeout", - "in": "query", - "description": "The maximum time to wait for wait_for_metadata_version before timing out.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The maximum time to wait for wait_for_metadata_version before timing out.", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "ClusterState_WithMetric 200 response" - } - }, - "x-operation-group": "cluster.state", - "x-version-added": "1.0" - } - }, - "/_cluster/state/{metric}/{index}": { - "get": { - "description": "Returns a comprehensive information about the state of the cluster.", - "operationId": "ClusterState_WithIndexMetric", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "metric", - "in": "path", - "description": "Limit the information returned to the specified metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to the specified metrics.", - "x-enum-options": [ - "_all", - "blocks", - "metadata", - "nodes", - "routing_table", - "routing_nodes", - "master_node", - "cluster_manager_node", - "version" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "wait_for_metadata_version", - "in": "query", - "description": "Wait for the metadata version to be equal or greater than the specified metadata version.", - "schema": { - "type": "integer", - "description": "Wait for the metadata version to be equal or greater than the specified metadata version.", - "format": "int32" - } - }, - { - "name": "wait_for_timeout", - "in": "query", - "description": "The maximum time to wait for wait_for_metadata_version before timing out.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The maximum time to wait for wait_for_metadata_version before timing out.", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "ClusterState_WithIndexMetric 200 response" - } - }, - "x-operation-group": "cluster.state", - "x-version-added": "1.0" - } - }, - "/_cluster/stats": { - "get": { - "description": "Returns high-level overview of cluster statistics.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-stats/" - }, - "operationId": "ClusterStats", - "parameters": [ - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterStats 200 response" - } - }, - "x-operation-group": "cluster.stats", - "x-version-added": "1.0" - } - }, - "/_cluster/stats/nodes/{node_id}": { - "get": { - "description": "Returns high-level overview of cluster statistics.", - "operationId": "ClusterStats_WithNodeId", - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterStats_WithNodeId 200 response" - } - }, - "x-operation-group": "cluster.stats", - "x-version-added": "1.0" - } - }, - "/_cluster/voting_config_exclusions": { - "delete": { - "description": "Clears cluster voting config exclusions.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ClusterDeleteVotingConfigExclusions", - "parameters": [ - { - "name": "wait_for_removal", - "in": "query", - "description": "Specifies whether to wait for all excluded nodes to be removed from the cluster before clearing the voting configuration exclusions list.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies whether to wait for all excluded nodes to be removed from the cluster before clearing the voting configuration exclusions list." - } - } - ], - "responses": { - "200": { - "description": "ClusterDeleteVotingConfigExclusions 200 response" - } - }, - "x-operation-group": "cluster.delete_voting_config_exclusions", - "x-version-added": "1.0" - }, - "post": { - "description": "Updates the cluster voting config exclusions by node ids or node names.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ClusterPostVotingConfigExclusions", - "parameters": [ - { - "name": "node_ids", - "in": "query", - "description": "Comma-separated list of the persistent ids of the nodes to exclude from the voting configuration. If specified, you may not also specify ?node_names.", - "schema": { - "type": "string", - "description": "Comma-separated list of the persistent ids of the nodes to exclude from the voting configuration. If specified, you may not also specify ?node_names." - } - }, - { - "name": "node_names", - "in": "query", - "description": "Comma-separated list of the names of the nodes to exclude from the voting configuration. If specified, you may not also specify ?node_ids.", - "schema": { - "type": "string", - "description": "Comma-separated list of the names of the nodes to exclude from the voting configuration. If specified, you may not also specify ?node_ids." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterPostVotingConfigExclusions 200 response" - } - }, - "x-operation-group": "cluster.post_voting_config_exclusions", - "x-version-added": "1.0" - } - }, - "/_component_template": { - "get": { - "description": "Returns one or more component templates.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ClusterGetComponentTemplate", - "parameters": [ - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "ClusterGetComponentTemplate 200 response" - } - }, - "x-operation-group": "cluster.get_component_template", - "x-version-added": "1.0" - } - }, - "/_component_template/{name}": { - "delete": { - "description": "Deletes a component template.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ClusterDeleteComponentTemplate", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterDeleteComponentTemplate 200 response" - } - }, - "x-operation-group": "cluster.delete_component_template", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns one or more component templates.", - "operationId": "ClusterGetComponentTemplate_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The Comma-separated names of the component templates.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The Comma-separated names of the component templates.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "ClusterGetComponentTemplate_WithName 200 response" - } - }, - "x-operation-group": "cluster.get_component_template", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns information about whether a particular component template exist.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ClusterExistsComponentTemplate", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "ClusterExistsComponentTemplate 200 response" - } - }, - "x-operation-group": "cluster.exists_component_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates or updates a component template.", - "operationId": "ClusterPutComponentTemplate_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClusterPutComponentTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "create", - "in": "query", - "description": "Whether the index template should only be added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template should only be added if new or can also replace an existing one." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterPutComponentTemplate_Post 200 response" - } - }, - "x-operation-group": "cluster.put_component_template", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates a component template.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-templates/#use-component-templates-to-create-an-index-template" - }, - "operationId": "ClusterPutComponentTemplate_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClusterPutComponentTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "create", - "in": "query", - "description": "Whether the index template should only be added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template should only be added if new or can also replace an existing one." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "ClusterPutComponentTemplate_Put 200 response" - } - }, - "x-operation-group": "cluster.put_component_template", - "x-version-added": "1.0" - } - }, - "/_count": { - "get": { - "description": "Returns number of documents matching a query.", - "operationId": "Count_Get", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "min_score", - "in": "query", - "description": "Include only documents with a specific `_score` value in the result.", - "schema": { - "type": "integer", - "description": "Include only documents with a specific `_score` value in the result.", - "format": "int32" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - } - ], - "responses": { - "200": { - "description": "Count_Get 200 response" - } - }, - "x-operation-group": "count", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns number of documents matching a query.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/count/" - }, - "operationId": "Count_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Count_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "min_score", - "in": "query", - "description": "Include only documents with a specific `_score` value in the result.", - "schema": { - "type": "integer", - "description": "Include only documents with a specific `_score` value in the result.", - "format": "int32" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - } - ], - "responses": { - "200": { - "description": "Count_Post 200 response" - } - }, - "x-operation-group": "count", - "x-version-added": "1.0" - } - }, - "/_dangling": { - "get": { - "description": "Returns all dangling indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/dangling-index/" - }, - "operationId": "DanglingIndicesListDanglingIndices", - "responses": { - "200": { - "description": "DanglingIndicesListDanglingIndices 200 response" - } - }, - "x-operation-group": "dangling_indices.list_dangling_indices", - "x-version-added": "1.0" - } - }, - "/_dangling/{index_uuid}": { - "delete": { - "description": "Deletes the specified dangling index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/dangling-index/" - }, - "operationId": "DanglingIndicesDeleteDanglingIndex", - "parameters": [ - { - "name": "index_uuid", - "in": "path", - "description": "The UUID of the dangling index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The UUID of the dangling index." - }, - "required": true - }, - { - "name": "accept_data_loss", - "in": "query", - "description": "Must be set to true in order to delete the dangling index.", - "schema": { - "type": "boolean", - "description": "Must be set to true in order to delete the dangling index." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "DanglingIndicesDeleteDanglingIndex 200 response" - } - }, - "x-operation-group": "dangling_indices.delete_dangling_index", - "x-version-added": "1.0" - }, - "post": { - "description": "Imports the specified dangling index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/dangling-index/" - }, - "operationId": "DanglingIndicesImportDanglingIndex", - "parameters": [ - { - "name": "index_uuid", - "in": "path", - "description": "The UUID of the dangling index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The UUID of the dangling index." - }, - "required": true - }, - { - "name": "accept_data_loss", - "in": "query", - "description": "Must be set to true in order to import the dangling index.", - "schema": { - "type": "boolean", - "description": "Must be set to true in order to import the dangling index." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "DanglingIndicesImportDanglingIndex 200 response" - } - }, - "x-operation-group": "dangling_indices.import_dangling_index", - "x-version-added": "1.0" - } - }, - "/_data_stream": { - "get": { - "description": "Returns data streams.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/data-streams/" - }, - "operationId": "IndicesGetDataStream", - "responses": { - "200": { - "description": "IndicesGetDataStream 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesGetDataStreamResponseContent" - } - } - } - } - }, - "x-operation-group": "indices.get_data_stream", - "x-version-added": "1.0" - } - }, - "/_data_stream/_stats": { - "get": { - "description": "Provides statistics on operations happening in a data stream.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/data-streams/" - }, - "operationId": "IndicesDataStreamsStats", - "responses": { - "200": { - "description": "IndicesDataStreamsStats 200 response" - } - }, - "x-operation-group": "indices.data_streams_stats", - "x-version-added": "1.0" - } - }, - "/_data_stream/{name}": { - "delete": { - "description": "Deletes a data stream.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/data-streams/" - }, - "operationId": "IndicesDeleteDataStream", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated list of data streams; use `_all` or empty string to perform the operation on all data streams.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of data streams; use `_all` or empty string to perform the operation on all data streams.", - "x-data-type": "array" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "IndicesDeleteDataStream 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesDeleteDataStreamResponseContent" - } - } - } - } - }, - "x-operation-group": "indices.delete_data_stream", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns data streams.", - "operationId": "IndicesGetDataStream_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated list of data streams; use `_all` or empty string to perform the operation on all data streams.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of data streams; use `_all` or empty string to perform the operation on all data streams.", - "x-data-type": "array" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "IndicesGetDataStream_WithName 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesGetDataStream_WithNameResponseContent" - } - } - } - } - }, - "x-operation-group": "indices.get_data_stream", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates a data stream.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/data-streams/" - }, - "operationId": "IndicesCreateDataStream", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesCreateDataStream_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the data stream.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the data stream." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "IndicesCreateDataStream 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesCreateDataStreamResponseContent" - } - } - } - } - }, - "x-operation-group": "indices.create_data_stream", - "x-version-added": "1.0" - } - }, - "/_data_stream/{name}/_stats": { - "get": { - "description": "Provides statistics on operations happening in a data stream.", - "operationId": "IndicesDataStreamsStats_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated list of data streams; use `_all` or empty string to perform the operation on all data streams.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of data streams; use `_all` or empty string to perform the operation on all data streams.", - "x-data-type": "array" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "IndicesDataStreamsStats_WithName 200 response" - } - }, - "x-operation-group": "indices.data_streams_stats", - "x-version-added": "1.0" - } - }, - "/_delete_by_query/{task_id}/_rethrottle": { - "post": { - "description": "Changes the number of requests per second for a particular Delete By Query operation.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "DeleteByQueryRethrottle", - "parameters": [ - { - "name": "task_id", - "in": "path", - "description": "The task id to rethrottle.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The task id to rethrottle." - }, - "required": true - }, - { - "name": "requests_per_second", - "in": "query", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "schema": { - "type": "integer", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "format": "int32" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "DeleteByQueryRethrottle 200 response" - } - }, - "x-operation-group": "delete_by_query_rethrottle", - "x-version-added": "1.0" - } - }, - "/_field_caps": { - "get": { - "description": "Returns the information about the capabilities of fields among multiple indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/field-types/supported-field-types/alias/#using-aliases-in-field-capabilities-api-operations" - }, - "operationId": "FieldCaps_Get", - "parameters": [ - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of field names.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of field names." - }, - "explode": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "include_unmapped", - "in": "query", - "description": "Indicates whether unmapped fields should be included in the response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether unmapped fields should be included in the response." - } - } - ], - "responses": { - "200": { - "description": "FieldCaps_Get 200 response" - } - }, - "x-operation-group": "field_caps", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns the information about the capabilities of fields among multiple indices.", - "operationId": "FieldCaps_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/FieldCaps_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of field names.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of field names." - }, - "explode": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "include_unmapped", - "in": "query", - "description": "Indicates whether unmapped fields should be included in the response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether unmapped fields should be included in the response." - } - } - ], - "responses": { - "200": { - "description": "FieldCaps_Post 200 response" - } - }, - "x-operation-group": "field_caps", - "x-version-added": "1.0" - } - }, - "/_flush": { - "get": { - "description": "Performs the flush operation on one or more indices.", - "operationId": "IndicesFlush_Get", - "parameters": [ - { - "name": "force", - "in": "query", - "description": "Whether a flush should be forced even if it is not necessarily needed ie. if no changes will be committed to the index. This is useful if transaction log IDs should be incremented even if no uncommitted changes are present. (This setting can be considered as internal).", - "schema": { - "type": "boolean", - "description": "Whether a flush should be forced even if it is not necessarily needed ie. if no changes will be committed to the index. This is useful if transaction log IDs should be incremented even if no uncommitted changes are present. (This setting can be considered as internal)." - } - }, - { - "name": "wait_if_ongoing", - "in": "query", - "description": "If set to true the flush operation will block until the flush can be executed if another flush operation is already executing. If set to false the flush will be skipped iff if another flush operation is already running.", - "schema": { - "type": "boolean", - "default": true, - "description": "If set to true the flush operation will block until the flush can be executed if another flush operation is already executing. If set to false the flush will be skipped iff if another flush operation is already running." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesFlush_Get 200 response" - } - }, - "x-operation-group": "indices.flush", - "x-version-added": "1.0" - }, - "post": { - "description": "Performs the flush operation on one or more indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesFlush_Post", - "parameters": [ - { - "name": "force", - "in": "query", - "description": "Whether a flush should be forced even if it is not necessarily needed ie. if no changes will be committed to the index. This is useful if transaction log IDs should be incremented even if no uncommitted changes are present. (This setting can be considered as internal).", - "schema": { - "type": "boolean", - "description": "Whether a flush should be forced even if it is not necessarily needed ie. if no changes will be committed to the index. This is useful if transaction log IDs should be incremented even if no uncommitted changes are present. (This setting can be considered as internal)." - } - }, - { - "name": "wait_if_ongoing", - "in": "query", - "description": "If set to true the flush operation will block until the flush can be executed if another flush operation is already executing. If set to false the flush will be skipped iff if another flush operation is already running.", - "schema": { - "type": "boolean", - "default": true, - "description": "If set to true the flush operation will block until the flush can be executed if another flush operation is already executing. If set to false the flush will be skipped iff if another flush operation is already running." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesFlush_Post 200 response" - } - }, - "x-operation-group": "indices.flush", - "x-version-added": "1.0" - } - }, - "/_forcemerge": { - "post": { - "description": "Performs the force merge operation on one or more indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesForcemerge", - "parameters": [ - { - "name": "flush", - "in": "query", - "description": "Specify whether the index should be flushed after performing the operation.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specify whether the index should be flushed after performing the operation." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "max_num_segments", - "in": "query", - "description": "The number of segments the index should be merged into (default: dynamic).", - "schema": { - "type": "integer", - "description": "The number of segments the index should be merged into (default: dynamic).", - "format": "int32" - } - }, - { - "name": "only_expunge_deletes", - "in": "query", - "description": "Specify whether the operation should only expunge deleted documents.", - "schema": { - "type": "boolean", - "description": "Specify whether the operation should only expunge deleted documents." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - } - ], - "responses": { - "200": { - "description": "IndicesForcemerge 200 response" - } - }, - "x-operation-group": "indices.forcemerge", - "x-version-added": "1.0" - } - }, - "/_index_template": { - "get": { - "description": "Returns an index template.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-templates/" - }, - "operationId": "IndicesGetIndexTemplate", - "parameters": [ - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetIndexTemplate 200 response" - } - }, - "x-operation-group": "indices.get_index_template", - "x-version-added": "1.0" - } - }, - "/_index_template/_simulate": { - "post": { - "description": "Simulate resolving the given template name or body.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesSimulateTemplate", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesSimulateTemplate_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "create", - "in": "query", - "description": "Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one." - } - }, - { - "name": "cause", - "in": "query", - "description": "User defined reason for dry-run creating the new template for simulation purposes.", - "schema": { - "type": "string", - "default": "false", - "description": "User defined reason for dry-run creating the new template for simulation purposes." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesSimulateTemplate 200 response" - } - }, - "x-operation-group": "indices.simulate_template", - "x-version-added": "1.0" - } - }, - "/_index_template/_simulate/{name}": { - "post": { - "description": "Simulate resolving the given template name or body.", - "operationId": "IndicesSimulateTemplate_WithName", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesSimulateTemplate_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "create", - "in": "query", - "description": "Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one." - } - }, - { - "name": "cause", - "in": "query", - "description": "User defined reason for dry-run creating the new template for simulation purposes.", - "schema": { - "type": "string", - "default": "false", - "description": "User defined reason for dry-run creating the new template for simulation purposes." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesSimulateTemplate_WithName 200 response" - } - }, - "x-operation-group": "indices.simulate_template", - "x-version-added": "1.0" - } - }, - "/_index_template/_simulate_index/{name}": { - "post": { - "description": "Simulate matching the given index name against the index templates in the system.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesSimulateIndexTemplate", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesSimulateIndexTemplate_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the index (it must be a concrete index name).", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the index (it must be a concrete index name)." - }, - "required": true - }, - { - "name": "create", - "in": "query", - "description": "Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template we optionally defined in the body should only be dry-run added if new or can also replace an existing one." - } - }, - { - "name": "cause", - "in": "query", - "description": "User defined reason for dry-run creating the new template for simulation purposes.", - "schema": { - "type": "string", - "default": "false", - "description": "User defined reason for dry-run creating the new template for simulation purposes." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesSimulateIndexTemplate 200 response" - } - }, - "x-operation-group": "indices.simulate_index_template", - "x-version-added": "1.0" - } - }, - "/_index_template/{name}": { - "delete": { - "description": "Deletes an index template.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-templates/#delete-a-template" - }, - "operationId": "IndicesDeleteIndexTemplate", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesDeleteIndexTemplate 200 response" - } - }, - "x-operation-group": "indices.delete_index_template", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns an index template.", - "operationId": "IndicesGetIndexTemplate_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated names of the index templates.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated names of the index templates.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetIndexTemplate_WithName 200 response" - } - }, - "x-operation-group": "indices.get_index_template", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns information about whether a particular index template exists.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-templates/" - }, - "operationId": "IndicesExistsIndexTemplate", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesExistsIndexTemplate 200 response" - } - }, - "x-operation-group": "indices.exists_index_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates or updates an index template.", - "operationId": "IndicesPutIndexTemplate_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutIndexTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "create", - "in": "query", - "description": "Whether the index template should only be added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template should only be added if new or can also replace an existing one." - } - }, - { - "name": "cause", - "in": "query", - "description": "User defined reason for creating/updating the index template.", - "schema": { - "type": "string", - "default": "false", - "description": "User defined reason for creating/updating the index template." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesPutIndexTemplate_Post 200 response" - } - }, - "x-operation-group": "indices.put_index_template", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates an index template.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-templates/" - }, - "operationId": "IndicesPutIndexTemplate_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutIndexTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "create", - "in": "query", - "description": "Whether the index template should only be added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template should only be added if new or can also replace an existing one." - } - }, - { - "name": "cause", - "in": "query", - "description": "User defined reason for creating/updating the index template.", - "schema": { - "type": "string", - "default": "false", - "description": "User defined reason for creating/updating the index template." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesPutIndexTemplate_Put 200 response" - } - }, - "x-operation-group": "indices.put_index_template", - "x-version-added": "1.0" - } - }, - "/_ingest/pipeline": { - "get": { - "description": "Returns a pipeline.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/ingest-apis/get-ingest/" - }, - "operationId": "IngestGetPipeline", - "parameters": [ - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IngestGetPipeline 200 response" - } - }, - "x-operation-group": "ingest.get_pipeline", - "x-version-added": "1.0" - } - }, - "/_ingest/pipeline/_simulate": { - "get": { - "description": "Allows to simulate a pipeline with example documents.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/ingest-apis/simulate-ingest/" - }, - "operationId": "IngestSimulate_Get", - "parameters": [ - { - "name": "verbose", - "in": "query", - "description": "Verbose mode. Display data output for each processor in executed pipeline.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display data output for each processor in executed pipeline." - } - } - ], - "responses": { - "200": { - "description": "IngestSimulate_Get 200 response" - } - }, - "x-operation-group": "ingest.simulate", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to simulate a pipeline with example documents.", - "operationId": "IngestSimulate_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IngestSimulate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "verbose", - "in": "query", - "description": "Verbose mode. Display data output for each processor in executed pipeline.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display data output for each processor in executed pipeline." - } - } - ], - "responses": { - "200": { - "description": "IngestSimulate_Post 200 response" - } - }, - "x-operation-group": "ingest.simulate", - "x-version-added": "1.0" - } - }, - "/_ingest/pipeline/{id}": { - "delete": { - "description": "Deletes a pipeline.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/ingest-apis/delete-ingest/" - }, - "operationId": "IngestDeletePipeline", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Pipeline ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Pipeline ID." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IngestDeletePipeline 200 response" - } - }, - "x-operation-group": "ingest.delete_pipeline", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns a pipeline.", - "operationId": "IngestGetPipeline_WithId", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Comma-separated list of pipeline ids. Wildcards supported.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of pipeline ids. Wildcards supported.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IngestGetPipeline_WithId 200 response" - } - }, - "x-operation-group": "ingest.get_pipeline", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates a pipeline.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/ingest-apis/create-update-ingest/" - }, - "operationId": "IngestPutPipeline", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IngestPutPipeline_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Pipeline ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Pipeline ID." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IngestPutPipeline 200 response" - } - }, - "x-operation-group": "ingest.put_pipeline", - "x-version-added": "1.0" - } - }, - "/_ingest/pipeline/{id}/_simulate": { - "get": { - "description": "Allows to simulate a pipeline with example documents.", - "operationId": "IngestSimulate_Get_WithId", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Pipeline ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Pipeline ID." - }, - "required": true - }, - { - "name": "verbose", - "in": "query", - "description": "Verbose mode. Display data output for each processor in executed pipeline.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display data output for each processor in executed pipeline." - } - } - ], - "responses": { - "200": { - "description": "IngestSimulate_Get_WithId 200 response" - } - }, - "x-operation-group": "ingest.simulate", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to simulate a pipeline with example documents.", - "operationId": "IngestSimulate_Post_WithId", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IngestSimulate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Pipeline ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Pipeline ID." - }, - "required": true - }, - { - "name": "verbose", - "in": "query", - "description": "Verbose mode. Display data output for each processor in executed pipeline.", - "schema": { - "type": "boolean", - "default": false, - "description": "Verbose mode. Display data output for each processor in executed pipeline." - } - } - ], - "responses": { - "200": { - "description": "IngestSimulate_Post_WithId 200 response" - } - }, - "x-operation-group": "ingest.simulate", - "x-version-added": "1.0" - } - }, - "/_ingest/processor/grok": { - "get": { - "description": "Returns a list of the built-in patterns.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IngestProcessorGrok", - "responses": { - "200": { - "description": "IngestProcessorGrok 200 response" - } - }, - "x-operation-group": "ingest.processor_grok", - "x-version-added": "1.0" - } - }, - "/_mapping": { - "get": { - "description": "Returns mappings for one or more indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/field-types/index/#get-a-mapping" - }, - "operationId": "IndicesGetMapping", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "x-version-deprecated": "1.0", - "x-deprecation-message": "This parameter is a no-op and field mappings are always retrieved locally.", - "deprecated": true - } - } - ], - "responses": { - "200": { - "description": "IndicesGetMapping 200 response" - } - }, - "x-operation-group": "indices.get_mapping", - "x-version-added": "1.0" - } - }, - "/_mapping/field/{fields}": { - "get": { - "description": "Returns mapping for one or more fields.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/field-types/index/" - }, - "operationId": "IndicesGetFieldMapping", - "parameters": [ - { - "name": "fields", - "in": "path", - "description": "Comma-separated list of fields.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of fields.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether the default mapping values should be returned as well.", - "schema": { - "type": "boolean", - "description": "Whether the default mapping values should be returned as well." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetFieldMapping 200 response" - } - }, - "x-operation-group": "indices.get_field_mapping", - "x-version-added": "1.0" - } - }, - "/_mget": { - "get": { - "description": "Allows to get multiple documents in one request.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/multi-get/" - }, - "operationId": "Mget_Get", - "parameters": [ - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specify whether to perform the operation in realtime or search mode.", - "schema": { - "type": "boolean", - "description": "Specify whether to perform the operation in realtime or search mode." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "Mget_Get 200 response" - } - }, - "x-operation-group": "mget", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to get multiple documents in one request.", - "operationId": "Mget_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Mget_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specify whether to perform the operation in realtime or search mode.", - "schema": { - "type": "boolean", - "description": "Specify whether to perform the operation in realtime or search mode." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "Mget_Post 200 response" - } - }, - "x-operation-group": "mget", - "x-version-added": "1.0" - } - }, - "/_msearch": { - "get": { - "description": "Allows to execute several search operations in one request.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/multi-search/" - }, - "operationId": "Msearch_Get", - "parameters": [ - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "max_concurrent_searches", - "in": "query", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "schema": { - "type": "integer", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "format": "int32" - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "pre_filter_shard_size", - "in": "query", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "schema": { - "type": "integer", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "format": "int32" - } - }, - { - "name": "max_concurrent_shard_requests", - "in": "query", - "description": "The number of concurrent shard requests each sub search executes concurrently per node. 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.", - "schema": { - "type": "integer", - "default": 5, - "description": "The number of concurrent shard requests each sub search executes concurrently per node. 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.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "Msearch_Get 200 response" - } - }, - "x-operation-group": "msearch", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to execute several search operations in one request.", - "operationId": "Msearch_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Msearch_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "max_concurrent_searches", - "in": "query", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "schema": { - "type": "integer", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "format": "int32" - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "pre_filter_shard_size", - "in": "query", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "schema": { - "type": "integer", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "format": "int32" - } - }, - { - "name": "max_concurrent_shard_requests", - "in": "query", - "description": "The number of concurrent shard requests each sub search executes concurrently per node. 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.", - "schema": { - "type": "integer", - "default": 5, - "description": "The number of concurrent shard requests each sub search executes concurrently per node. 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.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "Msearch_Post 200 response" - } - }, - "x-operation-group": "msearch", - "x-version-added": "1.0" - } - }, - "/_msearch/template": { - "get": { - "description": "Allows to execute several search template operations in one request.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/search-template/" - }, - "operationId": "MsearchTemplate_Get", - "parameters": [ - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "max_concurrent_searches", - "in": "query", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "schema": { - "type": "integer", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "MsearchTemplate_Get 200 response" - } - }, - "x-operation-group": "msearch_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to execute several search template operations in one request.", - "operationId": "MsearchTemplate_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/MsearchTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "max_concurrent_searches", - "in": "query", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "schema": { - "type": "integer", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "MsearchTemplate_Post 200 response" - } - }, - "x-operation-group": "msearch_template", - "x-version-added": "1.0" - } - }, - "/_mtermvectors": { - "get": { - "description": "Returns multiple termvectors in one request.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "Mtermvectors_Get", - "parameters": [ - { - "name": "ids", - "in": "query", - "description": "Comma-separated list of documents ids. You must define ids as parameter or set 'ids' or 'docs' in the request body.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of documents ids. You must define ids as parameter or set 'ids' or 'docs' in the request body." - }, - "explode": true - }, - { - "name": "term_statistics", - "in": "query", - "description": "Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "field_statistics", - "in": "query", - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - }, - "explode": true - }, - { - "name": "offsets", - "in": "query", - "description": "Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "positions", - "in": "query", - "description": "Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "payloads", - "in": "query", - "description": "Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "string", - "description": "Routing value. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specifies if requests are real-time as opposed to near-real-time.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if requests are real-time as opposed to near-real-time." - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Mtermvectors_Get 200 response" - } - }, - "x-operation-group": "mtermvectors", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns multiple termvectors in one request.", - "operationId": "Mtermvectors_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Mtermvectors_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "ids", - "in": "query", - "description": "Comma-separated list of documents ids. You must define ids as parameter or set 'ids' or 'docs' in the request body.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of documents ids. You must define ids as parameter or set 'ids' or 'docs' in the request body." - }, - "explode": true - }, - { - "name": "term_statistics", - "in": "query", - "description": "Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "field_statistics", - "in": "query", - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - }, - "explode": true - }, - { - "name": "offsets", - "in": "query", - "description": "Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "positions", - "in": "query", - "description": "Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "payloads", - "in": "query", - "description": "Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "string", - "description": "Routing value. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specifies if requests are real-time as opposed to near-real-time.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if requests are real-time as opposed to near-real-time." - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Mtermvectors_Post 200 response" - } - }, - "x-operation-group": "mtermvectors", - "x-version-added": "1.0" - } - }, - "/_nodes": { - "get": { - "description": "Returns information about nodes in the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-info/" - }, - "operationId": "NodesInfo", - "parameters": [ - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesInfo 200 response" - } - }, - "x-operation-group": "nodes.info", - "x-version-added": "1.0" - } - }, - "/_nodes/hot_threads": { - "get": { - "description": "Returns information about hot threads on each node in the cluster.", - "operationId": "NodesHotThreads", - "parameters": [ - { - "name": "interval", - "in": "query", - "description": "The interval for the second sampling of threads.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The interval for the second sampling of threads.", - "x-data-type": "time" - } - }, - { - "name": "snapshots", - "in": "query", - "description": "Number of samples of thread stacktrace.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of samples of thread stacktrace.", - "format": "int32" - } - }, - { - "name": "threads", - "in": "query", - "description": "Specify the number of threads to provide information for.", - "schema": { - "type": "integer", - "default": 3, - "description": "Specify the number of threads to provide information for.", - "format": "int32" - } - }, - { - "name": "ignore_idle_threads", - "in": "query", - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue.", - "schema": { - "type": "boolean", - "default": true, - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue." - } - }, - { - "name": "type", - "in": "query", - "description": "The type to sample.", - "schema": { - "$ref": "#/components/schemas/SampleType" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesHotThreads 200 response" - } - }, - "x-operation-group": "nodes.hot_threads", - "x-version-added": "1.0" - } - }, - "/_nodes/hotthreads": { - "get": { - "description": "Returns information about hot threads on each node in the cluster.", - "operationId": "NodesHotThreads_Deprecated", - "deprecated": true, - "parameters": [ - { - "name": "interval", - "in": "query", - "description": "The interval for the second sampling of threads.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The interval for the second sampling of threads.", - "x-data-type": "time" - } - }, - { - "name": "snapshots", - "in": "query", - "description": "Number of samples of thread stacktrace.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of samples of thread stacktrace.", - "format": "int32" - } - }, - { - "name": "threads", - "in": "query", - "description": "Specify the number of threads to provide information for.", - "schema": { - "type": "integer", - "default": 3, - "description": "Specify the number of threads to provide information for.", - "format": "int32" - } - }, - { - "name": "ignore_idle_threads", - "in": "query", - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue.", - "schema": { - "type": "boolean", - "default": true, - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue." - } - }, - { - "name": "type", - "in": "query", - "description": "The type to sample.", - "schema": { - "$ref": "#/components/schemas/SampleType" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesHotThreads_Deprecated 200 response" - } - }, - "x-deprecation-message": "The hot threads API accepts `hotthreads` but only `hot_threads` is documented", - "x-ignorable": true, - "x-operation-group": "nodes.hot_threads", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - } - }, - "/_nodes/reload_secure_settings": { - "post": { - "description": "Reloads secure settings.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-reload-secure/" - }, - "operationId": "NodesReloadSecureSettings", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/NodesReloadSecureSettings_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesReloadSecureSettings 200 response" - } - }, - "x-operation-group": "nodes.reload_secure_settings", - "x-version-added": "1.0" - } - }, - "/_nodes/stats": { - "get": { - "description": "Returns statistical information about nodes in the cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-usage/" - }, - "operationId": "NodesStats", - "parameters": [ - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return indices stats aggregated at index, node or shard level.", - "schema": { - "$ref": "#/components/schemas/NodesStatLevel" - } - }, - { - "name": "types", - "in": "query", - "description": "Comma-separated list of document types for the `indexing` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of document types for the `indexing` index metric." - }, - "explode": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - } - ], - "responses": { - "200": { - "description": "NodesStats 200 response" - } - }, - "x-operation-group": "nodes.stats", - "x-version-added": "1.0" - } - }, - "/_nodes/stats/{metric}": { - "get": { - "description": "Returns statistical information about nodes in the cluster.", - "operationId": "NodesStats_WithMetric", - "parameters": [ - { - "name": "metric", - "in": "path", - "description": "Limit the information returned to the specified metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to the specified metrics.", - "x-enum-options": [ - "_all", - "breaker", - "fs", - "http", - "indices", - "jvm", - "os", - "process", - "thread_pool", - "transport", - "discovery", - "indexing_pressure", - "search_pipeline" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return indices stats aggregated at index, node or shard level.", - "schema": { - "$ref": "#/components/schemas/NodesStatLevel" - } - }, - { - "name": "types", - "in": "query", - "description": "Comma-separated list of document types for the `indexing` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of document types for the `indexing` index metric." - }, - "explode": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - } - ], - "responses": { - "200": { - "description": "NodesStats_WithMetric 200 response" - } - }, - "x-operation-group": "nodes.stats", - "x-version-added": "1.0" - } - }, - "/_nodes/stats/{metric}/{index_metric}": { - "get": { - "description": "Returns statistical information about nodes in the cluster.", - "operationId": "NodesStats_WithIndexMetricMetric", - "parameters": [ - { - "name": "metric", - "in": "path", - "description": "Limit the information returned to the specified metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to the specified metrics.", - "x-enum-options": [ - "_all", - "breaker", - "fs", - "http", - "indices", - "jvm", - "os", - "process", - "thread_pool", - "transport", - "discovery", - "indexing_pressure", - "search_pipeline" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "index_metric", - "in": "path", - "description": "Limit the information returned for `indices` metric to the specific index metrics. Isn't used if `indices` (or `all`) metric isn't specified.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned for `indices` metric to the specific index metrics. Isn't used if `indices` (or `all`) metric isn't specified.", - "x-enum-options": [ - "_all", - "store", - "indexing", - "get", - "search", - "merge", - "flush", - "refresh", - "query_cache", - "fielddata", - "docs", - "warmer", - "completion", - "segments", - "translog", - "suggest", - "request_cache", - "recovery" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return indices stats aggregated at index, node or shard level.", - "schema": { - "$ref": "#/components/schemas/NodesStatLevel" - } - }, - { - "name": "types", - "in": "query", - "description": "Comma-separated list of document types for the `indexing` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of document types for the `indexing` index metric." - }, - "explode": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - } - ], - "responses": { - "200": { - "description": "NodesStats_WithIndexMetricMetric 200 response" - } - }, - "x-operation-group": "nodes.stats", - "x-version-added": "1.0" - } - }, - "/_nodes/usage": { - "get": { - "description": "Returns low-level information about REST actions usage on nodes.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "NodesUsage", - "parameters": [ - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesUsage 200 response" - } - }, - "x-operation-group": "nodes.usage", - "x-version-added": "1.0" - } - }, - "/_nodes/usage/{metric}": { - "get": { - "description": "Returns low-level information about REST actions usage on nodes.", - "operationId": "NodesUsage_WithMetric", - "parameters": [ - { - "name": "metric", - "in": "path", - "description": "Limit the information returned to the specified metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to the specified metrics.", - "x-enum-options": [ - "_all", - "rest_actions" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesUsage_WithMetric 200 response" - } - }, - "x-operation-group": "nodes.usage", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}": { - "get": { - "description": "Returns information about nodes in the cluster.", - "operationId": "NodesInfo_WithNodeId", - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-overloaded-param": "metric", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesInfo_WithNodeId 200 response" - } - }, - "x-operation-group": "nodes.info", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}/hot_threads": { - "get": { - "description": "Returns information about hot threads on each node in the cluster.", - "operationId": "NodesHotThreads_WithNodeId", - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "interval", - "in": "query", - "description": "The interval for the second sampling of threads.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The interval for the second sampling of threads.", - "x-data-type": "time" - } - }, - { - "name": "snapshots", - "in": "query", - "description": "Number of samples of thread stacktrace.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of samples of thread stacktrace.", - "format": "int32" - } - }, - { - "name": "threads", - "in": "query", - "description": "Specify the number of threads to provide information for.", - "schema": { - "type": "integer", - "default": 3, - "description": "Specify the number of threads to provide information for.", - "format": "int32" - } - }, - { - "name": "ignore_idle_threads", - "in": "query", - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue.", - "schema": { - "type": "boolean", - "default": true, - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue." - } - }, - { - "name": "type", - "in": "query", - "description": "The type to sample.", - "schema": { - "$ref": "#/components/schemas/SampleType" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesHotThreads_WithNodeId 200 response" - } - }, - "x-operation-group": "nodes.hot_threads", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}/hotthreads": { - "get": { - "description": "Returns information about hot threads on each node in the cluster.", - "operationId": "NodesHotThreads_WithNodeId_Deprecated", - "deprecated": true, - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "interval", - "in": "query", - "description": "The interval for the second sampling of threads.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "The interval for the second sampling of threads.", - "x-data-type": "time" - } - }, - { - "name": "snapshots", - "in": "query", - "description": "Number of samples of thread stacktrace.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of samples of thread stacktrace.", - "format": "int32" - } - }, - { - "name": "threads", - "in": "query", - "description": "Specify the number of threads to provide information for.", - "schema": { - "type": "integer", - "default": 3, - "description": "Specify the number of threads to provide information for.", - "format": "int32" - } - }, - { - "name": "ignore_idle_threads", - "in": "query", - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue.", - "schema": { - "type": "boolean", - "default": true, - "description": "Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue." - } - }, - { - "name": "type", - "in": "query", - "description": "The type to sample.", - "schema": { - "$ref": "#/components/schemas/SampleType" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesHotThreads_WithNodeId_Deprecated 200 response" - } - }, - "x-deprecation-message": "The hot threads API accepts `hotthreads` but only `hot_threads` is documented", - "x-ignorable": true, - "x-operation-group": "nodes.hot_threads", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - } - }, - "/_nodes/{node_id}/reload_secure_settings": { - "post": { - "description": "Reloads secure settings.", - "operationId": "NodesReloadSecureSettings_WithNodeId", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/NodesReloadSecureSettings_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "Comma-separated list of node IDs to span the reload/reinit call. Should stay empty because reloading usually involves all cluster nodes.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of node IDs to span the reload/reinit call. Should stay empty because reloading usually involves all cluster nodes.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesReloadSecureSettings_WithNodeId 200 response" - } - }, - "x-operation-group": "nodes.reload_secure_settings", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}/stats": { - "get": { - "description": "Returns statistical information about nodes in the cluster.", - "operationId": "NodesStats_WithNodeId", - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return indices stats aggregated at index, node or shard level.", - "schema": { - "$ref": "#/components/schemas/NodesStatLevel" - } - }, - { - "name": "types", - "in": "query", - "description": "Comma-separated list of document types for the `indexing` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of document types for the `indexing` index metric." - }, - "explode": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - } - ], - "responses": { - "200": { - "description": "NodesStats_WithNodeId 200 response" - } - }, - "x-operation-group": "nodes.stats", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}/stats/{metric}": { - "get": { - "description": "Returns statistical information about nodes in the cluster.", - "operationId": "NodesStats_WithMetricNodeId", - "parameters": [ - { - "name": "metric", - "in": "path", - "description": "Limit the information returned to the specified metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to the specified metrics.", - "x-enum-options": [ - "_all", - "breaker", - "fs", - "http", - "indices", - "jvm", - "os", - "process", - "thread_pool", - "transport", - "discovery", - "indexing_pressure", - "search_pipeline" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return indices stats aggregated at index, node or shard level.", - "schema": { - "$ref": "#/components/schemas/NodesStatLevel" - } - }, - { - "name": "types", - "in": "query", - "description": "Comma-separated list of document types for the `indexing` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of document types for the `indexing` index metric." - }, - "explode": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - } - ], - "responses": { - "200": { - "description": "NodesStats_WithMetricNodeId 200 response" - } - }, - "x-operation-group": "nodes.stats", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}/stats/{metric}/{index_metric}": { - "get": { - "description": "Returns statistical information about nodes in the cluster.", - "operationId": "NodesStats_WithIndexMetricMetricNodeId", - "parameters": [ - { - "name": "metric", - "in": "path", - "description": "Limit the information returned to the specified metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to the specified metrics.", - "x-enum-options": [ - "_all", - "breaker", - "fs", - "http", - "indices", - "jvm", - "os", - "process", - "thread_pool", - "transport", - "discovery", - "indexing_pressure", - "search_pipeline" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "index_metric", - "in": "path", - "description": "Limit the information returned for `indices` metric to the specific index metrics. Isn't used if `indices` (or `all`) metric isn't specified.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned for `indices` metric to the specific index metrics. Isn't used if `indices` (or `all`) metric isn't specified.", - "x-enum-options": [ - "_all", - "store", - "indexing", - "get", - "search", - "merge", - "flush", - "refresh", - "query_cache", - "fielddata", - "docs", - "warmer", - "completion", - "segments", - "translog", - "suggest", - "request_cache", - "recovery" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return indices stats aggregated at index, node or shard level.", - "schema": { - "$ref": "#/components/schemas/NodesStatLevel" - } - }, - { - "name": "types", - "in": "query", - "description": "Comma-separated list of document types for the `indexing` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of document types for the `indexing` index metric." - }, - "explode": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - } - ], - "responses": { - "200": { - "description": "NodesStats_WithIndexMetricMetricNodeId 200 response" - } - }, - "x-operation-group": "nodes.stats", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}/usage": { - "get": { - "description": "Returns low-level information about REST actions usage on nodes.", - "operationId": "NodesUsage_WithNodeId", - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesUsage_WithNodeId 200 response" - } - }, - "x-operation-group": "nodes.usage", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}/usage/{metric}": { - "get": { - "description": "Returns low-level information about REST actions usage on nodes.", - "operationId": "NodesUsage_WithMetricNodeId", - "parameters": [ - { - "name": "metric", - "in": "path", - "description": "Limit the information returned to the specified metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned to the specified metrics.", - "x-enum-options": [ - "_all", - "rest_actions" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesUsage_WithMetricNodeId 200 response" - } - }, - "x-operation-group": "nodes.usage", - "x-version-added": "1.0" - } - }, - "/_nodes/{node_id}/{metric}": { - "get": { - "description": "Returns information about nodes in the cluster.", - "operationId": "NodesInfo_WithMetricNodeId", - "parameters": [ - { - "name": "node_id", - "in": "path", - "description": "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.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "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.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "metric", - "in": "path", - "description": "Comma-separated list of metrics you wish returned. Leave empty to return all.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of metrics you wish returned. Leave empty to return all.", - "x-enum-options": [ - "settings", - "os", - "process", - "jvm", - "thread_pool", - "transport", - "http", - "plugins", - "ingest" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "NodesInfo_WithMetricNodeId 200 response" - } - }, - "x-operation-group": "nodes.info", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/account": { - "get": { - "description": "Returns account details for the current user.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-account-details" - }, - "operationId": "GetAccountDetails", - "responses": { - "200": { - "description": "GetAccountDetails 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AccountDetails" - } - } - } - } - }, - "x-operation-group": "security.get_account_details", - "x-version-added": "1.0" - }, - "put": { - "description": "Changes the password for the current user.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#change-password" - }, - "operationId": "ChangePassword", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ChangePasswordRequestContent" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "ChangePassword 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ChangePasswordResponseContent" - } - } - } - } - }, - "x-operation-group": "security.change_password", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/actiongroups": { - "patch": { - "description": "Creates, updates, or deletes multiple action groups in a single call.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#patch-action-groups" - }, - "operationId": "PatchActionGroups", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchActionGroupsInputPayload" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "PatchActionGroups 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchActionGroupsResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_action_groups", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/actiongroups/": { - "get": { - "description": "Retrieves all action groups.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-action-groups" - }, - "operationId": "GetActionGroups", - "responses": { - "200": { - "description": "GetActionGroups 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ActionGroupsMap" - } - } - } - } - }, - "x-operation-group": "security.get_action_groups", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/actiongroups/{action_group}": { - "delete": { - "description": "Delete a specified action group.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#delete-action-group" - }, - "operationId": "DeleteActionGroup", - "parameters": [ - { - "name": "action_group", - "in": "path", - "description": "Action group to delete.", - "schema": { - "type": "string", - "description": "Action group to delete." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "DeleteActionGroup 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteActionGroupResponseContent" - } - } - } - } - }, - "x-operation-group": "security.delete_action_group", - "x-version-added": "1.0" - }, - "get": { - "description": "Retrieves one action group.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-action-group" - }, - "operationId": "GetActionGroup", - "parameters": [ - { - "name": "action_group", - "in": "path", - "description": "Action group to retrieve.", - "schema": { - "type": "string", - "description": "Action group to retrieve." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "GetActionGroup 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ActionGroupsMap" - } - } - } - } - }, - "x-operation-group": "security.get_action_group", - "x-version-added": "1.0" - }, - "patch": { - "description": "Updates individual attributes of an action group.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#patch-action-group" - }, - "operationId": "PatchActionGroup", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchActionGroupInputPayload" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "action_group", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "PatchActionGroup 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchActionGroupResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_action_group", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or replaces the specified action group.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#create-action-group" - }, - "operationId": "CreateActionGroup", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Action_Group" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "action_group", - "in": "path", - "description": "The name of the action group to create or replace", - "schema": { - "type": "string", - "description": "The name of the action group to create or replace" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "CreateActionGroup 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreateActionGroupResponseContent" - } - } - } - } - }, - "x-operation-group": "security.create_action_group", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/audit": { - "get": { - "description": "Retrieves the audit configuration.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#audit-logs" - }, - "operationId": "GetAuditConfiguration", - "responses": { - "200": { - "description": "GetAuditConfiguration 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AuditConfigWithReadOnly" - } - } - } - } - }, - "x-operation-group": "security.get_audit_configuration", - "x-version-added": "1.0" - }, - "patch": { - "description": "A PATCH call is used to update specified fields in the audit configuration.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#audit-logs" - }, - "operationId": "PatchAuditConfiguration", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchAuditConfigurationInputPayload" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "PatchAuditConfiguration 200 response" - } - }, - "x-operation-group": "security.patch_audit_configuration", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/audit/config": { - "put": { - "description": "Updates the audit configuration.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#audit-logs" - }, - "operationId": "UpdateAuditConfiguration", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/AuditConfig" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "UpdateAuditConfiguration 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UpdateAuditConfigurationResponseContent" - } - } - } - } - }, - "x-operation-group": "security.update_audit_configuration", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/cache": { - "delete": { - "description": "Flushes the Security plugin user, authentication, and authorization cache.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#flush-cache" - }, - "operationId": "FlushCache", - "responses": { - "200": { - "description": "FlushCache 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/FlushCacheResponseContent" - } - } - } - } - }, - "x-operation-group": "security.flush_cache", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/internalusers": { - "get": { - "description": "Retrieve all internal users.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-users" - }, - "operationId": "GetUsers", - "responses": { - "200": { - "description": "GetUsers 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UsersMap" - } - } - } - } - }, - "x-operation-group": "security.get_users", - "x-version-added": "1.0" - }, - "patch": { - "description": "Creates, updates, or deletes multiple internal users in a single call.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#patch-users" - }, - "operationId": "PatchUsers", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchUsersInputPayload" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "PatchUsers 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchUsersResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_users", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/internalusers/{username}": { - "delete": { - "description": "Delete the specified user.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#delete-user" - }, - "operationId": "DeleteUser", - "parameters": [ - { - "name": "username", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "DeleteUser 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteUserResponseContent" - } - } - } - } - }, - "x-operation-group": "security.delete_user", - "x-version-added": "1.0" - }, - "get": { - "description": "Retrieve one internal user.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-user" - }, - "operationId": "GetUser", - "parameters": [ - { - "name": "username", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "GetUser 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UsersMap" - } - } - } - } - }, - "x-operation-group": "security.get_user", - "x-version-added": "1.0" - }, - "patch": { - "description": "Updates individual attributes of an internal user.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#patch-user" - }, - "operationId": "PatchUser", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchUserInputPayload" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "username", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "PatchUser 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchUserResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_user", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or replaces the specified user.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#create-user" - }, - "operationId": "CreateUser", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/User" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "username", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "CreateUser 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreateUserResponseContent" - } - } - } - } - }, - "x-operation-group": "security.create_user", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/nodesdn": { - "get": { - "description": "Retrieves all distinguished names in the allow list.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-distinguished-names" - }, - "operationId": "GetDistinguishedNames", - "responses": { - "200": { - "description": "GetDistinguishedNames 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DistinguishedNamesMap" - } - } - } - } - }, - "x-operation-group": "security.get_distinguished_names", - "x-version-added": "1.0" - }, - "patch": { - "description": "Bulk update of distinguished names.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#update-all-distinguished-names" - }, - "operationId": "PatchDistinguishedNames", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchDistinguishedNamesInputPayload" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "PatchDistinguishedNames 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchDistinguishedNamesResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_distinguished_names", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/nodesdn/{cluster_name}": { - "delete": { - "description": "Deletes all distinguished names in the specified cluster’s or node’s allow list.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#delete-distinguished-names" - }, - "operationId": "DeleteDistinguishedNames", - "parameters": [ - { - "name": "cluster_name", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "DeleteDistinguishedNames 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteDistinguishedNamesResponseContent" - } - } - } - } - }, - "x-operation-group": "security.delete_distinguished_names", - "x-version-added": "1.0" - }, - "get": { - "description": "Retrieve distinguished names of a specified cluster.", - "operationId": "GetDistinguishedNamesWithClusterName", - "parameters": [ - { - "name": "cluster_name", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "GetDistinguishedNamesWithClusterName 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DistinguishedNamesMap" - } - } - } - } - }, - "x-operation-group": "security.get_distinguished_names", - "x-version-added": "1.0" - }, - "put": { - "description": "Adds or updates the specified distinguished names in the cluster’s or node’s allow list.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#update-distinguished-names" - }, - "operationId": "UpdateDistinguishedNames", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DistinguishedNames" - } - } - } - }, - "parameters": [ - { - "name": "cluster_name", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "UpdateDistinguishedNames 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UpdateDistinguishedNamesResponseContent" - } - } - } - } - }, - "x-operation-group": "security.update_distinguished_names", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/roles": { - "patch": { - "description": "Creates, updates, or deletes multiple roles in a single call.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#patch-roles" - }, - "operationId": "PatchRoles", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchRolesInputPayload" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "PatchRoles 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchRolesResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_roles", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/roles/": { - "get": { - "description": "Retrieves all roles.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-roles" - }, - "operationId": "GetRoles", - "responses": { - "200": { - "description": "GetRoles 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RolesMap" - } - } - } - } - }, - "x-operation-group": "security.get_roles", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/roles/{role}": { - "delete": { - "description": "Delete the specified role.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#delete-role" - }, - "operationId": "DeleteRole", - "parameters": [ - { - "name": "role", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "DeleteRole 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteRoleResponseContent" - } - } - } - } - }, - "x-operation-group": "security.delete_role", - "x-version-added": "1.0" - }, - "get": { - "description": "Retrieves one role.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-role" - }, - "operationId": "GetRole", - "parameters": [ - { - "name": "role", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "GetRole 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RolesMap" - } - } - } - } - }, - "x-operation-group": "security.get_role", - "x-version-added": "1.0" - }, - "patch": { - "description": "Updates individual attributes of a role.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#patch-role" - }, - "operationId": "PatchRole", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchRoleInputPayload" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "role", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "PatchRole 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchRoleResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_role", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or replaces the specified role.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#create-role" - }, - "operationId": "CreateRole", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Role" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "role", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "CreateRole 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreateRoleResponseContent" - } - } - } - } - }, - "x-operation-group": "security.create_role", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/rolesmapping": { - "get": { - "description": "Retrieves all role mappings.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-role-mappings" - }, - "operationId": "GetRoleMappings", - "responses": { - "200": { - "description": "GetRoleMappings 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RoleMappings" - } - } - } - } - }, - "x-operation-group": "security.get_role_mappings", - "x-version-added": "1.0" - }, - "patch": { - "description": "Creates or updates multiple role mappings in a single call.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#patch-role-mappings" - }, - "operationId": "PatchRoleMappings", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchRoleMappingsInputPayload" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "PatchRoleMappings 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchRoleMappingsResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_role_mappings", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/rolesmapping/{role}": { - "delete": { - "description": "Deletes the specified role mapping.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#delete-role-mapping" - }, - "operationId": "DeleteRoleMapping", - "parameters": [ - { - "name": "role", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "DeleteRoleMapping 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteRoleMappingResponseContent" - } - } - } - } - }, - "x-operation-group": "security.delete_role_mapping", - "x-version-added": "1.0" - }, - "get": { - "description": "Retrieves one role mapping.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-role-mapping" - }, - "operationId": "GetRoleMapping", - "parameters": [ - { - "name": "role", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "GetRoleMapping 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RoleMappings" - } - } - } - } - }, - "x-operation-group": "security.get_role_mapping", - "x-version-added": "1.0" - }, - "patch": { - "description": "Updates individual attributes of a role mapping.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#patch-role-mapping" - }, - "operationId": "PatchRoleMapping", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchRoleMappingInputPayload" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "role", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "PatchRoleMapping 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchRoleMappingResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_role_mapping", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or replaces the specified role mapping.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#create-role-mapping" - }, - "operationId": "CreateRoleMapping", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RoleMapping" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "role", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "CreateRoleMapping 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreateRoleMappingResponseContent" - } - } - } - } - }, - "x-operation-group": "security.create_role_mapping", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/securityconfig": { - "get": { - "description": "Returns the current Security plugin configuration in JSON format.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#get-configuration" - }, - "operationId": "GetConfiguration", - "responses": { - "200": { - "description": "GetConfiguration 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DynamicConfig" - } - } - } - } - }, - "x-operation-group": "security.get_configuration", - "x-version-added": "1.0" - }, - "patch": { - "description": "A PATCH call is used to update the existing configuration using the REST API.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#patch-configuration" - }, - "operationId": "PatchConfiguration", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchConfigurationInputPayload" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "PatchConfiguration 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchConfigurationResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_configuration", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/securityconfig/config": { - "put": { - "description": "Adds or updates the existing configuration using the REST API.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#update-configuration" - }, - "operationId": "UpdateConfiguration", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DynamicConfig" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "UpdateConfiguration 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UpdateConfigurationResponseContent" - } - } - } - } - }, - "x-operation-group": "security.update_configuration", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/ssl/certs": { - "get": { - "description": "Retrieves the cluster’s security certificates.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#get-certificates" - }, - "operationId": "GetCertificates", - "responses": { - "200": { - "description": "GetCertificates 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/GetCertificatesResponseContent" - } - } - } - } - }, - "x-operation-group": "security.get_certificates", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/ssl/http/reloadcerts": { - "put": { - "description": "Reload HTTP layer communication certificates.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#reload-http-certificates" - }, - "operationId": "ReloadHttpCertificates", - "responses": { - "200": { - "description": "ReloadHttpCertificates 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ReloadHttpCertificatesResponseContent" - } - } - } - } - }, - "x-operation-group": "security.reload_http_certificates", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/ssl/transport/reloadcerts": { - "put": { - "description": "Reload transport layer communication certificates.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#reload-transport-certificates" - }, - "operationId": "ReloadTransportCertificates", - "responses": { - "200": { - "description": "ReloadTransportCertificates 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ReloadTransportCertificatesResponseContent" - } - } - } - } - }, - "x-operation-group": "security.reload_transport_certificates", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/tenants/": { - "get": { - "description": "Retrieves all tenants.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#get-tenants" - }, - "operationId": "GetTenants", - "responses": { - "200": { - "description": "GetTenants 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/TenantsMap" - } - } - } - } - }, - "x-operation-group": "security.get_tenants", - "x-version-added": "1.0" - }, - "patch": { - "description": "Add, delete, or modify multiple tenants in a single call.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#patch-tenants" - }, - "operationId": "PatchTenants", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchTenantsInputPayload" - } - } - }, - "required": true - }, - "responses": { - "200": { - "description": "PatchTenants 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchTenantsResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_tenants", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/api/tenants/{tenant}": { - "delete": { - "description": "Delete the specified tenant.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#delete-action-group" - }, - "operationId": "DeleteTenant", - "parameters": [ - { - "name": "tenant", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "DeleteTenant 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteTenantResponseContent" - } - } - } - } - }, - "x-operation-group": "security.delete_tenant", - "x-version-added": "1.0" - }, - "get": { - "description": "Retrieves one tenant.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#get-tenant" - }, - "operationId": "GetTenant", - "parameters": [ - { - "name": "tenant", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "GetTenant 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/TenantsMap" - } - } - } - } - }, - "x-operation-group": "security.get_tenant", - "x-version-added": "1.0" - }, - "patch": { - "description": "Add, delete, or modify a single tenant.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#patch-tenant" - }, - "operationId": "PatchTenant", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchTenantInputPayload" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "tenant", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "PatchTenant 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PatchTenantResponseContent" - } - } - } - } - }, - "x-operation-group": "security.patch_tenant", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or replaces the specified tenant.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/2.7/security/access-control/api/#create-tenant" - }, - "operationId": "CreateTenant", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreateTenantParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "tenant", - "in": "path", - "schema": { - "type": "string" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "CreateTenant 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreateTenantResponseContent" - } - } - } - } - }, - "x-operation-group": "security.create_tenant", - "x-version-added": "1.0" - } - }, - "/_plugins/_security/health": { - "get": { - "description": "Checks to see if the Security plugin is up and running.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/security/access-control/api/#health-check" - }, - "operationId": "SecurityHealth", - "responses": { - "200": { - "description": "SecurityHealth 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SecurityHealthResponseContent" - } - } - } - } - }, - "x-operation-group": "security.health", - "x-version-added": "1.0" - } - }, - "/_rank_eval": { - "get": { - "description": "Allows to evaluate the quality of ranked search results over a set of typical search queries.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/rank-eval/" - }, - "operationId": "RankEval_Get", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - } - ], - "responses": { - "200": { - "description": "RankEval_Get 200 response" - } - }, - "x-operation-group": "rank_eval", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to evaluate the quality of ranked search results over a set of typical search queries.", - "operationId": "RankEval_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RankEval_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - } - ], - "responses": { - "200": { - "description": "RankEval_Post 200 response" - } - }, - "x-operation-group": "rank_eval", - "x-version-added": "1.0" - } - }, - "/_recovery": { - "get": { - "description": "Returns information about ongoing index shard recoveries.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesRecovery", - "parameters": [ - { - "name": "detailed", - "in": "query", - "description": "Whether to display detailed information about shard recovery.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to display detailed information about shard recovery." - } - }, - { - "name": "active_only", - "in": "query", - "description": "Display only those recoveries that are currently on-going.", - "schema": { - "type": "boolean", - "default": false, - "description": "Display only those recoveries that are currently on-going." - } - } - ], - "responses": { - "200": { - "description": "IndicesRecovery 200 response" - } - }, - "x-operation-group": "indices.recovery", - "x-version-added": "1.0" - } - }, - "/_refresh": { - "get": { - "description": "Performs the refresh operation in one or more indices.", - "operationId": "IndicesRefresh_Get", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesRefresh_Get 200 response" - } - }, - "x-operation-group": "indices.refresh", - "x-version-added": "1.0" - }, - "post": { - "description": "Performs the refresh operation in one or more indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/tuning-your-cluster/availability-and-recovery/remote-store/index/#refresh-level-and-request-level-durability" - }, - "operationId": "IndicesRefresh_Post", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesRefresh_Post 200 response" - } - }, - "x-operation-group": "indices.refresh", - "x-version-added": "1.0" - } - }, - "/_reindex": { - "post": { - "description": "Allows to copy documents from one index to another, optionally filtering the source\ndocuments by a query, changing the destination index settings, or fetching the\ndocuments from a remote cluster.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/reindex-data/" - }, - "operationId": "Reindex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Reindex_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "refresh", - "in": "query", - "description": "Should the affected indexes be refreshed?.", - "schema": { - "type": "boolean", - "description": "Should the affected indexes be refreshed?." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Time each individual bulk request should wait for shards that are unavailable.", - "schema": { - "type": "string", - "default": "1m", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Time each individual bulk request should wait for shards that are unavailable.", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "requests_per_second", - "in": "query", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "schema": { - "type": "integer", - "default": 0, - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "format": "int32" - } - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "slices", - "in": "query", - "description": "The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to `auto`.", - "schema": { - "type": "string", - "default": "1", - "description": "The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to `auto`." - } - }, - { - "name": "max_docs", - "in": "query", - "description": "Maximum number of documents to process (default: all documents).", - "schema": { - "type": "integer", - "description": "Maximum number of documents to process (default: all documents).", - "format": "int32" - } - } - ], - "responses": { - "200": { - "description": "Reindex 200 response" - } - }, - "x-operation-group": "reindex", - "x-version-added": "1.0" - } - }, - "/_reindex/{task_id}/_rethrottle": { - "post": { - "description": "Changes the number of requests per second for a particular Reindex operation.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "ReindexRethrottle", - "parameters": [ - { - "name": "task_id", - "in": "path", - "description": "The task id to rethrottle.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The task id to rethrottle." - }, - "required": true - }, - { - "name": "requests_per_second", - "in": "query", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "schema": { - "type": "integer", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "format": "int32" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "ReindexRethrottle 200 response" - } - }, - "x-operation-group": "reindex_rethrottle", - "x-version-added": "1.0" - } - }, - "/_remote/info": { - "get": { - "description": "Returns the information about configured remote clusters.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/remote-info/" - }, - "operationId": "ClusterRemoteInfo", - "responses": { - "200": { - "description": "ClusterRemoteInfo 200 response" - } - }, - "x-operation-group": "cluster.remote_info", - "x-version-added": "1.0" - } - }, - "/_remotestore/_restore": { - "post": { - "description": "Restores from remote store.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/opensearch/remote/#restoring-from-a-backup" - }, - "operationId": "RemoteStoreRestore", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RemoteStoreRestore_BodyParams" - }, - "examples": { - "RemoteStoreRestore_example1": { - "summary": "Examples for Post Remote Storage Restore Operation.", - "description": "", - "value": { - "indices": [ - "books" - ] - } - } - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - } - ], - "responses": { - "200": { - "description": "RemoteStoreRestore 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RemoteStoreRestoreResponseContent" - }, - "examples": { - "RemoteStoreRestore_example1": { - "summary": "Examples for Post Remote Storage Restore Operation.", - "description": "", - "value": { - "remote_store": { - "indices": [ - "books" - ], - "shards": { - "total": 1, - "failed": 0, - "successful": 1 - } - } - } - } - } - } - } - } - }, - "x-operation-group": "remote_store.restore", - "x-version-added": "1.0" - } - }, - "/_render/template": { - "get": { - "description": "Allows to use the Mustache language to pre-render a search definition.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/search-template/" - }, - "operationId": "RenderSearchTemplate_Get", - "responses": { - "200": { - "description": "RenderSearchTemplate_Get 200 response" - } - }, - "x-operation-group": "render_search_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to use the Mustache language to pre-render a search definition.", - "operationId": "RenderSearchTemplate_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RenderSearchTemplate_BodyParams" - } - } - } - }, - "responses": { - "200": { - "description": "RenderSearchTemplate_Post 200 response" - } - }, - "x-operation-group": "render_search_template", - "x-version-added": "1.0" - } - }, - "/_render/template/{id}": { - "get": { - "description": "Allows to use the Mustache language to pre-render a search definition.", - "operationId": "RenderSearchTemplate_Get_WithId", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "The id of the stored search template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The id of the stored search template." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "RenderSearchTemplate_Get_WithId 200 response" - } - }, - "x-operation-group": "render_search_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to use the Mustache language to pre-render a search definition.", - "operationId": "RenderSearchTemplate_Post_WithId", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RenderSearchTemplate_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "The id of the stored search template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The id of the stored search template." - }, - "required": true - } - ], - "responses": { - "200": { - "description": "RenderSearchTemplate_Post_WithId 200 response" - } - }, - "x-operation-group": "render_search_template", - "x-version-added": "1.0" - } - }, - "/_resolve/index/{name}": { - "get": { - "description": "Returns information about any matching indices, aliases, and data streams.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesResolveIndex", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated list of names or wildcard expressions.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of names or wildcard expressions.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesResolveIndex 200 response" - } - }, - "x-operation-group": "indices.resolve_index", - "x-version-added": "1.0" - } - }, - "/_script_context": { - "get": { - "description": "Returns all script contexts.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/script-apis/get-script-contexts/" - }, - "operationId": "GetScriptContext", - "responses": { - "200": { - "description": "GetScriptContext 200 response" - } - }, - "x-operation-group": "get_script_context", - "x-version-added": "1.0" - } - }, - "/_script_language": { - "get": { - "description": "Returns available script types, languages and contexts.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/script-apis/get-script-language/" - }, - "operationId": "GetScriptLanguages", - "responses": { - "200": { - "description": "GetScriptLanguages 200 response" - } - }, - "x-operation-group": "get_script_languages", - "x-version-added": "1.0" - } - }, - "/_scripts/painless/_execute": { - "get": { - "description": "Allows an arbitrary script to be executed and a result to be returned.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/script-apis/exec-script/" - }, - "operationId": "ScriptsPainlessExecute_Get", - "responses": { - "200": { - "description": "ScriptsPainlessExecute_Get 200 response" - } - }, - "x-operation-group": "scripts_painless_execute", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows an arbitrary script to be executed and a result to be returned.", - "operationId": "ScriptsPainlessExecute_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ScriptsPainlessExecute_BodyParams" - } - } - } - }, - "responses": { - "200": { - "description": "ScriptsPainlessExecute_Post 200 response" - } - }, - "x-operation-group": "scripts_painless_execute", - "x-version-added": "1.0" - } - }, - "/_scripts/{id}": { - "delete": { - "description": "Deletes a script.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/script-apis/delete-script/" - }, - "operationId": "DeleteScript", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Script ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Script ID." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "DeleteScript 200 response" - } - }, - "x-operation-group": "delete_script", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns a script.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/script-apis/get-stored-script/" - }, - "operationId": "GetScript", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Script ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Script ID." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "GetScript 200 response" - } - }, - "x-operation-group": "get_script", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates or updates a script.", - "operationId": "PutScript_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PutScript_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Script ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Script ID." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "PutScript_Post 200 response" - } - }, - "x-operation-group": "put_script", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates a script.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/script-apis/create-stored-script/" - }, - "operationId": "PutScript_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PutScript_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Script ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Script ID." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "PutScript_Put 200 response" - } - }, - "x-operation-group": "put_script", - "x-version-added": "1.0" - } - }, - "/_scripts/{id}/{context}": { - "post": { - "description": "Creates or updates a script.", - "operationId": "PutScript_Post_WithContext", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PutScript_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Script ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Script ID." - }, - "required": true - }, - { - "name": "context", - "in": "path", - "description": "Script context.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Script context." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "PutScript_Post_WithContext 200 response" - } - }, - "x-operation-group": "put_script", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates a script.", - "operationId": "PutScript_Put_WithContext", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/PutScript_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Script ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Script ID." - }, - "required": true - }, - { - "name": "context", - "in": "path", - "description": "Script context.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Script context." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "PutScript_Put_WithContext 200 response" - } - }, - "x-operation-group": "put_script", - "x-version-added": "1.0" - } - }, - "/_search": { - "get": { - "description": "Returns results matching a query.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/search/" - }, - "operationId": "Search_Get", - "parameters": [ - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "explain", - "in": "query", - "description": "Specify whether to return detailed information about score computation as part of a hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return detailed information about score computation as part of a hit." - } - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "docvalue_fields", - "in": "query", - "description": "Comma-separated list of fields to return as the docvalue representation of a field for each hit.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return as the docvalue representation of a field for each hit." - }, - "explode": true - }, - { - "name": "from", - "in": "query", - "description": "Starting offset.", - "schema": { - "type": "integer", - "default": 0, - "description": "Starting offset.", - "format": "int32" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - }, - { - "name": "size", - "in": "query", - "description": "Number of hits to return.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of hits to return.", - "format": "int32" - } - }, - { - "name": "sort", - "in": "query", - "description": "Comma-separated list of : pairs.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of : pairs." - }, - "explode": true - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - }, - { - "name": "stats", - "in": "query", - "description": "Specific 'tag' of the request for logging and statistical purposes.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Specific 'tag' of the request for logging and statistical purposes." - }, - "explode": true - }, - { - "name": "suggest_field", - "in": "query", - "description": "Specify which field to use for suggestions.", - "schema": { - "type": "string", - "description": "Specify which field to use for suggestions." - } - }, - { - "name": "suggest_mode", - "in": "query", - "description": "Specify suggest mode.", - "schema": { - "$ref": "#/components/schemas/SuggestMode" - } - }, - { - "name": "suggest_size", - "in": "query", - "description": "How many suggestions to return in response.", - "schema": { - "type": "integer", - "description": "How many suggestions to return in response.", - "format": "int32" - } - }, - { - "name": "suggest_text", - "in": "query", - "description": "The source text for which the suggestions should be returned.", - "schema": { - "type": "string", - "description": "The source text for which the suggestions should be returned." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "track_scores", - "in": "query", - "description": "Whether to calculate and return scores even if they are not used for sorting.", - "schema": { - "type": "boolean", - "description": "Whether to calculate and return scores even if they are not used for sorting." - } - }, - { - "name": "track_total_hits", - "in": "query", - "description": "Indicate if the number of documents that match the query should be tracked.", - "schema": { - "type": "boolean", - "description": "Indicate if the number of documents that match the query should be tracked." - } - }, - { - "name": "allow_partial_search_results", - "in": "query", - "description": "Indicate if an error should be returned if there is a partial search failure or timeout.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicate if an error should be returned if there is a partial search failure or timeout." - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "version", - "in": "query", - "description": "Whether to return document version as part of a hit.", - "schema": { - "type": "boolean", - "description": "Whether to return document version as part of a hit." - } - }, - { - "name": "seq_no_primary_term", - "in": "query", - "description": "Specify whether to return sequence number and primary term of the last modification of each hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return sequence number and primary term of the last modification of each hit." - } - }, - { - "name": "request_cache", - "in": "query", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting.", - "schema": { - "type": "boolean", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting." - } - }, - { - "name": "batched_reduce_size", - "in": "query", - "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", - "schema": { - "type": "integer", - "default": 512, - "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", - "format": "int32" - } - }, - { - "name": "max_concurrent_shard_requests", - "in": "query", - "description": "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.", - "schema": { - "type": "integer", - "default": 5, - "description": "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.", - "format": "int32" - } - }, - { - "name": "pre_filter_shard_size", - "in": "query", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "schema": { - "type": "integer", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "search_pipeline", - "in": "query", - "description": "Customizable sequence of processing stages applied to search queries.", - "schema": { - "type": "string", - "description": "Customizable sequence of processing stages applied to search queries." - } - } - ], - "responses": { - "200": { - "description": "Search_Get 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Search_GetResponseContent" - } - } - } - } - }, - "x-operation-group": "search", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns results matching a query.", - "operationId": "Search_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Search_BodyParams" - }, - "examples": { - "Search_Post_example1": { - "summary": "Examples for Post Search Operation.", - "description": "", - "value": { - "query": { - "match_all": {} - }, - "fields": [ - "*" - ] - } - } - } - } - } - }, - "parameters": [ - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "explain", - "in": "query", - "description": "Specify whether to return detailed information about score computation as part of a hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return detailed information about score computation as part of a hit." - } - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "docvalue_fields", - "in": "query", - "description": "Comma-separated list of fields to return as the docvalue representation of a field for each hit.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return as the docvalue representation of a field for each hit." - }, - "explode": true - }, - { - "name": "from", - "in": "query", - "description": "Starting offset.", - "schema": { - "type": "integer", - "default": 0, - "description": "Starting offset.", - "format": "int32" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - }, - "examples": { - "Search_Post_example1": { - "summary": "Examples for Post Search Operation.", - "description": "", - "value": "1d" - } - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - }, - { - "name": "size", - "in": "query", - "description": "Number of hits to return.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of hits to return.", - "format": "int32" - } - }, - { - "name": "sort", - "in": "query", - "description": "Comma-separated list of : pairs.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of : pairs." - }, - "explode": true - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - }, - { - "name": "stats", - "in": "query", - "description": "Specific 'tag' of the request for logging and statistical purposes.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Specific 'tag' of the request for logging and statistical purposes." - }, - "explode": true - }, - { - "name": "suggest_field", - "in": "query", - "description": "Specify which field to use for suggestions.", - "schema": { - "type": "string", - "description": "Specify which field to use for suggestions." - } - }, - { - "name": "suggest_mode", - "in": "query", - "description": "Specify suggest mode.", - "schema": { - "$ref": "#/components/schemas/SuggestMode" - } - }, - { - "name": "suggest_size", - "in": "query", - "description": "How many suggestions to return in response.", - "schema": { - "type": "integer", - "description": "How many suggestions to return in response.", - "format": "int32" - } - }, - { - "name": "suggest_text", - "in": "query", - "description": "The source text for which the suggestions should be returned.", - "schema": { - "type": "string", - "description": "The source text for which the suggestions should be returned." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "track_scores", - "in": "query", - "description": "Whether to calculate and return scores even if they are not used for sorting.", - "schema": { - "type": "boolean", - "description": "Whether to calculate and return scores even if they are not used for sorting." - } - }, - { - "name": "track_total_hits", - "in": "query", - "description": "Indicate if the number of documents that match the query should be tracked.", - "schema": { - "type": "boolean", - "description": "Indicate if the number of documents that match the query should be tracked." - } - }, - { - "name": "allow_partial_search_results", - "in": "query", - "description": "Indicate if an error should be returned if there is a partial search failure or timeout.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicate if an error should be returned if there is a partial search failure or timeout." - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "version", - "in": "query", - "description": "Whether to return document version as part of a hit.", - "schema": { - "type": "boolean", - "description": "Whether to return document version as part of a hit." - } - }, - { - "name": "seq_no_primary_term", - "in": "query", - "description": "Specify whether to return sequence number and primary term of the last modification of each hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return sequence number and primary term of the last modification of each hit." - } - }, - { - "name": "request_cache", - "in": "query", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting.", - "schema": { - "type": "boolean", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting." - } - }, - { - "name": "batched_reduce_size", - "in": "query", - "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", - "schema": { - "type": "integer", - "default": 512, - "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", - "format": "int32" - } - }, - { - "name": "max_concurrent_shard_requests", - "in": "query", - "description": "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.", - "schema": { - "type": "integer", - "default": 5, - "description": "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.", - "format": "int32" - } - }, - { - "name": "pre_filter_shard_size", - "in": "query", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "schema": { - "type": "integer", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "search_pipeline", - "in": "query", - "description": "Customizable sequence of processing stages applied to search queries.", - "schema": { - "type": "string", - "description": "Customizable sequence of processing stages applied to search queries." - } - } - ], - "responses": { - "200": { - "description": "Search_Post 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Search_PostResponseContent" - }, - "examples": { - "Search_Post_example1": { - "summary": "Examples for Post Search Operation.", - "description": "", - "value": { - "timed_out": false, - "_shards": { - "total": 1, - "successful": 1, - "skipped": 0, - "failed": 0 - }, - "hits": { - "total": { - "value": 0, - "relation": "eq" - }, - "hits": [] - } - } - } - } - } - } - } - }, - "x-operation-group": "search", - "x-version-added": "1.0" - } - }, - "/_search/point_in_time": { - "delete": { - "description": "Deletes one or more point in time searches based on the IDs passed.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#delete-pits" - }, - "operationId": "DeletePit", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeletePit_BodyParams" - } - } - } - }, - "responses": { - "200": { - "description": "DeletePit 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeletePitResponseContent" - } - } - } - } - }, - "x-operation-group": "delete_pit", - "x-version-added": "2.4" - } - }, - "/_search/point_in_time/_all": { - "delete": { - "description": "Deletes all active point in time searches.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#delete-pits" - }, - "operationId": "DeleteAllPits", - "responses": { - "200": { - "description": "DeleteAllPits 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteAllPitsResponseContent" - } - } - } - } - }, - "x-operation-group": "delete_all_pits", - "x-version-added": "2.4" - }, - "get": { - "description": "Lists all active point in time searches.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#list-all-pits" - }, - "operationId": "GetAllPits", - "responses": { - "200": { - "description": "GetAllPits 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/GetAllPitsResponseContent" - } - } - } - } - }, - "x-operation-group": "get_all_pits", - "x-version-added": "2.4" - } - }, - "/_search/scroll": { - "delete": { - "description": "Explicitly clears the search context for a scroll.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/scroll/" - }, - "operationId": "ClearScroll", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClearScroll_BodyParams" - } - } - } - }, - "responses": { - "200": { - "description": "ClearScroll 200 response" - } - }, - "x-operation-group": "clear_scroll", - "x-version-added": "1.0" - }, - "get": { - "description": "Allows to retrieve a large numbers of results from a single search request.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/scroll/#path-and-http-methods" - }, - "operationId": "Scroll_Get", - "parameters": [ - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "scroll_id", - "in": "query", - "description": "Scroll ID.", - "schema": { - "type": "string", - "description": "Scroll ID." - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - } - ], - "responses": { - "200": { - "description": "Scroll_Get 200 response" - } - }, - "x-operation-group": "scroll", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to retrieve a large numbers of results from a single search request.", - "operationId": "Scroll_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Scroll_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "scroll_id", - "in": "query", - "description": "Scroll ID.", - "schema": { - "type": "string", - "description": "Scroll ID." - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - } - ], - "responses": { - "200": { - "description": "Scroll_Post 200 response" - } - }, - "x-operation-group": "scroll", - "x-version-added": "1.0" - } - }, - "/_search/scroll/{scroll_id}": { - "delete": { - "description": "Explicitly clears the search context for a scroll.", - "operationId": "ClearScroll_WithScrollId", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/ClearScroll_BodyParams" - } - } - } - }, - "deprecated": true, - "parameters": [ - { - "name": "scroll_id", - "in": "path", - "description": "Comma-separated list of scroll IDs to clear.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of scroll IDs to clear.", - "deprecated": true, - "x-data-type": "array" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "ClearScroll_WithScrollId 200 response" - } - }, - "x-deprecation-message": "A scroll id can be quite large and should be specified as part of the body", - "x-operation-group": "clear_scroll", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - }, - "get": { - "description": "Allows to retrieve a large numbers of results from a single search request.", - "operationId": "Scroll_Get_WithScrollId", - "deprecated": true, - "parameters": [ - { - "name": "scroll_id", - "in": "path", - "description": "Scroll ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Scroll ID." - }, - "required": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "scroll_id", - "in": "query", - "description": "Scroll ID.", - "schema": { - "type": "string", - "description": "Scroll ID." - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - } - ], - "responses": { - "200": { - "description": "Scroll_Get_WithScrollId 200 response" - } - }, - "x-deprecation-message": "A scroll id can be quite large and should be specified as part of the body", - "x-operation-group": "scroll", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - }, - "post": { - "description": "Allows to retrieve a large numbers of results from a single search request.", - "operationId": "Scroll_Post_WithScrollId", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Scroll_BodyParams" - } - } - } - }, - "deprecated": true, - "parameters": [ - { - "name": "scroll_id", - "in": "path", - "description": "Scroll ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Scroll ID." - }, - "required": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "scroll_id", - "in": "query", - "description": "Scroll ID.", - "schema": { - "type": "string", - "description": "Scroll ID." - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - } - ], - "responses": { - "200": { - "description": "Scroll_Post_WithScrollId 200 response" - } - }, - "x-deprecation-message": "A scroll id can be quite large and should be specified as part of the body", - "x-operation-group": "scroll", - "x-version-added": "1.0", - "x-version-deprecated": "1.0" - } - }, - "/_search/template": { - "get": { - "description": "Allows to use the Mustache language to pre-render a search definition.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/search-template/" - }, - "operationId": "SearchTemplate_Get", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "explain", - "in": "query", - "description": "Specify whether to return detailed information about score computation as part of a hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return detailed information about score computation as part of a hit." - } - }, - { - "name": "profile", - "in": "query", - "description": "Specify whether to profile the query execution.", - "schema": { - "type": "boolean", - "description": "Specify whether to profile the query execution." - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "SearchTemplate_Get 200 response" - } - }, - "x-operation-group": "search_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to use the Mustache language to pre-render a search definition.", - "operationId": "SearchTemplate_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SearchTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "explain", - "in": "query", - "description": "Specify whether to return detailed information about score computation as part of a hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return detailed information about score computation as part of a hit." - } - }, - { - "name": "profile", - "in": "query", - "description": "Specify whether to profile the query execution.", - "schema": { - "type": "boolean", - "description": "Specify whether to profile the query execution." - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "SearchTemplate_Post 200 response" - } - }, - "x-operation-group": "search_template", - "x-version-added": "1.0" - } - }, - "/_search_shards": { - "get": { - "description": "Returns information about the indices and shards that a search request would be executed against.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "SearchShards_Get", - "parameters": [ - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "SearchShards_Get 200 response" - } - }, - "x-operation-group": "search_shards", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns information about the indices and shards that a search request would be executed against.", - "operationId": "SearchShards_Post", - "parameters": [ - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "SearchShards_Post 200 response" - } - }, - "x-operation-group": "search_shards", - "x-version-added": "1.0" - } - }, - "/_segments": { - "get": { - "description": "Provides low-level information about segments in a Lucene index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesSegments", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "verbose", - "in": "query", - "description": "Includes detailed memory usage by Lucene.", - "schema": { - "type": "boolean", - "default": false, - "description": "Includes detailed memory usage by Lucene." - } - } - ], - "responses": { - "200": { - "description": "IndicesSegments 200 response" - } - }, - "x-operation-group": "indices.segments", - "x-version-added": "1.0" - } - }, - "/_settings": { - "get": { - "description": "Returns settings for one or more indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/get-settings/" - }, - "operationId": "IndicesGetSettings", - "parameters": [ - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether to return all default setting for each of the indices.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to return all default setting for each of the indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetSettings 200 response" - } - }, - "x-operation-group": "indices.get_settings", - "x-version-added": "1.0" - }, - "put": { - "description": "Updates the index settings.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/update-settings/" - }, - "operationId": "IndicesPutSettings", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutSettings_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "preserve_existing", - "in": "query", - "description": "Whether to update existing settings. If set to `true` existing settings on an index remain unchanged.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to update existing settings. If set to `true` existing settings on an index remain unchanged." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - } - ], - "responses": { - "200": { - "description": "IndicesPutSettings 200 response" - } - }, - "x-operation-group": "indices.put_settings", - "x-version-added": "1.0" - } - }, - "/_settings/{name}": { - "get": { - "description": "Returns settings for one or more indices.", - "operationId": "IndicesGetSettings_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated list of settings.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of settings.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether to return all default setting for each of the indices.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to return all default setting for each of the indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetSettings_WithName 200 response" - } - }, - "x-operation-group": "indices.get_settings", - "x-version-added": "1.0" - } - }, - "/_shard_stores": { - "get": { - "description": "Provides store information for shard copies of indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesShardStores", - "parameters": [ - { - "name": "status", - "in": "query", - "description": "Comma-separated list of statuses used to filter on shards to get store information for.", - "style": "form", - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/Status_Member" - }, - "description": "Comma-separated list of statuses used to filter on shards to get store information for." - }, - "explode": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesShardStores 200 response" - } - }, - "x-operation-group": "indices.shard_stores", - "x-version-added": "1.0" - } - }, - "/_snapshot": { - "get": { - "description": "Returns information about a repository.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/snapshots/get-snapshot-repository/" - }, - "operationId": "SnapshotGetRepository", - "parameters": [ - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "SnapshotGetRepository 200 response" - } - }, - "x-operation-group": "snapshot.get_repository", - "x-version-added": "1.0" - } - }, - "/_snapshot/_status": { - "get": { - "description": "Returns information about the status of a snapshot.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/snapshots/get-snapshot-status/" - }, - "operationId": "SnapshotStatus", - "parameters": [ - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown." - } - } - ], - "responses": { - "200": { - "description": "SnapshotStatus 200 response" - } - }, - "x-operation-group": "snapshot.status", - "x-version-added": "1.0" - } - }, - "/_snapshot/{repository}": { - "delete": { - "description": "Deletes a repository.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/snapshots/delete-snapshot-repository/" - }, - "operationId": "SnapshotDeleteRepository", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Name of the snapshot repository to unregister. Wildcard (`*`) patterns are supported.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Name of the snapshot repository to unregister. Wildcard (`*`) patterns are supported.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "SnapshotDeleteRepository 200 response" - } - }, - "x-operation-group": "snapshot.delete_repository", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns information about a repository.", - "operationId": "SnapshotGetRepository_WithRepository", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Comma-separated list of repository names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of repository names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "SnapshotGetRepository_WithRepository 200 response" - } - }, - "x-operation-group": "snapshot.get_repository", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates a repository.", - "operationId": "SnapshotCreateRepository_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SnapshotCreateRepository_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "verify", - "in": "query", - "description": "Whether to verify the repository after creation.", - "schema": { - "type": "boolean", - "description": "Whether to verify the repository after creation." - } - } - ], - "responses": { - "200": { - "description": "SnapshotCreateRepository_Post 200 response" - } - }, - "x-operation-group": "snapshot.create_repository", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates a repository.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/snapshots/create-repository/" - }, - "operationId": "SnapshotCreateRepository_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SnapshotCreateRepository_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "verify", - "in": "query", - "description": "Whether to verify the repository after creation.", - "schema": { - "type": "boolean", - "description": "Whether to verify the repository after creation." - } - } - ], - "responses": { - "200": { - "description": "SnapshotCreateRepository_Put 200 response" - } - }, - "x-operation-group": "snapshot.create_repository", - "x-version-added": "1.0" - } - }, - "/_snapshot/{repository}/_cleanup": { - "post": { - "description": "Removes stale data from repository.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "SnapshotCleanupRepository", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "SnapshotCleanupRepository 200 response" - } - }, - "x-operation-group": "snapshot.cleanup_repository", - "x-version-added": "1.0" - } - }, - "/_snapshot/{repository}/_status": { - "get": { - "description": "Returns information about the status of a snapshot.", - "operationId": "SnapshotStatus_WithRepository", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown." - } - } - ], - "responses": { - "200": { - "description": "SnapshotStatus_WithRepository 200 response" - } - }, - "x-operation-group": "snapshot.status", - "x-version-added": "1.0" - } - }, - "/_snapshot/{repository}/_verify": { - "post": { - "description": "Verifies a repository.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/snapshots/verify-snapshot-repository/" - }, - "operationId": "SnapshotVerifyRepository", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "SnapshotVerifyRepository 200 response" - } - }, - "x-operation-group": "snapshot.verify_repository", - "x-version-added": "1.0" - } - }, - "/_snapshot/{repository}/{snapshot}": { - "delete": { - "description": "Deletes a snapshot.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/snapshots/delete-snapshot/" - }, - "operationId": "SnapshotDelete", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "snapshot", - "in": "path", - "description": "Snapshot name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Snapshot name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "SnapshotDelete 200 response" - } - }, - "x-operation-group": "snapshot.delete", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns information about a snapshot.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "SnapshotGet", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "snapshot", - "in": "path", - "description": "Comma-separated list of snapshot names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of snapshot names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown." - } - }, - { - "name": "verbose", - "in": "query", - "description": "Whether to show verbose snapshot info or only show the basic info found in the repository index blob.", - "schema": { - "type": "boolean", - "description": "Whether to show verbose snapshot info or only show the basic info found in the repository index blob." - } - } - ], - "responses": { - "200": { - "description": "SnapshotGet 200 response" - } - }, - "x-operation-group": "snapshot.get", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates a snapshot in a repository.", - "operationId": "SnapshotCreate_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SnapshotCreate_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "snapshot", - "in": "path", - "description": "Snapshot name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Snapshot name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - } - ], - "responses": { - "200": { - "description": "SnapshotCreate_Post 200 response" - } - }, - "x-operation-group": "snapshot.create", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates a snapshot in a repository.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/snapshots/create-snapshot/" - }, - "operationId": "SnapshotCreate_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SnapshotCreate_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "snapshot", - "in": "path", - "description": "Snapshot name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Snapshot name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - } - ], - "responses": { - "200": { - "description": "SnapshotCreate_Put 200 response" - } - }, - "x-operation-group": "snapshot.create", - "x-version-added": "1.0" - } - }, - "/_snapshot/{repository}/{snapshot}/_clone/{target_snapshot}": { - "put": { - "description": "Clones indices from one snapshot into another snapshot in the same repository.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "SnapshotClone", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SnapshotClone_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "snapshot", - "in": "path", - "description": "Snapshot name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Snapshot name." - }, - "required": true - }, - { - "name": "target_snapshot", - "in": "path", - "description": "The name of the cloned snapshot to create.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the cloned snapshot to create." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "SnapshotClone 200 response" - } - }, - "x-operation-group": "snapshot.clone", - "x-version-added": "1.0" - } - }, - "/_snapshot/{repository}/{snapshot}/_restore": { - "post": { - "description": "Restores a snapshot.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/snapshots/restore-snapshot/" - }, - "operationId": "SnapshotRestore", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SnapshotRestore_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "snapshot", - "in": "path", - "description": "Snapshot name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Snapshot name." - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - } - ], - "responses": { - "200": { - "description": "SnapshotRestore 200 response" - } - }, - "x-operation-group": "snapshot.restore", - "x-version-added": "1.0" - } - }, - "/_snapshot/{repository}/{snapshot}/_status": { - "get": { - "description": "Returns information about the status of a snapshot.", - "operationId": "SnapshotStatus_WithRepositorySnapshot", - "parameters": [ - { - "name": "repository", - "in": "path", - "description": "Repository name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Repository name." - }, - "required": true - }, - { - "name": "snapshot", - "in": "path", - "description": "Comma-separated list of snapshot names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of snapshot names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown." - } - } - ], - "responses": { - "200": { - "description": "SnapshotStatus_WithRepositorySnapshot 200 response" - } - }, - "x-operation-group": "snapshot.status", - "x-version-added": "1.0" - } - }, - "/_stats": { - "get": { - "description": "Provides statistics on operations happening in an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesStats", - "parameters": [ - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return stats aggregated at cluster, index or shard level.", - "schema": { - "$ref": "#/components/schemas/IndiciesStatLevel" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - }, - { - "name": "include_unloaded_segments", - "in": "query", - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory.", - "schema": { - "type": "boolean", - "default": false, - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "forbid_closed_indices", - "in": "query", - "description": "If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices.", - "schema": { - "type": "boolean", - "default": true, - "description": "If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesStats 200 response" - } - }, - "x-operation-group": "indices.stats", - "x-version-added": "1.0" - } - }, - "/_stats/{metric}": { - "get": { - "description": "Provides statistics on operations happening in an index.", - "operationId": "IndicesStats_WithMetric", - "parameters": [ - { - "name": "metric", - "in": "path", - "description": "Limit the information returned the specific metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned the specific metrics.", - "x-enum-options": [ - "_all", - "store", - "indexing", - "get", - "search", - "merge", - "flush", - "refresh", - "query_cache", - "fielddata", - "docs", - "warmer", - "completion", - "segments", - "translog", - "suggest", - "request_cache", - "recovery" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return stats aggregated at cluster, index or shard level.", - "schema": { - "$ref": "#/components/schemas/IndiciesStatLevel" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - }, - { - "name": "include_unloaded_segments", - "in": "query", - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory.", - "schema": { - "type": "boolean", - "default": false, - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "forbid_closed_indices", - "in": "query", - "description": "If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices.", - "schema": { - "type": "boolean", - "default": true, - "description": "If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesStats_WithMetric 200 response" - } - }, - "x-operation-group": "indices.stats", - "x-version-added": "1.0" - } - }, - "/_tasks": { - "get": { - "description": "Returns a list of tasks.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/tasks/" - }, - "operationId": "TasksList", - "parameters": [ - { - "name": "nodes", - "in": "query", - "description": "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.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "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." - }, - "explode": true - }, - { - "name": "actions", - "in": "query", - "description": "Comma-separated list of actions that should be returned. Leave empty to return all.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of actions that should be returned. Leave empty to return all." - }, - "explode": true - }, - { - "name": "detailed", - "in": "query", - "description": "Return detailed task information.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return detailed task information." - } - }, - { - "name": "parent_task_id", - "in": "query", - "description": "Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all.", - "schema": { - "type": "string", - "description": "Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "group_by", - "in": "query", - "description": "Group tasks by nodes or parent/child relationships.", - "schema": { - "$ref": "#/components/schemas/GroupBy" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "TasksList 200 response" - } - }, - "x-operation-group": "tasks.list", - "x-version-added": "1.0" - } - }, - "/_tasks/_cancel": { - "post": { - "description": "Cancels a task, if it can be cancelled through an API.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/tasks/#task-canceling" - }, - "operationId": "TasksCancel", - "parameters": [ - { - "name": "nodes", - "in": "query", - "description": "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.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "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." - }, - "explode": true - }, - { - "name": "actions", - "in": "query", - "description": "Comma-separated list of actions that should be cancelled. Leave empty to cancel all.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of actions that should be cancelled. Leave empty to cancel all." - }, - "explode": true - }, - { - "name": "parent_task_id", - "in": "query", - "description": "Cancel tasks with specified parent task id (node_id:task_number). Set to -1 to cancel all.", - "schema": { - "type": "string", - "description": "Cancel tasks with specified parent task id (node_id:task_number). Set to -1 to cancel all." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - } - ], - "responses": { - "200": { - "description": "TasksCancel 200 response" - } - }, - "x-operation-group": "tasks.cancel", - "x-version-added": "1.0" - } - }, - "/_tasks/{task_id}": { - "get": { - "description": "Returns information about a task.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/tasks/" - }, - "operationId": "TasksGet", - "parameters": [ - { - "name": "task_id", - "in": "path", - "description": "Return the task with specified id (node_id:task_number).", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Return the task with specified id (node_id:task_number)." - }, - "required": true - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "TasksGet 200 response" - } - }, - "x-operation-group": "tasks.get", - "x-version-added": "1.0" - } - }, - "/_tasks/{task_id}/_cancel": { - "post": { - "description": "Cancels a task, if it can be cancelled through an API.", - "operationId": "TasksCancel_WithTaskId", - "parameters": [ - { - "name": "task_id", - "in": "path", - "description": "Cancel the task with specified task id (node_id:task_number).", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Cancel the task with specified task id (node_id:task_number)." - }, - "required": true - }, - { - "name": "nodes", - "in": "query", - "description": "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.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "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." - }, - "explode": true - }, - { - "name": "actions", - "in": "query", - "description": "Comma-separated list of actions that should be cancelled. Leave empty to cancel all.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of actions that should be cancelled. Leave empty to cancel all." - }, - "explode": true - }, - { - "name": "parent_task_id", - "in": "query", - "description": "Cancel tasks with specified parent task id (node_id:task_number). Set to -1 to cancel all.", - "schema": { - "type": "string", - "description": "Cancel tasks with specified parent task id (node_id:task_number). Set to -1 to cancel all." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - } - ], - "responses": { - "200": { - "description": "TasksCancel_WithTaskId 200 response" - } - }, - "x-operation-group": "tasks.cancel", - "x-version-added": "1.0" - } - }, - "/_template": { - "get": { - "description": "Returns an index template.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesGetTemplate", - "parameters": [ - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetTemplate 200 response" - } - }, - "x-operation-group": "indices.get_template", - "x-version-added": "1.0" - } - }, - "/_template/{name}": { - "delete": { - "description": "Deletes an index template.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesDeleteTemplate", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesDeleteTemplate 200 response" - } - }, - "x-operation-group": "indices.delete_template", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns an index template.", - "operationId": "IndicesGetTemplate_WithName", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated names of the index templates.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated names of the index templates.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetTemplate_WithName 200 response" - } - }, - "x-operation-group": "indices.get_template", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns information about whether a particular index template exists.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesExistsTemplate", - "parameters": [ - { - "name": "name", - "in": "path", - "description": "Comma-separated names of the index templates.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated names of the index templates.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesExistsTemplate 200 response" - } - }, - "x-operation-group": "indices.exists_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates or updates an index template.", - "operationId": "IndicesPutTemplate_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "order", - "in": "query", - "description": "The order for this template when merging multiple matching ones (higher numbers are merged later, overriding the lower numbers).", - "schema": { - "type": "integer", - "description": "The order for this template when merging multiple matching ones (higher numbers are merged later, overriding the lower numbers).", - "format": "int32" - } - }, - { - "name": "create", - "in": "query", - "description": "Whether the index template should only be added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template should only be added if new or can also replace an existing one." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesPutTemplate_Post 200 response" - } - }, - "x-operation-group": "indices.put_template", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates an index template.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-templates/" - }, - "operationId": "IndicesPutTemplate_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "name", - "in": "path", - "description": "The name of the template.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the template." - }, - "required": true - }, - { - "name": "order", - "in": "query", - "description": "The order for this template when merging multiple matching ones (higher numbers are merged later, overriding the lower numbers).", - "schema": { - "type": "integer", - "description": "The order for this template when merging multiple matching ones (higher numbers are merged later, overriding the lower numbers).", - "format": "int32" - } - }, - { - "name": "create", - "in": "query", - "description": "Whether the index template should only be added if new or can also replace an existing one.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether the index template should only be added if new or can also replace an existing one." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesPutTemplate_Put 200 response" - } - }, - "x-operation-group": "indices.put_template", - "x-version-added": "1.0" - } - }, - "/_update_by_query/{task_id}/_rethrottle": { - "post": { - "description": "Changes the number of requests per second for a particular Update By Query operation.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "UpdateByQueryRethrottle", - "parameters": [ - { - "name": "task_id", - "in": "path", - "description": "The task id to rethrottle.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The task id to rethrottle." - }, - "required": true - }, - { - "name": "requests_per_second", - "in": "query", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "schema": { - "type": "integer", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "format": "int32" - }, - "required": true - } - ], - "responses": { - "200": { - "description": "UpdateByQueryRethrottle 200 response" - } - }, - "x-operation-group": "update_by_query_rethrottle", - "x-version-added": "1.0" - } - }, - "/_upgrade": { - "get": { - "description": "The _upgrade API is no longer useful and will be removed.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesGetUpgrade", - "parameters": [ - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesGetUpgrade 200 response" - } - }, - "x-operation-group": "indices.get_upgrade", - "x-version-added": "1.0" - }, - "post": { - "description": "The _upgrade API is no longer useful and will be removed.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesUpgrade", - "parameters": [ - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "only_ancient_segments", - "in": "query", - "description": "If true, only ancient (an older Lucene major release) segments will be upgraded.", - "schema": { - "type": "boolean", - "description": "If true, only ancient (an older Lucene major release) segments will be upgraded." - } - } - ], - "responses": { - "200": { - "description": "IndicesUpgrade 200 response" - } - }, - "x-operation-group": "indices.upgrade", - "x-version-added": "1.0" - } - }, - "/_validate/query": { - "get": { - "description": "Allows a user to validate a potentially expensive query without executing it.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesValidateQuery_Get", - "parameters": [ - { - "name": "explain", - "in": "query", - "description": "Return detailed information about the error.", - "schema": { - "type": "boolean", - "description": "Return detailed information about the error." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "rewrite", - "in": "query", - "description": "Provide a more detailed explanation showing the actual Lucene query that will be executed.", - "schema": { - "type": "boolean", - "description": "Provide a more detailed explanation showing the actual Lucene query that will be executed." - } - }, - { - "name": "all_shards", - "in": "query", - "description": "Execute validation on all shards instead of one random shard per index.", - "schema": { - "type": "boolean", - "description": "Execute validation on all shards instead of one random shard per index." - } - } - ], - "responses": { - "200": { - "description": "IndicesValidateQuery_Get 200 response" - } - }, - "x-operation-group": "indices.validate_query", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows a user to validate a potentially expensive query without executing it.", - "operationId": "IndicesValidateQuery_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesValidateQuery_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "explain", - "in": "query", - "description": "Return detailed information about the error.", - "schema": { - "type": "boolean", - "description": "Return detailed information about the error." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "rewrite", - "in": "query", - "description": "Provide a more detailed explanation showing the actual Lucene query that will be executed.", - "schema": { - "type": "boolean", - "description": "Provide a more detailed explanation showing the actual Lucene query that will be executed." - } - }, - { - "name": "all_shards", - "in": "query", - "description": "Execute validation on all shards instead of one random shard per index.", - "schema": { - "type": "boolean", - "description": "Execute validation on all shards instead of one random shard per index." - } - } - ], - "responses": { - "200": { - "description": "IndicesValidateQuery_Post 200 response" - } - }, - "x-operation-group": "indices.validate_query", - "x-version-added": "1.0" - } - }, - "/{alias}/_rollover": { - "post": { - "description": "Updates an alias to point to a new index when the existing index\nis considered to be too large or too old.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/dashboards/im-dashboards/rollover/" - }, - "operationId": "IndicesRollover", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesRollover_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "alias", - "in": "path", - "description": "The name of the alias to rollover.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the alias to rollover." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "dry_run", - "in": "query", - "description": "If set to true the rollover action will only be validated but not actually performed even if a condition matches.", - "schema": { - "type": "boolean", - "default": false, - "description": "If set to true the rollover action will only be validated but not actually performed even if a condition matches." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for on the newly created rollover index before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for on the newly created rollover index before the operation returns." - } - } - ], - "responses": { - "200": { - "description": "IndicesRollover 200 response" - } - }, - "x-operation-group": "indices.rollover", - "x-version-added": "1.0" - } - }, - "/{alias}/_rollover/{new_index}": { - "post": { - "description": "Updates an alias to point to a new index when the existing index\nis considered to be too large or too old.", - "operationId": "IndicesRollover_WithNewIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesRollover_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "alias", - "in": "path", - "description": "The name of the alias to rollover.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the alias to rollover." - }, - "required": true - }, - { - "name": "new_index", - "in": "path", - "description": "The name of the rollover index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the rollover index." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "dry_run", - "in": "query", - "description": "If set to true the rollover action will only be validated but not actually performed even if a condition matches.", - "schema": { - "type": "boolean", - "default": false, - "description": "If set to true the rollover action will only be validated but not actually performed even if a condition matches." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for on the newly created rollover index before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for on the newly created rollover index before the operation returns." - } - } - ], - "responses": { - "200": { - "description": "IndicesRollover_WithNewIndex 200 response" - } - }, - "x-operation-group": "indices.rollover", - "x-version-added": "1.0" - } - }, - "/{index}": { - "delete": { - "description": "Deletes an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/delete-index/" - }, - "operationId": "IndicesDelete", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to delete; use `_all` or `*` string to delete all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to delete; use `_all` or `*` string to delete all indices.", - "x-data-type": "array" - }, - "required": true, - "examples": { - "IndicesDelete_example1": { - "summary": "Examples for Delete Index Operation.", - "description": "", - "value": "books" - } - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesDelete 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesDeleteResponseContent" - }, - "examples": { - "IndicesDelete_example1": { - "summary": "Examples for Delete Index Operation.", - "description": "", - "value": { - "acknowledged": true - } - } - } - } - } - } - }, - "x-operation-group": "indices.delete", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns information about one or more indices.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/get-index/" - }, - "operationId": "IndicesGet", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether to return all default setting for each of the indices.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to return all default setting for each of the indices." - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesGet 200 response" - } - }, - "x-operation-group": "indices.get", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns information about whether a particular index exists.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/exists/" - }, - "operationId": "IndicesExists", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether to return all default setting for each of the indices.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to return all default setting for each of the indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesExists 200 response" - } - }, - "x-operation-group": "indices.exists", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates an index with optional settings and mappings.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/create-index/" - }, - "operationId": "IndicesCreate", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesCreate_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true, - "examples": { - "IndicesCreate_example1": { - "summary": "Examples for Create Index Operation.", - "description": "", - "value": "books" - } - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for before the operation returns." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesCreate 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesCreateResponseContent" - }, - "examples": { - "IndicesCreate_example1": { - "summary": "Examples for Create Index Operation.", - "description": "", - "value": { - "index": "books", - "shards_acknowledged": true, - "acknowledged": true - } - } - } - } - } - } - }, - "x-operation-group": "indices.create", - "x-version-added": "1.0" - } - }, - "/{index}/_alias": { - "get": { - "description": "Returns an alias.", - "operationId": "IndicesGetAlias_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to filter aliases.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to filter aliases.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetAlias_WithIndex 200 response" - } - }, - "x-operation-group": "indices.get_alias", - "x-version-added": "1.0" - } - }, - "/{index}/_alias/{name}": { - "delete": { - "description": "Deletes an alias.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-alias/#delete-aliases" - }, - "operationId": "IndicesDeleteAlias", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "name", - "in": "path", - "description": "Comma-separated list of aliases to delete (supports wildcards); use `_all` to delete all aliases for the specified indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of aliases to delete (supports wildcards); use `_all` to delete all aliases for the specified indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesDeleteAlias 200 response" - } - }, - "x-operation-group": "indices.delete_alias", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns an alias.", - "operationId": "IndicesGetAlias_WithIndexName", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to filter aliases.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to filter aliases.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "name", - "in": "path", - "description": "Comma-separated list of alias names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of alias names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetAlias_WithIndexName 200 response" - } - }, - "x-operation-group": "indices.get_alias", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns information about whether a particular alias exists.", - "operationId": "IndicesExistsAlias_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to filter aliases.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to filter aliases.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "name", - "in": "path", - "description": "Comma-separated list of alias names.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of alias names.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesExistsAlias_WithIndex 200 response" - } - }, - "x-operation-group": "indices.exists_alias", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates or updates an alias.", - "operationId": "IndicesPutAlias_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutAlias_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "name", - "in": "path", - "description": "The name of the alias to be created or updated.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the alias to be created or updated." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesPutAlias_Post 200 response" - } - }, - "x-operation-group": "indices.put_alias", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates an alias.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/im-plugin/index-alias/#create-aliases" - }, - "operationId": "IndicesPutAlias_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutAlias_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "name", - "in": "path", - "description": "The name of the alias to be created or updated.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the alias to be created or updated." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesPutAlias_Put 200 response" - } - }, - "x-operation-group": "indices.put_alias", - "x-version-added": "1.0" - } - }, - "/{index}/_aliases/{name}": { - "delete": { - "description": "Deletes an alias.", - "operationId": "IndicesDeleteAlias_Plural", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "name", - "in": "path", - "description": "Comma-separated list of aliases to delete (supports wildcards); use `_all` to delete all aliases for the specified indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of aliases to delete (supports wildcards); use `_all` to delete all aliases for the specified indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesDeleteAlias_Plural 200 response" - } - }, - "x-operation-group": "indices.delete_alias", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates or updates an alias.", - "operationId": "IndicesPutAlias_Post_Plural", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutAlias_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "name", - "in": "path", - "description": "The name of the alias to be created or updated.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the alias to be created or updated." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesPutAlias_Post_Plural 200 response" - } - }, - "x-operation-group": "indices.put_alias", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates an alias.", - "operationId": "IndicesPutAlias_Put_Plural", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutAlias_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "name", - "in": "path", - "description": "The name of the alias to be created or updated.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the alias to be created or updated." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesPutAlias_Put_Plural 200 response" - } - }, - "x-operation-group": "indices.put_alias", - "x-version-added": "1.0" - } - }, - "/{index}/_analyze": { - "get": { - "description": "Performs the analysis process on a text and return the tokens breakdown of the text.", - "operationId": "IndicesAnalyze_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The name of the index to scope the operation.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the index to scope the operation." - }, - "required": true - }, - { - "name": "index", - "in": "query", - "description": "The name of the index to scope the operation.", - "schema": { - "type": "string", - "description": "The name of the index to scope the operation." - } - } - ], - "responses": { - "200": { - "description": "IndicesAnalyze_Get_WithIndex 200 response" - } - }, - "x-operation-group": "indices.analyze", - "x-version-added": "1.0" - }, - "post": { - "description": "Performs the analysis process on a text and return the tokens breakdown of the text.", - "operationId": "IndicesAnalyze_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesAnalyze_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The name of the index to scope the operation.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the index to scope the operation." - }, - "required": true - }, - { - "name": "index", - "in": "query", - "description": "The name of the index to scope the operation.", - "schema": { - "type": "string", - "description": "The name of the index to scope the operation." - } - } - ], - "responses": { - "200": { - "description": "IndicesAnalyze_Post_WithIndex 200 response" - } - }, - "x-operation-group": "indices.analyze", - "x-version-added": "1.0" - } - }, - "/{index}/_block/{block}": { - "put": { - "description": "Adds a block to an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "IndicesAddBlock", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to add a block to.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to add a block to.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "block", - "in": "path", - "description": "The block to add (one of read, write, read_only or metadata).", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The block to add (one of read, write, read_only or metadata)." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesAddBlock 200 response" - } - }, - "x-operation-group": "indices.add_block", - "x-version-added": "1.0" - } - }, - "/{index}/_bulk": { - "post": { - "description": "Allows to perform multiple index/update/delete operations in a single request.", - "operationId": "Bulk_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Bulk_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Default index for items which don't provide one.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Default index for items which don't provide one." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "type", - "in": "query", - "description": "Default document type for items which don't provide one.", - "schema": { - "type": "string", - "description": "Default document type for items which don't provide one." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or default list of fields to return, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or default list of fields to return, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "Default list of fields to exclude from the returned _source field, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Default list of fields to exclude from the returned _source field, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "Default list of fields to extract and return from the _source field, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Default list of fields to extract and return from the _source field, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - }, - { - "name": "require_alias", - "in": "query", - "description": "Sets require_alias for all incoming documents.", - "schema": { - "type": "boolean", - "default": false, - "description": "Sets require_alias for all incoming documents." - } - } - ], - "responses": { - "200": { - "description": "Bulk_Post_WithIndex 200 response" - } - }, - "x-operation-group": "bulk", - "x-version-added": "1.0" - }, - "put": { - "description": "Allows to perform multiple index/update/delete operations in a single request.", - "operationId": "Bulk_Put_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Bulk_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Default index for items which don't provide one.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Default index for items which don't provide one." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "type", - "in": "query", - "description": "Default document type for items which don't provide one.", - "schema": { - "type": "string", - "description": "Default document type for items which don't provide one." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or default list of fields to return, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or default list of fields to return, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "Default list of fields to exclude from the returned _source field, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Default list of fields to exclude from the returned _source field, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "Default list of fields to extract and return from the _source field, can be overridden on each sub-request.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Default list of fields to extract and return from the _source field, can be overridden on each sub-request." - }, - "explode": true - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - }, - { - "name": "require_alias", - "in": "query", - "description": "Sets require_alias for all incoming documents.", - "schema": { - "type": "boolean", - "default": false, - "description": "Sets require_alias for all incoming documents." - } - } - ], - "responses": { - "200": { - "description": "Bulk_Put_WithIndex 200 response" - } - }, - "x-operation-group": "bulk", - "x-version-added": "1.0" - } - }, - "/{index}/_cache/clear": { - "post": { - "description": "Clears all or specific caches for one or more indices.", - "operationId": "IndicesClearCache_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "fielddata", - "in": "query", - "description": "Clear field data.", - "schema": { - "type": "boolean", - "description": "Clear field data." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to clear when using the `fielddata` parameter (default: all).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to clear when using the `fielddata` parameter (default: all)." - }, - "explode": true - }, - { - "name": "query", - "in": "query", - "description": "Clear query caches.", - "schema": { - "type": "boolean", - "description": "Clear query caches." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "index", - "in": "query", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices." - }, - "explode": true - }, - { - "name": "request", - "in": "query", - "description": "Clear request cache.", - "schema": { - "type": "boolean", - "description": "Clear request cache." - } - } - ], - "responses": { - "200": { - "description": "IndicesClearCache_WithIndex 200 response" - } - }, - "x-operation-group": "indices.clear_cache", - "x-version-added": "1.0" - } - }, - "/{index}/_clone/{target}": { - "post": { - "description": "Clones an index.", - "operationId": "IndicesClone_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesClone_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The name of the source index to clone.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the source index to clone." - }, - "required": true - }, - { - "name": "target", - "in": "path", - "description": "The name of the target index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the target index." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for on the cloned index before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for on the cloned index before the operation returns." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "task_execution_timeout", - "in": "query", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesClone_Post 200 response" - } - }, - "x-operation-group": "indices.clone", - "x-version-added": "1.0" - }, - "put": { - "description": "Clones an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/clone/" - }, - "operationId": "IndicesClone_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesClone_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The name of the source index to clone.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the source index to clone." - }, - "required": true - }, - { - "name": "target", - "in": "path", - "description": "The name of the target index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the target index." - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for on the cloned index before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for on the cloned index before the operation returns." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "task_execution_timeout", - "in": "query", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesClone_Put 200 response" - } - }, - "x-operation-group": "indices.clone", - "x-version-added": "1.0" - } - }, - "/{index}/_close": { - "post": { - "description": "Closes an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/close-index/" - }, - "operationId": "IndicesClose", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to close.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to close.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of active shards to wait for before the operation returns.", - "schema": { - "type": "string", - "description": "Sets the number of active shards to wait for before the operation returns." - } - } - ], - "responses": { - "200": { - "description": "IndicesClose 200 response" - } - }, - "x-operation-group": "indices.close", - "x-version-added": "1.0" - } - }, - "/{index}/_count": { - "get": { - "description": "Returns number of documents matching a query.", - "operationId": "Count_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to restrict the results.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to restrict the results.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "min_score", - "in": "query", - "description": "Include only documents with a specific `_score` value in the result.", - "schema": { - "type": "integer", - "description": "Include only documents with a specific `_score` value in the result.", - "format": "int32" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - } - ], - "responses": { - "200": { - "description": "Count_Get_WithIndex 200 response" - } - }, - "x-operation-group": "count", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns number of documents matching a query.", - "operationId": "Count_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Count_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to restrict the results.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to restrict the results.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "min_score", - "in": "query", - "description": "Include only documents with a specific `_score` value in the result.", - "schema": { - "type": "integer", - "description": "Include only documents with a specific `_score` value in the result.", - "format": "int32" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - } - ], - "responses": { - "200": { - "description": "Count_Post_WithIndex 200 response" - } - }, - "x-operation-group": "count", - "x-version-added": "1.0" - } - }, - "/{index}/_create/{id}": { - "post": { - "description": "Creates a new document in the index.\n\nReturns a 409 response when a document with a same ID already exists in the index.", - "operationId": "Create_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Create_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - } - ], - "responses": { - "200": { - "description": "Create_Post 200 response" - } - }, - "x-operation-group": "create", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates a new document in the index.\n\nReturns a 409 response when a document with a same ID already exists in the index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/index-document/" - }, - "operationId": "Create_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Create_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - } - ], - "responses": { - "200": { - "description": "Create_Put 200 response" - } - }, - "x-operation-group": "create", - "x-version-added": "1.0" - } - }, - "/{index}/_delete_by_query": { - "post": { - "description": "Deletes documents matching the provided query.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/delete-by-query/" - }, - "operationId": "DeleteByQuery", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/DeleteByQuery_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "from", - "in": "query", - "description": "Starting offset.", - "schema": { - "type": "integer", - "default": 0, - "description": "Starting offset.", - "format": "int32" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "conflicts", - "in": "query", - "description": "What to do when the operation encounters version conflicts?.", - "schema": { - "$ref": "#/components/schemas/Conflicts" - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - }, - { - "name": "search_timeout", - "in": "query", - "description": "Explicit timeout for each search request. Defaults to no timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit timeout for each search request. Defaults to no timeout.", - "x-data-type": "time" - } - }, - { - "name": "size", - "in": "query", - "description": "Deprecated, please use `max_docs` instead.", - "schema": { - "type": "integer", - "description": "Deprecated, please use `max_docs` instead.", - "format": "int32" - } - }, - { - "name": "max_docs", - "in": "query", - "description": "Maximum number of documents to process (default: all documents).", - "schema": { - "type": "integer", - "description": "Maximum number of documents to process (default: all documents).", - "format": "int32" - } - }, - { - "name": "sort", - "in": "query", - "description": "Comma-separated list of : pairs.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of : pairs." - }, - "explode": true - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - }, - { - "name": "stats", - "in": "query", - "description": "Specific 'tag' of the request for logging and statistical purposes.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Specific 'tag' of the request for logging and statistical purposes." - }, - "explode": true - }, - { - "name": "version", - "in": "query", - "description": "Whether to return document version as part of a hit.", - "schema": { - "type": "boolean", - "description": "Whether to return document version as part of a hit." - } - }, - { - "name": "request_cache", - "in": "query", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting.", - "schema": { - "type": "boolean", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Time each individual bulk request should wait for shards that are unavailable.", - "schema": { - "type": "string", - "default": "1m", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Time each individual bulk request should wait for shards that are unavailable.", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "scroll_size", - "in": "query", - "description": "Size on the scroll request powering the operation.", - "schema": { - "type": "integer", - "default": 100, - "description": "Size on the scroll request powering the operation.", - "format": "int32" - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "requests_per_second", - "in": "query", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "schema": { - "type": "integer", - "default": 0, - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "format": "int32" - } - }, - { - "name": "slices", - "in": "query", - "description": "The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to `auto`.", - "schema": { - "type": "string", - "default": "1", - "description": "The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to `auto`." - } - } - ], - "responses": { - "200": { - "description": "DeleteByQuery 200 response" - } - }, - "x-operation-group": "delete_by_query", - "x-version-added": "1.0" - } - }, - "/{index}/_doc": { - "post": { - "description": "Creates or updates a document in an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/index-document/" - }, - "operationId": "Index_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Index_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "op_type", - "in": "query", - "description": "Explicit operation type. Defaults to `index` for requests with an explicit document ID, and to `create` for requests without an explicit document ID.", - "schema": { - "$ref": "#/components/schemas/OpType" - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - }, - { - "name": "if_seq_no", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "format": "int32" - } - }, - { - "name": "if_primary_term", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "format": "int32" - } - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - }, - { - "name": "require_alias", - "in": "query", - "description": "When true, requires destination to be an alias.", - "schema": { - "type": "boolean", - "default": false, - "description": "When true, requires destination to be an alias." - } - } - ], - "responses": { - "200": { - "description": "Index_Post 200 response" - } - }, - "x-operation-group": "index", - "x-version-added": "1.0" - } - }, - "/{index}/_doc/{id}": { - "delete": { - "description": "Removes a document from the index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/delete-document/" - }, - "operationId": "Delete", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "if_seq_no", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "format": "int32" - } - }, - { - "name": "if_primary_term", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "format": "int32" - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Delete 200 response" - } - }, - "x-operation-group": "delete", - "x-version-added": "1.0" - }, - "get": { - "description": "Returns a document.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/" - }, - "operationId": "Get", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true, - "examples": { - "Get_example1": { - "summary": "Examples for Get document doc Operation.", - "description": "", - "value": "1" - } - } - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true, - "examples": { - "Get_example1": { - "summary": "Examples for Get document doc Operation.", - "description": "", - "value": "books" - } - } - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specify whether to perform the operation in realtime or search mode.", - "schema": { - "type": "boolean", - "description": "Specify whether to perform the operation in realtime or search mode." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Get 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/GetResponseContent" - }, - "examples": { - "Get_example1": { - "summary": "Examples for Get document doc Operation.", - "description": "", - "value": { - "_index": "books", - "_id": "1", - "found": true - } - } - } - } - } - } - }, - "x-operation-group": "get", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns information about whether a document exists in an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/" - }, - "operationId": "Exists", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specify whether to perform the operation in realtime or search mode.", - "schema": { - "type": "boolean", - "description": "Specify whether to perform the operation in realtime or search mode." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Exists 200 response" - } - }, - "x-operation-group": "exists", - "x-version-added": "1.0" - }, - "post": { - "description": "Creates or updates a document in an index.", - "operationId": "Index_Post_WithId", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Index_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "op_type", - "in": "query", - "description": "Explicit operation type. Defaults to `index` for requests with an explicit document ID, and to `create` for requests without an explicit document ID.", - "schema": { - "$ref": "#/components/schemas/OpType" - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - }, - { - "name": "if_seq_no", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "format": "int32" - } - }, - { - "name": "if_primary_term", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "format": "int32" - } - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - }, - { - "name": "require_alias", - "in": "query", - "description": "When true, requires destination to be an alias.", - "schema": { - "type": "boolean", - "default": false, - "description": "When true, requires destination to be an alias." - } - } - ], - "responses": { - "200": { - "description": "Index_Post_WithId 200 response" - } - }, - "x-operation-group": "index", - "x-version-added": "1.0" - }, - "put": { - "description": "Creates or updates a document in an index.", - "operationId": "Index_Put_WithId", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Index_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "op_type", - "in": "query", - "description": "Explicit operation type. Defaults to `index` for requests with an explicit document ID, and to `create` for requests without an explicit document ID.", - "schema": { - "$ref": "#/components/schemas/OpType" - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - }, - { - "name": "if_seq_no", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "format": "int32" - } - }, - { - "name": "if_primary_term", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "format": "int32" - } - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - }, - { - "name": "require_alias", - "in": "query", - "description": "When true, requires destination to be an alias.", - "schema": { - "type": "boolean", - "default": false, - "description": "When true, requires destination to be an alias." - } - } - ], - "responses": { - "200": { - "description": "Index_Put_WithId 200 response" - } - }, - "x-operation-group": "index", - "x-version-added": "1.0" - } - }, - "/{index}/_explain/{id}": { - "get": { - "description": "Returns information about why a specific matches (or doesn't match) a query.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/explain/" - }, - "operationId": "Explain_Get", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcards and prefix queries in the query string query should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcards and prefix queries in the query string query should be analyzed." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The default field for query string query.", - "schema": { - "type": "string", - "default": "_all", - "description": "The default field for query string query." - } - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "Explain_Get 200 response" - } - }, - "x-operation-group": "explain", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns information about why a specific matches (or doesn't match) a query.", - "operationId": "Explain_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Explain_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcards and prefix queries in the query string query should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcards and prefix queries in the query string query should be analyzed." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The default field for query string query.", - "schema": { - "type": "string", - "default": "_all", - "description": "The default field for query string query." - } - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "Explain_Post 200 response" - } - }, - "x-operation-group": "explain", - "x-version-added": "1.0" - } - }, - "/{index}/_field_caps": { - "get": { - "description": "Returns the information about the capabilities of fields among multiple indices.", - "operationId": "FieldCaps_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of field names.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of field names." - }, - "explode": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "include_unmapped", - "in": "query", - "description": "Indicates whether unmapped fields should be included in the response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether unmapped fields should be included in the response." - } - } - ], - "responses": { - "200": { - "description": "FieldCaps_Get_WithIndex 200 response" - } - }, - "x-operation-group": "field_caps", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns the information about the capabilities of fields among multiple indices.", - "operationId": "FieldCaps_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/FieldCaps_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of field names.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of field names." - }, - "explode": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "include_unmapped", - "in": "query", - "description": "Indicates whether unmapped fields should be included in the response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether unmapped fields should be included in the response." - } - } - ], - "responses": { - "200": { - "description": "FieldCaps_Post_WithIndex 200 response" - } - }, - "x-operation-group": "field_caps", - "x-version-added": "1.0" - } - }, - "/{index}/_flush": { - "get": { - "description": "Performs the flush operation on one or more indices.", - "operationId": "IndicesFlush_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "force", - "in": "query", - "description": "Whether a flush should be forced even if it is not necessarily needed ie. if no changes will be committed to the index. This is useful if transaction log IDs should be incremented even if no uncommitted changes are present. (This setting can be considered as internal).", - "schema": { - "type": "boolean", - "description": "Whether a flush should be forced even if it is not necessarily needed ie. if no changes will be committed to the index. This is useful if transaction log IDs should be incremented even if no uncommitted changes are present. (This setting can be considered as internal)." - } - }, - { - "name": "wait_if_ongoing", - "in": "query", - "description": "If set to true the flush operation will block until the flush can be executed if another flush operation is already executing. If set to false the flush will be skipped iff if another flush operation is already running.", - "schema": { - "type": "boolean", - "default": true, - "description": "If set to true the flush operation will block until the flush can be executed if another flush operation is already executing. If set to false the flush will be skipped iff if another flush operation is already running." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesFlush_Get_WithIndex 200 response" - } - }, - "x-operation-group": "indices.flush", - "x-version-added": "1.0" - }, - "post": { - "description": "Performs the flush operation on one or more indices.", - "operationId": "IndicesFlush_Post_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "force", - "in": "query", - "description": "Whether a flush should be forced even if it is not necessarily needed ie. if no changes will be committed to the index. This is useful if transaction log IDs should be incremented even if no uncommitted changes are present. (This setting can be considered as internal).", - "schema": { - "type": "boolean", - "description": "Whether a flush should be forced even if it is not necessarily needed ie. if no changes will be committed to the index. This is useful if transaction log IDs should be incremented even if no uncommitted changes are present. (This setting can be considered as internal)." - } - }, - { - "name": "wait_if_ongoing", - "in": "query", - "description": "If set to true the flush operation will block until the flush can be executed if another flush operation is already executing. If set to false the flush will be skipped iff if another flush operation is already running.", - "schema": { - "type": "boolean", - "default": true, - "description": "If set to true the flush operation will block until the flush can be executed if another flush operation is already executing. If set to false the flush will be skipped iff if another flush operation is already running." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesFlush_Post_WithIndex 200 response" - } - }, - "x-operation-group": "indices.flush", - "x-version-added": "1.0" - } - }, - "/{index}/_forcemerge": { - "post": { - "description": "Performs the force merge operation on one or more indices.", - "operationId": "IndicesForcemerge_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "flush", - "in": "query", - "description": "Specify whether the index should be flushed after performing the operation.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specify whether the index should be flushed after performing the operation." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "max_num_segments", - "in": "query", - "description": "The number of segments the index should be merged into (default: dynamic).", - "schema": { - "type": "integer", - "description": "The number of segments the index should be merged into (default: dynamic).", - "format": "int32" - } - }, - { - "name": "only_expunge_deletes", - "in": "query", - "description": "Specify whether the operation should only expunge deleted documents.", - "schema": { - "type": "boolean", - "description": "Specify whether the operation should only expunge deleted documents." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - } - ], - "responses": { - "200": { - "description": "IndicesForcemerge_WithIndex 200 response" - } - }, - "x-operation-group": "indices.forcemerge", - "x-version-added": "1.0" - } - }, - "/{index}/_mapping": { - "get": { - "description": "Returns mappings for one or more indices.", - "operationId": "IndicesGetMapping_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "x-version-deprecated": "1.0", - "x-deprecation-message": "This parameter is a no-op and field mappings are always retrieved locally.", - "deprecated": true - } - } - ], - "responses": { - "200": { - "description": "IndicesGetMapping_WithIndex 200 response" - } - }, - "x-operation-group": "indices.get_mapping", - "x-version-added": "1.0" - }, - "post": { - "description": "Updates the index mappings.", - "operationId": "IndicesPutMapping_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutMapping_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "write_index_only", - "in": "query", - "description": "When true, applies mappings only to the write index of an alias or data stream.", - "schema": { - "type": "boolean", - "default": false, - "description": "When true, applies mappings only to the write index of an alias or data stream." - } - } - ], - "responses": { - "200": { - "description": "IndicesPutMapping_Post 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutMapping_PostResponseContent" - } - } - } - } - }, - "x-operation-group": "indices.put_mapping", - "x-version-added": "1.0" - }, - "put": { - "description": "Updates the index mappings.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/put-mapping/" - }, - "operationId": "IndicesPutMapping_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutMapping_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "write_index_only", - "in": "query", - "description": "When true, applies mappings only to the write index of an alias or data stream.", - "schema": { - "type": "boolean", - "default": false, - "description": "When true, applies mappings only to the write index of an alias or data stream." - } - } - ], - "responses": { - "200": { - "description": "IndicesPutMapping_Put 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutMapping_PutResponseContent" - } - } - } - } - }, - "x-operation-group": "indices.put_mapping", - "x-version-added": "1.0" - } - }, - "/{index}/_mapping/field/{fields}": { - "get": { - "description": "Returns mapping for one or more fields.", - "operationId": "IndicesGetFieldMapping_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "fields", - "in": "path", - "description": "Comma-separated list of fields.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of fields.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether the default mapping values should be returned as well.", - "schema": { - "type": "boolean", - "description": "Whether the default mapping values should be returned as well." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetFieldMapping_WithIndex 200 response" - } - }, - "x-operation-group": "indices.get_field_mapping", - "x-version-added": "1.0" - } - }, - "/{index}/_mget": { - "get": { - "description": "Allows to get multiple documents in one request.", - "operationId": "Mget_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specify whether to perform the operation in realtime or search mode.", - "schema": { - "type": "boolean", - "description": "Specify whether to perform the operation in realtime or search mode." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "Mget_Get_WithIndex 200 response" - } - }, - "x-operation-group": "mget", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to get multiple documents in one request.", - "operationId": "Mget_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Mget_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specify whether to perform the operation in realtime or search mode.", - "schema": { - "type": "boolean", - "description": "Specify whether to perform the operation in realtime or search mode." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - } - ], - "responses": { - "200": { - "description": "Mget_Post_WithIndex 200 response" - } - }, - "x-operation-group": "mget", - "x-version-added": "1.0" - } - }, - "/{index}/_msearch": { - "get": { - "description": "Allows to execute several search operations in one request.", - "operationId": "Msearch_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to use as default.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to use as default.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "max_concurrent_searches", - "in": "query", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "schema": { - "type": "integer", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "format": "int32" - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "pre_filter_shard_size", - "in": "query", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "schema": { - "type": "integer", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "format": "int32" - } - }, - { - "name": "max_concurrent_shard_requests", - "in": "query", - "description": "The number of concurrent shard requests each sub search executes concurrently per node. 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.", - "schema": { - "type": "integer", - "default": 5, - "description": "The number of concurrent shard requests each sub search executes concurrently per node. 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.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "Msearch_Get_WithIndex 200 response" - } - }, - "x-operation-group": "msearch", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to execute several search operations in one request.", - "operationId": "Msearch_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Msearch_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to use as default.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to use as default.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "max_concurrent_searches", - "in": "query", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "schema": { - "type": "integer", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "format": "int32" - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "pre_filter_shard_size", - "in": "query", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "schema": { - "type": "integer", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "format": "int32" - } - }, - { - "name": "max_concurrent_shard_requests", - "in": "query", - "description": "The number of concurrent shard requests each sub search executes concurrently per node. 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.", - "schema": { - "type": "integer", - "default": 5, - "description": "The number of concurrent shard requests each sub search executes concurrently per node. 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.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "Msearch_Post_WithIndex 200 response" - } - }, - "x-operation-group": "msearch", - "x-version-added": "1.0" - } - }, - "/{index}/_msearch/template": { - "get": { - "description": "Allows to execute several search template operations in one request.", - "operationId": "MsearchTemplate_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to use as default.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to use as default.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "max_concurrent_searches", - "in": "query", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "schema": { - "type": "integer", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "MsearchTemplate_Get_WithIndex 200 response" - } - }, - "x-operation-group": "msearch_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to execute several search template operations in one request.", - "operationId": "MsearchTemplate_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/MsearchTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to use as default.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to use as default.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "max_concurrent_searches", - "in": "query", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "schema": { - "type": "integer", - "description": "Controls the maximum number of concurrent searches the multi search api will execute.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "MsearchTemplate_Post_WithIndex 200 response" - } - }, - "x-operation-group": "msearch_template", - "x-version-added": "1.0" - } - }, - "/{index}/_mtermvectors": { - "get": { - "description": "Returns multiple termvectors in one request.", - "operationId": "Mtermvectors_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The index in which the document resides.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The index in which the document resides." - }, - "required": true - }, - { - "name": "ids", - "in": "query", - "description": "Comma-separated list of documents ids. You must define ids as parameter or set 'ids' or 'docs' in the request body.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of documents ids. You must define ids as parameter or set 'ids' or 'docs' in the request body." - }, - "explode": true - }, - { - "name": "term_statistics", - "in": "query", - "description": "Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "field_statistics", - "in": "query", - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - }, - "explode": true - }, - { - "name": "offsets", - "in": "query", - "description": "Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "positions", - "in": "query", - "description": "Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "payloads", - "in": "query", - "description": "Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "string", - "description": "Routing value. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specifies if requests are real-time as opposed to near-real-time.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if requests are real-time as opposed to near-real-time." - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Mtermvectors_Get_WithIndex 200 response" - } - }, - "x-operation-group": "mtermvectors", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns multiple termvectors in one request.", - "operationId": "Mtermvectors_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Mtermvectors_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The index in which the document resides.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The index in which the document resides." - }, - "required": true - }, - { - "name": "ids", - "in": "query", - "description": "Comma-separated list of documents ids. You must define ids as parameter or set 'ids' or 'docs' in the request body.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of documents ids. You must define ids as parameter or set 'ids' or 'docs' in the request body." - }, - "explode": true - }, - { - "name": "term_statistics", - "in": "query", - "description": "Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specifies if total term frequency and document frequency should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "field_statistics", - "in": "query", - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - }, - "explode": true - }, - { - "name": "offsets", - "in": "query", - "description": "Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term offsets should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "positions", - "in": "query", - "description": "Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term positions should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "payloads", - "in": "query", - "description": "Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term payloads should be returned. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'.", - "schema": { - "type": "string", - "description": "Routing value. Applies to all returned documents unless otherwise specified in body 'params' or 'docs'." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specifies if requests are real-time as opposed to near-real-time.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if requests are real-time as opposed to near-real-time." - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Mtermvectors_Post_WithIndex 200 response" - } - }, - "x-operation-group": "mtermvectors", - "x-version-added": "1.0" - } - }, - "/{index}/_open": { - "post": { - "description": "Opens an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/open-index/" - }, - "operationId": "IndicesOpen", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices to open.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices to open.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of active shards to wait for before the operation returns.", - "schema": { - "type": "string", - "description": "Sets the number of active shards to wait for before the operation returns." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "task_execution_timeout", - "in": "query", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesOpen 200 response" - } - }, - "x-operation-group": "indices.open", - "x-version-added": "1.0" - } - }, - "/{index}/_rank_eval": { - "get": { - "description": "Allows to evaluate the quality of ranked search results over a set of typical search queries.", - "operationId": "RankEval_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - } - ], - "responses": { - "200": { - "description": "RankEval_Get_WithIndex 200 response" - } - }, - "x-operation-group": "rank_eval", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to evaluate the quality of ranked search results over a set of typical search queries.", - "operationId": "RankEval_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/RankEval_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - } - ], - "responses": { - "200": { - "description": "RankEval_Post_WithIndex 200 response" - } - }, - "x-operation-group": "rank_eval", - "x-version-added": "1.0" - } - }, - "/{index}/_recovery": { - "get": { - "description": "Returns information about ongoing index shard recoveries.", - "operationId": "IndicesRecovery_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "detailed", - "in": "query", - "description": "Whether to display detailed information about shard recovery.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to display detailed information about shard recovery." - } - }, - { - "name": "active_only", - "in": "query", - "description": "Display only those recoveries that are currently on-going.", - "schema": { - "type": "boolean", - "default": false, - "description": "Display only those recoveries that are currently on-going." - } - } - ], - "responses": { - "200": { - "description": "IndicesRecovery_WithIndex 200 response" - } - }, - "x-operation-group": "indices.recovery", - "x-version-added": "1.0" - } - }, - "/{index}/_refresh": { - "get": { - "description": "Performs the refresh operation in one or more indices.", - "operationId": "IndicesRefresh_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesRefresh_Get_WithIndex 200 response" - } - }, - "x-operation-group": "indices.refresh", - "x-version-added": "1.0" - }, - "post": { - "description": "Performs the refresh operation in one or more indices.", - "operationId": "IndicesRefresh_Post_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesRefresh_Post_WithIndex 200 response" - } - }, - "x-operation-group": "indices.refresh", - "x-version-added": "1.0" - } - }, - "/{index}/_search": { - "get": { - "description": "Returns results matching a query.", - "operationId": "Search_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "explain", - "in": "query", - "description": "Specify whether to return detailed information about score computation as part of a hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return detailed information about score computation as part of a hit." - } - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "docvalue_fields", - "in": "query", - "description": "Comma-separated list of fields to return as the docvalue representation of a field for each hit.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return as the docvalue representation of a field for each hit." - }, - "explode": true - }, - { - "name": "from", - "in": "query", - "description": "Starting offset.", - "schema": { - "type": "integer", - "default": 0, - "description": "Starting offset.", - "format": "int32" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - }, - { - "name": "size", - "in": "query", - "description": "Number of hits to return.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of hits to return.", - "format": "int32" - } - }, - { - "name": "sort", - "in": "query", - "description": "Comma-separated list of : pairs.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of : pairs." - }, - "explode": true - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - }, - { - "name": "stats", - "in": "query", - "description": "Specific 'tag' of the request for logging and statistical purposes.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Specific 'tag' of the request for logging and statistical purposes." - }, - "explode": true - }, - { - "name": "suggest_field", - "in": "query", - "description": "Specify which field to use for suggestions.", - "schema": { - "type": "string", - "description": "Specify which field to use for suggestions." - } - }, - { - "name": "suggest_mode", - "in": "query", - "description": "Specify suggest mode.", - "schema": { - "$ref": "#/components/schemas/SuggestMode" - } - }, - { - "name": "suggest_size", - "in": "query", - "description": "How many suggestions to return in response.", - "schema": { - "type": "integer", - "description": "How many suggestions to return in response.", - "format": "int32" - } - }, - { - "name": "suggest_text", - "in": "query", - "description": "The source text for which the suggestions should be returned.", - "schema": { - "type": "string", - "description": "The source text for which the suggestions should be returned." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "track_scores", - "in": "query", - "description": "Whether to calculate and return scores even if they are not used for sorting.", - "schema": { - "type": "boolean", - "description": "Whether to calculate and return scores even if they are not used for sorting." - } - }, - { - "name": "track_total_hits", - "in": "query", - "description": "Indicate if the number of documents that match the query should be tracked.", - "schema": { - "type": "boolean", - "description": "Indicate if the number of documents that match the query should be tracked." - } - }, - { - "name": "allow_partial_search_results", - "in": "query", - "description": "Indicate if an error should be returned if there is a partial search failure or timeout.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicate if an error should be returned if there is a partial search failure or timeout." - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "version", - "in": "query", - "description": "Whether to return document version as part of a hit.", - "schema": { - "type": "boolean", - "description": "Whether to return document version as part of a hit." - } - }, - { - "name": "seq_no_primary_term", - "in": "query", - "description": "Specify whether to return sequence number and primary term of the last modification of each hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return sequence number and primary term of the last modification of each hit." - } - }, - { - "name": "request_cache", - "in": "query", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting.", - "schema": { - "type": "boolean", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting." - } - }, - { - "name": "batched_reduce_size", - "in": "query", - "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", - "schema": { - "type": "integer", - "default": 512, - "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", - "format": "int32" - } - }, - { - "name": "max_concurrent_shard_requests", - "in": "query", - "description": "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.", - "schema": { - "type": "integer", - "default": 5, - "description": "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.", - "format": "int32" - } - }, - { - "name": "pre_filter_shard_size", - "in": "query", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "schema": { - "type": "integer", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "search_pipeline", - "in": "query", - "description": "Customizable sequence of processing stages applied to search queries.", - "schema": { - "type": "string", - "description": "Customizable sequence of processing stages applied to search queries." - } - } - ], - "responses": { - "200": { - "description": "Search_Get_WithIndex 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Search_Get_WithIndexResponseContent" - } - } - } - } - }, - "x-operation-group": "search", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns results matching a query.", - "operationId": "Search_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Search_BodyParams" - }, - "examples": { - "Search_Post_WithIndex_example1": { - "summary": "Examples for Post Search With Index Operation.", - "description": "", - "value": { - "query": { - "match_all": {} - }, - "fields": [ - "*" - ] - } - } - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true, - "examples": { - "Search_Post_WithIndex_example1": { - "summary": "Examples for Post Search With Index Operation.", - "description": "", - "value": "books" - } - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "explain", - "in": "query", - "description": "Specify whether to return detailed information about score computation as part of a hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return detailed information about score computation as part of a hit." - } - }, - { - "name": "stored_fields", - "in": "query", - "description": "Comma-separated list of stored fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of stored fields to return." - }, - "explode": true - }, - { - "name": "docvalue_fields", - "in": "query", - "description": "Comma-separated list of fields to return as the docvalue representation of a field for each hit.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return as the docvalue representation of a field for each hit." - }, - "explode": true - }, - { - "name": "from", - "in": "query", - "description": "Starting offset.", - "schema": { - "type": "integer", - "default": 0, - "description": "Starting offset.", - "format": "int32" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - }, - "examples": { - "Search_Post_WithIndex_example1": { - "summary": "Examples for Post Search With Index Operation.", - "description": "", - "value": "1d" - } - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - }, - { - "name": "size", - "in": "query", - "description": "Number of hits to return.", - "schema": { - "type": "integer", - "default": 10, - "description": "Number of hits to return.", - "format": "int32" - } - }, - { - "name": "sort", - "in": "query", - "description": "Comma-separated list of : pairs.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of : pairs." - }, - "explode": true - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - }, - { - "name": "stats", - "in": "query", - "description": "Specific 'tag' of the request for logging and statistical purposes.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Specific 'tag' of the request for logging and statistical purposes." - }, - "explode": true - }, - { - "name": "suggest_field", - "in": "query", - "description": "Specify which field to use for suggestions.", - "schema": { - "type": "string", - "description": "Specify which field to use for suggestions." - } - }, - { - "name": "suggest_mode", - "in": "query", - "description": "Specify suggest mode.", - "schema": { - "$ref": "#/components/schemas/SuggestMode" - } - }, - { - "name": "suggest_size", - "in": "query", - "description": "How many suggestions to return in response.", - "schema": { - "type": "integer", - "description": "How many suggestions to return in response.", - "format": "int32" - } - }, - { - "name": "suggest_text", - "in": "query", - "description": "The source text for which the suggestions should be returned.", - "schema": { - "type": "string", - "description": "The source text for which the suggestions should be returned." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "track_scores", - "in": "query", - "description": "Whether to calculate and return scores even if they are not used for sorting.", - "schema": { - "type": "boolean", - "description": "Whether to calculate and return scores even if they are not used for sorting." - } - }, - { - "name": "track_total_hits", - "in": "query", - "description": "Indicate if the number of documents that match the query should be tracked.", - "schema": { - "type": "boolean", - "description": "Indicate if the number of documents that match the query should be tracked." - } - }, - { - "name": "allow_partial_search_results", - "in": "query", - "description": "Indicate if an error should be returned if there is a partial search failure or timeout.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicate if an error should be returned if there is a partial search failure or timeout." - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "version", - "in": "query", - "description": "Whether to return document version as part of a hit.", - "schema": { - "type": "boolean", - "description": "Whether to return document version as part of a hit." - } - }, - { - "name": "seq_no_primary_term", - "in": "query", - "description": "Specify whether to return sequence number and primary term of the last modification of each hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return sequence number and primary term of the last modification of each hit." - } - }, - { - "name": "request_cache", - "in": "query", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting.", - "schema": { - "type": "boolean", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting." - } - }, - { - "name": "batched_reduce_size", - "in": "query", - "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", - "schema": { - "type": "integer", - "default": 512, - "description": "The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large.", - "format": "int32" - } - }, - { - "name": "max_concurrent_shard_requests", - "in": "query", - "description": "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.", - "schema": { - "type": "integer", - "default": 5, - "description": "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.", - "format": "int32" - } - }, - { - "name": "pre_filter_shard_size", - "in": "query", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "schema": { - "type": "integer", - "description": "Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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.", - "format": "int32" - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "search_pipeline", - "in": "query", - "description": "Customizable sequence of processing stages applied to search queries.", - "schema": { - "type": "string", - "description": "Customizable sequence of processing stages applied to search queries." - } - } - ], - "responses": { - "200": { - "description": "Search_Post_WithIndex 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Search_Post_WithIndexResponseContent" - }, - "examples": { - "Search_Post_WithIndex_example1": { - "summary": "Examples for Post Search With Index Operation.", - "description": "", - "value": { - "timed_out": false, - "_shards": { - "total": 1, - "successful": 1, - "skipped": 0, - "failed": 0 - }, - "hits": { - "total": { - "value": 0, - "relation": "eq" - }, - "hits": [] - } - } - } - } - } - } - } - }, - "x-operation-group": "search", - "x-version-added": "1.0" - } - }, - "/{index}/_search/point_in_time": { - "post": { - "description": "Creates point in time context.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#create-a-pit" - }, - "operationId": "CreatePit", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "allow_partial_pit_creation", - "in": "query", - "description": "Allow if point in time can be created with partial failures.", - "schema": { - "type": "boolean", - "description": "Allow if point in time can be created with partial failures." - } - }, - { - "name": "keep_alive", - "in": "query", - "description": "Specify the keep alive for point in time.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify the keep alive for point in time.", - "x-data-type": "time" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "CreatePit 200 response", - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/CreatePitResponseContent" - } - } - } - } - }, - "x-operation-group": "create_pit", - "x-version-added": "2.4" - } - }, - "/{index}/_search/template": { - "get": { - "description": "Allows to use the Mustache language to pre-render a search definition.", - "operationId": "SearchTemplate_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "explain", - "in": "query", - "description": "Specify whether to return detailed information about score computation as part of a hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return detailed information about score computation as part of a hit." - } - }, - { - "name": "profile", - "in": "query", - "description": "Specify whether to profile the query execution.", - "schema": { - "type": "boolean", - "description": "Specify whether to profile the query execution." - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "SearchTemplate_Get_WithIndex 200 response" - } - }, - "x-operation-group": "search_template", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows to use the Mustache language to pre-render a search definition.", - "operationId": "SearchTemplate_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/SearchTemplate_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "ignore_throttled", - "in": "query", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled.", - "schema": { - "type": "boolean", - "description": "Whether specified concrete, expanded or aliased indices should be ignored when throttled." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchTypeMulti" - } - }, - { - "name": "explain", - "in": "query", - "description": "Specify whether to return detailed information about score computation as part of a hit.", - "schema": { - "type": "boolean", - "description": "Specify whether to return detailed information about score computation as part of a hit." - } - }, - { - "name": "profile", - "in": "query", - "description": "Specify whether to profile the query execution.", - "schema": { - "type": "boolean", - "description": "Specify whether to profile the query execution." - } - }, - { - "name": "typed_keys", - "in": "query", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response.", - "schema": { - "type": "boolean", - "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response." - } - }, - { - "name": "rest_total_hits_as_int", - "in": "query", - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response.", - "schema": { - "type": "boolean", - "default": false, - "description": "Indicates whether hits.total should be rendered as an integer or an object in the rest search response." - } - }, - { - "name": "ccs_minimize_roundtrips", - "in": "query", - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution.", - "schema": { - "type": "boolean", - "default": true, - "description": "Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution." - } - } - ], - "responses": { - "200": { - "description": "SearchTemplate_Post_WithIndex 200 response" - } - }, - "x-operation-group": "search_template", - "x-version-added": "1.0" - } - }, - "/{index}/_search_shards": { - "get": { - "description": "Returns information about the indices and shards that a search request would be executed against.", - "operationId": "SearchShards_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "SearchShards_Get_WithIndex 200 response" - } - }, - "x-operation-group": "search_shards", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns information about the indices and shards that a search request would be executed against.", - "operationId": "SearchShards_Post_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "SearchShards_Post_WithIndex 200 response" - } - }, - "x-operation-group": "search_shards", - "x-version-added": "1.0" - } - }, - "/{index}/_segments": { - "get": { - "description": "Provides low-level information about segments in a Lucene index.", - "operationId": "IndicesSegments_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "verbose", - "in": "query", - "description": "Includes detailed memory usage by Lucene.", - "schema": { - "type": "boolean", - "default": false, - "description": "Includes detailed memory usage by Lucene." - } - } - ], - "responses": { - "200": { - "description": "IndicesSegments_WithIndex 200 response" - } - }, - "x-operation-group": "indices.segments", - "x-version-added": "1.0" - } - }, - "/{index}/_settings": { - "get": { - "description": "Returns settings for one or more indices.", - "operationId": "IndicesGetSettings_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true, - "examples": { - "IndicesGetSettings_WithIndex_example1": { - "summary": "Examples for Get settings Index Operation.", - "description": "", - "value": "books" - } - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether to return all default setting for each of the indices.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to return all default setting for each of the indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetSettings_WithIndex 200 response" - } - }, - "x-operation-group": "indices.get_settings", - "x-version-added": "1.0" - }, - "put": { - "description": "Updates the index settings.", - "operationId": "IndicesPutSettings_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesPutSettings_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "preserve_existing", - "in": "query", - "description": "Whether to update existing settings. If set to `true` existing settings on an index remain unchanged.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to update existing settings. If set to `true` existing settings on an index remain unchanged." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - } - ], - "responses": { - "200": { - "description": "IndicesPutSettings_WithIndex 200 response" - } - }, - "x-operation-group": "indices.put_settings", - "x-version-added": "1.0" - } - }, - "/{index}/_settings/{name}": { - "get": { - "description": "Returns settings for one or more indices.", - "operationId": "IndicesGetSettings_WithIndexName", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true, - "examples": { - "IndicesGetSettings_WithIndexName_example1": { - "summary": "Examples for Get settings Index-setting Operation.", - "description": "", - "value": "books" - } - } - }, - { - "name": "name", - "in": "path", - "description": "Comma-separated list of settings.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of settings.", - "x-data-type": "array" - }, - "required": true, - "examples": { - "IndicesGetSettings_WithIndexName_example1": { - "summary": "Examples for Get settings Index-setting Operation.", - "description": "", - "value": "index" - } - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "flat_settings", - "in": "query", - "description": "Return settings in flat format.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return settings in flat format." - } - }, - { - "name": "local", - "in": "query", - "description": "Return local information, do not retrieve the state from cluster-manager node.", - "schema": { - "type": "boolean", - "default": false, - "description": "Return local information, do not retrieve the state from cluster-manager node." - } - }, - { - "name": "include_defaults", - "in": "query", - "description": "Whether to return all default setting for each of the indices.", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to return all default setting for each of the indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesGetSettings_WithIndexName 200 response" - } - }, - "x-operation-group": "indices.get_settings", - "x-version-added": "1.0" - } - }, - "/{index}/_shard_stores": { - "get": { - "description": "Provides store information for shard copies of indices.", - "operationId": "IndicesShardStores_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "status", - "in": "query", - "description": "Comma-separated list of statuses used to filter on shards to get store information for.", - "style": "form", - "schema": { - "type": "array", - "items": { - "$ref": "#/components/schemas/Status_Member" - }, - "description": "Comma-separated list of statuses used to filter on shards to get store information for." - }, - "explode": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesShardStores_WithIndex 200 response" - } - }, - "x-operation-group": "indices.shard_stores", - "x-version-added": "1.0" - } - }, - "/{index}/_shrink/{target}": { - "post": { - "description": "Allow to shrink an existing index into a new index with fewer primary shards.", - "operationId": "IndicesShrink_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesShrink_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The name of the source index to shrink.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the source index to shrink." - }, - "required": true - }, - { - "name": "target", - "in": "path", - "description": "The name of the target index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the target index." - }, - "required": true - }, - { - "name": "copy_settings", - "in": "query", - "description": "whether or not to copy settings from the source index.", - "schema": { - "type": "boolean", - "default": false, - "description": "whether or not to copy settings from the source index." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for on the shrunken index before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for on the shrunken index before the operation returns." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "task_execution_timeout", - "in": "query", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesShrink_Post 200 response" - } - }, - "x-operation-group": "indices.shrink", - "x-version-added": "1.0" - }, - "put": { - "description": "Allow to shrink an existing index into a new index with fewer primary shards.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/shrink-index/" - }, - "operationId": "IndicesShrink_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesShrink_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The name of the source index to shrink.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the source index to shrink." - }, - "required": true - }, - { - "name": "target", - "in": "path", - "description": "The name of the target index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the target index." - }, - "required": true - }, - { - "name": "copy_settings", - "in": "query", - "description": "whether or not to copy settings from the source index.", - "schema": { - "type": "boolean", - "default": false, - "description": "whether or not to copy settings from the source index." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for on the shrunken index before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for on the shrunken index before the operation returns." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "task_execution_timeout", - "in": "query", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesShrink_Put 200 response" - } - }, - "x-operation-group": "indices.shrink", - "x-version-added": "1.0" - } - }, - "/{index}/_source/{id}": { - "get": { - "description": "Returns the source of a document.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/" - }, - "operationId": "GetSource", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true, - "examples": { - "GetSource_example1": { - "summary": "Examples for Get document source Operation.", - "description": "", - "value": "1" - } - } - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true, - "examples": { - "GetSource_example1": { - "summary": "Examples for Get document source Operation.", - "description": "", - "value": "books" - } - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specify whether to perform the operation in realtime or search mode.", - "schema": { - "type": "boolean", - "description": "Specify whether to perform the operation in realtime or search mode." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "GetSource 200 response" - } - }, - "x-operation-group": "get_source", - "x-version-added": "1.0" - }, - "head": { - "description": "Returns information about whether a document source exists in an index.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/" - }, - "operationId": "ExistsSource", - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specify whether to perform the operation in realtime or search mode.", - "schema": { - "type": "boolean", - "description": "Specify whether to perform the operation in realtime or search mode." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Refresh the shard containing the document before performing the operation.", - "schema": { - "type": "boolean", - "description": "Refresh the shard containing the document before performing the operation." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "ExistsSource 200 response" - } - }, - "x-operation-group": "exists_source", - "x-version-added": "1.0" - } - }, - "/{index}/_split/{target}": { - "post": { - "description": "Allows you to split an existing index into a new index with more primary shards.", - "operationId": "IndicesSplit_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesSplit_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The name of the source index to split.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the source index to split." - }, - "required": true - }, - { - "name": "target", - "in": "path", - "description": "The name of the target index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the target index." - }, - "required": true - }, - { - "name": "copy_settings", - "in": "query", - "description": "whether or not to copy settings from the source index.", - "schema": { - "type": "boolean", - "default": false, - "description": "whether or not to copy settings from the source index." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for on the shrunken index before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for on the shrunken index before the operation returns." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "task_execution_timeout", - "in": "query", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesSplit_Post 200 response" - } - }, - "x-operation-group": "indices.split", - "x-version-added": "1.0" - }, - "put": { - "description": "Allows you to split an existing index into a new index with more primary shards.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/index-apis/split/" - }, - "operationId": "IndicesSplit_Put", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesSplit_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The name of the source index to split.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the source index to split." - }, - "required": true - }, - { - "name": "target", - "in": "path", - "description": "The name of the target index.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The name of the target index." - }, - "required": true - }, - { - "name": "copy_settings", - "in": "query", - "description": "whether or not to copy settings from the source index.", - "schema": { - "type": "boolean", - "default": false, - "description": "whether or not to copy settings from the source index." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "master_timeout", - "in": "query", - "description": "Operation timeout for connection to master node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to master node.", - "x-version-deprecated": "2.0.0", - "x-data-type": "time", - "x-deprecation-message": "To promote inclusive language, use 'cluster_manager_timeout' instead.", - "deprecated": true - } - }, - { - "name": "cluster_manager_timeout", - "in": "query", - "description": "Operation timeout for connection to cluster-manager node.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout for connection to cluster-manager node.", - "x-version-added": "2.0.0", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Set the number of active shards to wait for on the shrunken index before the operation returns.", - "schema": { - "type": "string", - "description": "Set the number of active shards to wait for on the shrunken index before the operation returns." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "task_execution_timeout", - "in": "query", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h.", - "x-data-type": "time" - } - } - ], - "responses": { - "200": { - "description": "IndicesSplit_Put 200 response" - } - }, - "x-operation-group": "indices.split", - "x-version-added": "1.0" - } - }, - "/{index}/_stats": { - "get": { - "description": "Provides statistics on operations happening in an index.", - "operationId": "IndicesStats_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return stats aggregated at cluster, index or shard level.", - "schema": { - "$ref": "#/components/schemas/IndiciesStatLevel" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - }, - { - "name": "include_unloaded_segments", - "in": "query", - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory.", - "schema": { - "type": "boolean", - "default": false, - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "forbid_closed_indices", - "in": "query", - "description": "If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices.", - "schema": { - "type": "boolean", - "default": true, - "description": "If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesStats_WithIndex 200 response" - } - }, - "x-operation-group": "indices.stats", - "x-version-added": "1.0" - } - }, - "/{index}/_stats/{metric}": { - "get": { - "description": "Provides statistics on operations happening in an index.", - "operationId": "IndicesStats_WithIndexMetric", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "metric", - "in": "path", - "description": "Limit the information returned the specific metrics.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Limit the information returned the specific metrics.", - "x-enum-options": [ - "_all", - "store", - "indexing", - "get", - "search", - "merge", - "flush", - "refresh", - "query_cache", - "fielddata", - "docs", - "warmer", - "completion", - "segments", - "translog", - "suggest", - "request_cache", - "recovery" - ], - "x-data-type": "array" - }, - "required": true - }, - { - "name": "completion_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fielddata_fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards).", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards)." - }, - "explode": true - }, - { - "name": "groups", - "in": "query", - "description": "Comma-separated list of search groups for `search` index metric.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of search groups for `search` index metric." - }, - "explode": true - }, - { - "name": "level", - "in": "query", - "description": "Return stats aggregated at cluster, index or shard level.", - "schema": { - "$ref": "#/components/schemas/IndiciesStatLevel" - } - }, - { - "name": "include_segment_file_sizes", - "in": "query", - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested).", - "schema": { - "type": "boolean", - "default": false, - "description": "Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested)." - } - }, - { - "name": "include_unloaded_segments", - "in": "query", - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory.", - "schema": { - "type": "boolean", - "default": false, - "description": "If set to true segment stats will include stats for segments that are not currently loaded into memory." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "forbid_closed_indices", - "in": "query", - "description": "If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices.", - "schema": { - "type": "boolean", - "default": true, - "description": "If set to false stats will also collected from closed indices if explicitly specified or if expand_wildcards expands to closed indices." - } - } - ], - "responses": { - "200": { - "description": "IndicesStats_WithIndexMetric 200 response" - } - }, - "x-operation-group": "indices.stats", - "x-version-added": "1.0" - } - }, - "/{index}/_termvectors": { - "get": { - "description": "Returns information and statistics about terms in the fields of a particular document.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest" - }, - "operationId": "Termvectors_Get", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The index in which the document resides.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The index in which the document resides." - }, - "required": true - }, - { - "name": "term_statistics", - "in": "query", - "description": "Specifies if total term frequency and document frequency should be returned.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specifies if total term frequency and document frequency should be returned." - } - }, - { - "name": "field_statistics", - "in": "query", - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return." - }, - "explode": true - }, - { - "name": "offsets", - "in": "query", - "description": "Specifies if term offsets should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term offsets should be returned." - } - }, - { - "name": "positions", - "in": "query", - "description": "Specifies if term positions should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term positions should be returned." - } - }, - { - "name": "payloads", - "in": "query", - "description": "Specifies if term payloads should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term payloads should be returned." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specifies if request is real-time as opposed to near-real-time.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if request is real-time as opposed to near-real-time." - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Termvectors_Get 200 response" - } - }, - "x-operation-group": "termvectors", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns information and statistics about terms in the fields of a particular document.", - "operationId": "Termvectors_Post", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Termvectors_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The index in which the document resides.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The index in which the document resides." - }, - "required": true - }, - { - "name": "term_statistics", - "in": "query", - "description": "Specifies if total term frequency and document frequency should be returned.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specifies if total term frequency and document frequency should be returned." - } - }, - { - "name": "field_statistics", - "in": "query", - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return." - }, - "explode": true - }, - { - "name": "offsets", - "in": "query", - "description": "Specifies if term offsets should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term offsets should be returned." - } - }, - { - "name": "positions", - "in": "query", - "description": "Specifies if term positions should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term positions should be returned." - } - }, - { - "name": "payloads", - "in": "query", - "description": "Specifies if term payloads should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term payloads should be returned." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specifies if request is real-time as opposed to near-real-time.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if request is real-time as opposed to near-real-time." - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Termvectors_Post 200 response" - } - }, - "x-operation-group": "termvectors", - "x-version-added": "1.0" - } - }, - "/{index}/_termvectors/{id}": { - "get": { - "description": "Returns information and statistics about terms in the fields of a particular document.", - "operationId": "Termvectors_Get_WithId", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The index in which the document resides.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The index in which the document resides." - }, - "required": true - }, - { - "name": "id", - "in": "path", - "description": "Document ID. When not specified a doc param should be supplied.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID. When not specified a doc param should be supplied." - }, - "required": true - }, - { - "name": "term_statistics", - "in": "query", - "description": "Specifies if total term frequency and document frequency should be returned.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specifies if total term frequency and document frequency should be returned." - } - }, - { - "name": "field_statistics", - "in": "query", - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return." - }, - "explode": true - }, - { - "name": "offsets", - "in": "query", - "description": "Specifies if term offsets should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term offsets should be returned." - } - }, - { - "name": "positions", - "in": "query", - "description": "Specifies if term positions should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term positions should be returned." - } - }, - { - "name": "payloads", - "in": "query", - "description": "Specifies if term payloads should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term payloads should be returned." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specifies if request is real-time as opposed to near-real-time.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if request is real-time as opposed to near-real-time." - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Termvectors_Get_WithId 200 response" - } - }, - "x-operation-group": "termvectors", - "x-version-added": "1.0" - }, - "post": { - "description": "Returns information and statistics about terms in the fields of a particular document.", - "operationId": "Termvectors_Post_WithId", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Termvectors_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "The index in which the document resides.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "The index in which the document resides." - }, - "required": true - }, - { - "name": "id", - "in": "path", - "description": "Document ID. When not specified a doc param should be supplied.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID. When not specified a doc param should be supplied." - }, - "required": true - }, - { - "name": "term_statistics", - "in": "query", - "description": "Specifies if total term frequency and document frequency should be returned.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specifies if total term frequency and document frequency should be returned." - } - }, - { - "name": "field_statistics", - "in": "query", - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if document count, sum of document frequencies and sum of total term frequencies should be returned." - } - }, - { - "name": "fields", - "in": "query", - "description": "Comma-separated list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of fields to return." - }, - "explode": true - }, - { - "name": "offsets", - "in": "query", - "description": "Specifies if term offsets should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term offsets should be returned." - } - }, - { - "name": "positions", - "in": "query", - "description": "Specifies if term positions should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term positions should be returned." - } - }, - { - "name": "payloads", - "in": "query", - "description": "Specifies if term payloads should be returned.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if term payloads should be returned." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "realtime", - "in": "query", - "description": "Specifies if request is real-time as opposed to near-real-time.", - "schema": { - "type": "boolean", - "default": true, - "description": "Specifies if request is real-time as opposed to near-real-time." - } - }, - { - "name": "version", - "in": "query", - "description": "Explicit version number for concurrency control.", - "schema": { - "type": "integer", - "description": "Explicit version number for concurrency control.", - "format": "int32" - } - }, - { - "name": "version_type", - "in": "query", - "description": "Specific version type.", - "schema": { - "$ref": "#/components/schemas/VersionType" - } - } - ], - "responses": { - "200": { - "description": "Termvectors_Post_WithId 200 response" - } - }, - "x-operation-group": "termvectors", - "x-version-added": "1.0" - } - }, - "/{index}/_update/{id}": { - "post": { - "description": "Updates a document with a script or partial document.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/update-document/" - }, - "operationId": "Update", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/Update_BodyParams" - } - } - }, - "required": true - }, - "parameters": [ - { - "name": "id", - "in": "path", - "description": "Document ID.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Document ID." - }, - "required": true - }, - { - "name": "index", - "in": "path", - "description": "Index name.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Index name." - }, - "required": true - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "lang", - "in": "query", - "description": "The script language.", - "schema": { - "type": "string", - "default": "painless", - "description": "The script language." - } - }, - { - "name": "refresh", - "in": "query", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "schema": { - "$ref": "#/components/schemas/RefreshEnum" - } - }, - { - "name": "retry_on_conflict", - "in": "query", - "description": "Specify how many times should the operation be retried when a conflict occurs.", - "schema": { - "type": "integer", - "default": 0, - "description": "Specify how many times should the operation be retried when a conflict occurs.", - "format": "int32" - } - }, - { - "name": "routing", - "in": "query", - "description": "Routing value.", - "schema": { - "type": "string", - "description": "Routing value." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Operation timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Operation timeout.", - "x-data-type": "time" - } - }, - { - "name": "if_seq_no", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified sequence number.", - "format": "int32" - } - }, - { - "name": "if_primary_term", - "in": "query", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "schema": { - "type": "integer", - "description": "only perform the operation if the last operation that has changed the document has the specified primary term.", - "format": "int32" - } - }, - { - "name": "require_alias", - "in": "query", - "description": "When true, requires destination to be an alias.", - "schema": { - "type": "boolean", - "default": false, - "description": "When true, requires destination to be an alias." - } - } - ], - "responses": { - "200": { - "description": "Update 200 response" - } - }, - "x-operation-group": "update", - "x-version-added": "1.0" - } - }, - "/{index}/_update_by_query": { - "post": { - "description": "Performs an update on every document in the index without changing the source,\nfor example to pick up a mapping change.", - "externalDocs": { - "description": "API Reference", - "url": "https://opensearch.org/docs/latest/api-reference/document-apis/update-by-query/" - }, - "operationId": "UpdateByQuery", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/UpdateByQuery_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "from", - "in": "query", - "description": "Starting offset.", - "schema": { - "type": "integer", - "default": 0, - "description": "Starting offset.", - "format": "int32" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "conflicts", - "in": "query", - "description": "What to do when the operation encounters version conflicts?.", - "schema": { - "$ref": "#/components/schemas/Conflicts" - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "pipeline", - "in": "query", - "description": "The pipeline id to preprocess incoming documents with.", - "schema": { - "type": "string", - "description": "The pipeline id to preprocess incoming documents with." - } - }, - { - "name": "preference", - "in": "query", - "description": "Specify the node or shard the operation should be performed on.", - "schema": { - "type": "string", - "default": "random", - "description": "Specify the node or shard the operation should be performed on." - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "routing", - "in": "query", - "description": "Comma-separated list of specific routing values.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of specific routing values." - }, - "explode": true - }, - { - "name": "scroll", - "in": "query", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Specify how long a consistent view of the index should be maintained for scrolled search.", - "x-data-type": "time" - } - }, - { - "name": "search_type", - "in": "query", - "description": "Search operation type.", - "schema": { - "$ref": "#/components/schemas/SearchType" - } - }, - { - "name": "search_timeout", - "in": "query", - "description": "Explicit timeout for each search request. Defaults to no timeout.", - "schema": { - "type": "string", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Explicit timeout for each search request. Defaults to no timeout.", - "x-data-type": "time" - } - }, - { - "name": "size", - "in": "query", - "description": "Deprecated, please use `max_docs` instead.", - "schema": { - "type": "integer", - "description": "Deprecated, please use `max_docs` instead.", - "format": "int32" - } - }, - { - "name": "max_docs", - "in": "query", - "description": "Maximum number of documents to process (default: all documents).", - "schema": { - "type": "integer", - "description": "Maximum number of documents to process (default: all documents).", - "format": "int32" - } - }, - { - "name": "sort", - "in": "query", - "description": "Comma-separated list of : pairs.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Comma-separated list of : pairs." - }, - "explode": true - }, - { - "name": "_source", - "in": "query", - "description": "True or false to return the _source field or not, or a list of fields to return.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "True or false to return the _source field or not, or a list of fields to return." - }, - "explode": true - }, - { - "name": "_source_excludes", - "in": "query", - "description": "List of fields to exclude from the returned _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to exclude from the returned _source field." - }, - "explode": true - }, - { - "name": "_source_includes", - "in": "query", - "description": "List of fields to extract and return from the _source field.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "List of fields to extract and return from the _source field." - }, - "explode": true - }, - { - "name": "terminate_after", - "in": "query", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "schema": { - "type": "integer", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", - "format": "int32" - } - }, - { - "name": "stats", - "in": "query", - "description": "Specific 'tag' of the request for logging and statistical purposes.", - "style": "form", - "schema": { - "type": "array", - "items": { - "type": "string" - }, - "description": "Specific 'tag' of the request for logging and statistical purposes." - }, - "explode": true - }, - { - "name": "version", - "in": "query", - "description": "Whether to return document version as part of a hit.", - "schema": { - "type": "boolean", - "description": "Whether to return document version as part of a hit." - } - }, - { - "name": "request_cache", - "in": "query", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting.", - "schema": { - "type": "boolean", - "description": "Specify if request cache should be used for this request or not, defaults to index level setting." - } - }, - { - "name": "refresh", - "in": "query", - "description": "Should the affected indexes be refreshed?.", - "schema": { - "type": "boolean", - "description": "Should the affected indexes be refreshed?." - } - }, - { - "name": "timeout", - "in": "query", - "description": "Time each individual bulk request should wait for shards that are unavailable.", - "schema": { - "type": "string", - "default": "1m", - "pattern": "^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$", - "description": "Time each individual bulk request should wait for shards that are unavailable.", - "x-data-type": "time" - } - }, - { - "name": "wait_for_active_shards", - "in": "query", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1).", - "schema": { - "type": "string", - "default": "1", - "description": "Sets the number of shard copies that must be active before proceeding with the operation. Defaults to 1, meaning the primary shard only. Set to `all` for all shard copies, otherwise set to any non-negative value less than or equal to the total number of copies for the shard (number of replicas + 1)." - } - }, - { - "name": "scroll_size", - "in": "query", - "description": "Size on the scroll request powering the operation.", - "schema": { - "type": "integer", - "default": 100, - "description": "Size on the scroll request powering the operation.", - "format": "int32" - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": true, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "requests_per_second", - "in": "query", - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "schema": { - "type": "integer", - "default": 0, - "description": "The throttle for this request in sub-requests per second. -1 means no throttle.", - "format": "int32" - } - }, - { - "name": "slices", - "in": "query", - "description": "The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to `auto`.", - "schema": { - "type": "string", - "default": "1", - "description": "The number of slices this task should be divided into. Defaults to 1, meaning the task isn't sliced into subtasks. Can be set to `auto`." - } - } - ], - "responses": { - "200": { - "description": "UpdateByQuery 200 response" - } - }, - "x-operation-group": "update_by_query", - "x-version-added": "1.0" - } - }, - "/{index}/_upgrade": { - "get": { - "description": "The _upgrade API is no longer useful and will be removed.", - "operationId": "IndicesGetUpgrade_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - } - ], - "responses": { - "200": { - "description": "IndicesGetUpgrade_WithIndex 200 response" - } - }, - "x-operation-group": "indices.get_upgrade", - "x-version-added": "1.0" - }, - "post": { - "description": "The _upgrade API is no longer useful and will be removed.", - "operationId": "IndicesUpgrade_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "wait_for_completion", - "in": "query", - "description": "Should this request wait until the operation has completed before returning.", - "schema": { - "type": "boolean", - "default": false, - "description": "Should this request wait until the operation has completed before returning." - } - }, - { - "name": "only_ancient_segments", - "in": "query", - "description": "If true, only ancient (an older Lucene major release) segments will be upgraded.", - "schema": { - "type": "boolean", - "description": "If true, only ancient (an older Lucene major release) segments will be upgraded." - } - } - ], - "responses": { - "200": { - "description": "IndicesUpgrade_WithIndex 200 response" - } - }, - "x-operation-group": "indices.upgrade", - "x-version-added": "1.0" - } - }, - "/{index}/_validate/query": { - "get": { - "description": "Allows a user to validate a potentially expensive query without executing it.", - "operationId": "IndicesValidateQuery_Get_WithIndex", - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "explain", - "in": "query", - "description": "Return detailed information about the error.", - "schema": { - "type": "boolean", - "description": "Return detailed information about the error." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "rewrite", - "in": "query", - "description": "Provide a more detailed explanation showing the actual Lucene query that will be executed.", - "schema": { - "type": "boolean", - "description": "Provide a more detailed explanation showing the actual Lucene query that will be executed." - } - }, - { - "name": "all_shards", - "in": "query", - "description": "Execute validation on all shards instead of one random shard per index.", - "schema": { - "type": "boolean", - "description": "Execute validation on all shards instead of one random shard per index." - } - } - ], - "responses": { - "200": { - "description": "IndicesValidateQuery_Get_WithIndex 200 response" - } - }, - "x-operation-group": "indices.validate_query", - "x-version-added": "1.0" - }, - "post": { - "description": "Allows a user to validate a potentially expensive query without executing it.", - "operationId": "IndicesValidateQuery_Post_WithIndex", - "requestBody": { - "content": { - "application/json": { - "schema": { - "$ref": "#/components/schemas/IndicesValidateQuery_BodyParams" - } - } - } - }, - "parameters": [ - { - "name": "index", - "in": "path", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "schema": { - "type": "string", - "pattern": "^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$", - "description": "Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices.", - "x-data-type": "array" - }, - "required": true - }, - { - "name": "explain", - "in": "query", - "description": "Return detailed information about the error.", - "schema": { - "type": "boolean", - "description": "Return detailed information about the error." - } - }, - { - "name": "ignore_unavailable", - "in": "query", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed).", - "schema": { - "type": "boolean", - "description": "Whether specified concrete indices should be ignored when unavailable (missing or closed)." - } - }, - { - "name": "allow_no_indices", - "in": "query", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified).", - "schema": { - "type": "boolean", - "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified)." - } - }, - { - "name": "expand_wildcards", - "in": "query", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "schema": { - "$ref": "#/components/schemas/ExpandWildcards" - } - }, - { - "name": "q", - "in": "query", - "description": "Query in the Lucene query string syntax.", - "schema": { - "type": "string", - "description": "Query in the Lucene query string syntax." - } - }, - { - "name": "analyzer", - "in": "query", - "description": "The analyzer to use for the query string.", - "schema": { - "type": "string", - "description": "The analyzer to use for the query string." - } - }, - { - "name": "analyze_wildcard", - "in": "query", - "description": "Specify whether wildcard and prefix queries should be analyzed.", - "schema": { - "type": "boolean", - "default": false, - "description": "Specify whether wildcard and prefix queries should be analyzed." - } - }, - { - "name": "default_operator", - "in": "query", - "description": "The default operator for query string query (AND or OR).", - "schema": { - "$ref": "#/components/schemas/DefaultOperator" - } - }, - { - "name": "df", - "in": "query", - "description": "The field to use as default where no field prefix is given in the query string.", - "schema": { - "type": "string", - "description": "The field to use as default where no field prefix is given in the query string." - } - }, - { - "name": "lenient", - "in": "query", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored.", - "schema": { - "type": "boolean", - "description": "Specify whether format-based query failures (such as providing text to a numeric field) should be ignored." - } - }, - { - "name": "rewrite", - "in": "query", - "description": "Provide a more detailed explanation showing the actual Lucene query that will be executed.", - "schema": { - "type": "boolean", - "description": "Provide a more detailed explanation showing the actual Lucene query that will be executed." - } - }, - { - "name": "all_shards", - "in": "query", - "description": "Execute validation on all shards instead of one random shard per index.", - "schema": { - "type": "boolean", - "description": "Execute validation on all shards instead of one random shard per index." - } - } - ], - "responses": { - "200": { - "description": "IndicesValidateQuery_Post_WithIndex 200 response" - } - }, - "x-operation-group": "indices.validate_query", - "x-version-added": "1.0" - } - } - }, - "components": { - "schemas": { - "AccountDetails": { - "type": "object", - "properties": { - "user_name": { - "type": "string" - }, - "is_reserved": { - "type": "boolean" - }, - "is_hidden": { - "type": "boolean" - }, - "is_internal_user": { - "type": "boolean" - }, - "user_requested_tenant": { - "type": "string" - }, - "backend_roles": { - "type": "array", - "items": { - "type": "string" - } - }, - "custom_attribute_names": { - "type": "array", - "items": { - "type": "string" - } - }, - "tenants": { - "$ref": "#/components/schemas/UserTenants" - }, - "roles": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "ActionGroupsMap": { - "type": "object", - "additionalProperties": { - "$ref": "#/components/schemas/Action_Group" - } - }, - "ActionObjectStructure": { - "type": "object", - "properties": { - "add": { - "$ref": "#/components/schemas/UserDefinedStructure" - }, - "remove": { - "$ref": "#/components/schemas/UserDefinedStructure" - }, - "remove_index": { - "$ref": "#/components/schemas/UserDefinedStructure" - } - } - }, - "Action_Group": { - "type": "object", - "properties": { - "reserved": { - "type": "boolean" - }, - "hidden": { - "type": "boolean" - }, - "allowed_actions": { - "type": "array", - "items": { - "type": "string" - } - }, - "type": { - "type": "string" - }, - "description": { - "type": "string" - }, - "static": { - "type": "boolean" - } - } - }, - "AuditConfig": { - "type": "object", - "properties": { - "compliance": { - "$ref": "#/components/schemas/ComplianceConfig" - }, - "enabled": { - "type": "boolean" - }, - "audit": { - "$ref": "#/components/schemas/AuditLogsConfig" - } - } - }, - "AuditConfigWithReadOnly": { - "type": "object", - "properties": { - "_readonly": { - "type": "array", - "items": { - "type": "string" - } - }, - "config": { - "$ref": "#/components/schemas/AuditConfig" - } - } - }, - "AuditLogsConfig": { - "type": "object", - "properties": { - "ignore_users": { - "type": "array", - "items": { - "type": "string" - } - }, - "ignore_requests": { - "type": "array", - "items": { - "type": "string" - } - }, - "disabled_rest_categories": { - "type": "array", - "items": { - "type": "string" - } - }, - "disabled_transport_categories": { - "type": "array", - "items": { - "type": "string" - } - }, - "log_request_body": { - "type": "boolean" - }, - "resolve_indices": { - "type": "boolean" - }, - "resolve_bulk_requests": { - "type": "boolean" - }, - "exclude_sensitive_headers": { - "type": "boolean" - }, - "enable_transport": { - "type": "boolean" - }, - "enable_rest": { - "type": "boolean" - } - } - }, - "Bulk_BodyParams": { - "type": "object", - "description": "The operation definition and data (action-data pairs), separated by newlines", - "x-serialize": "bulk" - }, - "Bytes": { - "type": "string", - "description": "The unit in which to display byte values.", - "enum": [ - "b", - "k", - "kb", - "m", - "mb", - "g", - "gb", - "t", - "tb", - "p", - "pb" - ] - }, - "CatAllPitSegmentsOutputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CatPitSegmentsRecord" - } - }, - "CatPitSegmentsOutputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CatPitSegmentsRecord" - } - }, - "CatPitSegmentsRecord": { - "type": "object", - "properties": { - "index": { - "type": "string" - }, - "shard": { - "type": "string" - }, - "prirep": { - "type": "string" - }, - "ip": { - "type": "string" - }, - "segment": { - "type": "string" - }, - "generation": { - "type": "string" - }, - "docs.count": { - "type": "string" - }, - "docs.deleted": { - "type": "string" - }, - "size": { - "type": "string" - }, - "size.memory": { - "type": "string" - }, - "committed": { - "type": "string" - }, - "searchable": { - "type": "string" - }, - "version": { - "type": "string" - }, - "compound": { - "type": "string" - } - } - }, - "CatPitSegments_BodyParams": { - "type": "object", - "properties": { - "pit_id": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "required": [ - "pit_id" - ] - }, - "CatSegmentReplicationOutputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CatSegmentReplicationRecord" - } - }, - "CatSegmentReplicationRecord": { - "type": "object", - "properties": { - "shardId": { - "type": "string" - }, - "target_node": { - "type": "string" - }, - "target_host": { - "type": "string" - }, - "checkpoints_behind": { - "type": "string" - }, - "bytes_behind": { - "type": "string" - }, - "current_lag": { - "type": "string" - }, - "last_completed_lag": { - "type": "string" - }, - "rejected_requests": { - "type": "string" - }, - "stage": { - "type": "string" - }, - "time": { - "type": "string" - }, - "files_fetched": { - "type": "string" - }, - "files_percent": { - "type": "string" - }, - "bytes_fetched": { - "type": "string" - }, - "bytes_percent": { - "type": "string" - }, - "start_time": { - "type": "string" - }, - "stop_time": { - "type": "string" - }, - "files": { - "type": "string" - }, - "files_total": { - "type": "string" - }, - "bytes": { - "type": "string" - }, - "bytes_total": { - "type": "string" - }, - "replicating_stage_time_taken": { - "type": "string" - }, - "get_checkpoint_info_stage_time_taken": { - "type": "string" - }, - "file_diff_stage_time_taken": { - "type": "string" - }, - "get_files_stage_time_taken": { - "type": "string" - }, - "finalize_replication_stage_time_taken": { - "type": "string" - } - } - }, - "CatSegmentReplication_WithIndexOutputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CatSegmentReplicationRecord" - } - }, - "CertificatesDetail": { - "type": "object", - "properties": { - "issuer_dn": { - "type": "string" - }, - "subject_dn": { - "type": "string" - }, - "san": { - "type": "string" - }, - "not_before": { - "type": "string" - }, - "not_after": { - "type": "string" - } - } - }, - "ChangePasswordRequestContent": { - "type": "object", - "properties": { - "current_password": { - "type": "string", - "description": "The current password" - }, - "password": { - "type": "string", - "description": "The new password to set" - } - }, - "required": [ - "current_password", - "password" - ] - }, - "ChangePasswordResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "ClearScroll_BodyParams": { - "type": "object", - "description": "Comma-separated list of scroll IDs to clear if none was specified via the scroll_id parameter" - }, - "ClusterAllocationExplain_BodyParams": { - "type": "object", - "description": "The index, shard, and primary flag to explain. Empty means 'explain the first unassigned shard'" - }, - "ClusterGetSettingsResponseContent": { - "type": "object", - "properties": { - "persistent": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "transient": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "defaults": { - "$ref": "#/components/schemas/UserDefinedValueMap" - } - } - }, - "ClusterHealthLevel": { - "type": "string", - "description": "Specify the level of detail for returned information.", - "enum": [ - "cluster", - "indices", - "shards", - "awareness_attributes" - ] - }, - "ClusterPutComponentTemplate_BodyParams": { - "type": "object", - "description": "The template definition" - }, - "ClusterPutSettingsResponseContent": { - "type": "object", - "properties": { - "acknowledged": { - "type": "boolean" - }, - "persistent": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "transient": { - "$ref": "#/components/schemas/UserDefinedValueMap" - } - } - }, - "ClusterPutSettings_BodyParams": { - "type": "object", - "description": "The settings to be updated. Can be either `transient` or `persistent` (survives cluster restart).", - "properties": { - "persistent": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "transient": { - "$ref": "#/components/schemas/UserDefinedValueMap" - } - } - }, - "ClusterRerouteMetric_Member": { - "type": "string", - "enum": [ - "_all", - "blocks", - "metadata", - "nodes", - "routing_table", - "master_node", - "cluster_manager_node", - "version" - ] - }, - "ClusterReroute_BodyParams": { - "type": "object", - "description": "The definition of `commands` to perform (`move`, `cancel`, `allocate`)" - }, - "ComplianceConfig": { - "type": "object", - "properties": { - "enabled": { - "type": "boolean" - }, - "write_log_diffs": { - "type": "boolean" - }, - "read_watched_fields": {}, - "read_ignore_users": { - "type": "array", - "items": { - "type": "string" - } - }, - "write_watched_indices": { - "type": "array", - "items": { - "type": "string" - } - }, - "write_ignore_users": { - "type": "array", - "items": { - "type": "string" - } - }, - "read_metadata_only": { - "type": "boolean" - }, - "write_metadata_only": { - "type": "boolean" - }, - "external_config": { - "type": "boolean" - }, - "internal_config": { - "type": "boolean" - } - } - }, - "Conflicts": { - "type": "string", - "description": "What to do when the operation encounters version conflicts?.", - "enum": [ - "abort", - "proceed" - ] - }, - "Count_BodyParams": { - "type": "object", - "description": "Query to restrict the results specified with the Query DSL (optional)" - }, - "CreateActionGroupResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "CreatePitResponseContent": { - "type": "object", - "properties": { - "pit_id": { - "type": "string" - }, - "_shards": { - "$ref": "#/components/schemas/ShardStatistics" - }, - "creation_time": { - "type": "integer", - "format": "int64" - } - } - }, - "CreateRoleMappingResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "CreateRoleResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "CreateTenantParams": { - "type": "object", - "properties": { - "description": { - "type": "string" - } - } - }, - "CreateTenantResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "CreateUserResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "Create_BodyParams": { - "type": "object", - "description": "The document" - }, - "DataStream": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "timestamp_field": { - "$ref": "#/components/schemas/DataStreamTimestampField" - }, - "indices": { - "type": "array", - "items": { - "$ref": "#/components/schemas/DataStreamIndex" - } - }, - "generation": { - "type": "integer", - "format": "int64" - }, - "status": { - "$ref": "#/components/schemas/DataStreamStatus" - }, - "template": { - "type": "string" - } - } - }, - "DataStreamIndex": { - "type": "object", - "properties": { - "index_name": { - "type": "string" - }, - "index_uuid": { - "type": "string" - } - } - }, - "DataStreamStatus": { - "type": "string", - "enum": [ - "green", - "yellow", - "red" - ] - }, - "DataStreamTimestampField": { - "type": "object", - "properties": { - "name": { - "type": "string" - } - } - }, - "DefaultOperator": { - "type": "string", - "description": "The default operator for query string query (AND or OR).", - "enum": [ - "AND", - "OR" - ] - }, - "DeleteActionGroupResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "DeleteAllPitsResponseContent": { - "type": "object", - "properties": { - "pits": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PitsDetailsDeleteAll" - } - } - } - }, - "DeleteByQuery_BodyParams": { - "type": "object", - "description": "The search definition using the Query DSL" - }, - "DeleteDistinguishedNamesResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "DeletePitResponseContent": { - "type": "object", - "properties": { - "pits": { - "type": "array", - "items": { - "$ref": "#/components/schemas/DeletedPit" - } - } - } - }, - "DeletePit_BodyParams": { - "type": "object", - "description": "The point-in-time ids to be deleted", - "properties": { - "pit_id": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "required": [ - "pit_id" - ] - }, - "DeleteRoleMappingResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "DeleteRoleResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "DeleteTenantResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "DeleteUserResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "DeletedPit": { - "type": "object", - "properties": { - "successful": { - "type": "boolean" - }, - "pit_id": { - "type": "string" - } - } - }, - "DistinguishedNames": { - "type": "object", - "properties": { - "nodes_dn": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "DistinguishedNamesMap": { - "type": "object", - "additionalProperties": { - "$ref": "#/components/schemas/DistinguishedNames" - } - }, - "DynamicConfig": { - "type": "object", - "properties": { - "dynamic": { - "$ref": "#/components/schemas/DynamicOptions" - } - } - }, - "DynamicOptions": { - "type": "object", - "properties": { - "filteredAliasMode": { - "type": "string" - }, - "disableRestAuth": { - "type": "boolean" - }, - "disableIntertransportAuth": { - "type": "boolean" - }, - "respectRequestIndicesOptions": { - "type": "boolean" - }, - "kibana": {}, - "http": {}, - "authc": {}, - "authz": {}, - "authFailureListeners": {}, - "doNotFailOnForbidden": { - "type": "boolean" - }, - "multiRolespanEnabled": { - "type": "boolean" - }, - "hostsResolverMode": { - "type": "string" - }, - "doNotFailOnForbiddenEmpty": { - "type": "boolean" - } - } - }, - "ExpandWildcards": { - "type": "string", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", - "enum": [ - "all", - "open", - "closed", - "hidden", - "none" - ] - }, - "Explain_BodyParams": { - "type": "object", - "description": "The query definition using the Query DSL" - }, - "FieldCaps_BodyParams": { - "type": "object", - "description": "An index filter specified with the Query DSL" - }, - "FlushCacheResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "GetAllPitsResponseContent": { - "type": "object", - "properties": { - "pits": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PitDetail" - } - } - } - }, - "GetCertificatesResponseContent": { - "type": "object", - "properties": { - "http_certificates_list": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CertificatesDetail" - } - }, - "transport_certificates_list": { - "type": "array", - "items": { - "$ref": "#/components/schemas/CertificatesDetail" - } - } - } - }, - "GetResponseContent": { - "type": "object", - "properties": { - "_index": { - "type": "string" - }, - "_type": { - "type": "string" - }, - "_id": { - "type": "string" - }, - "version": { - "type": "integer", - "format": "int32" - }, - "seq_no": { - "type": "integer", - "format": "int64" - }, - "primary_term": { - "type": "integer", - "format": "int64" - }, - "found": { - "type": "boolean" - }, - "_routing": { - "type": "string" - }, - "_source": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "_fields": { - "$ref": "#/components/schemas/UserDefinedValueMap" - } - }, - "required": [ - "_id", - "_index", - "found" - ] - }, - "GroupBy": { - "type": "string", - "description": "Group tasks by nodes or parent/child relationships.", - "enum": [ - "nodes", - "parents", - "none" - ] - }, - "Health": { - "type": "string", - "description": "Health status ('green', 'yellow', or 'red') to filter only indices matching the specified health status.", - "enum": [ - "green", - "yellow", - "red" - ] - }, - "Hits": { - "type": "object", - "properties": { - "_index": { - "type": "string" - }, - "_type": { - "type": "string" - }, - "_id": { - "type": "string" - }, - "_score": { - "type": "number", - "format": "float" - }, - "_source": {}, - "fields": {} - } - }, - "HitsMetadata": { - "type": "object", - "properties": { - "total": { - "$ref": "#/components/schemas/Total" - }, - "max_score": { - "type": "number", - "format": "double" - }, - "hits": { - "type": "array", - "items": { - "$ref": "#/components/schemas/Hits" - } - } - } - }, - "IndexPermission": { - "type": "object", - "properties": { - "index_patterns": { - "type": "array", - "items": { - "type": "string" - } - }, - "dls": { - "type": "string" - }, - "fls": { - "type": "array", - "items": { - "type": "string" - } - }, - "masked_fields": { - "type": "array", - "items": { - "type": "string" - } - }, - "allowed_actions": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "Index_BodyParams": { - "type": "object", - "description": "The document" - }, - "IndicesAnalyze_BodyParams": { - "type": "object", - "description": "Define analyzer/tokenizer parameters and the text on which the analysis should be performed" - }, - "IndicesClone_BodyParams": { - "type": "object", - "description": "The configuration for the target index (`settings` and `aliases`)" - }, - "IndicesCreateDataStreamResponseContent": { - "type": "object", - "properties": { - "acknowledged": { - "type": "boolean" - } - } - }, - "IndicesCreateDataStream_BodyParams": { - "type": "object", - "description": "The data stream definition" - }, - "IndicesCreateResponseContent": { - "type": "object", - "properties": { - "index": { - "type": "string" - }, - "shards_acknowledged": { - "type": "boolean" - }, - "acknowledged": { - "type": "boolean" - } - }, - "required": [ - "acknowledged", - "index", - "shards_acknowledged" - ] - }, - "IndicesCreate_BodyParams": { - "type": "object", - "description": "The configuration for the index (`settings` and `mappings`)", - "properties": { - "aliases": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "mapping": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "settings": { - "$ref": "#/components/schemas/UserDefinedValueMap" - } - } - }, - "IndicesDeleteDataStreamResponseContent": { - "type": "object", - "properties": { - "acknowledged": { - "type": "boolean" - } - } - }, - "IndicesDeleteResponseContent": { - "type": "object", - "properties": { - "acknowledged": { - "type": "boolean" - } - } - }, - "IndicesGetDataStreamResponseContent": { - "type": "object", - "properties": { - "data_streams": { - "type": "array", - "items": { - "$ref": "#/components/schemas/DataStream" - } - } - } - }, - "IndicesGetDataStream_WithNameResponseContent": { - "type": "object", - "properties": { - "data_streams": { - "type": "array", - "items": { - "$ref": "#/components/schemas/DataStream" - } - } - } - }, - "IndicesPutAlias_BodyParams": { - "type": "object", - "description": "The settings for the alias, such as `routing` or `filter`" - }, - "IndicesPutIndexTemplate_BodyParams": { - "type": "object", - "description": "The template definition" - }, - "IndicesPutMapping_BodyParams": { - "type": "object", - "description": "The mapping definition" - }, - "IndicesPutMapping_PostResponseContent": { - "type": "object", - "properties": { - "acknowledged": { - "type": "boolean" - } - } - }, - "IndicesPutMapping_PutResponseContent": { - "type": "object", - "properties": { - "acknowledged": { - "type": "boolean" - } - } - }, - "IndicesPutSettings_BodyParams": { - "type": "object", - "description": "The index settings to be updated" - }, - "IndicesPutTemplate_BodyParams": { - "type": "object", - "description": "The template definition" - }, - "IndicesRollover_BodyParams": { - "type": "object", - "description": "The conditions that needs to be met for executing rollover" - }, - "IndicesShrink_BodyParams": { - "type": "object", - "description": "The configuration for the target index (`settings` and `aliases`)" - }, - "IndicesSimulateIndexTemplate_BodyParams": { - "type": "object", - "description": "New index template definition, which will be included in the simulation, as if it already exists in the system" - }, - "IndicesSimulateTemplate_BodyParams": { - "type": "object", - "description": "New index template definition to be simulated, if no index template name is specified" - }, - "IndicesSplit_BodyParams": { - "type": "object", - "description": "The configuration for the target index (`settings` and `aliases`)" - }, - "IndicesUpdateAliasesResponseContent": { - "type": "object", - "properties": { - "acknowledged": { - "type": "boolean" - } - }, - "required": [ - "acknowledged" - ] - }, - "IndicesUpdateAliases_BodyParams": { - "type": "object", - "description": "The definition of `actions` to perform", - "properties": { - "actions": { - "$ref": "#/components/schemas/ActionObjectStructure" - } - } - }, - "IndicesValidateQuery_BodyParams": { - "type": "object", - "description": "The query definition specified with the Query DSL" - }, - "IndiciesStatLevel": { - "type": "string", - "description": "Return stats aggregated at cluster, index or shard level.", - "enum": [ - "cluster", - "indices", - "shards" - ] - }, - "InfoResponseContent": { - "type": "object", - "properties": { - "name": { - "type": "string" - }, - "cluster_name": { - "type": "string" - }, - "cluster_uuid": { - "type": "string" - }, - "version": { - "$ref": "#/components/schemas/InfoVersion" - }, - "tagline": { - "type": "string" - } - } - }, - "InfoVersion": { - "type": "object", - "properties": { - "distribution": { - "type": "string" - }, - "number": { - "type": "string" - }, - "build_type": { - "type": "string" - }, - "build_hash": { - "type": "string" - }, - "build_date": { - "type": "string" - }, - "build_snapshot": { - "type": "boolean" - }, - "lucene_version": { - "type": "string" - }, - "minimum_wire_compatibility_version": { - "type": "string" - }, - "minimum_index_compatibility_version": { - "type": "string" - } - } - }, - "IngestPutPipeline_BodyParams": { - "type": "object", - "description": "The ingest definition" - }, - "IngestSimulate_BodyParams": { - "type": "object", - "description": "The simulate definition" - }, - "Mget_BodyParams": { - "type": "object", - "description": "Document identifiers; can be either `docs` (containing full document information) or `ids` (when index is provided in the URL." - }, - "MsearchTemplate_BodyParams": { - "type": "object", - "description": "The request definitions (metadata-search request definition pairs), separated by newlines", - "x-serialize": "bulk" - }, - "Msearch_BodyParams": { - "type": "object", - "description": "The request definitions (metadata-search request definition pairs), separated by newlines", - "x-serialize": "bulk" - }, - "Mtermvectors_BodyParams": { - "type": "object", - "description": "Define ids, documents, parameters or a list of parameters per document here. You must at least provide a list of document ids. See documentation." - }, - "NodesReloadSecureSettings_BodyParams": { - "type": "object", - "description": "An object containing the password for the opensearch keystore" - }, - "NodesStatLevel": { - "type": "string", - "description": "Return indices stats aggregated at index, node or shard level.", - "enum": [ - "indices", - "node", - "shards" - ] - }, - "OpType": { - "type": "string", - "description": "Explicit operation type. Defaults to `index` for requests with an explicit document ID, and to `create` for requests without an explicit document ID.", - "enum": [ - "index", - "create" - ] - }, - "PatchActionGroupInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchActionGroupResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchActionGroupsInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchActionGroupsResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchAuditConfigurationInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchConfigurationInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchConfigurationResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchDistinguishedNamesInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchDistinguishedNamesResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchOperation": { - "type": "object", - "properties": { - "op": { - "type": "string", - "description": "The operation to perform. Possible values: remove,add, replace, move, copy, test." - }, - "path": { - "type": "string", - "description": "The path to the resource." - }, - "value": { - "description": "The new values used for the update." - } - }, - "required": [ - "op", - "path" - ] - }, - "PatchRoleInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchRoleMappingInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchRoleMappingResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchRoleMappingsInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchRoleMappingsResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchRoleResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchRolesInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchRolesResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchTenantInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchTenantResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchTenantsInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchTenantsResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchUserInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchUserResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PatchUsersInputPayload": { - "type": "array", - "items": { - "$ref": "#/components/schemas/PatchOperation" - } - }, - "PatchUsersResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "PitDetail": { - "type": "object", - "properties": { - "pit_id": { - "type": "string" - }, - "creation_time": { - "type": "integer", - "format": "int64" - }, - "keep_alive": { - "type": "integer", - "format": "int64" - } - } - }, - "PitsDetailsDeleteAll": { - "type": "object", - "properties": { - "successful": { - "type": "boolean" - }, - "pit_id": { - "type": "string" - } - } - }, - "PutScript_BodyParams": { - "type": "object", - "description": "The document" - }, - "RankEval_BodyParams": { - "type": "object", - "description": "The ranking evaluation search definition, including search requests, document ratings and ranking metric definition." - }, - "RefreshEnum": { - "type": "string", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` (the default) then do nothing with refreshes.", - "enum": [ - "true", - "false", - "wait_for" - ] - }, - "Reindex_BodyParams": { - "type": "object", - "description": "The search definition using the Query DSL and the prototype for the index request." - }, - "Relation": { - "type": "string", - "enum": [ - "eq", - "gte" - ] - }, - "ReloadHttpCertificatesResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "ReloadTransportCertificatesResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "RemoteStoreRestoreInfo": { - "type": "object", - "properties": { - "snapshot": { - "type": "string" - }, - "indices": { - "type": "array", - "items": { - "type": "string" - } - }, - "shards": { - "$ref": "#/components/schemas/RemoteStoreRestoreShardsInfo" - } - } - }, - "RemoteStoreRestoreResponseContent": { - "type": "object", - "properties": { - "accepted": { - "type": "boolean" - }, - "remote_store": { - "$ref": "#/components/schemas/RemoteStoreRestoreInfo" - } - } - }, - "RemoteStoreRestoreShardsInfo": { - "type": "object", - "properties": { - "total": { - "type": "integer", - "format": "int32" - }, - "failed": { - "type": "integer", - "format": "int32" - }, - "successful": { - "type": "integer", - "format": "int32" - } - } - }, - "RemoteStoreRestore_BodyParams": { - "type": "object", - "description": "Comma-separated list of index IDs", - "properties": { - "indices": { - "type": "array", - "items": { - "type": "string" - } - } - }, - "required": [ - "indices" - ] - }, - "RenderSearchTemplate_BodyParams": { - "type": "object", - "description": "The search definition template and its params" - }, - "Role": { - "type": "object", - "properties": { - "reserved": { - "type": "boolean" - }, - "hidden": { - "type": "boolean" - }, - "description": { - "type": "string" - }, - "cluster_permissions": { - "type": "array", - "items": { - "type": "string" - } - }, - "index_permissions": { - "type": "array", - "items": { - "$ref": "#/components/schemas/IndexPermission" - } - }, - "tenant_permissions": { - "type": "array", - "items": { - "$ref": "#/components/schemas/TenantPermission" - } - }, - "static": { - "type": "boolean" - } - } - }, - "RoleMapping": { - "type": "object", - "properties": { - "hosts": { - "type": "array", - "items": { - "type": "string" - } - }, - "users": { - "type": "array", - "items": { - "type": "string" - } - }, - "reserved": { - "type": "boolean" - }, - "hidden": { - "type": "boolean" - }, - "backend_roles": { - "type": "array", - "items": { - "type": "string" - } - }, - "and_backend_roles": { - "type": "array", - "items": { - "type": "string" - } - }, - "description": { - "type": "string" - } - } - }, - "RoleMappings": { - "type": "object", - "additionalProperties": { - "$ref": "#/components/schemas/RoleMapping" - } - }, - "RolesMap": { - "type": "object", - "additionalProperties": { - "$ref": "#/components/schemas/Role" - } - }, - "SampleType": { - "type": "string", - "description": "The type to sample.", - "enum": [ - "cpu", - "wait", - "block" - ] - }, - "ScriptsPainlessExecute_BodyParams": { - "type": "object", - "description": "The script to execute" - }, - "Scroll_BodyParams": { - "type": "object", - "description": "The scroll ID if not passed by URL or query parameter." - }, - "SearchTemplate_BodyParams": { - "type": "object", - "description": "The search definition template and its params" - }, - "SearchType": { - "type": "string", - "description": "Search operation type.", - "enum": [ - "query_then_fetch", - "dfs_query_then_fetch" - ] - }, - "SearchTypeMulti": { - "type": "string", - "description": "Search operation type.", - "enum": [ - "query_then_fetch", - "query_and_fetch", - "dfs_query_then_fetch", - "dfs_query_and_fetch" - ] - }, - "Search_BodyParams": { - "type": "object", - "description": "The search definition using the Query DSL", - "properties": { - "docvalue_fields": { - "type": "string" - }, - "explain": { - "type": "boolean" - }, - "from": { - "type": "integer", - "format": "int32" - }, - "seq_no_primary_term": { - "type": "boolean" - }, - "size": { - "type": "integer", - "format": "int32" - }, - "source": { - "type": "string" - }, - "stats": { - "type": "string" - }, - "terminate_after": { - "type": "integer", - "format": "int32" - }, - "timeout": { - "$ref": "#/components/schemas/Time" - }, - "version": { - "type": "boolean" - }, - "fields": { - "type": "array", - "items": { - "type": "string" - } - }, - "min_score": { - "type": "integer", - "format": "int32" - }, - "indices_boost": { - "type": "array", - "items": {} - }, - "query": { - "$ref": "#/components/schemas/UserDefinedObjectStructure" - } - } - }, - "Search_GetResponseContent": { - "type": "object", - "properties": { - "_scroll_id": { - "type": "string" - }, - "took": { - "type": "integer", - "format": "int64" - }, - "timed_out": { - "type": "boolean" - }, - "_shards": { - "$ref": "#/components/schemas/ShardStatistics" - }, - "hits": { - "$ref": "#/components/schemas/HitsMetadata" - } - } - }, - "Search_Get_WithIndexResponseContent": { - "type": "object", - "properties": { - "_scroll_id": { - "type": "string" - }, - "took": { - "type": "integer", - "format": "int64" - }, - "timed_out": { - "type": "boolean" - }, - "_shards": { - "$ref": "#/components/schemas/ShardStatistics" - }, - "hits": { - "$ref": "#/components/schemas/HitsMetadata" - } - } - }, - "Search_PostResponseContent": { - "type": "object", - "properties": { - "_scroll_id": { - "type": "string" - }, - "took": { - "type": "integer", - "format": "int64" - }, - "timed_out": { - "type": "boolean" - }, - "_shards": { - "$ref": "#/components/schemas/ShardStatistics" - }, - "hits": { - "$ref": "#/components/schemas/HitsMetadata" - } - } - }, - "Search_Post_WithIndexResponseContent": { - "type": "object", - "properties": { - "_scroll_id": { - "type": "string" - }, - "took": { - "type": "integer", - "format": "int64" - }, - "timed_out": { - "type": "boolean" - }, - "_shards": { - "$ref": "#/components/schemas/ShardStatistics" - }, - "hits": { - "$ref": "#/components/schemas/HitsMetadata" - } - } - }, - "SecurityHealthResponseContent": { - "type": "object", - "properties": { - "message": { - "type": "string" - }, - "mode": { - "type": "string" - }, - "status": { - "type": "string" - } - } - }, - "ShardStatistics": { - "type": "object", - "properties": { - "total": { - "type": "integer", - "format": "int32" - }, - "successful": { - "type": "integer", - "format": "int32" - }, - "skipped": { - "type": "integer", - "format": "int32" - }, - "failed": { - "type": "integer", - "format": "int32" - } - } - }, - "SnapshotClone_BodyParams": { - "type": "object", - "description": "The snapshot clone definition" - }, - "SnapshotCreateRepository_BodyParams": { - "type": "object", - "description": "The repository definition" - }, - "SnapshotCreate_BodyParams": { - "type": "object", - "description": "The snapshot definition" - }, - "SnapshotRestore_BodyParams": { - "type": "object", - "description": "Details of what to restore" - }, - "Status_Member": { - "type": "string", - "enum": [ - "green", - "yellow", - "red", - "all" - ] - }, - "SuggestMode": { - "type": "string", - "description": "Specify suggest mode.", - "enum": [ - "missing", - "popular", - "always" - ] - }, - "Tenant": { - "type": "object", - "properties": { - "reserved": { - "type": "boolean" - }, - "hidden": { - "type": "boolean" - }, - "description": { - "type": "string" - }, - "static": { - "type": "boolean" - } - } - }, - "TenantPermission": { - "type": "object", - "properties": { - "tenant_patterns": { - "type": "array", - "items": { - "type": "string" - } - }, - "allowed_actions": { - "type": "array", - "items": { - "type": "string" - } - } - } - }, - "TenantsMap": { - "type": "object", - "additionalProperties": { - "$ref": "#/components/schemas/Tenant" - } - }, - "Termvectors_BodyParams": { - "type": "object", - "description": "Define parameters and or supply a document to get termvectors for. See documentation." - }, - "Time": { - "type": "string", - "description": "The unit in which to display time values.", - "enum": [ - "d", - "h", - "m", - "s", - "ms", - "micros", - "nanos" - ] - }, - "Total": { - "type": "object", - "properties": { - "value": { - "type": "integer", - "format": "int32" - }, - "relation": { - "$ref": "#/components/schemas/Relation" - } - } - }, - "UpdateAuditConfigurationResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "UpdateByQuery_BodyParams": { - "type": "object", - "description": "The search definition using the Query DSL" - }, - "UpdateConfigurationResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "UpdateDistinguishedNamesResponseContent": { - "type": "object", - "properties": { - "status": { - "type": "string", - "description": "Security Operation Status" - }, - "message": { - "type": "string", - "description": "Security Operation Message" - } - } - }, - "Update_BodyParams": { - "type": "object", - "description": "The request definition requires either `script` or partial `doc`" - }, - "User": { - "type": "object", - "properties": { - "hash": { - "type": "string" - }, - "reserved": { - "type": "boolean" - }, - "hidden": { - "type": "boolean" - }, - "backend_roles": { - "type": "array", - "items": { - "type": "string" - } - }, - "attributes": { - "$ref": "#/components/schemas/UserAttributes" - }, - "description": { - "type": "string" - }, - "opendistro_security_roles": { - "type": "array", - "items": { - "type": "string" - } - }, - "static": { - "type": "boolean" - } - } - }, - "UserAttributes": { - "type": "object", - "additionalProperties": { - "type": "string" - } - }, - "UserDefinedObjectStructure": { - "type": "object", - "properties": { - "bool": {}, - "boosting": {}, - "combined_fields": {}, - "constant_score": {}, - "dis_max": {}, - "distance_feature": {}, - "exists": {}, - "function_score": {}, - "fuzzy": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "geo_bounding_box": {}, - "geo_distance": {}, - "geo_polygon": {}, - "geo_shape": {}, - "has_child": {}, - "has_parent": {}, - "ids": {}, - "intervals": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "knn": {}, - "match": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "match_all": {}, - "match_bool_prefix": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "match_none": {}, - "match_phrase": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "match_phrase_prefix": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "more_like_this": {}, - "multi_match": {}, - "nested": {}, - "parent_id": {}, - "percolate": {}, - "pinned": {}, - "prefix": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "query_string": {}, - "range": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "rank_feature": {}, - "regexp": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "script": {}, - "script_score": {}, - "shape": {}, - "simple_query_string": {}, - "span_containing": {}, - "field_masking_span": {}, - "span_first": {}, - "span_multi": {}, - "span_near": {}, - "span_not": {}, - "span_or": {}, - "span_term": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "span_within": {}, - "term": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "terms": {}, - "terms_set": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "wildcard": { - "$ref": "#/components/schemas/UserDefinedValueMap" - }, - "wrapper": {} - } - }, - "UserDefinedStructure": { - "type": "object", - "properties": { - "alias": { - "type": "string" - }, - "aliases": { - "type": "array", - "items": { - "type": "string" - } - }, - "filter": {}, - "index": { - "type": "string" - }, - "indices": { - "type": "array", - "items": { - "type": "string" - } - }, - "index_routing": { - "type": "string" - }, - "is_hidden": { - "type": "boolean" - }, - "is_write_index": { - "type": "boolean" - }, - "must_exist": { - "type": "string" - }, - "routing": { - "type": "string" - }, - "search_routing": { - "type": "string" - } - } - }, - "UserDefinedValueMap": { - "type": "object", - "additionalProperties": {} - }, - "UserTenants": { - "type": "object", - "properties": { - "global_tenant": { - "type": "boolean" - }, - "admin_tenant": { - "type": "boolean" - }, - "admin": { - "type": "boolean" - } - } - }, - "UsersMap": { - "type": "object", - "additionalProperties": { - "$ref": "#/components/schemas/User" - } - }, - "VersionType": { - "type": "string", - "description": "Specific version type.", - "enum": [ - "internal", - "external", - "external_gte", - "force" - ] - }, - "WaitForEvents": { - "type": "string", - "description": "Wait until all currently queued events with the given priority are processed.", - "enum": [ - "immediate", - "urgent", - "high", - "normal", - "low", - "languid" - ] - }, - "WaitForStatus": { - "type": "string", - "description": "Wait until cluster is in a specific state.", - "enum": [ - "green", - "yellow", - "red" - ] - } - }, - "securitySchemes": { - "smithy.api.httpBasicAuth": { - "type": "http", - "description": "HTTP Basic authentication", - "scheme": "Basic" - } - } - }, - "security": [ - { - "smithy.api.httpBasicAuth": [] - } - ] -} diff --git a/src/ApiGenerator/RestSpecDownloader.cs b/src/ApiGenerator/RestSpecDownloader.cs index 5eb276ef7a..772daf8c13 100644 --- a/src/ApiGenerator/RestSpecDownloader.cs +++ b/src/ApiGenerator/RestSpecDownloader.cs @@ -41,7 +41,7 @@ public static class RestSpecDownloader public static async Task DownloadAsync(string branch, CancellationToken token) { - var githubUrl = $"https://raw.githubusercontent.com/opensearch-project/opensearch-api-specification/{branch}/OpenSearch.openapi.json"; + var githubUrl = $"https://github.com/opensearch-project/opensearch-api-specification/releases/download/{branch}/opensearch-openapi.yaml"; Console.WriteLine($"Downloading OpenAPI spec for branch {branch}"); var spec = await Http.GetStringAsync(githubUrl, token); await File.WriteAllTextAsync(GeneratorLocations.OpenApiSpecFile, spec, token); diff --git a/src/ApiGenerator/Views/LowLevel/Enums.cshtml b/src/ApiGenerator/Views/LowLevel/Enums.cshtml index 65bc11fe9f..5671849983 100644 --- a/src/ApiGenerator/Views/LowLevel/Enums.cshtml +++ b/src/ApiGenerator/Views/LowLevel/Enums.cshtml @@ -1,45 +1,16 @@ @using System.Linq -@using System.Text @using ApiGenerator.Domain @using ApiGenerator -@using ApiGenerator.Configuration.Overrides @inherits CodeTemplatePage @{ await IncludeLegacyGeneratorNotice(); } @functions { - private const string RawSize = "Raw"; - private const string SizeEnum = "Size"; + private static bool IsFlag(EnumDescription e) => + e.IsFlag || e.Name.EndsWith("Metric") || e.Name.EndsWith("Feature"); - private string CreateEnum(string enumName, string value, int? i) - { - var enumValue = (enumName == SizeEnum && value == string.Empty) ? RawSize : value.ToPascalCase(true); - var enumCsharp = string.Format("[EnumMember(Value = \"{0}\")] {1}{2}", value, enumValue, i.HasValue ? " = 1 << " + i.Value : null); - if (GlobalOverrides.Instance.ObsoleteEnumMembers.TryGetValue(enumName, out var d) && d.TryGetValue(value, out var obsolete)) - { - return string.Format("[Obsolete(\"{0}\")]{2}\t\t{1}", obsolete, enumCsharp, Environment.NewLine); - } - return enumCsharp; - } - private string CreateCase(string e, string o) - { - var enumValue = GetEnumValue(e, o); - var isObsolete = GlobalOverrides.Instance.ObsoleteEnumMembers.TryGetValue(e, out var d) && d.TryGetValue(o, out _); - var sb = new StringBuilder(); - if (isObsolete) sb.AppendLine("#pragma warning disable 618"); - sb.Append(string.Format("case {0}.{1}: return \"{2}\";", e, enumValue, o)); - if (isObsolete) sb.AppendLine(Environment.NewLine + "#pragma warning disable 618"); - return sb.ToString(); - } - private bool IsFlag(string name) - { - return name.EndsWith("Metric") || name.EndsWith("Feature"); - } - - private string GetEnumValue(string enumName, string value) - { - return enumName == SizeEnum && value == string.Empty - ? RawSize - : value.ToPascalCase(true); - } + private static string GetEnumValue(string enumName, string value) => + enumName == "Size" && value == string.Empty + ? "Raw" + : value.ToPascalCase(true); } // ReSharper disable RedundantUsingDirective using System; @@ -54,11 +25,17 @@ namespace OpenSearch.Net { @foreach (var e in Model.EnumsInTheSpec) { - var isFlag = IsFlag(e.Name); + var isFlag = IsFlag(e); - @(isFlag ? "[Flags, StringEnum]" : "[StringEnum]")public enum @e.Name - { - @Raw(string.Join(","+ Environment.NewLine + "\t\t", e.Options.OrderBy(s => s == "_all" ? 1 : 0).Select((s, i) => CreateEnum(e.Name, s, isFlag ? (int?)i : null)))) + @(isFlag ? "[Flags, StringEnum]" : "[StringEnum]") + public enum @e.Name + { + @foreach (var (o, i) in e.Options.OrderBy(o => o == "_all" ? 1 : 0).Select((o, i) => (o, i))) + { + @(i > 0 ? "," : null) + [EnumMember(Value = "@(o)")] + @(GetEnumValue(e.Name, o))@(isFlag ? Raw($" = 1 << {i}") : null) + } } } @@ -68,55 +45,48 @@ namespace OpenSearch.Net { @foreach (var e in Model.EnumsInTheSpec) { - EnumStringResolvers.TryAdd(typeof(@(e.Name)), e => GetStringValue((@(e.Name))e)); + AddEnumStringResolver<@(e.Name)>(GetStringValue); } } @foreach (var e in Model.EnumsInTheSpec) { - var isFlag = IsFlag(e.Name); - - public static string GetStringValue(this @(e.Name) enumValue) - { - - if (isFlag) - { - var allOption = e.Options.FirstOrDefault(o => o == "_all"); - if (allOption != null) - { - if ((enumValue & @(e.Name).All) != 0) return "_all"; - - } - var list = new @(Raw("List()")); - - var g = GlobalOverrides.Instance.ObsoleteEnumMembers.TryGetValue(e.Name, out var d); - foreach (var option in e.Options.Where(o => o != "_all")) - { - var value = GetEnumValue(e.Name, option); - if (g && d.TryGetValue(option, out var _)) { -#pragma warning disable 618 - if ((enumValue & @(e.Name).@(value)) != 0) list.Add("@(option)"); -#pragma warning restore 618 - - } - else { - if ((enumValue & @(e.Name).@(value)) != 0) list.Add("@(option)"); - - } - } - return string.Join(",", list); - } - } + if (IsFlag(e)) + { + + public static string GetStringValue(this @(e.Name) enumValue) + { + + if (e.Options.Any(o => o == "_all")) + { + if ((enumValue & @(e.Name).All) != 0) return "_all"; + + } + var list = new @(Raw("List()")); + + foreach (var o in e.Options.Where(o => o != "_all")) + { + if ((enumValue & @(e.Name).@(GetEnumValue(e.Name, o))) != 0) list.Add("@(o)"); + + } + return string.Join(",", list); + } + } else { - switch (enumValue) - { - @Raw(string.Join(Environment.NewLine + "\t\t\t\t", e.Options.Select(o => CreateCase(e.Name, o)))) - } - throw new ArgumentException($"'{enumValue.ToString()}' is not a valid value for enum '@(e.Name)'"); - } + + public static string GetStringValue(this @(e.Name) enumValue) => + enumValue switch { + @foreach (var o in e.Options) + { + @(e.Name).@(GetEnumValue(e.Name, o)) => "@(o)", + + } + _ => throw new ArgumentException($"'{enumValue.ToString()}' is not a valid value for enum '@(e.Name)'") + }; + } - } + } } } diff --git a/src/ApiGenerator/opensearch-openapi.yaml b/src/ApiGenerator/opensearch-openapi.yaml new file mode 100644 index 0000000000..d0613dffca --- /dev/null +++ b/src/ApiGenerator/opensearch-openapi.yaml @@ -0,0 +1,41514 @@ +openapi: 3.1.0 +info: + title: OpenSearch API + description: OpenSearch API + version: 1.0.0 +paths: + /: + get: + operationId: info.0 + x-operation-group: info + x-version-added: '1.0' + description: Returns basic information about the cluster. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: [] + responses: + '200': + $ref: '#/components/responses/info@200' + head: + operationId: ping.0 + x-operation-group: ping + x-version-added: '1.0' + description: Returns whether the cluster is running. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: [] + responses: + '200': + $ref: '#/components/responses/ping@200' + /_alias: + get: + operationId: indices.get_alias.0 + x-operation-group: indices.get_alias + x-version-added: '1.0' + description: Returns an alias. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-alias/ + parameters: + - $ref: '#/components/parameters/indices.get_alias::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_alias::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_alias::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_alias::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_alias@200' + /_alias/{name}: + get: + operationId: indices.get_alias.1 + x-operation-group: indices.get_alias + x-version-added: '1.0' + description: Returns an alias. + parameters: + - $ref: '#/components/parameters/indices.get_alias::path.name' + - $ref: '#/components/parameters/indices.get_alias::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_alias::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_alias::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_alias::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_alias@200' + head: + operationId: indices.exists_alias.0 + x-operation-group: indices.exists_alias + x-version-added: '1.0' + description: Returns information about whether a particular alias exists. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.exists_alias::path.name' + - $ref: '#/components/parameters/indices.exists_alias::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.exists_alias::query.allow_no_indices' + - $ref: '#/components/parameters/indices.exists_alias::query.expand_wildcards' + - $ref: '#/components/parameters/indices.exists_alias::query.local' + responses: + '200': + $ref: '#/components/responses/indices.exists_alias@200' + /_aliases: + post: + operationId: indices.update_aliases.0 + x-operation-group: indices.update_aliases + x-version-added: '1.0' + description: Updates index aliases. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/alias/ + parameters: + - $ref: '#/components/parameters/indices.update_aliases::query.timeout' + - $ref: '#/components/parameters/indices.update_aliases::query.master_timeout' + - $ref: '#/components/parameters/indices.update_aliases::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.update_aliases' + responses: + '200': + $ref: '#/components/responses/indices.update_aliases@200' + /_analyze: + get: + operationId: indices.analyze.0 + x-operation-group: indices.analyze + x-version-added: '1.0' + description: Performs the analysis process on a text and return the tokens breakdown of the text. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/analyze-apis/perform-text-analysis/ + parameters: + - $ref: '#/components/parameters/indices.analyze::query.index' + requestBody: + $ref: '#/components/requestBodies/indices.analyze' + responses: + '200': + $ref: '#/components/responses/indices.analyze@200' + post: + operationId: indices.analyze.1 + x-operation-group: indices.analyze + x-version-added: '1.0' + description: Performs the analysis process on a text and return the tokens breakdown of the text. + parameters: + - $ref: '#/components/parameters/indices.analyze::query.index' + requestBody: + $ref: '#/components/requestBodies/indices.analyze' + responses: + '200': + $ref: '#/components/responses/indices.analyze@200' + /_bulk: + post: + operationId: bulk.0 + x-operation-group: bulk + x-version-added: '1.0' + description: Allows to perform multiple index/update/delete operations in a single request. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/bulk/ + parameters: + - $ref: '#/components/parameters/bulk::query.wait_for_active_shards' + - $ref: '#/components/parameters/bulk::query.refresh' + - $ref: '#/components/parameters/bulk::query.routing' + - $ref: '#/components/parameters/bulk::query.timeout' + - $ref: '#/components/parameters/bulk::query.type' + - $ref: '#/components/parameters/bulk::query._source' + - $ref: '#/components/parameters/bulk::query._source_excludes' + - $ref: '#/components/parameters/bulk::query._source_includes' + - $ref: '#/components/parameters/bulk::query.pipeline' + - $ref: '#/components/parameters/bulk::query.require_alias' + requestBody: + $ref: '#/components/requestBodies/bulk' + responses: + '200': + $ref: '#/components/responses/bulk@200' + put: + operationId: bulk.1 + x-operation-group: bulk + x-version-added: '1.0' + description: Allows to perform multiple index/update/delete operations in a single request. + parameters: + - $ref: '#/components/parameters/bulk::query.wait_for_active_shards' + - $ref: '#/components/parameters/bulk::query.refresh' + - $ref: '#/components/parameters/bulk::query.routing' + - $ref: '#/components/parameters/bulk::query.timeout' + - $ref: '#/components/parameters/bulk::query.type' + - $ref: '#/components/parameters/bulk::query._source' + - $ref: '#/components/parameters/bulk::query._source_excludes' + - $ref: '#/components/parameters/bulk::query._source_includes' + - $ref: '#/components/parameters/bulk::query.pipeline' + - $ref: '#/components/parameters/bulk::query.require_alias' + requestBody: + $ref: '#/components/requestBodies/bulk' + responses: + '200': + $ref: '#/components/responses/bulk@200' + /_cache/clear: + post: + operationId: indices.clear_cache.0 + x-operation-group: indices.clear_cache + x-version-added: '1.0' + description: Clears all or specific caches for one or more indices. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/clear-index-cache/ + parameters: + - $ref: '#/components/parameters/indices.clear_cache::query.fielddata' + - $ref: '#/components/parameters/indices.clear_cache::query.fields' + - $ref: '#/components/parameters/indices.clear_cache::query.query' + - $ref: '#/components/parameters/indices.clear_cache::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.clear_cache::query.allow_no_indices' + - $ref: '#/components/parameters/indices.clear_cache::query.expand_wildcards' + - $ref: '#/components/parameters/indices.clear_cache::query.index' + - $ref: '#/components/parameters/indices.clear_cache::query.request' + responses: + '200': + $ref: '#/components/responses/indices.clear_cache@200' + /_cat: + get: + operationId: cat.help.0 + x-operation-group: cat.help + x-version-added: '1.0' + description: Returns help for the Cat APIs. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/index/ + parameters: + - $ref: '#/components/parameters/cat.help::query.help' + - $ref: '#/components/parameters/cat.help::query.s' + responses: + '200': + $ref: '#/components/responses/cat.help@200' + /_cat/aliases: + get: + operationId: cat.aliases.0 + x-operation-group: cat.aliases + x-version-added: '1.0' + description: Shows information about currently configured aliases to indices including filter and routing infos. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-aliases/ + parameters: + - $ref: '#/components/parameters/cat.aliases::query.format' + - $ref: '#/components/parameters/cat.aliases::query.local' + - $ref: '#/components/parameters/cat.aliases::query.h' + - $ref: '#/components/parameters/cat.aliases::query.help' + - $ref: '#/components/parameters/cat.aliases::query.s' + - $ref: '#/components/parameters/cat.aliases::query.v' + - $ref: '#/components/parameters/cat.aliases::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/cat.aliases@200' + /_cat/aliases/{name}: + get: + operationId: cat.aliases.1 + x-operation-group: cat.aliases + x-version-added: '1.0' + description: Shows information about currently configured aliases to indices including filter and routing infos. + parameters: + - $ref: '#/components/parameters/cat.aliases::path.name' + - $ref: '#/components/parameters/cat.aliases::query.format' + - $ref: '#/components/parameters/cat.aliases::query.local' + - $ref: '#/components/parameters/cat.aliases::query.h' + - $ref: '#/components/parameters/cat.aliases::query.help' + - $ref: '#/components/parameters/cat.aliases::query.s' + - $ref: '#/components/parameters/cat.aliases::query.v' + - $ref: '#/components/parameters/cat.aliases::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/cat.aliases@200' + /_cat/allocation: + get: + operationId: cat.allocation.0 + x-operation-group: cat.allocation + x-version-added: '1.0' + description: Provides a snapshot of how many shards are allocated to each data node and how much disk space they are using. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-allocation/ + parameters: + - $ref: '#/components/parameters/cat.allocation::query.format' + - $ref: '#/components/parameters/cat.allocation::query.bytes' + - $ref: '#/components/parameters/cat.allocation::query.local' + - $ref: '#/components/parameters/cat.allocation::query.master_timeout' + - $ref: '#/components/parameters/cat.allocation::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.allocation::query.h' + - $ref: '#/components/parameters/cat.allocation::query.help' + - $ref: '#/components/parameters/cat.allocation::query.s' + - $ref: '#/components/parameters/cat.allocation::query.v' + responses: + '200': + $ref: '#/components/responses/cat.allocation@200' + /_cat/allocation/{node_id}: + get: + operationId: cat.allocation.1 + x-operation-group: cat.allocation + x-version-added: '1.0' + description: Provides a snapshot of how many shards are allocated to each data node and how much disk space they are using. + parameters: + - $ref: '#/components/parameters/cat.allocation::path.node_id' + - $ref: '#/components/parameters/cat.allocation::query.format' + - $ref: '#/components/parameters/cat.allocation::query.bytes' + - $ref: '#/components/parameters/cat.allocation::query.local' + - $ref: '#/components/parameters/cat.allocation::query.master_timeout' + - $ref: '#/components/parameters/cat.allocation::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.allocation::query.h' + - $ref: '#/components/parameters/cat.allocation::query.help' + - $ref: '#/components/parameters/cat.allocation::query.s' + - $ref: '#/components/parameters/cat.allocation::query.v' + responses: + '200': + $ref: '#/components/responses/cat.allocation@200' + /_cat/cluster_manager: + get: + operationId: cat.cluster_manager.0 + x-operation-group: cat.cluster_manager + x-version-added: '2.0' + description: Returns information about the cluster-manager node. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-cluster_manager/ + parameters: + - $ref: '#/components/parameters/cat.cluster_manager::query.format' + - $ref: '#/components/parameters/cat.cluster_manager::query.local' + - $ref: '#/components/parameters/cat.cluster_manager::query.master_timeout' + - $ref: '#/components/parameters/cat.cluster_manager::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.cluster_manager::query.h' + - $ref: '#/components/parameters/cat.cluster_manager::query.help' + - $ref: '#/components/parameters/cat.cluster_manager::query.s' + - $ref: '#/components/parameters/cat.cluster_manager::query.v' + responses: + '200': + $ref: '#/components/responses/cat.cluster_manager@200' + /_cat/count: + get: + operationId: cat.count.0 + x-operation-group: cat.count + x-version-added: '1.0' + description: Provides quick access to the document count of the entire cluster, or individual indices. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-count/ + parameters: + - $ref: '#/components/parameters/cat.count::query.format' + - $ref: '#/components/parameters/cat.count::query.h' + - $ref: '#/components/parameters/cat.count::query.help' + - $ref: '#/components/parameters/cat.count::query.s' + - $ref: '#/components/parameters/cat.count::query.v' + responses: + '200': + $ref: '#/components/responses/cat.count@200' + /_cat/count/{index}: + get: + operationId: cat.count.1 + x-operation-group: cat.count + x-version-added: '1.0' + description: Provides quick access to the document count of the entire cluster, or individual indices. + parameters: + - $ref: '#/components/parameters/cat.count::path.index' + - $ref: '#/components/parameters/cat.count::query.format' + - $ref: '#/components/parameters/cat.count::query.h' + - $ref: '#/components/parameters/cat.count::query.help' + - $ref: '#/components/parameters/cat.count::query.s' + - $ref: '#/components/parameters/cat.count::query.v' + responses: + '200': + $ref: '#/components/responses/cat.count@200' + /_cat/fielddata: + get: + operationId: cat.fielddata.0 + x-operation-group: cat.fielddata + x-version-added: '1.0' + description: Shows how much heap memory is currently being used by fielddata on every data node in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-field-data/ + parameters: + - $ref: '#/components/parameters/cat.fielddata::query.format' + - $ref: '#/components/parameters/cat.fielddata::query.bytes' + - $ref: '#/components/parameters/cat.fielddata::query.h' + - $ref: '#/components/parameters/cat.fielddata::query.help' + - $ref: '#/components/parameters/cat.fielddata::query.s' + - $ref: '#/components/parameters/cat.fielddata::query.v' + - $ref: '#/components/parameters/cat.fielddata::query.fields' + responses: + '200': + $ref: '#/components/responses/cat.fielddata@200' + /_cat/fielddata/{fields}: + get: + operationId: cat.fielddata.1 + x-operation-group: cat.fielddata + x-version-added: '1.0' + description: Shows how much heap memory is currently being used by fielddata on every data node in the cluster. + parameters: + - $ref: '#/components/parameters/cat.fielddata::path.fields' + - $ref: '#/components/parameters/cat.fielddata::query.format' + - $ref: '#/components/parameters/cat.fielddata::query.bytes' + - $ref: '#/components/parameters/cat.fielddata::query.h' + - $ref: '#/components/parameters/cat.fielddata::query.help' + - $ref: '#/components/parameters/cat.fielddata::query.s' + - $ref: '#/components/parameters/cat.fielddata::query.v' + - $ref: '#/components/parameters/cat.fielddata::query.fields' + responses: + '200': + $ref: '#/components/responses/cat.fielddata@200' + /_cat/health: + get: + operationId: cat.health.0 + x-operation-group: cat.health + x-version-added: '1.0' + description: Returns a concise representation of the cluster health. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-health/ + parameters: + - $ref: '#/components/parameters/cat.health::query.format' + - $ref: '#/components/parameters/cat.health::query.h' + - $ref: '#/components/parameters/cat.health::query.help' + - $ref: '#/components/parameters/cat.health::query.s' + - $ref: '#/components/parameters/cat.health::query.time' + - $ref: '#/components/parameters/cat.health::query.ts' + - $ref: '#/components/parameters/cat.health::query.v' + responses: + '200': + $ref: '#/components/responses/cat.health@200' + /_cat/indices: + get: + operationId: cat.indices.0 + x-operation-group: cat.indices + x-version-added: '1.0' + description: 'Returns information about indices: number of primaries and replicas, document counts, disk size, ...' + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-indices/ + parameters: + - $ref: '#/components/parameters/cat.indices::query.format' + - $ref: '#/components/parameters/cat.indices::query.bytes' + - $ref: '#/components/parameters/cat.indices::query.local' + - $ref: '#/components/parameters/cat.indices::query.master_timeout' + - $ref: '#/components/parameters/cat.indices::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.indices::query.h' + - $ref: '#/components/parameters/cat.indices::query.health' + - $ref: '#/components/parameters/cat.indices::query.help' + - $ref: '#/components/parameters/cat.indices::query.pri' + - $ref: '#/components/parameters/cat.indices::query.s' + - $ref: '#/components/parameters/cat.indices::query.time' + - $ref: '#/components/parameters/cat.indices::query.v' + - $ref: '#/components/parameters/cat.indices::query.include_unloaded_segments' + - $ref: '#/components/parameters/cat.indices::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/cat.indices@200' + /_cat/indices/{index}: + get: + operationId: cat.indices.1 + x-operation-group: cat.indices + x-version-added: '1.0' + description: 'Returns information about indices: number of primaries and replicas, document counts, disk size, ...' + parameters: + - $ref: '#/components/parameters/cat.indices::path.index' + - $ref: '#/components/parameters/cat.indices::query.format' + - $ref: '#/components/parameters/cat.indices::query.bytes' + - $ref: '#/components/parameters/cat.indices::query.local' + - $ref: '#/components/parameters/cat.indices::query.master_timeout' + - $ref: '#/components/parameters/cat.indices::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.indices::query.h' + - $ref: '#/components/parameters/cat.indices::query.health' + - $ref: '#/components/parameters/cat.indices::query.help' + - $ref: '#/components/parameters/cat.indices::query.pri' + - $ref: '#/components/parameters/cat.indices::query.s' + - $ref: '#/components/parameters/cat.indices::query.time' + - $ref: '#/components/parameters/cat.indices::query.v' + - $ref: '#/components/parameters/cat.indices::query.include_unloaded_segments' + - $ref: '#/components/parameters/cat.indices::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/cat.indices@200' + /_cat/master: + get: + operationId: cat.master.0 + x-operation-group: cat.master + deprecated: true + x-deprecation-message: To promote inclusive language, please use '/_cat/cluster_manager' instead. + x-version-added: '1.0' + x-version-deprecated: '2.0' + description: Returns information about the cluster-manager node. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-cluster_manager/ + parameters: + - $ref: '#/components/parameters/cat.master::query.format' + - $ref: '#/components/parameters/cat.master::query.local' + - $ref: '#/components/parameters/cat.master::query.master_timeout' + - $ref: '#/components/parameters/cat.master::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.master::query.h' + - $ref: '#/components/parameters/cat.master::query.help' + - $ref: '#/components/parameters/cat.master::query.s' + - $ref: '#/components/parameters/cat.master::query.v' + responses: + '200': + $ref: '#/components/responses/cat.master@200' + /_cat/nodeattrs: + get: + operationId: cat.nodeattrs.0 + x-operation-group: cat.nodeattrs + x-version-added: '1.0' + description: Returns information about custom node attributes. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-nodeattrs/ + parameters: + - $ref: '#/components/parameters/cat.nodeattrs::query.format' + - $ref: '#/components/parameters/cat.nodeattrs::query.local' + - $ref: '#/components/parameters/cat.nodeattrs::query.master_timeout' + - $ref: '#/components/parameters/cat.nodeattrs::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.nodeattrs::query.h' + - $ref: '#/components/parameters/cat.nodeattrs::query.help' + - $ref: '#/components/parameters/cat.nodeattrs::query.s' + - $ref: '#/components/parameters/cat.nodeattrs::query.v' + responses: + '200': + $ref: '#/components/responses/cat.nodeattrs@200' + /_cat/nodes: + get: + operationId: cat.nodes.0 + x-operation-group: cat.nodes + x-version-added: '1.0' + description: Returns basic statistics about performance of cluster nodes. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/ + parameters: + - $ref: '#/components/parameters/cat.nodes::query.bytes' + - $ref: '#/components/parameters/cat.nodes::query.format' + - $ref: '#/components/parameters/cat.nodes::query.full_id' + - $ref: '#/components/parameters/cat.nodes::query.local' + - $ref: '#/components/parameters/cat.nodes::query.master_timeout' + - $ref: '#/components/parameters/cat.nodes::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.nodes::query.h' + - $ref: '#/components/parameters/cat.nodes::query.help' + - $ref: '#/components/parameters/cat.nodes::query.s' + - $ref: '#/components/parameters/cat.nodes::query.time' + - $ref: '#/components/parameters/cat.nodes::query.v' + responses: + '200': + $ref: '#/components/responses/cat.nodes@200' + /_cat/pending_tasks: + get: + operationId: cat.pending_tasks.0 + x-operation-group: cat.pending_tasks + x-version-added: '1.0' + description: Returns a concise representation of the cluster pending tasks. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-pending-tasks/ + parameters: + - $ref: '#/components/parameters/cat.pending_tasks::query.format' + - $ref: '#/components/parameters/cat.pending_tasks::query.local' + - $ref: '#/components/parameters/cat.pending_tasks::query.master_timeout' + - $ref: '#/components/parameters/cat.pending_tasks::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.pending_tasks::query.h' + - $ref: '#/components/parameters/cat.pending_tasks::query.help' + - $ref: '#/components/parameters/cat.pending_tasks::query.s' + - $ref: '#/components/parameters/cat.pending_tasks::query.time' + - $ref: '#/components/parameters/cat.pending_tasks::query.v' + responses: + '200': + $ref: '#/components/responses/cat.pending_tasks@200' + /_cat/pit_segments: + get: + operationId: cat.pit_segments.0 + x-operation-group: cat.pit_segments + x-version-added: '2.4' + description: List segments for one or several PITs. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/point-in-time-api/ + parameters: + - $ref: '#/components/parameters/cat.pit_segments::query.format' + - $ref: '#/components/parameters/cat.pit_segments::query.h' + - $ref: '#/components/parameters/cat.pit_segments::query.help' + - $ref: '#/components/parameters/cat.pit_segments::query.s' + - $ref: '#/components/parameters/cat.pit_segments::query.v' + - $ref: '#/components/parameters/cat.pit_segments::query.bytes' + requestBody: + $ref: '#/components/requestBodies/cat.pit_segments' + responses: + '200': + $ref: '#/components/responses/cat.pit_segments@200' + /_cat/pit_segments/_all: + get: + operationId: cat.all_pit_segments.0 + x-operation-group: cat.all_pit_segments + x-version-added: '2.4' + description: Lists all active point-in-time segments. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/point-in-time-api/ + parameters: + - $ref: '#/components/parameters/cat.all_pit_segments::query.format' + - $ref: '#/components/parameters/cat.all_pit_segments::query.h' + - $ref: '#/components/parameters/cat.all_pit_segments::query.help' + - $ref: '#/components/parameters/cat.all_pit_segments::query.s' + - $ref: '#/components/parameters/cat.all_pit_segments::query.v' + - $ref: '#/components/parameters/cat.all_pit_segments::query.bytes' + responses: + '200': + $ref: '#/components/responses/cat.all_pit_segments@200' + /_cat/plugins: + get: + operationId: cat.plugins.0 + x-operation-group: cat.plugins + x-version-added: '1.0' + description: Returns information about installed plugins across nodes node. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-plugins/ + parameters: + - $ref: '#/components/parameters/cat.plugins::query.format' + - $ref: '#/components/parameters/cat.plugins::query.local' + - $ref: '#/components/parameters/cat.plugins::query.master_timeout' + - $ref: '#/components/parameters/cat.plugins::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.plugins::query.h' + - $ref: '#/components/parameters/cat.plugins::query.help' + - $ref: '#/components/parameters/cat.plugins::query.s' + - $ref: '#/components/parameters/cat.plugins::query.v' + responses: + '200': + $ref: '#/components/responses/cat.plugins@200' + /_cat/recovery: + get: + operationId: cat.recovery.0 + x-operation-group: cat.recovery + x-version-added: '1.0' + description: Returns information about index shard recoveries, both on-going completed. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-plugins/ + parameters: + - $ref: '#/components/parameters/cat.recovery::query.format' + - $ref: '#/components/parameters/cat.recovery::query.active_only' + - $ref: '#/components/parameters/cat.recovery::query.bytes' + - $ref: '#/components/parameters/cat.recovery::query.detailed' + - $ref: '#/components/parameters/cat.recovery::query.h' + - $ref: '#/components/parameters/cat.recovery::query.help' + - $ref: '#/components/parameters/cat.recovery::query.index' + - $ref: '#/components/parameters/cat.recovery::query.s' + - $ref: '#/components/parameters/cat.recovery::query.time' + - $ref: '#/components/parameters/cat.recovery::query.v' + responses: + '200': + $ref: '#/components/responses/cat.recovery@200' + /_cat/recovery/{index}: + get: + operationId: cat.recovery.1 + x-operation-group: cat.recovery + x-version-added: '1.0' + description: Returns information about index shard recoveries, both on-going completed. + parameters: + - $ref: '#/components/parameters/cat.recovery::path.index' + - $ref: '#/components/parameters/cat.recovery::query.format' + - $ref: '#/components/parameters/cat.recovery::query.active_only' + - $ref: '#/components/parameters/cat.recovery::query.bytes' + - $ref: '#/components/parameters/cat.recovery::query.detailed' + - $ref: '#/components/parameters/cat.recovery::query.h' + - $ref: '#/components/parameters/cat.recovery::query.help' + - $ref: '#/components/parameters/cat.recovery::query.index' + - $ref: '#/components/parameters/cat.recovery::query.s' + - $ref: '#/components/parameters/cat.recovery::query.time' + - $ref: '#/components/parameters/cat.recovery::query.v' + responses: + '200': + $ref: '#/components/responses/cat.recovery@200' + /_cat/repositories: + get: + operationId: cat.repositories.0 + x-operation-group: cat.repositories + x-version-added: '1.0' + description: Returns information about snapshot repositories registered in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-repositories/ + parameters: + - $ref: '#/components/parameters/cat.repositories::query.format' + - $ref: '#/components/parameters/cat.repositories::query.local' + - $ref: '#/components/parameters/cat.repositories::query.master_timeout' + - $ref: '#/components/parameters/cat.repositories::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.repositories::query.h' + - $ref: '#/components/parameters/cat.repositories::query.help' + - $ref: '#/components/parameters/cat.repositories::query.s' + - $ref: '#/components/parameters/cat.repositories::query.v' + responses: + '200': + $ref: '#/components/responses/cat.repositories@200' + /_cat/segment_replication: + get: + operationId: cat.segment_replication.0 + x-operation-group: cat.segment_replication + x-version-added: 2.6.0 + description: Returns information about both on-going and latest completed Segment Replication events. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-segment-replication/ + parameters: + - $ref: '#/components/parameters/cat.segment_replication::query.format' + - $ref: '#/components/parameters/cat.segment_replication::query.h' + - $ref: '#/components/parameters/cat.segment_replication::query.help' + - $ref: '#/components/parameters/cat.segment_replication::query.s' + - $ref: '#/components/parameters/cat.segment_replication::query.v' + - $ref: '#/components/parameters/cat.segment_replication::query.allow_no_indices' + - $ref: '#/components/parameters/cat.segment_replication::query.expand_wildcards' + - $ref: '#/components/parameters/cat.segment_replication::query.ignore_throttled' + - $ref: '#/components/parameters/cat.segment_replication::query.ignore_unavailable' + - $ref: '#/components/parameters/cat.segment_replication::query.active_only' + - $ref: '#/components/parameters/cat.segment_replication::query.completed_only' + - $ref: '#/components/parameters/cat.segment_replication::query.bytes' + - $ref: '#/components/parameters/cat.segment_replication::query.detailed' + - $ref: '#/components/parameters/cat.segment_replication::query.shards' + - $ref: '#/components/parameters/cat.segment_replication::query.index' + - $ref: '#/components/parameters/cat.segment_replication::query.time' + - $ref: '#/components/parameters/cat.segment_replication::query.timeout' + responses: + '200': + $ref: '#/components/responses/cat.segment_replication@200' + /_cat/segment_replication/{index}: + get: + operationId: cat.segment_replication.1 + x-operation-group: cat.segment_replication + x-version-added: 2.6.0 + description: Returns information about both on-going and latest completed Segment Replication events. + parameters: + - $ref: '#/components/parameters/cat.segment_replication::path.index' + - $ref: '#/components/parameters/cat.segment_replication::query.format' + - $ref: '#/components/parameters/cat.segment_replication::query.h' + - $ref: '#/components/parameters/cat.segment_replication::query.help' + - $ref: '#/components/parameters/cat.segment_replication::query.s' + - $ref: '#/components/parameters/cat.segment_replication::query.v' + - $ref: '#/components/parameters/cat.segment_replication::query.allow_no_indices' + - $ref: '#/components/parameters/cat.segment_replication::query.expand_wildcards' + - $ref: '#/components/parameters/cat.segment_replication::query.ignore_throttled' + - $ref: '#/components/parameters/cat.segment_replication::query.ignore_unavailable' + - $ref: '#/components/parameters/cat.segment_replication::query.active_only' + - $ref: '#/components/parameters/cat.segment_replication::query.completed_only' + - $ref: '#/components/parameters/cat.segment_replication::query.bytes' + - $ref: '#/components/parameters/cat.segment_replication::query.detailed' + - $ref: '#/components/parameters/cat.segment_replication::query.shards' + - $ref: '#/components/parameters/cat.segment_replication::query.index' + - $ref: '#/components/parameters/cat.segment_replication::query.time' + - $ref: '#/components/parameters/cat.segment_replication::query.timeout' + responses: + '200': + $ref: '#/components/responses/cat.segment_replication@200' + /_cat/segments: + get: + operationId: cat.segments.0 + x-operation-group: cat.segments + x-version-added: '1.0' + description: Provides low-level information about the segments in the shards of an index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-segments/ + parameters: + - $ref: '#/components/parameters/cat.segments::query.format' + - $ref: '#/components/parameters/cat.segments::query.bytes' + - $ref: '#/components/parameters/cat.segments::query.master_timeout' + - $ref: '#/components/parameters/cat.segments::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.segments::query.h' + - $ref: '#/components/parameters/cat.segments::query.help' + - $ref: '#/components/parameters/cat.segments::query.s' + - $ref: '#/components/parameters/cat.segments::query.v' + responses: + '200': + $ref: '#/components/responses/cat.segments@200' + /_cat/segments/{index}: + get: + operationId: cat.segments.1 + x-operation-group: cat.segments + x-version-added: '1.0' + description: Provides low-level information about the segments in the shards of an index. + parameters: + - $ref: '#/components/parameters/cat.segments::path.index' + - $ref: '#/components/parameters/cat.segments::query.format' + - $ref: '#/components/parameters/cat.segments::query.bytes' + - $ref: '#/components/parameters/cat.segments::query.master_timeout' + - $ref: '#/components/parameters/cat.segments::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.segments::query.h' + - $ref: '#/components/parameters/cat.segments::query.help' + - $ref: '#/components/parameters/cat.segments::query.s' + - $ref: '#/components/parameters/cat.segments::query.v' + responses: + '200': + $ref: '#/components/responses/cat.segments@200' + /_cat/shards: + get: + operationId: cat.shards.0 + x-operation-group: cat.shards + x-version-added: '1.0' + description: Provides a detailed view of shard allocation on nodes. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-shards/ + parameters: + - $ref: '#/components/parameters/cat.shards::query.format' + - $ref: '#/components/parameters/cat.shards::query.bytes' + - $ref: '#/components/parameters/cat.shards::query.local' + - $ref: '#/components/parameters/cat.shards::query.master_timeout' + - $ref: '#/components/parameters/cat.shards::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.shards::query.h' + - $ref: '#/components/parameters/cat.shards::query.help' + - $ref: '#/components/parameters/cat.shards::query.s' + - $ref: '#/components/parameters/cat.shards::query.time' + - $ref: '#/components/parameters/cat.shards::query.v' + responses: + '200': + $ref: '#/components/responses/cat.shards@200' + /_cat/shards/{index}: + get: + operationId: cat.shards.1 + x-operation-group: cat.shards + x-version-added: '1.0' + description: Provides a detailed view of shard allocation on nodes. + parameters: + - $ref: '#/components/parameters/cat.shards::path.index' + - $ref: '#/components/parameters/cat.shards::query.format' + - $ref: '#/components/parameters/cat.shards::query.bytes' + - $ref: '#/components/parameters/cat.shards::query.local' + - $ref: '#/components/parameters/cat.shards::query.master_timeout' + - $ref: '#/components/parameters/cat.shards::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.shards::query.h' + - $ref: '#/components/parameters/cat.shards::query.help' + - $ref: '#/components/parameters/cat.shards::query.s' + - $ref: '#/components/parameters/cat.shards::query.time' + - $ref: '#/components/parameters/cat.shards::query.v' + responses: + '200': + $ref: '#/components/responses/cat.shards@200' + /_cat/snapshots: + get: + operationId: cat.snapshots.0 + x-operation-group: cat.snapshots + x-version-added: '1.0' + description: Returns all snapshots in a specific repository. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-snapshots/ + parameters: + - $ref: '#/components/parameters/cat.snapshots::query.format' + - $ref: '#/components/parameters/cat.snapshots::query.ignore_unavailable' + - $ref: '#/components/parameters/cat.snapshots::query.master_timeout' + - $ref: '#/components/parameters/cat.snapshots::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.snapshots::query.h' + - $ref: '#/components/parameters/cat.snapshots::query.help' + - $ref: '#/components/parameters/cat.snapshots::query.s' + - $ref: '#/components/parameters/cat.snapshots::query.time' + - $ref: '#/components/parameters/cat.snapshots::query.v' + responses: + '200': + $ref: '#/components/responses/cat.snapshots@200' + /_cat/snapshots/{repository}: + get: + operationId: cat.snapshots.1 + x-operation-group: cat.snapshots + x-version-added: '1.0' + description: Returns all snapshots in a specific repository. + parameters: + - $ref: '#/components/parameters/cat.snapshots::path.repository' + - $ref: '#/components/parameters/cat.snapshots::query.format' + - $ref: '#/components/parameters/cat.snapshots::query.ignore_unavailable' + - $ref: '#/components/parameters/cat.snapshots::query.master_timeout' + - $ref: '#/components/parameters/cat.snapshots::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.snapshots::query.h' + - $ref: '#/components/parameters/cat.snapshots::query.help' + - $ref: '#/components/parameters/cat.snapshots::query.s' + - $ref: '#/components/parameters/cat.snapshots::query.time' + - $ref: '#/components/parameters/cat.snapshots::query.v' + responses: + '200': + $ref: '#/components/responses/cat.snapshots@200' + /_cat/tasks: + get: + operationId: cat.tasks.0 + x-operation-group: cat.tasks + x-version-added: '1.0' + description: Returns information about the tasks currently executing on one or more nodes in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-tasks/ + parameters: + - $ref: '#/components/parameters/cat.tasks::query.format' + - $ref: '#/components/parameters/cat.tasks::query.nodes' + - $ref: '#/components/parameters/cat.tasks::query.actions' + - $ref: '#/components/parameters/cat.tasks::query.detailed' + - $ref: '#/components/parameters/cat.tasks::query.parent_task_id' + - $ref: '#/components/parameters/cat.tasks::query.h' + - $ref: '#/components/parameters/cat.tasks::query.help' + - $ref: '#/components/parameters/cat.tasks::query.s' + - $ref: '#/components/parameters/cat.tasks::query.time' + - $ref: '#/components/parameters/cat.tasks::query.v' + responses: + '200': + $ref: '#/components/responses/cat.tasks@200' + /_cat/templates: + get: + operationId: cat.templates.0 + x-operation-group: cat.templates + x-version-added: '1.0' + description: Returns information about existing templates. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-templates/ + parameters: + - $ref: '#/components/parameters/cat.templates::query.format' + - $ref: '#/components/parameters/cat.templates::query.local' + - $ref: '#/components/parameters/cat.templates::query.master_timeout' + - $ref: '#/components/parameters/cat.templates::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.templates::query.h' + - $ref: '#/components/parameters/cat.templates::query.help' + - $ref: '#/components/parameters/cat.templates::query.s' + - $ref: '#/components/parameters/cat.templates::query.v' + responses: + '200': + $ref: '#/components/responses/cat.templates@200' + /_cat/templates/{name}: + get: + operationId: cat.templates.1 + x-operation-group: cat.templates + x-version-added: '1.0' + description: Returns information about existing templates. + parameters: + - $ref: '#/components/parameters/cat.templates::path.name' + - $ref: '#/components/parameters/cat.templates::query.format' + - $ref: '#/components/parameters/cat.templates::query.local' + - $ref: '#/components/parameters/cat.templates::query.master_timeout' + - $ref: '#/components/parameters/cat.templates::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.templates::query.h' + - $ref: '#/components/parameters/cat.templates::query.help' + - $ref: '#/components/parameters/cat.templates::query.s' + - $ref: '#/components/parameters/cat.templates::query.v' + responses: + '200': + $ref: '#/components/responses/cat.templates@200' + /_cat/thread_pool: + get: + operationId: cat.thread_pool.0 + x-operation-group: cat.thread_pool + x-version-added: '1.0' + description: |- + Returns cluster-wide thread pool statistics per node. + By default the active, queue and rejected statistics are returned for all thread pools. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cat/cat-thread-pool/ + parameters: + - $ref: '#/components/parameters/cat.thread_pool::query.format' + - $ref: '#/components/parameters/cat.thread_pool::query.size' + - $ref: '#/components/parameters/cat.thread_pool::query.local' + - $ref: '#/components/parameters/cat.thread_pool::query.master_timeout' + - $ref: '#/components/parameters/cat.thread_pool::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.thread_pool::query.h' + - $ref: '#/components/parameters/cat.thread_pool::query.help' + - $ref: '#/components/parameters/cat.thread_pool::query.s' + - $ref: '#/components/parameters/cat.thread_pool::query.v' + responses: + '200': + $ref: '#/components/responses/cat.thread_pool@200' + /_cat/thread_pool/{thread_pool_patterns}: + get: + operationId: cat.thread_pool.1 + x-operation-group: cat.thread_pool + x-version-added: '1.0' + description: |- + Returns cluster-wide thread pool statistics per node. + By default the active, queue and rejected statistics are returned for all thread pools. + parameters: + - $ref: '#/components/parameters/cat.thread_pool::path.thread_pool_patterns' + - $ref: '#/components/parameters/cat.thread_pool::query.format' + - $ref: '#/components/parameters/cat.thread_pool::query.size' + - $ref: '#/components/parameters/cat.thread_pool::query.local' + - $ref: '#/components/parameters/cat.thread_pool::query.master_timeout' + - $ref: '#/components/parameters/cat.thread_pool::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cat.thread_pool::query.h' + - $ref: '#/components/parameters/cat.thread_pool::query.help' + - $ref: '#/components/parameters/cat.thread_pool::query.s' + - $ref: '#/components/parameters/cat.thread_pool::query.v' + responses: + '200': + $ref: '#/components/responses/cat.thread_pool@200' + /_cluster/allocation/explain: + get: + operationId: cluster.allocation_explain.0 + x-operation-group: cluster.allocation_explain + x-version-added: '1.0' + description: Provides explanations for shard allocations in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-allocation/ + parameters: + - $ref: '#/components/parameters/cluster.allocation_explain::query.include_yes_decisions' + - $ref: '#/components/parameters/cluster.allocation_explain::query.include_disk_info' + requestBody: + $ref: '#/components/requestBodies/cluster.allocation_explain' + responses: + '200': + $ref: '#/components/responses/cluster.allocation_explain@200' + post: + operationId: cluster.allocation_explain.1 + x-operation-group: cluster.allocation_explain + x-version-added: '1.0' + description: Provides explanations for shard allocations in the cluster. + parameters: + - $ref: '#/components/parameters/cluster.allocation_explain::query.include_yes_decisions' + - $ref: '#/components/parameters/cluster.allocation_explain::query.include_disk_info' + requestBody: + $ref: '#/components/requestBodies/cluster.allocation_explain' + responses: + '200': + $ref: '#/components/responses/cluster.allocation_explain@200' + /_cluster/decommission/awareness: + delete: + operationId: cluster.delete_decommission_awareness.0 + x-operation-group: cluster.delete_decommission_awareness + x-version-added: '1.0' + description: Delete any existing decommission. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-decommission/#example-decommissioning-and-recommissioning-a-zone + responses: + '200': + $ref: '#/components/responses/cluster.delete_decommission_awareness@200' + /_cluster/decommission/awareness/{awareness_attribute_name}/_status: + get: + operationId: cluster.get_decommission_awareness.0 + x-operation-group: cluster.get_decommission_awareness + x-version-added: '1.0' + description: Get details and status of decommissioned attribute. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-decommission/#example-getting-zone-decommission-status + parameters: + - $ref: '#/components/parameters/cluster.get_decommission_awareness::path.awareness_attribute_name' + responses: + '200': + $ref: '#/components/responses/cluster.get_decommission_awareness@200' + /_cluster/decommission/awareness/{awareness_attribute_name}/{awareness_attribute_value}: + put: + operationId: cluster.put_decommission_awareness.0 + x-operation-group: cluster.put_decommission_awareness + x-version-added: '1.0' + description: Decommissions an awareness attribute. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-decommission/#example-decommissioning-and-recommissioning-a-zone + parameters: + - $ref: '#/components/parameters/cluster.put_decommission_awareness::path.awareness_attribute_name' + - $ref: '#/components/parameters/cluster.put_decommission_awareness::path.awareness_attribute_value' + responses: + '200': + $ref: '#/components/responses/cluster.put_decommission_awareness@200' + /_cluster/health: + get: + operationId: cluster.health.0 + x-operation-group: cluster.health + x-version-added: '1.0' + description: Returns basic information about the health of the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-health/ + parameters: + - $ref: '#/components/parameters/cluster.health::query.expand_wildcards' + - $ref: '#/components/parameters/cluster.health::query.level' + - $ref: '#/components/parameters/cluster.health::query.local' + - $ref: '#/components/parameters/cluster.health::query.master_timeout' + - $ref: '#/components/parameters/cluster.health::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.health::query.timeout' + - $ref: '#/components/parameters/cluster.health::query.wait_for_active_shards' + - $ref: '#/components/parameters/cluster.health::query.wait_for_nodes' + - $ref: '#/components/parameters/cluster.health::query.wait_for_events' + - $ref: '#/components/parameters/cluster.health::query.wait_for_no_relocating_shards' + - $ref: '#/components/parameters/cluster.health::query.wait_for_no_initializing_shards' + - $ref: '#/components/parameters/cluster.health::query.wait_for_status' + - $ref: '#/components/parameters/cluster.health::query.awareness_attribute' + responses: + '200': + $ref: '#/components/responses/cluster.health@200' + /_cluster/health/{index}: + get: + operationId: cluster.health.1 + x-operation-group: cluster.health + x-version-added: '1.0' + description: Returns basic information about the health of the cluster. + parameters: + - $ref: '#/components/parameters/cluster.health::path.index' + - $ref: '#/components/parameters/cluster.health::query.expand_wildcards' + - $ref: '#/components/parameters/cluster.health::query.level' + - $ref: '#/components/parameters/cluster.health::query.local' + - $ref: '#/components/parameters/cluster.health::query.master_timeout' + - $ref: '#/components/parameters/cluster.health::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.health::query.timeout' + - $ref: '#/components/parameters/cluster.health::query.wait_for_active_shards' + - $ref: '#/components/parameters/cluster.health::query.wait_for_nodes' + - $ref: '#/components/parameters/cluster.health::query.wait_for_events' + - $ref: '#/components/parameters/cluster.health::query.wait_for_no_relocating_shards' + - $ref: '#/components/parameters/cluster.health::query.wait_for_no_initializing_shards' + - $ref: '#/components/parameters/cluster.health::query.wait_for_status' + - $ref: '#/components/parameters/cluster.health::query.awareness_attribute' + responses: + '200': + $ref: '#/components/responses/cluster.health@200' + /_cluster/nodes/hot_threads: + get: + operationId: nodes.hot_threads.0 + x-operation-group: nodes.hot_threads + x-ignorable: true + deprecated: true + x-deprecation-message: The hot accepts /_cluster/nodes as prefix for backwards compatibility reasons + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Returns information about hot threads on each node in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-hot-threads/ + parameters: + - $ref: '#/components/parameters/nodes.hot_threads::query.interval' + - $ref: '#/components/parameters/nodes.hot_threads::query.snapshots' + - $ref: '#/components/parameters/nodes.hot_threads::query.threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.ignore_idle_threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.type' + - $ref: '#/components/parameters/nodes.hot_threads::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.hot_threads@200' + /_cluster/nodes/hotthreads: + get: + operationId: nodes.hot_threads.1 + x-operation-group: nodes.hot_threads + x-ignorable: true + deprecated: true + x-deprecation-message: The hot threads API accepts `hotthreads` but only `hot_threads` is documented + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Returns information about hot threads on each node in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.hot_threads::query.interval' + - $ref: '#/components/parameters/nodes.hot_threads::query.snapshots' + - $ref: '#/components/parameters/nodes.hot_threads::query.threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.ignore_idle_threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.type' + - $ref: '#/components/parameters/nodes.hot_threads::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.hot_threads@200' + /_cluster/nodes/{node_id}/hot_threads: + get: + operationId: nodes.hot_threads.2 + x-operation-group: nodes.hot_threads + x-ignorable: true + deprecated: true + x-deprecation-message: The hot accepts /_cluster/nodes as prefix for backwards compatibility reasons + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Returns information about hot threads on each node in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.hot_threads::path.node_id' + - $ref: '#/components/parameters/nodes.hot_threads::query.interval' + - $ref: '#/components/parameters/nodes.hot_threads::query.snapshots' + - $ref: '#/components/parameters/nodes.hot_threads::query.threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.ignore_idle_threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.type' + - $ref: '#/components/parameters/nodes.hot_threads::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.hot_threads@200' + /_cluster/nodes/{node_id}/hotthreads: + get: + operationId: nodes.hot_threads.3 + x-operation-group: nodes.hot_threads + x-ignorable: true + deprecated: true + x-deprecation-message: The hot threads API accepts `hotthreads` but only `hot_threads` is documented + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Returns information about hot threads on each node in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.hot_threads::path.node_id' + - $ref: '#/components/parameters/nodes.hot_threads::query.interval' + - $ref: '#/components/parameters/nodes.hot_threads::query.snapshots' + - $ref: '#/components/parameters/nodes.hot_threads::query.threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.ignore_idle_threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.type' + - $ref: '#/components/parameters/nodes.hot_threads::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.hot_threads@200' + /_cluster/pending_tasks: + get: + operationId: cluster.pending_tasks.0 + x-operation-group: cluster.pending_tasks + x-version-added: '1.0' + description: |- + Returns a list of any cluster-level changes (e.g. create index, update mapping, + allocate or fail shard) which have not yet been executed. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/cluster.pending_tasks::query.local' + - $ref: '#/components/parameters/cluster.pending_tasks::query.master_timeout' + - $ref: '#/components/parameters/cluster.pending_tasks::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/cluster.pending_tasks@200' + /_cluster/reroute: + post: + operationId: cluster.reroute.0 + x-operation-group: cluster.reroute + x-version-added: '1.0' + description: Allows to manually change the allocation of individual shards in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/cluster.reroute::query.dry_run' + - $ref: '#/components/parameters/cluster.reroute::query.explain' + - $ref: '#/components/parameters/cluster.reroute::query.retry_failed' + - $ref: '#/components/parameters/cluster.reroute::query.metric' + - $ref: '#/components/parameters/cluster.reroute::query.master_timeout' + - $ref: '#/components/parameters/cluster.reroute::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.reroute::query.timeout' + requestBody: + $ref: '#/components/requestBodies/cluster.reroute' + responses: + '200': + $ref: '#/components/responses/cluster.reroute@200' + /_cluster/routing/awareness/weights: + delete: + operationId: cluster.delete_weighted_routing.0 + x-operation-group: cluster.delete_weighted_routing + x-version-added: '1.0' + description: Delete weighted shard routing weights. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-awareness/#example-deleting-weights + responses: + '200': + $ref: '#/components/responses/cluster.delete_weighted_routing@200' + /_cluster/routing/awareness/{attribute}/weights: + get: + operationId: cluster.get_weighted_routing.0 + x-operation-group: cluster.get_weighted_routing + x-version-added: '1.0' + description: Fetches weighted shard routing weights. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-awareness/#example-getting-weights-for-all-zones + parameters: + - $ref: '#/components/parameters/cluster.get_weighted_routing::path.attribute' + responses: + '200': + $ref: '#/components/responses/cluster.get_weighted_routing@200' + put: + operationId: cluster.put_weighted_routing.0 + x-operation-group: cluster.put_weighted_routing + x-version-added: '1.0' + description: Updates weighted shard routing weights. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-awareness/#example-weighted-round-robin-search + parameters: + - $ref: '#/components/parameters/cluster.put_weighted_routing::path.attribute' + responses: + '200': + $ref: '#/components/responses/cluster.put_weighted_routing@200' + /_cluster/settings: + get: + operationId: cluster.get_settings.0 + x-operation-group: cluster.get_settings + x-version-added: '1.0' + description: Returns cluster settings. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-settings/ + parameters: + - $ref: '#/components/parameters/cluster.get_settings::query.flat_settings' + - $ref: '#/components/parameters/cluster.get_settings::query.master_timeout' + - $ref: '#/components/parameters/cluster.get_settings::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.get_settings::query.timeout' + - $ref: '#/components/parameters/cluster.get_settings::query.include_defaults' + responses: + '200': + $ref: '#/components/responses/cluster.get_settings@200' + put: + operationId: cluster.put_settings.0 + x-operation-group: cluster.put_settings + x-version-added: '1.0' + description: Updates the cluster settings. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-settings/ + parameters: + - $ref: '#/components/parameters/cluster.put_settings::query.flat_settings' + - $ref: '#/components/parameters/cluster.put_settings::query.master_timeout' + - $ref: '#/components/parameters/cluster.put_settings::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.put_settings::query.timeout' + requestBody: + $ref: '#/components/requestBodies/cluster.put_settings' + responses: + '200': + $ref: '#/components/responses/cluster.put_settings@200' + /_cluster/state: + get: + operationId: cluster.state.0 + x-operation-group: cluster.state + x-version-added: '1.0' + description: Returns a comprehensive information about the state of the cluster. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/cluster.state::query.local' + - $ref: '#/components/parameters/cluster.state::query.master_timeout' + - $ref: '#/components/parameters/cluster.state::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.state::query.flat_settings' + - $ref: '#/components/parameters/cluster.state::query.wait_for_metadata_version' + - $ref: '#/components/parameters/cluster.state::query.wait_for_timeout' + - $ref: '#/components/parameters/cluster.state::query.ignore_unavailable' + - $ref: '#/components/parameters/cluster.state::query.allow_no_indices' + - $ref: '#/components/parameters/cluster.state::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/cluster.state@200' + /_cluster/state/{metric}: + get: + operationId: cluster.state.1 + x-operation-group: cluster.state + x-version-added: '1.0' + description: Returns a comprehensive information about the state of the cluster. + parameters: + - $ref: '#/components/parameters/cluster.state::path.metric' + - $ref: '#/components/parameters/cluster.state::query.local' + - $ref: '#/components/parameters/cluster.state::query.master_timeout' + - $ref: '#/components/parameters/cluster.state::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.state::query.flat_settings' + - $ref: '#/components/parameters/cluster.state::query.wait_for_metadata_version' + - $ref: '#/components/parameters/cluster.state::query.wait_for_timeout' + - $ref: '#/components/parameters/cluster.state::query.ignore_unavailable' + - $ref: '#/components/parameters/cluster.state::query.allow_no_indices' + - $ref: '#/components/parameters/cluster.state::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/cluster.state@200' + /_cluster/state/{metric}/{index}: + get: + operationId: cluster.state.2 + x-operation-group: cluster.state + x-version-added: '1.0' + description: Returns a comprehensive information about the state of the cluster. + parameters: + - $ref: '#/components/parameters/cluster.state::path.index' + - $ref: '#/components/parameters/cluster.state::path.metric' + - $ref: '#/components/parameters/cluster.state::query.local' + - $ref: '#/components/parameters/cluster.state::query.master_timeout' + - $ref: '#/components/parameters/cluster.state::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.state::query.flat_settings' + - $ref: '#/components/parameters/cluster.state::query.wait_for_metadata_version' + - $ref: '#/components/parameters/cluster.state::query.wait_for_timeout' + - $ref: '#/components/parameters/cluster.state::query.ignore_unavailable' + - $ref: '#/components/parameters/cluster.state::query.allow_no_indices' + - $ref: '#/components/parameters/cluster.state::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/cluster.state@200' + /_cluster/stats: + get: + operationId: cluster.stats.0 + x-operation-group: cluster.stats + x-version-added: '1.0' + description: Returns high-level overview of cluster statistics. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/cluster-api/cluster-stats/ + parameters: + - $ref: '#/components/parameters/cluster.stats::query.flat_settings' + - $ref: '#/components/parameters/cluster.stats::query.timeout' + responses: + '200': + $ref: '#/components/responses/cluster.stats@200' + /_cluster/stats/nodes/{node_id}: + get: + operationId: cluster.stats.1 + x-operation-group: cluster.stats + x-version-added: '1.0' + description: Returns high-level overview of cluster statistics. + parameters: + - $ref: '#/components/parameters/cluster.stats::path.node_id' + - $ref: '#/components/parameters/cluster.stats::query.flat_settings' + - $ref: '#/components/parameters/cluster.stats::query.timeout' + responses: + '200': + $ref: '#/components/responses/cluster.stats@200' + /_cluster/voting_config_exclusions: + delete: + operationId: cluster.delete_voting_config_exclusions.0 + x-operation-group: cluster.delete_voting_config_exclusions + x-version-added: '1.0' + description: Clears cluster voting config exclusions. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/cluster.delete_voting_config_exclusions::query.wait_for_removal' + responses: + '200': + $ref: '#/components/responses/cluster.delete_voting_config_exclusions@200' + post: + operationId: cluster.post_voting_config_exclusions.0 + x-operation-group: cluster.post_voting_config_exclusions + x-version-added: '1.0' + description: Updates the cluster voting config exclusions by node ids or node names. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/cluster.post_voting_config_exclusions::query.node_ids' + - $ref: '#/components/parameters/cluster.post_voting_config_exclusions::query.node_names' + - $ref: '#/components/parameters/cluster.post_voting_config_exclusions::query.timeout' + responses: + '200': + $ref: '#/components/responses/cluster.post_voting_config_exclusions@200' + /_component_template: + get: + operationId: cluster.get_component_template.0 + x-operation-group: cluster.get_component_template + x-version-added: '1.0' + description: Returns one or more component templates. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/cluster.get_component_template::query.master_timeout' + - $ref: '#/components/parameters/cluster.get_component_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.get_component_template::query.local' + responses: + '200': + $ref: '#/components/responses/cluster.get_component_template@200' + /_component_template/{name}: + delete: + operationId: cluster.delete_component_template.0 + x-operation-group: cluster.delete_component_template + x-version-added: '1.0' + description: Deletes a component template. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/cluster.delete_component_template::path.name' + - $ref: '#/components/parameters/cluster.delete_component_template::query.timeout' + - $ref: '#/components/parameters/cluster.delete_component_template::query.master_timeout' + - $ref: '#/components/parameters/cluster.delete_component_template::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/cluster.delete_component_template@200' + get: + operationId: cluster.get_component_template.1 + x-operation-group: cluster.get_component_template + x-version-added: '1.0' + description: Returns one or more component templates. + parameters: + - $ref: '#/components/parameters/cluster.get_component_template::path.name' + - $ref: '#/components/parameters/cluster.get_component_template::query.master_timeout' + - $ref: '#/components/parameters/cluster.get_component_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.get_component_template::query.local' + responses: + '200': + $ref: '#/components/responses/cluster.get_component_template@200' + head: + operationId: cluster.exists_component_template.0 + x-operation-group: cluster.exists_component_template + x-version-added: '1.0' + description: Returns information about whether a particular component template exist. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/cluster.exists_component_template::path.name' + - $ref: '#/components/parameters/cluster.exists_component_template::query.master_timeout' + - $ref: '#/components/parameters/cluster.exists_component_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.exists_component_template::query.local' + responses: + '200': + $ref: '#/components/responses/cluster.exists_component_template@200' + post: + operationId: cluster.put_component_template.0 + x-operation-group: cluster.put_component_template + x-version-added: '1.0' + description: Creates or updates a component template. + parameters: + - $ref: '#/components/parameters/cluster.put_component_template::path.name' + - $ref: '#/components/parameters/cluster.put_component_template::query.create' + - $ref: '#/components/parameters/cluster.put_component_template::query.timeout' + - $ref: '#/components/parameters/cluster.put_component_template::query.master_timeout' + - $ref: '#/components/parameters/cluster.put_component_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/cluster.put_component_template' + responses: + '200': + $ref: '#/components/responses/cluster.put_component_template@200' + put: + operationId: cluster.put_component_template.1 + x-operation-group: cluster.put_component_template + x-version-added: '1.0' + description: Creates or updates a component template. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-templates/#use-component-templates-to-create-an-index-template + parameters: + - $ref: '#/components/parameters/cluster.put_component_template::path.name' + - $ref: '#/components/parameters/cluster.put_component_template::query.create' + - $ref: '#/components/parameters/cluster.put_component_template::query.timeout' + - $ref: '#/components/parameters/cluster.put_component_template::query.master_timeout' + - $ref: '#/components/parameters/cluster.put_component_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/cluster.put_component_template' + responses: + '200': + $ref: '#/components/responses/cluster.put_component_template@200' + /_count: + get: + operationId: count.0 + x-operation-group: count + x-version-added: '1.0' + description: Returns number of documents matching a query. + parameters: + - $ref: '#/components/parameters/count::query.ignore_unavailable' + - $ref: '#/components/parameters/count::query.ignore_throttled' + - $ref: '#/components/parameters/count::query.allow_no_indices' + - $ref: '#/components/parameters/count::query.expand_wildcards' + - $ref: '#/components/parameters/count::query.min_score' + - $ref: '#/components/parameters/count::query.preference' + - $ref: '#/components/parameters/count::query.routing' + - $ref: '#/components/parameters/count::query.q' + - $ref: '#/components/parameters/count::query.analyzer' + - $ref: '#/components/parameters/count::query.analyze_wildcard' + - $ref: '#/components/parameters/count::query.default_operator' + - $ref: '#/components/parameters/count::query.df' + - $ref: '#/components/parameters/count::query.lenient' + - $ref: '#/components/parameters/count::query.terminate_after' + requestBody: + $ref: '#/components/requestBodies/count' + responses: + '200': + $ref: '#/components/responses/count@200' + post: + operationId: count.1 + x-operation-group: count + x-version-added: '1.0' + description: Returns number of documents matching a query. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/count/ + parameters: + - $ref: '#/components/parameters/count::query.ignore_unavailable' + - $ref: '#/components/parameters/count::query.ignore_throttled' + - $ref: '#/components/parameters/count::query.allow_no_indices' + - $ref: '#/components/parameters/count::query.expand_wildcards' + - $ref: '#/components/parameters/count::query.min_score' + - $ref: '#/components/parameters/count::query.preference' + - $ref: '#/components/parameters/count::query.routing' + - $ref: '#/components/parameters/count::query.q' + - $ref: '#/components/parameters/count::query.analyzer' + - $ref: '#/components/parameters/count::query.analyze_wildcard' + - $ref: '#/components/parameters/count::query.default_operator' + - $ref: '#/components/parameters/count::query.df' + - $ref: '#/components/parameters/count::query.lenient' + - $ref: '#/components/parameters/count::query.terminate_after' + requestBody: + $ref: '#/components/requestBodies/count' + responses: + '200': + $ref: '#/components/responses/count@200' + /_dangling: + get: + operationId: dangling_indices.list_dangling_indices.0 + x-operation-group: dangling_indices.list_dangling_indices + x-version-added: '1.0' + description: Returns all dangling indices. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/dangling-index/ + parameters: [] + responses: + '200': + $ref: '#/components/responses/dangling_indices.list_dangling_indices@200' + /_dangling/{index_uuid}: + delete: + operationId: dangling_indices.delete_dangling_index.0 + x-operation-group: dangling_indices.delete_dangling_index + x-version-added: '1.0' + description: Deletes the specified dangling index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/dangling-index/ + parameters: + - $ref: '#/components/parameters/dangling_indices.delete_dangling_index::path.index_uuid' + - $ref: '#/components/parameters/dangling_indices.delete_dangling_index::query.accept_data_loss' + - $ref: '#/components/parameters/dangling_indices.delete_dangling_index::query.timeout' + - $ref: '#/components/parameters/dangling_indices.delete_dangling_index::query.master_timeout' + - $ref: '#/components/parameters/dangling_indices.delete_dangling_index::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/dangling_indices.delete_dangling_index@200' + post: + operationId: dangling_indices.import_dangling_index.0 + x-operation-group: dangling_indices.import_dangling_index + x-version-added: '1.0' + description: Imports the specified dangling index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/dangling-index/ + parameters: + - $ref: '#/components/parameters/dangling_indices.import_dangling_index::path.index_uuid' + - $ref: '#/components/parameters/dangling_indices.import_dangling_index::query.accept_data_loss' + - $ref: '#/components/parameters/dangling_indices.import_dangling_index::query.timeout' + - $ref: '#/components/parameters/dangling_indices.import_dangling_index::query.master_timeout' + - $ref: '#/components/parameters/dangling_indices.import_dangling_index::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/dangling_indices.import_dangling_index@200' + /_data_stream: + get: + operationId: indices.get_data_stream.0 + x-operation-group: indices.get_data_stream + x-version-added: '1.0' + description: Returns data streams. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/data-streams/ + parameters: [] + responses: + '200': + $ref: '#/components/responses/indices.get_data_stream@200' + /_data_stream/_stats: + get: + operationId: indices.data_streams_stats.0 + x-operation-group: indices.data_streams_stats + x-version-added: '1.0' + description: Provides statistics on operations happening in a data stream. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/data-streams/ + parameters: [] + responses: + '200': + $ref: '#/components/responses/indices.data_streams_stats@200' + /_data_stream/{name}: + delete: + operationId: indices.delete_data_stream.0 + x-operation-group: indices.delete_data_stream + x-version-added: '1.0' + description: Deletes a data stream. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/data-streams/ + parameters: + - $ref: '#/components/parameters/indices.delete_data_stream::path.name' + responses: + '200': + $ref: '#/components/responses/indices.delete_data_stream@200' + get: + operationId: indices.get_data_stream.1 + x-operation-group: indices.get_data_stream + x-version-added: '1.0' + description: Returns data streams. + parameters: + - $ref: '#/components/parameters/indices.get_data_stream::path.name' + responses: + '200': + $ref: '#/components/responses/indices.get_data_stream@200' + put: + operationId: indices.create_data_stream.0 + x-operation-group: indices.create_data_stream + x-version-added: '1.0' + description: Creates or updates a data stream. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/data-streams/ + parameters: + - $ref: '#/components/parameters/indices.create_data_stream::path.name' + requestBody: + $ref: '#/components/requestBodies/indices.create_data_stream' + responses: + '200': + $ref: '#/components/responses/indices.create_data_stream@200' + /_data_stream/{name}/_stats: + get: + operationId: indices.data_streams_stats.1 + x-operation-group: indices.data_streams_stats + x-version-added: '1.0' + description: Provides statistics on operations happening in a data stream. + parameters: + - $ref: '#/components/parameters/indices.data_streams_stats::path.name' + responses: + '200': + $ref: '#/components/responses/indices.data_streams_stats@200' + /_delete_by_query/{task_id}/_rethrottle: + post: + operationId: delete_by_query_rethrottle.0 + x-operation-group: delete_by_query_rethrottle + x-version-added: '1.0' + description: Changes the number of requests per second for a particular Delete By Query operation. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/delete_by_query_rethrottle::path.task_id' + - $ref: '#/components/parameters/delete_by_query_rethrottle::query.requests_per_second' + responses: + '200': + $ref: '#/components/responses/delete_by_query_rethrottle@200' + /_field_caps: + get: + operationId: field_caps.0 + x-operation-group: field_caps + x-version-added: '1.0' + description: Returns the information about the capabilities of fields among multiple indices. + externalDocs: + url: https://opensearch.org/docs/latest/field-types/supported-field-types/alias/#using-aliases-in-field-capabilities-api-operations + parameters: + - $ref: '#/components/parameters/field_caps::query.fields' + - $ref: '#/components/parameters/field_caps::query.ignore_unavailable' + - $ref: '#/components/parameters/field_caps::query.allow_no_indices' + - $ref: '#/components/parameters/field_caps::query.expand_wildcards' + - $ref: '#/components/parameters/field_caps::query.include_unmapped' + requestBody: + $ref: '#/components/requestBodies/field_caps' + responses: + '200': + $ref: '#/components/responses/field_caps@200' + post: + operationId: field_caps.1 + x-operation-group: field_caps + x-version-added: '1.0' + description: Returns the information about the capabilities of fields among multiple indices. + parameters: + - $ref: '#/components/parameters/field_caps::query.fields' + - $ref: '#/components/parameters/field_caps::query.ignore_unavailable' + - $ref: '#/components/parameters/field_caps::query.allow_no_indices' + - $ref: '#/components/parameters/field_caps::query.expand_wildcards' + - $ref: '#/components/parameters/field_caps::query.include_unmapped' + requestBody: + $ref: '#/components/requestBodies/field_caps' + responses: + '200': + $ref: '#/components/responses/field_caps@200' + /_flush: + get: + operationId: indices.flush.0 + x-operation-group: indices.flush + x-version-added: '1.0' + description: Performs the flush operation on one or more indices. + parameters: + - $ref: '#/components/parameters/indices.flush::query.force' + - $ref: '#/components/parameters/indices.flush::query.wait_if_ongoing' + - $ref: '#/components/parameters/indices.flush::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.flush::query.allow_no_indices' + - $ref: '#/components/parameters/indices.flush::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.flush@200' + post: + operationId: indices.flush.1 + x-operation-group: indices.flush + x-version-added: '1.0' + description: Performs the flush operation on one or more indices. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.flush::query.force' + - $ref: '#/components/parameters/indices.flush::query.wait_if_ongoing' + - $ref: '#/components/parameters/indices.flush::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.flush::query.allow_no_indices' + - $ref: '#/components/parameters/indices.flush::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.flush@200' + /_forcemerge: + post: + operationId: indices.forcemerge.0 + x-operation-group: indices.forcemerge + x-version-added: '1.0' + description: Performs the force merge operation on one or more indices. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.forcemerge::query.flush' + - $ref: '#/components/parameters/indices.forcemerge::query.primary_only' + - $ref: '#/components/parameters/indices.forcemerge::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.forcemerge::query.allow_no_indices' + - $ref: '#/components/parameters/indices.forcemerge::query.expand_wildcards' + - $ref: '#/components/parameters/indices.forcemerge::query.max_num_segments' + - $ref: '#/components/parameters/indices.forcemerge::query.only_expunge_deletes' + - $ref: '#/components/parameters/indices.forcemerge::query.wait_for_completion' + responses: + '200': + $ref: '#/components/responses/indices.forcemerge@200' + /_index_template: + get: + operationId: indices.get_index_template.0 + x-operation-group: indices.get_index_template + x-version-added: '1.0' + description: Returns an index template. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-templates/ + parameters: + - $ref: '#/components/parameters/indices.get_index_template::query.flat_settings' + - $ref: '#/components/parameters/indices.get_index_template::query.master_timeout' + - $ref: '#/components/parameters/indices.get_index_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_index_template::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_index_template@200' + /_index_template/_simulate: + post: + operationId: indices.simulate_template.0 + x-operation-group: indices.simulate_template + x-version-added: '1.0' + description: Simulate resolving the given template name or body. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.simulate_template::query.create' + - $ref: '#/components/parameters/indices.simulate_template::query.cause' + - $ref: '#/components/parameters/indices.simulate_template::query.master_timeout' + - $ref: '#/components/parameters/indices.simulate_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.simulate_template' + responses: + '200': + $ref: '#/components/responses/indices.simulate_template@200' + /_index_template/_simulate/{name}: + post: + operationId: indices.simulate_template.1 + x-operation-group: indices.simulate_template + x-version-added: '1.0' + description: Simulate resolving the given template name or body. + parameters: + - $ref: '#/components/parameters/indices.simulate_template::path.name' + - $ref: '#/components/parameters/indices.simulate_template::query.create' + - $ref: '#/components/parameters/indices.simulate_template::query.cause' + - $ref: '#/components/parameters/indices.simulate_template::query.master_timeout' + - $ref: '#/components/parameters/indices.simulate_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.simulate_template' + responses: + '200': + $ref: '#/components/responses/indices.simulate_template@200' + /_index_template/_simulate_index/{name}: + post: + operationId: indices.simulate_index_template.0 + x-operation-group: indices.simulate_index_template + x-version-added: '1.0' + description: Simulate matching the given index name against the index templates in the system. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.simulate_index_template::path.name' + - $ref: '#/components/parameters/indices.simulate_index_template::query.create' + - $ref: '#/components/parameters/indices.simulate_index_template::query.cause' + - $ref: '#/components/parameters/indices.simulate_index_template::query.master_timeout' + - $ref: '#/components/parameters/indices.simulate_index_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.simulate_index_template' + responses: + '200': + $ref: '#/components/responses/indices.simulate_index_template@200' + /_index_template/{name}: + delete: + operationId: indices.delete_index_template.0 + x-operation-group: indices.delete_index_template + x-version-added: '1.0' + description: Deletes an index template. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-templates/#delete-a-template + parameters: + - $ref: '#/components/parameters/indices.delete_index_template::path.name' + - $ref: '#/components/parameters/indices.delete_index_template::query.timeout' + - $ref: '#/components/parameters/indices.delete_index_template::query.master_timeout' + - $ref: '#/components/parameters/indices.delete_index_template::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/indices.delete_index_template@200' + get: + operationId: indices.get_index_template.1 + x-operation-group: indices.get_index_template + x-version-added: '1.0' + description: Returns an index template. + parameters: + - $ref: '#/components/parameters/indices.get_index_template::path.name' + - $ref: '#/components/parameters/indices.get_index_template::query.flat_settings' + - $ref: '#/components/parameters/indices.get_index_template::query.master_timeout' + - $ref: '#/components/parameters/indices.get_index_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_index_template::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_index_template@200' + head: + operationId: indices.exists_index_template.0 + x-operation-group: indices.exists_index_template + x-version-added: '1.0' + description: Returns information about whether a particular index template exists. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-templates/ + parameters: + - $ref: '#/components/parameters/indices.exists_index_template::path.name' + - $ref: '#/components/parameters/indices.exists_index_template::query.flat_settings' + - $ref: '#/components/parameters/indices.exists_index_template::query.master_timeout' + - $ref: '#/components/parameters/indices.exists_index_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.exists_index_template::query.local' + responses: + '200': + $ref: '#/components/responses/indices.exists_index_template@200' + post: + operationId: indices.put_index_template.0 + x-operation-group: indices.put_index_template + x-version-added: '1.0' + description: Creates or updates an index template. + parameters: + - $ref: '#/components/parameters/indices.put_index_template::path.name' + - $ref: '#/components/parameters/indices.put_index_template::query.create' + - $ref: '#/components/parameters/indices.put_index_template::query.cause' + - $ref: '#/components/parameters/indices.put_index_template::query.master_timeout' + - $ref: '#/components/parameters/indices.put_index_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.put_index_template' + responses: + '200': + $ref: '#/components/responses/indices.put_index_template@200' + put: + operationId: indices.put_index_template.1 + x-operation-group: indices.put_index_template + x-version-added: '1.0' + description: Creates or updates an index template. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-templates/ + parameters: + - $ref: '#/components/parameters/indices.put_index_template::path.name' + - $ref: '#/components/parameters/indices.put_index_template::query.create' + - $ref: '#/components/parameters/indices.put_index_template::query.cause' + - $ref: '#/components/parameters/indices.put_index_template::query.master_timeout' + - $ref: '#/components/parameters/indices.put_index_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.put_index_template' + responses: + '200': + $ref: '#/components/responses/indices.put_index_template@200' + /_ingest/pipeline: + get: + operationId: ingest.get_pipeline.0 + x-operation-group: ingest.get_pipeline + x-version-added: '1.0' + description: Returns a pipeline. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/ingest-apis/get-ingest/ + parameters: + - $ref: '#/components/parameters/ingest.get_pipeline::query.master_timeout' + - $ref: '#/components/parameters/ingest.get_pipeline::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/ingest.get_pipeline@200' + /_ingest/pipeline/_simulate: + get: + operationId: ingest.simulate.0 + x-operation-group: ingest.simulate + x-version-added: '1.0' + description: Allows to simulate a pipeline with example documents. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/ingest-apis/simulate-ingest/ + parameters: + - $ref: '#/components/parameters/ingest.simulate::query.verbose' + requestBody: + $ref: '#/components/requestBodies/ingest.simulate' + responses: + '200': + $ref: '#/components/responses/ingest.simulate@200' + post: + operationId: ingest.simulate.1 + x-operation-group: ingest.simulate + x-version-added: '1.0' + description: Allows to simulate a pipeline with example documents. + parameters: + - $ref: '#/components/parameters/ingest.simulate::query.verbose' + requestBody: + $ref: '#/components/requestBodies/ingest.simulate' + responses: + '200': + $ref: '#/components/responses/ingest.simulate@200' + /_ingest/pipeline/{id}: + delete: + operationId: ingest.delete_pipeline.0 + x-operation-group: ingest.delete_pipeline + x-version-added: '1.0' + description: Deletes a pipeline. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/ingest-apis/delete-ingest/ + parameters: + - $ref: '#/components/parameters/ingest.delete_pipeline::path.id' + - $ref: '#/components/parameters/ingest.delete_pipeline::query.master_timeout' + - $ref: '#/components/parameters/ingest.delete_pipeline::query.cluster_manager_timeout' + - $ref: '#/components/parameters/ingest.delete_pipeline::query.timeout' + responses: + '200': + $ref: '#/components/responses/ingest.delete_pipeline@200' + get: + operationId: ingest.get_pipeline.1 + x-operation-group: ingest.get_pipeline + x-version-added: '1.0' + description: Returns a pipeline. + parameters: + - $ref: '#/components/parameters/ingest.get_pipeline::path.id' + - $ref: '#/components/parameters/ingest.get_pipeline::query.master_timeout' + - $ref: '#/components/parameters/ingest.get_pipeline::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/ingest.get_pipeline@200' + put: + operationId: ingest.put_pipeline.0 + x-operation-group: ingest.put_pipeline + x-version-added: '1.0' + description: Creates or updates a pipeline. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/ingest-apis/create-update-ingest/ + parameters: + - $ref: '#/components/parameters/ingest.put_pipeline::path.id' + - $ref: '#/components/parameters/ingest.put_pipeline::query.master_timeout' + - $ref: '#/components/parameters/ingest.put_pipeline::query.cluster_manager_timeout' + - $ref: '#/components/parameters/ingest.put_pipeline::query.timeout' + requestBody: + $ref: '#/components/requestBodies/ingest.put_pipeline' + responses: + '200': + $ref: '#/components/responses/ingest.put_pipeline@200' + /_ingest/pipeline/{id}/_simulate: + get: + operationId: ingest.simulate.2 + x-operation-group: ingest.simulate + x-version-added: '1.0' + description: Allows to simulate a pipeline with example documents. + parameters: + - $ref: '#/components/parameters/ingest.simulate::path.id' + - $ref: '#/components/parameters/ingest.simulate::query.verbose' + requestBody: + $ref: '#/components/requestBodies/ingest.simulate' + responses: + '200': + $ref: '#/components/responses/ingest.simulate@200' + post: + operationId: ingest.simulate.3 + x-operation-group: ingest.simulate + x-version-added: '1.0' + description: Allows to simulate a pipeline with example documents. + parameters: + - $ref: '#/components/parameters/ingest.simulate::path.id' + - $ref: '#/components/parameters/ingest.simulate::query.verbose' + requestBody: + $ref: '#/components/requestBodies/ingest.simulate' + responses: + '200': + $ref: '#/components/responses/ingest.simulate@200' + /_ingest/processor/grok: + get: + operationId: ingest.processor_grok.0 + x-operation-group: ingest.processor_grok + x-version-added: '1.0' + description: Returns a list of the built-in patterns. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: [] + responses: + '200': + $ref: '#/components/responses/ingest.processor_grok@200' + /_mapping: + get: + operationId: indices.get_mapping.0 + x-operation-group: indices.get_mapping + x-version-added: '1.0' + description: Returns mappings for one or more indices. + externalDocs: + url: https://opensearch.org/docs/latest/field-types/index/#get-a-mapping + parameters: + - $ref: '#/components/parameters/indices.get_mapping::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_mapping::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_mapping::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_mapping::query.master_timeout' + - $ref: '#/components/parameters/indices.get_mapping::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_mapping::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_mapping@200' + /_mapping/field/{fields}: + get: + operationId: indices.get_field_mapping.0 + x-operation-group: indices.get_field_mapping + x-version-added: '1.0' + description: Returns mapping for one or more fields. + externalDocs: + url: https://opensearch.org/docs/latest/field-types/index/ + parameters: + - $ref: '#/components/parameters/indices.get_field_mapping::path.fields' + - $ref: '#/components/parameters/indices.get_field_mapping::query.include_defaults' + - $ref: '#/components/parameters/indices.get_field_mapping::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_field_mapping::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_field_mapping::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_field_mapping::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_field_mapping@200' + /_mget: + get: + operationId: mget.0 + x-operation-group: mget + x-version-added: '1.0' + description: Allows to get multiple documents in one request. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/multi-get/ + parameters: + - $ref: '#/components/parameters/mget::query.stored_fields' + - $ref: '#/components/parameters/mget::query.preference' + - $ref: '#/components/parameters/mget::query.realtime' + - $ref: '#/components/parameters/mget::query.refresh' + - $ref: '#/components/parameters/mget::query.routing' + - $ref: '#/components/parameters/mget::query._source' + - $ref: '#/components/parameters/mget::query._source_excludes' + - $ref: '#/components/parameters/mget::query._source_includes' + requestBody: + $ref: '#/components/requestBodies/mget' + responses: + '200': + $ref: '#/components/responses/mget@200' + post: + operationId: mget.1 + x-operation-group: mget + x-version-added: '1.0' + description: Allows to get multiple documents in one request. + parameters: + - $ref: '#/components/parameters/mget::query.stored_fields' + - $ref: '#/components/parameters/mget::query.preference' + - $ref: '#/components/parameters/mget::query.realtime' + - $ref: '#/components/parameters/mget::query.refresh' + - $ref: '#/components/parameters/mget::query.routing' + - $ref: '#/components/parameters/mget::query._source' + - $ref: '#/components/parameters/mget::query._source_excludes' + - $ref: '#/components/parameters/mget::query._source_includes' + requestBody: + $ref: '#/components/requestBodies/mget' + responses: + '200': + $ref: '#/components/responses/mget@200' + /_msearch: + get: + operationId: msearch.0 + x-operation-group: msearch + x-version-added: '1.0' + description: Allows to execute several search operations in one request. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/multi-search/ + parameters: + - $ref: '#/components/parameters/msearch::query.search_type' + - $ref: '#/components/parameters/msearch::query.max_concurrent_searches' + - $ref: '#/components/parameters/msearch::query.typed_keys' + - $ref: '#/components/parameters/msearch::query.pre_filter_shard_size' + - $ref: '#/components/parameters/msearch::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/msearch::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/msearch::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/msearch' + responses: + '200': + $ref: '#/components/responses/msearch@200' + post: + operationId: msearch.1 + x-operation-group: msearch + x-version-added: '1.0' + description: Allows to execute several search operations in one request. + parameters: + - $ref: '#/components/parameters/msearch::query.search_type' + - $ref: '#/components/parameters/msearch::query.max_concurrent_searches' + - $ref: '#/components/parameters/msearch::query.typed_keys' + - $ref: '#/components/parameters/msearch::query.pre_filter_shard_size' + - $ref: '#/components/parameters/msearch::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/msearch::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/msearch::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/msearch' + responses: + '200': + $ref: '#/components/responses/msearch@200' + /_msearch/template: + get: + operationId: msearch_template.0 + x-operation-group: msearch_template + x-version-added: '1.0' + description: Allows to execute several search template operations in one request. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/search-template/ + parameters: + - $ref: '#/components/parameters/msearch_template::query.search_type' + - $ref: '#/components/parameters/msearch_template::query.typed_keys' + - $ref: '#/components/parameters/msearch_template::query.max_concurrent_searches' + - $ref: '#/components/parameters/msearch_template::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/msearch_template::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/msearch_template' + responses: + '200': + $ref: '#/components/responses/msearch_template@200' + post: + operationId: msearch_template.1 + x-operation-group: msearch_template + x-version-added: '1.0' + description: Allows to execute several search template operations in one request. + parameters: + - $ref: '#/components/parameters/msearch_template::query.search_type' + - $ref: '#/components/parameters/msearch_template::query.typed_keys' + - $ref: '#/components/parameters/msearch_template::query.max_concurrent_searches' + - $ref: '#/components/parameters/msearch_template::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/msearch_template::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/msearch_template' + responses: + '200': + $ref: '#/components/responses/msearch_template@200' + /_mtermvectors: + get: + operationId: mtermvectors.0 + x-operation-group: mtermvectors + x-version-added: '1.0' + description: Returns multiple termvectors in one request. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/mtermvectors::query.ids' + - $ref: '#/components/parameters/mtermvectors::query.term_statistics' + - $ref: '#/components/parameters/mtermvectors::query.field_statistics' + - $ref: '#/components/parameters/mtermvectors::query.fields' + - $ref: '#/components/parameters/mtermvectors::query.offsets' + - $ref: '#/components/parameters/mtermvectors::query.positions' + - $ref: '#/components/parameters/mtermvectors::query.payloads' + - $ref: '#/components/parameters/mtermvectors::query.preference' + - $ref: '#/components/parameters/mtermvectors::query.routing' + - $ref: '#/components/parameters/mtermvectors::query.realtime' + - $ref: '#/components/parameters/mtermvectors::query.version' + - $ref: '#/components/parameters/mtermvectors::query.version_type' + requestBody: + $ref: '#/components/requestBodies/mtermvectors' + responses: + '200': + $ref: '#/components/responses/mtermvectors@200' + post: + operationId: mtermvectors.1 + x-operation-group: mtermvectors + x-version-added: '1.0' + description: Returns multiple termvectors in one request. + parameters: + - $ref: '#/components/parameters/mtermvectors::query.ids' + - $ref: '#/components/parameters/mtermvectors::query.term_statistics' + - $ref: '#/components/parameters/mtermvectors::query.field_statistics' + - $ref: '#/components/parameters/mtermvectors::query.fields' + - $ref: '#/components/parameters/mtermvectors::query.offsets' + - $ref: '#/components/parameters/mtermvectors::query.positions' + - $ref: '#/components/parameters/mtermvectors::query.payloads' + - $ref: '#/components/parameters/mtermvectors::query.preference' + - $ref: '#/components/parameters/mtermvectors::query.routing' + - $ref: '#/components/parameters/mtermvectors::query.realtime' + - $ref: '#/components/parameters/mtermvectors::query.version' + - $ref: '#/components/parameters/mtermvectors::query.version_type' + requestBody: + $ref: '#/components/requestBodies/mtermvectors' + responses: + '200': + $ref: '#/components/responses/mtermvectors@200' + /_nodes: + get: + operationId: nodes.info.0 + x-operation-group: nodes.info + x-version-added: '1.0' + description: Returns information about nodes in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-info/ + parameters: + - $ref: '#/components/parameters/nodes.info::query.flat_settings' + - $ref: '#/components/parameters/nodes.info::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.info@200' + /_nodes/hot_threads: + get: + operationId: nodes.hot_threads.4 + x-operation-group: nodes.hot_threads + x-version-added: '1.0' + description: Returns information about hot threads on each node in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.hot_threads::query.interval' + - $ref: '#/components/parameters/nodes.hot_threads::query.snapshots' + - $ref: '#/components/parameters/nodes.hot_threads::query.threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.ignore_idle_threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.type' + - $ref: '#/components/parameters/nodes.hot_threads::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.hot_threads@200' + /_nodes/hotthreads: + get: + operationId: nodes.hot_threads.5 + x-operation-group: nodes.hot_threads + x-ignorable: true + deprecated: true + x-deprecation-message: The hot threads API accepts `hotthreads` but only `hot_threads` is documented + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Returns information about hot threads on each node in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.hot_threads::query.interval' + - $ref: '#/components/parameters/nodes.hot_threads::query.snapshots' + - $ref: '#/components/parameters/nodes.hot_threads::query.threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.ignore_idle_threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.type' + - $ref: '#/components/parameters/nodes.hot_threads::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.hot_threads@200' + /_nodes/reload_secure_settings: + post: + operationId: nodes.reload_secure_settings.0 + x-operation-group: nodes.reload_secure_settings + x-version-added: '1.0' + description: Reloads secure settings. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-reload-secure/ + parameters: + - $ref: '#/components/parameters/nodes.reload_secure_settings::query.timeout' + requestBody: + $ref: '#/components/requestBodies/nodes.reload_secure_settings' + responses: + '200': + $ref: '#/components/responses/nodes.reload_secure_settings@200' + /_nodes/stats: + get: + operationId: nodes.stats.0 + x-operation-group: nodes.stats + x-version-added: '1.0' + description: Returns statistical information about nodes in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-usage/ + parameters: + - $ref: '#/components/parameters/nodes.stats::query.completion_fields' + - $ref: '#/components/parameters/nodes.stats::query.fielddata_fields' + - $ref: '#/components/parameters/nodes.stats::query.fields' + - $ref: '#/components/parameters/nodes.stats::query.groups' + - $ref: '#/components/parameters/nodes.stats::query.level' + - $ref: '#/components/parameters/nodes.stats::query.types' + - $ref: '#/components/parameters/nodes.stats::query.timeout' + - $ref: '#/components/parameters/nodes.stats::query.include_segment_file_sizes' + responses: + '200': + $ref: '#/components/responses/nodes.stats@200' + /_nodes/stats/{metric}: + get: + operationId: nodes.stats.1 + x-operation-group: nodes.stats + x-version-added: '1.0' + description: Returns statistical information about nodes in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.stats::path.metric' + - $ref: '#/components/parameters/nodes.stats::query.completion_fields' + - $ref: '#/components/parameters/nodes.stats::query.fielddata_fields' + - $ref: '#/components/parameters/nodes.stats::query.fields' + - $ref: '#/components/parameters/nodes.stats::query.groups' + - $ref: '#/components/parameters/nodes.stats::query.level' + - $ref: '#/components/parameters/nodes.stats::query.types' + - $ref: '#/components/parameters/nodes.stats::query.timeout' + - $ref: '#/components/parameters/nodes.stats::query.include_segment_file_sizes' + responses: + '200': + $ref: '#/components/responses/nodes.stats@200' + /_nodes/stats/{metric}/{index_metric}: + get: + operationId: nodes.stats.2 + x-operation-group: nodes.stats + x-version-added: '1.0' + description: Returns statistical information about nodes in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.stats::path.metric' + - $ref: '#/components/parameters/nodes.stats::path.index_metric' + - $ref: '#/components/parameters/nodes.stats::query.completion_fields' + - $ref: '#/components/parameters/nodes.stats::query.fielddata_fields' + - $ref: '#/components/parameters/nodes.stats::query.fields' + - $ref: '#/components/parameters/nodes.stats::query.groups' + - $ref: '#/components/parameters/nodes.stats::query.level' + - $ref: '#/components/parameters/nodes.stats::query.types' + - $ref: '#/components/parameters/nodes.stats::query.timeout' + - $ref: '#/components/parameters/nodes.stats::query.include_segment_file_sizes' + responses: + '200': + $ref: '#/components/responses/nodes.stats@200' + /_nodes/usage: + get: + operationId: nodes.usage.0 + x-operation-group: nodes.usage + x-version-added: '1.0' + description: Returns low-level information about REST actions usage on nodes. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/nodes.usage::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.usage@200' + /_nodes/usage/{metric}: + get: + operationId: nodes.usage.1 + x-operation-group: nodes.usage + x-version-added: '1.0' + description: Returns low-level information about REST actions usage on nodes. + parameters: + - $ref: '#/components/parameters/nodes.usage::path.metric' + - $ref: '#/components/parameters/nodes.usage::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.usage@200' + /_nodes/{metric}: + get: + operationId: nodes.info.1 + x-operation-group: nodes.info + x-version-added: '1.0' + description: Returns information about nodes in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.info::path.metric' + - $ref: '#/components/parameters/nodes.info::query.flat_settings' + - $ref: '#/components/parameters/nodes.info::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.info@200' + /_nodes/{node_id}: + get: + operationId: nodes.info.2 + x-operation-group: nodes.info + x-version-added: '1.0' + description: Returns information about nodes in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.info::path.node_id' + - $ref: '#/components/parameters/nodes.info::query.flat_settings' + - $ref: '#/components/parameters/nodes.info::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.info@200' + /_nodes/{node_id}/hot_threads: + get: + operationId: nodes.hot_threads.6 + x-operation-group: nodes.hot_threads + x-version-added: '1.0' + description: Returns information about hot threads on each node in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.hot_threads::path.node_id' + - $ref: '#/components/parameters/nodes.hot_threads::query.interval' + - $ref: '#/components/parameters/nodes.hot_threads::query.snapshots' + - $ref: '#/components/parameters/nodes.hot_threads::query.threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.ignore_idle_threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.type' + - $ref: '#/components/parameters/nodes.hot_threads::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.hot_threads@200' + /_nodes/{node_id}/hotthreads: + get: + operationId: nodes.hot_threads.7 + x-operation-group: nodes.hot_threads + x-ignorable: true + deprecated: true + x-deprecation-message: The hot threads API accepts `hotthreads` but only `hot_threads` is documented + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Returns information about hot threads on each node in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.hot_threads::path.node_id' + - $ref: '#/components/parameters/nodes.hot_threads::query.interval' + - $ref: '#/components/parameters/nodes.hot_threads::query.snapshots' + - $ref: '#/components/parameters/nodes.hot_threads::query.threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.ignore_idle_threads' + - $ref: '#/components/parameters/nodes.hot_threads::query.type' + - $ref: '#/components/parameters/nodes.hot_threads::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.hot_threads@200' + /_nodes/{node_id}/reload_secure_settings: + post: + operationId: nodes.reload_secure_settings.1 + x-operation-group: nodes.reload_secure_settings + x-version-added: '1.0' + description: Reloads secure settings. + parameters: + - $ref: '#/components/parameters/nodes.reload_secure_settings::path.node_id' + - $ref: '#/components/parameters/nodes.reload_secure_settings::query.timeout' + requestBody: + $ref: '#/components/requestBodies/nodes.reload_secure_settings' + responses: + '200': + $ref: '#/components/responses/nodes.reload_secure_settings@200' + /_nodes/{node_id}/stats: + get: + operationId: nodes.stats.3 + x-operation-group: nodes.stats + x-version-added: '1.0' + description: Returns statistical information about nodes in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.stats::path.node_id' + - $ref: '#/components/parameters/nodes.stats::query.completion_fields' + - $ref: '#/components/parameters/nodes.stats::query.fielddata_fields' + - $ref: '#/components/parameters/nodes.stats::query.fields' + - $ref: '#/components/parameters/nodes.stats::query.groups' + - $ref: '#/components/parameters/nodes.stats::query.level' + - $ref: '#/components/parameters/nodes.stats::query.types' + - $ref: '#/components/parameters/nodes.stats::query.timeout' + - $ref: '#/components/parameters/nodes.stats::query.include_segment_file_sizes' + responses: + '200': + $ref: '#/components/responses/nodes.stats@200' + /_nodes/{node_id}/stats/{metric}: + get: + operationId: nodes.stats.4 + x-operation-group: nodes.stats + x-version-added: '1.0' + description: Returns statistical information about nodes in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.stats::path.metric' + - $ref: '#/components/parameters/nodes.stats::path.node_id' + - $ref: '#/components/parameters/nodes.stats::query.completion_fields' + - $ref: '#/components/parameters/nodes.stats::query.fielddata_fields' + - $ref: '#/components/parameters/nodes.stats::query.fields' + - $ref: '#/components/parameters/nodes.stats::query.groups' + - $ref: '#/components/parameters/nodes.stats::query.level' + - $ref: '#/components/parameters/nodes.stats::query.types' + - $ref: '#/components/parameters/nodes.stats::query.timeout' + - $ref: '#/components/parameters/nodes.stats::query.include_segment_file_sizes' + responses: + '200': + $ref: '#/components/responses/nodes.stats@200' + /_nodes/{node_id}/stats/{metric}/{index_metric}: + get: + operationId: nodes.stats.5 + x-operation-group: nodes.stats + x-version-added: '1.0' + description: Returns statistical information about nodes in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.stats::path.metric' + - $ref: '#/components/parameters/nodes.stats::path.index_metric' + - $ref: '#/components/parameters/nodes.stats::path.node_id' + - $ref: '#/components/parameters/nodes.stats::query.completion_fields' + - $ref: '#/components/parameters/nodes.stats::query.fielddata_fields' + - $ref: '#/components/parameters/nodes.stats::query.fields' + - $ref: '#/components/parameters/nodes.stats::query.groups' + - $ref: '#/components/parameters/nodes.stats::query.level' + - $ref: '#/components/parameters/nodes.stats::query.types' + - $ref: '#/components/parameters/nodes.stats::query.timeout' + - $ref: '#/components/parameters/nodes.stats::query.include_segment_file_sizes' + responses: + '200': + $ref: '#/components/responses/nodes.stats@200' + /_nodes/{node_id}/usage: + get: + operationId: nodes.usage.2 + x-operation-group: nodes.usage + x-version-added: '1.0' + description: Returns low-level information about REST actions usage on nodes. + parameters: + - $ref: '#/components/parameters/nodes.usage::path.node_id' + - $ref: '#/components/parameters/nodes.usage::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.usage@200' + /_nodes/{node_id}/usage/{metric}: + get: + operationId: nodes.usage.3 + x-operation-group: nodes.usage + x-version-added: '1.0' + description: Returns low-level information about REST actions usage on nodes. + parameters: + - $ref: '#/components/parameters/nodes.usage::path.metric' + - $ref: '#/components/parameters/nodes.usage::path.node_id' + - $ref: '#/components/parameters/nodes.usage::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.usage@200' + /_nodes/{node_id}/{metric}: + get: + operationId: nodes.info.3 + x-operation-group: nodes.info + x-version-added: '1.0' + description: Returns information about nodes in the cluster. + parameters: + - $ref: '#/components/parameters/nodes.info::path.node_id' + - $ref: '#/components/parameters/nodes.info::path.metric' + - $ref: '#/components/parameters/nodes.info::query.flat_settings' + - $ref: '#/components/parameters/nodes.info::query.timeout' + responses: + '200': + $ref: '#/components/responses/nodes.info@200' + /_plugins/_knn/models/_search: + get: + operationId: knn.search_models.0 + x-operation-group: knn.search_models + x-version-added: '1.0' + description: Use an OpenSearch query to search for models in the index. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/knn/api/#search-model + parameters: + - $ref: '#/components/parameters/knn.search_models::query.analyzer' + - $ref: '#/components/parameters/knn.search_models::query.analyze_wildcard' + - $ref: '#/components/parameters/knn.search_models::query.ccs_minimize_roundtrips' + - $ref: '#/components/parameters/knn.search_models::query.default_operator' + - $ref: '#/components/parameters/knn.search_models::query.df' + - $ref: '#/components/parameters/knn.search_models::query.explain' + - $ref: '#/components/parameters/knn.search_models::query.stored_fields' + - $ref: '#/components/parameters/knn.search_models::query.docvalue_fields' + - $ref: '#/components/parameters/knn.search_models::query.from' + - $ref: '#/components/parameters/knn.search_models::query.ignore_unavailable' + - $ref: '#/components/parameters/knn.search_models::query.ignore_throttled' + - $ref: '#/components/parameters/knn.search_models::query.allow_no_indices' + - $ref: '#/components/parameters/knn.search_models::query.expand_wildcards' + - $ref: '#/components/parameters/knn.search_models::query.lenient' + - $ref: '#/components/parameters/knn.search_models::query.preference' + - $ref: '#/components/parameters/knn.search_models::query.q' + - $ref: '#/components/parameters/knn.search_models::query.routing' + - $ref: '#/components/parameters/knn.search_models::query.scroll' + - $ref: '#/components/parameters/knn.search_models::query.search_type' + - $ref: '#/components/parameters/knn.search_models::query.size' + - $ref: '#/components/parameters/knn.search_models::query.sort' + - $ref: '#/components/parameters/knn.search_models::query._source' + - $ref: '#/components/parameters/knn.search_models::query._source_excludes' + - $ref: '#/components/parameters/knn.search_models::query._source_includes' + - $ref: '#/components/parameters/knn.search_models::query.terminate_after' + - $ref: '#/components/parameters/knn.search_models::query.stats' + - $ref: '#/components/parameters/knn.search_models::query.suggest_field' + - $ref: '#/components/parameters/knn.search_models::query.suggest_mode' + - $ref: '#/components/parameters/knn.search_models::query.suggest_size' + - $ref: '#/components/parameters/knn.search_models::query.suggest_text' + - $ref: '#/components/parameters/knn.search_models::query.timeout' + - $ref: '#/components/parameters/knn.search_models::query.track_scores' + - $ref: '#/components/parameters/knn.search_models::query.track_total_hits' + - $ref: '#/components/parameters/knn.search_models::query.allow_partial_search_results' + - $ref: '#/components/parameters/knn.search_models::query.typed_keys' + - $ref: '#/components/parameters/knn.search_models::query.version' + - $ref: '#/components/parameters/knn.search_models::query.seq_no_primary_term' + - $ref: '#/components/parameters/knn.search_models::query.request_cache' + - $ref: '#/components/parameters/knn.search_models::query.batched_reduce_size' + - $ref: '#/components/parameters/knn.search_models::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/knn.search_models::query.pre_filter_shard_size' + - $ref: '#/components/parameters/knn.search_models::query.rest_total_hits_as_int' + responses: + '200': + $ref: '#/components/responses/knn.search_models@200' + post: + operationId: knn.search_models.1 + x-operation-group: knn.search_models + x-version-added: '1.0' + description: Use an OpenSearch query to search for models in the index. + parameters: + - $ref: '#/components/parameters/knn.search_models::query.analyzer' + - $ref: '#/components/parameters/knn.search_models::query.analyze_wildcard' + - $ref: '#/components/parameters/knn.search_models::query.ccs_minimize_roundtrips' + - $ref: '#/components/parameters/knn.search_models::query.default_operator' + - $ref: '#/components/parameters/knn.search_models::query.df' + - $ref: '#/components/parameters/knn.search_models::query.explain' + - $ref: '#/components/parameters/knn.search_models::query.stored_fields' + - $ref: '#/components/parameters/knn.search_models::query.docvalue_fields' + - $ref: '#/components/parameters/knn.search_models::query.from' + - $ref: '#/components/parameters/knn.search_models::query.ignore_unavailable' + - $ref: '#/components/parameters/knn.search_models::query.ignore_throttled' + - $ref: '#/components/parameters/knn.search_models::query.allow_no_indices' + - $ref: '#/components/parameters/knn.search_models::query.expand_wildcards' + - $ref: '#/components/parameters/knn.search_models::query.lenient' + - $ref: '#/components/parameters/knn.search_models::query.preference' + - $ref: '#/components/parameters/knn.search_models::query.q' + - $ref: '#/components/parameters/knn.search_models::query.routing' + - $ref: '#/components/parameters/knn.search_models::query.scroll' + - $ref: '#/components/parameters/knn.search_models::query.search_type' + - $ref: '#/components/parameters/knn.search_models::query.size' + - $ref: '#/components/parameters/knn.search_models::query.sort' + - $ref: '#/components/parameters/knn.search_models::query._source' + - $ref: '#/components/parameters/knn.search_models::query._source_excludes' + - $ref: '#/components/parameters/knn.search_models::query._source_includes' + - $ref: '#/components/parameters/knn.search_models::query.terminate_after' + - $ref: '#/components/parameters/knn.search_models::query.stats' + - $ref: '#/components/parameters/knn.search_models::query.suggest_field' + - $ref: '#/components/parameters/knn.search_models::query.suggest_mode' + - $ref: '#/components/parameters/knn.search_models::query.suggest_size' + - $ref: '#/components/parameters/knn.search_models::query.suggest_text' + - $ref: '#/components/parameters/knn.search_models::query.timeout' + - $ref: '#/components/parameters/knn.search_models::query.track_scores' + - $ref: '#/components/parameters/knn.search_models::query.track_total_hits' + - $ref: '#/components/parameters/knn.search_models::query.allow_partial_search_results' + - $ref: '#/components/parameters/knn.search_models::query.typed_keys' + - $ref: '#/components/parameters/knn.search_models::query.version' + - $ref: '#/components/parameters/knn.search_models::query.seq_no_primary_term' + - $ref: '#/components/parameters/knn.search_models::query.request_cache' + - $ref: '#/components/parameters/knn.search_models::query.batched_reduce_size' + - $ref: '#/components/parameters/knn.search_models::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/knn.search_models::query.pre_filter_shard_size' + - $ref: '#/components/parameters/knn.search_models::query.rest_total_hits_as_int' + requestBody: + $ref: '#/components/requestBodies/knn.search_models' + responses: + '200': + $ref: '#/components/responses/knn.search_models@200' + /_plugins/_knn/models/_train: + post: + operationId: knn.train_model.0 + x-operation-group: knn.train_model + x-version-added: '1.0' + description: Create and train a model that can be used for initializing k-NN native library indexes during indexing. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/knn/api/#train-model + parameters: + - $ref: '#/components/parameters/knn.train_model::query.preference' + requestBody: + $ref: '#/components/requestBodies/knn.train_model' + responses: + '200': + $ref: '#/components/responses/knn.train_model@200' + /_plugins/_knn/models/{model_id}: + delete: + operationId: knn.delete_model.0 + x-operation-group: knn.delete_model + x-version-added: '1.0' + description: Used to delete a particular model in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/knn/api/#delete-model + parameters: + - $ref: '#/components/parameters/knn.delete_model::path.model_id' + responses: + '200': + $ref: '#/components/responses/knn.delete_model@200' + get: + operationId: knn.get_model.0 + x-operation-group: knn.get_model + x-version-added: '1.0' + description: Used to retrieve information about models present in the cluster. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/knn/api/#get-model + parameters: + - $ref: '#/components/parameters/knn.get_model::path.model_id' + responses: + '200': + $ref: '#/components/responses/knn.get_model@200' + /_plugins/_knn/models/{model_id}/_train: + post: + operationId: knn.train_model.1 + x-operation-group: knn.train_model + x-version-added: '1.0' + description: Create and train a model that can be used for initializing k-NN native library indexes during indexing. + parameters: + - $ref: '#/components/parameters/knn.train_model::path.model_id' + - $ref: '#/components/parameters/knn.train_model::query.preference' + requestBody: + $ref: '#/components/requestBodies/knn.train_model' + responses: + '200': + $ref: '#/components/responses/knn.train_model@200' + /_plugins/_knn/stats: + get: + operationId: knn.stats.0 + x-operation-group: knn.stats + x-version-added: '1.0' + description: Provides information about the current status of the k-NN plugin. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/knn/api/#stats + parameters: + - $ref: '#/components/parameters/knn.stats::query.timeout' + responses: + '200': + $ref: '#/components/responses/knn.stats@200' + /_plugins/_knn/stats/{stat}: + get: + operationId: knn.stats.1 + x-operation-group: knn.stats + x-version-added: '1.0' + description: Provides information about the current status of the k-NN plugin. + parameters: + - $ref: '#/components/parameters/knn.stats::path.stat' + - $ref: '#/components/parameters/knn.stats::query.timeout' + responses: + '200': + $ref: '#/components/responses/knn.stats@200' + /_plugins/_knn/warmup/{index}: + get: + operationId: knn.warmup.0 + x-operation-group: knn.warmup + x-version-added: '1.0' + description: Preloads native library files into memory, reducing initial search latency for specified indexes + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/knn/api/#warmup-operation + parameters: + - $ref: '#/components/parameters/knn.warmup::path.index' + responses: + '200': + $ref: '#/components/responses/knn.warmup@200' + /_plugins/_knn/{node_id}/stats: + get: + operationId: knn.stats.2 + x-operation-group: knn.stats + x-version-added: '1.0' + description: Provides information about the current status of the k-NN plugin. + parameters: + - $ref: '#/components/parameters/knn.stats::path.node_id' + - $ref: '#/components/parameters/knn.stats::query.timeout' + responses: + '200': + $ref: '#/components/responses/knn.stats@200' + /_plugins/_knn/{node_id}/stats/{stat}: + get: + operationId: knn.stats.3 + x-operation-group: knn.stats + x-version-added: '1.0' + description: Provides information about the current status of the k-NN plugin. + parameters: + - $ref: '#/components/parameters/knn.stats::path.node_id' + - $ref: '#/components/parameters/knn.stats::path.stat' + - $ref: '#/components/parameters/knn.stats::query.timeout' + responses: + '200': + $ref: '#/components/responses/knn.stats@200' + /_plugins/_notifications/configs: + delete: + operationId: notifications.delete_configs.0 + x-operation-group: notifications.delete_configs + x-version-added: '2.2' + description: Delete multiple channel configurations. + externalDocs: + url: https://opensearch.org/docs/latest/observing-your-data/notifications/api/#delete-channel-configuration + parameters: + - $ref: '#/components/parameters/notifications.delete_configs::query.config_id' + - $ref: '#/components/parameters/notifications.delete_configs::query.config_id_list' + responses: + '200': + $ref: '#/components/responses/notifications.delete_configs@200' + get: + operationId: notifications.get_configs.0 + x-operation-group: notifications.get_configs + x-version-added: '2.0' + description: Get multiple channel configurations with filtering. + externalDocs: + url: https://opensearch.org/docs/latest/observing-your-data/notifications/api/#list-all-notification-configurations + parameters: + - $ref: '#/components/parameters/notifications.get_configs::query.last_updated_time_ms' + - $ref: '#/components/parameters/notifications.get_configs::query.created_time_ms' + - $ref: '#/components/parameters/notifications.get_configs::query.config_type' + - $ref: '#/components/parameters/notifications.get_configs::query.email.email_account_id' + - $ref: '#/components/parameters/notifications.get_configs::query.email.email_group_id_list' + - $ref: '#/components/parameters/notifications.get_configs::query.smtp_account.method' + - $ref: '#/components/parameters/notifications.get_configs::query.ses_account.region' + - $ref: '#/components/parameters/notifications.get_configs::query.name' + - $ref: '#/components/parameters/notifications.get_configs::query.name.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.description' + - $ref: '#/components/parameters/notifications.get_configs::query.description.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.slack.url' + - $ref: '#/components/parameters/notifications.get_configs::query.slack.url.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.chime.url' + - $ref: '#/components/parameters/notifications.get_configs::query.chime.url.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.microsoft_teams.url' + - $ref: '#/components/parameters/notifications.get_configs::query.microsoft_teams.url.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.webhook.url' + - $ref: '#/components/parameters/notifications.get_configs::query.webhook.url.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.smtp_account.host' + - $ref: '#/components/parameters/notifications.get_configs::query.smtp_account.host.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.smtp_account.from_address' + - $ref: '#/components/parameters/notifications.get_configs::query.smtp_account.from_address.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.sns.topic_arn' + - $ref: '#/components/parameters/notifications.get_configs::query.sns.topic_arn.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.sns.role_arn' + - $ref: '#/components/parameters/notifications.get_configs::query.sns.role_arn.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.ses_account.role_arn' + - $ref: '#/components/parameters/notifications.get_configs::query.ses_account.role_arn.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.ses_account.from_address' + - $ref: '#/components/parameters/notifications.get_configs::query.ses_account.from_address.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.is_enabled' + - $ref: '#/components/parameters/notifications.get_configs::query.email.recipient_list.recipient' + - $ref: '#/components/parameters/notifications.get_configs::query.email.recipient_list.recipient.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.email_group.recipient_list.recipient' + - $ref: '#/components/parameters/notifications.get_configs::query.email_group.recipient_list.recipient.keyword' + - $ref: '#/components/parameters/notifications.get_configs::query.query' + - $ref: '#/components/parameters/notifications.get_configs::query.text_query' + requestBody: + $ref: '#/components/requestBodies/notifications.get_configs' + responses: + '200': + $ref: '#/components/responses/notifications.get_configs@200' + post: + operationId: notifications.create_config.0 + x-operation-group: notifications.create_config + x-version-added: '2.0' + description: Create channel configuration. + externalDocs: + url: https://opensearch.org/docs/latest/observing-your-data/notifications/api/#create-channel-configuration + requestBody: + $ref: '#/components/requestBodies/notifications.create_config' + responses: + '200': + $ref: '#/components/responses/notifications.create_config@200' + /_plugins/_notifications/configs/{config_id}: + delete: + operationId: notifications.delete_config.0 + x-operation-group: notifications.delete_config + x-version-added: '2.0' + description: Delete a channel configuration. + externalDocs: + url: https://opensearch.org/docs/latest/observing-your-data/notifications/api/#delete-channel-configuration + parameters: + - $ref: '#/components/parameters/notifications.delete_config::path.config_id' + responses: + '200': + $ref: '#/components/responses/notifications.delete_config@200' + get: + operationId: notifications.get_config.0 + x-operation-group: notifications.get_config + x-version-added: '2.0' + description: Get a specific channel configuration. + parameters: + - $ref: '#/components/parameters/notifications.get_config::path.config_id' + responses: + '200': + $ref: '#/components/responses/notifications.get_config@200' + put: + operationId: notifications.update_config.0 + x-operation-group: notifications.update_config + x-version-added: '2.0' + description: Update channel configuration. + externalDocs: + url: https://opensearch.org/docs/latest/observing-your-data/notifications/api/#update-channel-configuration + parameters: + - $ref: '#/components/parameters/notifications.update_config::path.config_id' + requestBody: + $ref: '#/components/requestBodies/notifications.update_config' + responses: + '200': + $ref: '#/components/responses/notifications.update_config@200' + /_plugins/_notifications/feature/test/{config_id}: + get: + operationId: notifications.send_test.0 + x-operation-group: notifications.send_test + deprecated: true + x-deprecation-message: Use the POST method instead. + x-version-added: '2.0' + x-version-deprecated: '2.3' + description: Send a test notification. + externalDocs: + url: https://opensearch.org/docs/latest/observing-your-data/notifications/api/#send-test-notification + parameters: + - $ref: '#/components/parameters/notifications.send_test::path.config_id' + responses: + '200': + $ref: '#/components/responses/notifications.send_test@200' + post: + operationId: notifications.send_test.1 + x-operation-group: notifications.send_test + x-version-added: '2.0' + description: Send a test notification. + externalDocs: + url: https://opensearch.org/docs/latest/observing-your-data/notifications/api/#send-test-notification + parameters: + - $ref: '#/components/parameters/notifications.send_test::path.config_id' + responses: + '200': + $ref: '#/components/responses/notifications.send_test@200' + /_plugins/_notifications/features: + get: + operationId: notifications.list_features.0 + x-operation-group: notifications.list_features + x-version-added: '2.0' + description: List supported channel configurations. + externalDocs: + url: https://opensearch.org/docs/latest/observing-your-data/notifications/api/#list-supported-channel-configurations + responses: + '200': + $ref: '#/components/responses/notifications.list_features@200' + /_plugins/_security/api/account: + get: + operationId: security.get_account_details.0 + x-operation-group: security.get_account_details + x-version-added: '1.0' + description: Returns account details for the current user. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-account-details + responses: + '200': + $ref: '#/components/responses/security.get_account_details@200' + put: + operationId: security.change_password.0 + x-operation-group: security.change_password + x-version-added: '1.0' + description: Changes the password for the current user. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#change-password + requestBody: + $ref: '#/components/requestBodies/security.change_password' + responses: + '200': + $ref: '#/components/responses/security.change_password@200' + /_plugins/_security/api/actiongroups: + get: + operationId: security.get_action_groups.0 + x-operation-group: security.get_action_groups + x-version-added: '1.0' + description: Retrieves all action groups. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-action-groups + responses: + '200': + $ref: '#/components/responses/security.get_action_groups@200' + patch: + operationId: security.patch_action_groups.0 + x-operation-group: security.patch_action_groups + x-version-added: '1.0' + description: Creates, updates, or deletes multiple action groups in a single call. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#patch-action-groups + requestBody: + $ref: '#/components/requestBodies/security.patch_action_groups' + responses: + '200': + $ref: '#/components/responses/security.patch_action_groups@200' + /_plugins/_security/api/actiongroups/{action_group}: + delete: + operationId: security.delete_action_group.0 + x-operation-group: security.delete_action_group + x-version-added: '1.0' + description: Delete a specified action group. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#delete-action-group + parameters: + - $ref: '#/components/parameters/security.delete_action_group::path.action_group' + responses: + '200': + $ref: '#/components/responses/security.delete_action_group@200' + get: + operationId: security.get_action_group.0 + x-operation-group: security.get_action_group + x-version-added: '1.0' + description: Retrieves one action group. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-action-group + parameters: + - $ref: '#/components/parameters/security.get_action_group::path.action_group' + responses: + '200': + $ref: '#/components/responses/security.get_action_group@200' + patch: + operationId: security.patch_action_group.0 + x-operation-group: security.patch_action_group + x-version-added: '1.0' + description: Updates individual attributes of an action group. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#patch-action-group + parameters: + - $ref: '#/components/parameters/security.patch_action_group::path.action_group' + requestBody: + $ref: '#/components/requestBodies/security.patch_action_group' + responses: + '200': + $ref: '#/components/responses/security.patch_action_group@200' + put: + operationId: security.create_action_group.0 + x-operation-group: security.create_action_group + x-version-added: '1.0' + description: Creates or replaces the specified action group. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#create-action-group + parameters: + - $ref: '#/components/parameters/security.create_action_group::path.action_group' + requestBody: + $ref: '#/components/requestBodies/security.create_action_group' + responses: + '200': + $ref: '#/components/responses/security.create_action_group@200' + /_plugins/_security/api/audit: + get: + operationId: security.get_audit_configuration.0 + x-operation-group: security.get_audit_configuration + x-version-added: '1.0' + description: Retrieves the audit configuration. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#audit-logs + responses: + '200': + $ref: '#/components/responses/security.get_audit_configuration@200' + patch: + operationId: security.patch_audit_configuration.0 + x-operation-group: security.patch_audit_configuration + x-version-added: '1.0' + description: A PATCH call is used to update specified fields in the audit configuration. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#audit-logs + requestBody: + $ref: '#/components/requestBodies/security.patch_audit_configuration' + responses: + '200': + $ref: '#/components/responses/security.patch_audit_configuration@200' + /_plugins/_security/api/audit/config: + put: + operationId: security.update_audit_configuration.0 + x-operation-group: security.update_audit_configuration + x-version-added: '1.0' + description: Updates the audit configuration. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#audit-logs + requestBody: + $ref: '#/components/requestBodies/security.update_audit_configuration' + responses: + '200': + $ref: '#/components/responses/security.update_audit_configuration@200' + /_plugins/_security/api/cache: + delete: + operationId: security.flush_cache.0 + x-operation-group: security.flush_cache + x-version-added: '1.0' + description: Flushes the Security plugin user, authentication, and authorization cache. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#flush-cache + responses: + '200': + $ref: '#/components/responses/security.flush_cache@200' + /_plugins/_security/api/internalusers: + get: + operationId: security.get_users.0 + x-operation-group: security.get_users + x-version-added: '1.0' + description: Retrieve all internal users. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-users + responses: + '200': + $ref: '#/components/responses/security.get_users@200' + patch: + operationId: security.patch_users.0 + x-operation-group: security.patch_users + x-version-added: '1.0' + description: Creates, updates, or deletes multiple internal users in a single call. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#patch-users + requestBody: + $ref: '#/components/requestBodies/security.patch_users' + responses: + '200': + $ref: '#/components/responses/security.patch_users@200' + /_plugins/_security/api/internalusers/{username}: + delete: + operationId: security.delete_user.0 + x-operation-group: security.delete_user + x-version-added: '1.0' + description: Delete the specified user. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#delete-user + parameters: + - $ref: '#/components/parameters/security.delete_user::path.username' + responses: + '200': + $ref: '#/components/responses/security.delete_user@200' + get: + operationId: security.get_user.0 + x-operation-group: security.get_user + x-version-added: '1.0' + description: Retrieve one internal user. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-user + parameters: + - $ref: '#/components/parameters/security.get_user::path.username' + responses: + '200': + $ref: '#/components/responses/security.get_user@200' + patch: + operationId: security.patch_user.0 + x-operation-group: security.patch_user + x-version-added: '1.0' + description: Updates individual attributes of an internal user. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#patch-user + parameters: + - $ref: '#/components/parameters/security.patch_user::path.username' + requestBody: + $ref: '#/components/requestBodies/security.patch_user' + responses: + '200': + $ref: '#/components/responses/security.patch_user@200' + put: + operationId: security.create_user.0 + x-operation-group: security.create_user + x-version-added: '1.0' + description: Creates or replaces the specified user. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#create-user + parameters: + - $ref: '#/components/parameters/security.create_user::path.username' + requestBody: + $ref: '#/components/requestBodies/security.create_user' + responses: + '200': + $ref: '#/components/responses/security.create_user@200' + /_plugins/_security/api/nodesdn: + get: + operationId: security.get_distinguished_names.0 + x-operation-group: security.get_distinguished_names + x-version-added: '1.0' + description: Retrieves all distinguished names in the allow list. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-distinguished-names + responses: + '200': + $ref: '#/components/responses/security.get_distinguished_names@200' + patch: + operationId: security.patch_distinguished_names.0 + x-operation-group: security.patch_distinguished_names + x-version-added: '1.0' + description: Bulk update of distinguished names. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#update-all-distinguished-names + requestBody: + $ref: '#/components/requestBodies/security.patch_distinguished_names' + responses: + '200': + $ref: '#/components/responses/security.patch_distinguished_names@200' + /_plugins/_security/api/nodesdn/{cluster_name}: + delete: + operationId: security.delete_distinguished_names.0 + x-operation-group: security.delete_distinguished_names + x-version-added: '1.0' + description: Deletes all distinguished names in the specified cluster’s or node’s allow list. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#delete-distinguished-names + parameters: + - $ref: '#/components/parameters/security.delete_distinguished_names::path.cluster_name' + responses: + '200': + $ref: '#/components/responses/security.delete_distinguished_names@200' + get: + operationId: security.get_distinguished_names.1 + x-operation-group: security.get_distinguished_names + x-version-added: '1.0' + description: Retrieve distinguished names of a specified cluster. + parameters: + - $ref: '#/components/parameters/security.get_distinguished_names::path.cluster_name' + responses: + '200': + $ref: '#/components/responses/security.get_distinguished_names@200' + put: + operationId: security.update_distinguished_names.0 + x-operation-group: security.update_distinguished_names + x-version-added: '1.0' + description: Adds or updates the specified distinguished names in the cluster’s or node’s allow list. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#update-distinguished-names + parameters: + - $ref: '#/components/parameters/security.update_distinguished_names::path.cluster_name' + requestBody: + $ref: '#/components/requestBodies/security.update_distinguished_names' + responses: + '200': + $ref: '#/components/responses/security.update_distinguished_names@200' + /_plugins/_security/api/roles: + patch: + operationId: security.patch_roles.0 + x-operation-group: security.patch_roles + x-version-added: '1.0' + description: Creates, updates, or deletes multiple roles in a single call. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#patch-roles + requestBody: + $ref: '#/components/requestBodies/security.patch_roles' + responses: + '200': + $ref: '#/components/responses/security.patch_roles@200' + /_plugins/_security/api/roles/: + get: + operationId: security.get_roles.0 + x-operation-group: security.get_roles + x-version-added: '1.0' + description: Retrieves all roles. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-roles + responses: + '200': + $ref: '#/components/responses/security.get_roles@200' + /_plugins/_security/api/roles/{role}: + delete: + operationId: security.delete_role.0 + x-operation-group: security.delete_role + x-version-added: '1.0' + description: Delete the specified role. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#delete-role + parameters: + - $ref: '#/components/parameters/security.delete_role::path.role' + responses: + '200': + $ref: '#/components/responses/security.delete_role@200' + get: + operationId: security.get_role.0 + x-operation-group: security.get_role + x-version-added: '1.0' + description: Retrieves one role. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-role + parameters: + - $ref: '#/components/parameters/security.get_role::path.role' + responses: + '200': + $ref: '#/components/responses/security.get_role@200' + patch: + operationId: security.patch_role.0 + x-operation-group: security.patch_role + x-version-added: '1.0' + description: Updates individual attributes of a role. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#patch-role + parameters: + - $ref: '#/components/parameters/security.patch_role::path.role' + requestBody: + $ref: '#/components/requestBodies/security.patch_role' + responses: + '200': + $ref: '#/components/responses/security.patch_role@200' + put: + operationId: security.create_role.0 + x-operation-group: security.create_role + x-version-added: '1.0' + description: Creates or replaces the specified role. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#create-role + parameters: + - $ref: '#/components/parameters/security.create_role::path.role' + requestBody: + $ref: '#/components/requestBodies/security.create_role' + responses: + '200': + $ref: '#/components/responses/security.create_role@200' + /_plugins/_security/api/rolesmapping: + get: + operationId: security.get_role_mappings.0 + x-operation-group: security.get_role_mappings + x-version-added: '1.0' + description: Retrieves all role mappings. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-role-mappings + responses: + '200': + $ref: '#/components/responses/security.get_role_mappings@200' + patch: + operationId: security.patch_role_mappings.0 + x-operation-group: security.patch_role_mappings + x-version-added: '1.0' + description: Creates or updates multiple role mappings in a single call. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#patch-role-mappings + requestBody: + $ref: '#/components/requestBodies/security.patch_role_mappings' + responses: + '200': + $ref: '#/components/responses/security.patch_role_mappings@200' + /_plugins/_security/api/rolesmapping/{role}: + delete: + operationId: security.delete_role_mapping.0 + x-operation-group: security.delete_role_mapping + x-version-added: '1.0' + description: Deletes the specified role mapping. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#delete-role-mapping + parameters: + - $ref: '#/components/parameters/security.delete_role_mapping::path.role' + responses: + '200': + $ref: '#/components/responses/security.delete_role_mapping@200' + get: + operationId: security.get_role_mapping.0 + x-operation-group: security.get_role_mapping + x-version-added: '1.0' + description: Retrieves one role mapping. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-role-mapping + parameters: + - $ref: '#/components/parameters/security.get_role_mapping::path.role' + responses: + '200': + $ref: '#/components/responses/security.get_role_mapping@200' + patch: + operationId: security.patch_role_mapping.0 + x-operation-group: security.patch_role_mapping + x-version-added: '1.0' + description: Updates individual attributes of a role mapping. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#patch-role-mapping + parameters: + - $ref: '#/components/parameters/security.patch_role_mapping::path.role' + requestBody: + $ref: '#/components/requestBodies/security.patch_role_mapping' + responses: + '200': + $ref: '#/components/responses/security.patch_role_mapping@200' + put: + operationId: security.create_role_mapping.0 + x-operation-group: security.create_role_mapping + x-version-added: '1.0' + description: Creates or replaces the specified role mapping. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#create-role-mapping + parameters: + - $ref: '#/components/parameters/security.create_role_mapping::path.role' + requestBody: + $ref: '#/components/requestBodies/security.create_role_mapping' + responses: + '200': + $ref: '#/components/responses/security.create_role_mapping@200' + /_plugins/_security/api/securityconfig: + get: + operationId: security.get_configuration.0 + x-operation-group: security.get_configuration + x-version-added: '1.0' + description: Returns the current Security plugin configuration in JSON format. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#get-configuration + responses: + '200': + $ref: '#/components/responses/security.get_configuration@200' + patch: + operationId: security.patch_configuration.0 + x-operation-group: security.patch_configuration + x-version-added: '1.0' + description: A PATCH call is used to update the existing configuration using the REST API. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#patch-configuration + requestBody: + $ref: '#/components/requestBodies/security.patch_configuration' + responses: + '200': + $ref: '#/components/responses/security.patch_configuration@200' + /_plugins/_security/api/securityconfig/config: + put: + operationId: security.update_configuration.0 + x-operation-group: security.update_configuration + x-version-added: '1.0' + description: Adds or updates the existing configuration using the REST API. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#update-configuration + requestBody: + $ref: '#/components/requestBodies/security.update_configuration' + responses: + '200': + $ref: '#/components/responses/security.update_configuration@200' + /_plugins/_security/api/ssl/certs: + get: + operationId: security.get_certificates.0 + x-operation-group: security.get_certificates + x-version-added: '1.0' + description: Retrieves the cluster’s security certificates. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#get-certificates + responses: + '200': + $ref: '#/components/responses/security.get_certificates@200' + /_plugins/_security/api/ssl/http/reloadcerts: + put: + operationId: security.reload_http_certificates.0 + x-operation-group: security.reload_http_certificates + x-version-added: '1.0' + description: Reload HTTP layer communication certificates. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#reload-http-certificates + responses: + '200': + $ref: '#/components/responses/security.reload_http_certificates@200' + /_plugins/_security/api/ssl/transport/reloadcerts: + put: + operationId: security.reload_transport_certificates.0 + x-operation-group: security.reload_transport_certificates + x-version-added: '1.0' + description: Reload transport layer communication certificates. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#reload-transport-certificates + responses: + '200': + $ref: '#/components/responses/security.reload_transport_certificates@200' + /_plugins/_security/api/tenants/: + get: + operationId: security.get_tenants.0 + x-operation-group: security.get_tenants + x-version-added: '1.0' + description: Retrieves all tenants. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#get-tenants + responses: + '200': + $ref: '#/components/responses/security.get_tenants@200' + patch: + operationId: security.patch_tenants.0 + x-operation-group: security.patch_tenants + x-version-added: '1.0' + description: Add, delete, or modify multiple tenants in a single call. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#patch-tenants + requestBody: + $ref: '#/components/requestBodies/security.patch_tenants' + responses: + '200': + $ref: '#/components/responses/security.patch_tenants@200' + /_plugins/_security/api/tenants/{tenant}: + delete: + operationId: security.delete_tenant.0 + x-operation-group: security.delete_tenant + x-version-added: '1.0' + description: Delete the specified tenant. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#delete-action-group + parameters: + - $ref: '#/components/parameters/security.delete_tenant::path.tenant' + responses: + '200': + $ref: '#/components/responses/security.delete_tenant@200' + get: + operationId: security.get_tenant.0 + x-operation-group: security.get_tenant + x-version-added: '1.0' + description: Retrieves one tenant. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#get-tenant + parameters: + - $ref: '#/components/parameters/security.get_tenant::path.tenant' + responses: + '200': + $ref: '#/components/responses/security.get_tenant@200' + patch: + operationId: security.patch_tenant.0 + x-operation-group: security.patch_tenant + x-version-added: '1.0' + description: Add, delete, or modify a single tenant. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#patch-tenant + parameters: + - $ref: '#/components/parameters/security.patch_tenant::path.tenant' + requestBody: + $ref: '#/components/requestBodies/security.patch_tenant' + responses: + '200': + $ref: '#/components/responses/security.patch_tenant@200' + put: + operationId: security.create_tenant.0 + x-operation-group: security.create_tenant + x-version-added: '1.0' + description: Creates or replaces the specified tenant. + externalDocs: + url: https://opensearch.org/docs/2.7/security/access-control/api/#create-tenant + parameters: + - $ref: '#/components/parameters/security.create_tenant::path.tenant' + requestBody: + $ref: '#/components/requestBodies/security.create_tenant' + responses: + '200': + $ref: '#/components/responses/security.create_tenant@200' + /_plugins/_security/health: + get: + operationId: security.health.0 + x-operation-group: security.health + x-version-added: '1.0' + description: Checks to see if the Security plugin is up and running. + externalDocs: + url: https://opensearch.org/docs/latest/security/access-control/api/#health-check + responses: + '200': + $ref: '#/components/responses/security.health@200' + /_rank_eval: + get: + operationId: rank_eval.0 + x-operation-group: rank_eval + x-version-added: '1.0' + description: Allows to evaluate the quality of ranked search results over a set of typical search queries. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/rank-eval/ + parameters: + - $ref: '#/components/parameters/rank_eval::query.ignore_unavailable' + - $ref: '#/components/parameters/rank_eval::query.allow_no_indices' + - $ref: '#/components/parameters/rank_eval::query.expand_wildcards' + - $ref: '#/components/parameters/rank_eval::query.search_type' + requestBody: + $ref: '#/components/requestBodies/rank_eval' + responses: + '200': + $ref: '#/components/responses/rank_eval@200' + post: + operationId: rank_eval.1 + x-operation-group: rank_eval + x-version-added: '1.0' + description: Allows to evaluate the quality of ranked search results over a set of typical search queries. + parameters: + - $ref: '#/components/parameters/rank_eval::query.ignore_unavailable' + - $ref: '#/components/parameters/rank_eval::query.allow_no_indices' + - $ref: '#/components/parameters/rank_eval::query.expand_wildcards' + - $ref: '#/components/parameters/rank_eval::query.search_type' + requestBody: + $ref: '#/components/requestBodies/rank_eval' + responses: + '200': + $ref: '#/components/responses/rank_eval@200' + /_recovery: + get: + operationId: indices.recovery.0 + x-operation-group: indices.recovery + x-version-added: '1.0' + description: Returns information about ongoing index shard recoveries. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.recovery::query.detailed' + - $ref: '#/components/parameters/indices.recovery::query.active_only' + responses: + '200': + $ref: '#/components/responses/indices.recovery@200' + /_refresh: + get: + operationId: indices.refresh.0 + x-operation-group: indices.refresh + x-version-added: '1.0' + description: Performs the refresh operation in one or more indices. + parameters: + - $ref: '#/components/parameters/indices.refresh::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.refresh::query.allow_no_indices' + - $ref: '#/components/parameters/indices.refresh::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.refresh@200' + post: + operationId: indices.refresh.1 + x-operation-group: indices.refresh + x-version-added: '1.0' + description: Performs the refresh operation in one or more indices. + externalDocs: + url: https://opensearch.org/docs/latest/tuning-your-cluster/availability-and-recovery/remote-store/index/#refresh-level-and-request-level-durability + parameters: + - $ref: '#/components/parameters/indices.refresh::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.refresh::query.allow_no_indices' + - $ref: '#/components/parameters/indices.refresh::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.refresh@200' + /_reindex: + post: + operationId: reindex.0 + x-operation-group: reindex + x-version-added: '1.0' + description: |- + Allows to copy documents from one index to another, optionally filtering the source + documents by a query, changing the destination index settings, or fetching the + documents from a remote cluster. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/reindex-data/ + parameters: + - $ref: '#/components/parameters/reindex::query.refresh' + - $ref: '#/components/parameters/reindex::query.timeout' + - $ref: '#/components/parameters/reindex::query.wait_for_active_shards' + - $ref: '#/components/parameters/reindex::query.wait_for_completion' + - $ref: '#/components/parameters/reindex::query.requests_per_second' + - $ref: '#/components/parameters/reindex::query.scroll' + - $ref: '#/components/parameters/reindex::query.slices' + - $ref: '#/components/parameters/reindex::query.max_docs' + requestBody: + $ref: '#/components/requestBodies/reindex' + responses: + '200': + $ref: '#/components/responses/reindex@200' + /_reindex/{task_id}/_rethrottle: + post: + operationId: reindex_rethrottle.0 + x-operation-group: reindex_rethrottle + x-version-added: '1.0' + description: Changes the number of requests per second for a particular Reindex operation. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/reindex_rethrottle::path.task_id' + - $ref: '#/components/parameters/reindex_rethrottle::query.requests_per_second' + responses: + '200': + $ref: '#/components/responses/reindex_rethrottle@200' + /_remote/info: + get: + operationId: cluster.remote_info.0 + x-operation-group: cluster.remote_info + x-version-added: '1.0' + description: Returns the information about configured remote clusters. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/remote-info/ + parameters: [] + responses: + '200': + $ref: '#/components/responses/cluster.remote_info@200' + /_remotestore/_restore: + post: + operationId: remote_store.restore.0 + x-operation-group: remote_store.restore + x-version-added: '1.0' + description: Restores from remote store. + externalDocs: + url: https://opensearch.org/docs/latest/opensearch/remote/#restoring-from-a-backup + parameters: + - $ref: '#/components/parameters/remote_store.restore::query.cluster_manager_timeout' + - $ref: '#/components/parameters/remote_store.restore::query.wait_for_completion' + requestBody: + $ref: '#/components/requestBodies/remote_store.restore' + responses: + '200': + $ref: '#/components/responses/remote_store.restore@200' + /_render/template: + get: + operationId: render_search_template.0 + x-operation-group: render_search_template + x-version-added: '1.0' + description: Allows to use the Mustache language to pre-render a search definition. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/search-template/ + parameters: [] + requestBody: + $ref: '#/components/requestBodies/render_search_template' + responses: + '200': + $ref: '#/components/responses/render_search_template@200' + post: + operationId: render_search_template.1 + x-operation-group: render_search_template + x-version-added: '1.0' + description: Allows to use the Mustache language to pre-render a search definition. + parameters: [] + requestBody: + $ref: '#/components/requestBodies/render_search_template' + responses: + '200': + $ref: '#/components/responses/render_search_template@200' + /_render/template/{id}: + get: + operationId: render_search_template.2 + x-operation-group: render_search_template + x-version-added: '1.0' + description: Allows to use the Mustache language to pre-render a search definition. + parameters: + - $ref: '#/components/parameters/render_search_template::path.id' + requestBody: + $ref: '#/components/requestBodies/render_search_template' + responses: + '200': + $ref: '#/components/responses/render_search_template@200' + post: + operationId: render_search_template.3 + x-operation-group: render_search_template + x-version-added: '1.0' + description: Allows to use the Mustache language to pre-render a search definition. + parameters: + - $ref: '#/components/parameters/render_search_template::path.id' + requestBody: + $ref: '#/components/requestBodies/render_search_template' + responses: + '200': + $ref: '#/components/responses/render_search_template@200' + /_resolve/index/{name}: + get: + operationId: indices.resolve_index.0 + x-operation-group: indices.resolve_index + x-version-added: '1.0' + description: Returns information about any matching indices, aliases, and data streams. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.resolve_index::path.name' + - $ref: '#/components/parameters/indices.resolve_index::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.resolve_index@200' + /_script_context: + get: + operationId: get_script_context.0 + x-operation-group: get_script_context + x-version-added: '1.0' + description: Returns all script contexts. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/script-apis/get-script-contexts/ + parameters: [] + responses: + '200': + $ref: '#/components/responses/get_script_context@200' + /_script_language: + get: + operationId: get_script_languages.0 + x-operation-group: get_script_languages + x-version-added: '1.0' + description: Returns available script types, languages and contexts. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/script-apis/get-script-language/ + parameters: [] + responses: + '200': + $ref: '#/components/responses/get_script_languages@200' + /_scripts/painless/_execute: + get: + operationId: scripts_painless_execute.0 + x-operation-group: scripts_painless_execute + x-version-added: '1.0' + description: Allows an arbitrary script to be executed and a result to be returned. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/script-apis/exec-script/ + parameters: [] + requestBody: + $ref: '#/components/requestBodies/scripts_painless_execute' + responses: + '200': + $ref: '#/components/responses/scripts_painless_execute@200' + post: + operationId: scripts_painless_execute.1 + x-operation-group: scripts_painless_execute + x-version-added: '1.0' + description: Allows an arbitrary script to be executed and a result to be returned. + parameters: [] + requestBody: + $ref: '#/components/requestBodies/scripts_painless_execute' + responses: + '200': + $ref: '#/components/responses/scripts_painless_execute@200' + /_scripts/{id}: + delete: + operationId: delete_script.0 + x-operation-group: delete_script + x-version-added: '1.0' + description: Deletes a script. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/script-apis/delete-script/ + parameters: + - $ref: '#/components/parameters/delete_script::path.id' + - $ref: '#/components/parameters/delete_script::query.timeout' + - $ref: '#/components/parameters/delete_script::query.master_timeout' + - $ref: '#/components/parameters/delete_script::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/delete_script@200' + get: + operationId: get_script.0 + x-operation-group: get_script + x-version-added: '1.0' + description: Returns a script. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/script-apis/get-stored-script/ + parameters: + - $ref: '#/components/parameters/get_script::path.id' + - $ref: '#/components/parameters/get_script::query.master_timeout' + - $ref: '#/components/parameters/get_script::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/get_script@200' + post: + operationId: put_script.0 + x-operation-group: put_script + x-version-added: '1.0' + description: Creates or updates a script. + parameters: + - $ref: '#/components/parameters/put_script::path.id' + - $ref: '#/components/parameters/put_script::query.timeout' + - $ref: '#/components/parameters/put_script::query.master_timeout' + - $ref: '#/components/parameters/put_script::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/put_script' + responses: + '200': + $ref: '#/components/responses/put_script@200' + put: + operationId: put_script.1 + x-operation-group: put_script + x-version-added: '1.0' + description: Creates or updates a script. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/script-apis/create-stored-script/ + parameters: + - $ref: '#/components/parameters/put_script::path.id' + - $ref: '#/components/parameters/put_script::query.timeout' + - $ref: '#/components/parameters/put_script::query.master_timeout' + - $ref: '#/components/parameters/put_script::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/put_script' + responses: + '200': + $ref: '#/components/responses/put_script@200' + /_scripts/{id}/{context}: + post: + operationId: put_script.2 + x-operation-group: put_script + x-version-added: '1.0' + description: Creates or updates a script. + parameters: + - $ref: '#/components/parameters/put_script::path.id' + - $ref: '#/components/parameters/put_script::path.context' + - $ref: '#/components/parameters/put_script::query.timeout' + - $ref: '#/components/parameters/put_script::query.master_timeout' + - $ref: '#/components/parameters/put_script::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/put_script' + responses: + '200': + $ref: '#/components/responses/put_script@200' + put: + operationId: put_script.3 + x-operation-group: put_script + x-version-added: '1.0' + description: Creates or updates a script. + parameters: + - $ref: '#/components/parameters/put_script::path.id' + - $ref: '#/components/parameters/put_script::path.context' + - $ref: '#/components/parameters/put_script::query.timeout' + - $ref: '#/components/parameters/put_script::query.master_timeout' + - $ref: '#/components/parameters/put_script::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/put_script' + responses: + '200': + $ref: '#/components/responses/put_script@200' + /_search: + get: + operationId: search.0 + x-operation-group: search + x-version-added: '1.0' + description: Returns results matching a query. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/search/ + parameters: + - $ref: '#/components/parameters/search::query.analyzer' + - $ref: '#/components/parameters/search::query.analyze_wildcard' + - $ref: '#/components/parameters/search::query.ccs_minimize_roundtrips' + - $ref: '#/components/parameters/search::query.default_operator' + - $ref: '#/components/parameters/search::query.df' + - $ref: '#/components/parameters/search::query.explain' + - $ref: '#/components/parameters/search::query.stored_fields' + - $ref: '#/components/parameters/search::query.docvalue_fields' + - $ref: '#/components/parameters/search::query.from' + - $ref: '#/components/parameters/search::query.ignore_unavailable' + - $ref: '#/components/parameters/search::query.ignore_throttled' + - $ref: '#/components/parameters/search::query.allow_no_indices' + - $ref: '#/components/parameters/search::query.expand_wildcards' + - $ref: '#/components/parameters/search::query.lenient' + - $ref: '#/components/parameters/search::query.preference' + - $ref: '#/components/parameters/search::query.q' + - $ref: '#/components/parameters/search::query.routing' + - $ref: '#/components/parameters/search::query.scroll' + - $ref: '#/components/parameters/search::query.search_type' + - $ref: '#/components/parameters/search::query.size' + - $ref: '#/components/parameters/search::query.sort' + - $ref: '#/components/parameters/search::query._source' + - $ref: '#/components/parameters/search::query._source_excludes' + - $ref: '#/components/parameters/search::query._source_includes' + - $ref: '#/components/parameters/search::query.terminate_after' + - $ref: '#/components/parameters/search::query.stats' + - $ref: '#/components/parameters/search::query.suggest_field' + - $ref: '#/components/parameters/search::query.suggest_mode' + - $ref: '#/components/parameters/search::query.suggest_size' + - $ref: '#/components/parameters/search::query.suggest_text' + - $ref: '#/components/parameters/search::query.timeout' + - $ref: '#/components/parameters/search::query.track_scores' + - $ref: '#/components/parameters/search::query.track_total_hits' + - $ref: '#/components/parameters/search::query.allow_partial_search_results' + - $ref: '#/components/parameters/search::query.typed_keys' + - $ref: '#/components/parameters/search::query.version' + - $ref: '#/components/parameters/search::query.seq_no_primary_term' + - $ref: '#/components/parameters/search::query.request_cache' + - $ref: '#/components/parameters/search::query.batched_reduce_size' + - $ref: '#/components/parameters/search::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/search::query.pre_filter_shard_size' + - $ref: '#/components/parameters/search::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/search::query.search_pipeline' + - $ref: '#/components/parameters/search::query.include_named_queries_score' + requestBody: + $ref: '#/components/requestBodies/search' + responses: + '200': + $ref: '#/components/responses/search@200' + post: + operationId: search.1 + x-operation-group: search + x-version-added: '1.0' + description: Returns results matching a query. + parameters: + - $ref: '#/components/parameters/search::query.analyzer' + - $ref: '#/components/parameters/search::query.analyze_wildcard' + - $ref: '#/components/parameters/search::query.ccs_minimize_roundtrips' + - $ref: '#/components/parameters/search::query.default_operator' + - $ref: '#/components/parameters/search::query.df' + - $ref: '#/components/parameters/search::query.explain' + - $ref: '#/components/parameters/search::query.stored_fields' + - $ref: '#/components/parameters/search::query.docvalue_fields' + - $ref: '#/components/parameters/search::query.from' + - $ref: '#/components/parameters/search::query.ignore_unavailable' + - $ref: '#/components/parameters/search::query.ignore_throttled' + - $ref: '#/components/parameters/search::query.allow_no_indices' + - $ref: '#/components/parameters/search::query.expand_wildcards' + - $ref: '#/components/parameters/search::query.lenient' + - $ref: '#/components/parameters/search::query.preference' + - $ref: '#/components/parameters/search::query.q' + - $ref: '#/components/parameters/search::query.routing' + - $ref: '#/components/parameters/search::query.scroll' + - $ref: '#/components/parameters/search::query.search_type' + - $ref: '#/components/parameters/search::query.size' + - $ref: '#/components/parameters/search::query.sort' + - $ref: '#/components/parameters/search::query._source' + - $ref: '#/components/parameters/search::query._source_excludes' + - $ref: '#/components/parameters/search::query._source_includes' + - $ref: '#/components/parameters/search::query.terminate_after' + - $ref: '#/components/parameters/search::query.stats' + - $ref: '#/components/parameters/search::query.suggest_field' + - $ref: '#/components/parameters/search::query.suggest_mode' + - $ref: '#/components/parameters/search::query.suggest_size' + - $ref: '#/components/parameters/search::query.suggest_text' + - $ref: '#/components/parameters/search::query.timeout' + - $ref: '#/components/parameters/search::query.track_scores' + - $ref: '#/components/parameters/search::query.track_total_hits' + - $ref: '#/components/parameters/search::query.allow_partial_search_results' + - $ref: '#/components/parameters/search::query.typed_keys' + - $ref: '#/components/parameters/search::query.version' + - $ref: '#/components/parameters/search::query.seq_no_primary_term' + - $ref: '#/components/parameters/search::query.request_cache' + - $ref: '#/components/parameters/search::query.batched_reduce_size' + - $ref: '#/components/parameters/search::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/search::query.pre_filter_shard_size' + - $ref: '#/components/parameters/search::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/search::query.search_pipeline' + - $ref: '#/components/parameters/search::query.include_named_queries_score' + requestBody: + $ref: '#/components/requestBodies/search' + responses: + '200': + $ref: '#/components/responses/search@200' + /_search/pipeline/{pipeline}: + get: + operationId: search_pipeline.get.0 + x-operation-group: search_pipeline.get + x-version-added: '2.9' + description: Retrieves information about a specified search pipeline. + parameters: + - $ref: '#/components/parameters/search_pipeline.get::path.pipeline' + responses: + '200': + $ref: '#/components/responses/search_pipeline.get@200' + put: + operationId: search_pipeline.create.0 + x-operation-group: search_pipeline.create + x-version-added: '2.9' + description: Creates or replaces the specified search pipeline. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/search-pipelines/creating-search-pipeline/ + parameters: + - $ref: '#/components/parameters/search_pipeline.create::path.pipeline' + requestBody: + $ref: '#/components/requestBodies/search_pipeline.create' + responses: + '200': + $ref: '#/components/responses/search_pipeline.create@200' + /_search/point_in_time: + delete: + operationId: delete_pit.0 + x-operation-group: delete_pit + x-version-added: '2.4' + description: Deletes one or more point in time searches based on the IDs passed. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#delete-pits + requestBody: + $ref: '#/components/requestBodies/delete_pit' + responses: + '200': + $ref: '#/components/responses/delete_pit@200' + /_search/point_in_time/_all: + delete: + operationId: delete_all_pits.0 + x-operation-group: delete_all_pits + x-version-added: '2.4' + description: Deletes all active point in time searches. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#delete-pits + responses: + '200': + $ref: '#/components/responses/delete_all_pits@200' + get: + operationId: get_all_pits.0 + x-operation-group: get_all_pits + x-version-added: '2.4' + description: Lists all active point in time searches. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#list-all-pits + responses: + '200': + $ref: '#/components/responses/get_all_pits@200' + /_search/scroll: + delete: + operationId: clear_scroll.0 + x-operation-group: clear_scroll + x-version-added: '1.0' + description: Explicitly clears the search context for a scroll. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/scroll/ + parameters: [] + requestBody: + $ref: '#/components/requestBodies/clear_scroll' + responses: + '200': + $ref: '#/components/responses/clear_scroll@200' + get: + operationId: scroll.0 + x-operation-group: scroll + x-version-added: '1.0' + description: Allows to retrieve a large numbers of results from a single search request. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/scroll/#path-and-http-methods + parameters: + - $ref: '#/components/parameters/scroll::query.scroll' + - $ref: '#/components/parameters/scroll::query.scroll_id' + - $ref: '#/components/parameters/scroll::query.rest_total_hits_as_int' + requestBody: + $ref: '#/components/requestBodies/scroll' + responses: + '200': + $ref: '#/components/responses/scroll@200' + post: + operationId: scroll.1 + x-operation-group: scroll + x-version-added: '1.0' + description: Allows to retrieve a large numbers of results from a single search request. + parameters: + - $ref: '#/components/parameters/scroll::query.scroll' + - $ref: '#/components/parameters/scroll::query.scroll_id' + - $ref: '#/components/parameters/scroll::query.rest_total_hits_as_int' + requestBody: + $ref: '#/components/requestBodies/scroll' + responses: + '200': + $ref: '#/components/responses/scroll@200' + /_search/scroll/{scroll_id}: + delete: + operationId: clear_scroll.1 + x-operation-group: clear_scroll + deprecated: true + x-deprecation-message: A scroll id can be quite large and should be specified as part of the body + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Explicitly clears the search context for a scroll. + parameters: + - $ref: '#/components/parameters/clear_scroll::path.scroll_id' + requestBody: + $ref: '#/components/requestBodies/clear_scroll' + responses: + '200': + $ref: '#/components/responses/clear_scroll@200' + get: + operationId: scroll.2 + x-operation-group: scroll + deprecated: true + x-deprecation-message: A scroll id can be quite large and should be specified as part of the body + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Allows to retrieve a large numbers of results from a single search request. + parameters: + - $ref: '#/components/parameters/scroll::path.scroll_id' + - $ref: '#/components/parameters/scroll::query.scroll' + - $ref: '#/components/parameters/scroll::query.scroll_id' + - $ref: '#/components/parameters/scroll::query.rest_total_hits_as_int' + requestBody: + $ref: '#/components/requestBodies/scroll' + responses: + '200': + $ref: '#/components/responses/scroll@200' + post: + operationId: scroll.3 + x-operation-group: scroll + deprecated: true + x-deprecation-message: A scroll id can be quite large and should be specified as part of the body + x-version-added: '1.0' + x-version-deprecated: '1.0' + description: Allows to retrieve a large numbers of results from a single search request. + parameters: + - $ref: '#/components/parameters/scroll::path.scroll_id' + - $ref: '#/components/parameters/scroll::query.scroll' + - $ref: '#/components/parameters/scroll::query.scroll_id' + - $ref: '#/components/parameters/scroll::query.rest_total_hits_as_int' + requestBody: + $ref: '#/components/requestBodies/scroll' + responses: + '200': + $ref: '#/components/responses/scroll@200' + /_search/template: + get: + operationId: search_template.0 + x-operation-group: search_template + x-version-added: '1.0' + description: Allows to use the Mustache language to pre-render a search definition. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/search-template/ + parameters: + - $ref: '#/components/parameters/search_template::query.ignore_unavailable' + - $ref: '#/components/parameters/search_template::query.ignore_throttled' + - $ref: '#/components/parameters/search_template::query.allow_no_indices' + - $ref: '#/components/parameters/search_template::query.expand_wildcards' + - $ref: '#/components/parameters/search_template::query.preference' + - $ref: '#/components/parameters/search_template::query.routing' + - $ref: '#/components/parameters/search_template::query.scroll' + - $ref: '#/components/parameters/search_template::query.search_type' + - $ref: '#/components/parameters/search_template::query.explain' + - $ref: '#/components/parameters/search_template::query.profile' + - $ref: '#/components/parameters/search_template::query.typed_keys' + - $ref: '#/components/parameters/search_template::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/search_template::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/search_template' + responses: + '200': + $ref: '#/components/responses/search_template@200' + post: + operationId: search_template.1 + x-operation-group: search_template + x-version-added: '1.0' + description: Allows to use the Mustache language to pre-render a search definition. + parameters: + - $ref: '#/components/parameters/search_template::query.ignore_unavailable' + - $ref: '#/components/parameters/search_template::query.ignore_throttled' + - $ref: '#/components/parameters/search_template::query.allow_no_indices' + - $ref: '#/components/parameters/search_template::query.expand_wildcards' + - $ref: '#/components/parameters/search_template::query.preference' + - $ref: '#/components/parameters/search_template::query.routing' + - $ref: '#/components/parameters/search_template::query.scroll' + - $ref: '#/components/parameters/search_template::query.search_type' + - $ref: '#/components/parameters/search_template::query.explain' + - $ref: '#/components/parameters/search_template::query.profile' + - $ref: '#/components/parameters/search_template::query.typed_keys' + - $ref: '#/components/parameters/search_template::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/search_template::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/search_template' + responses: + '200': + $ref: '#/components/responses/search_template@200' + /_search_shards: + get: + operationId: search_shards.0 + x-operation-group: search_shards + x-version-added: '1.0' + description: Returns information about the indices and shards that a search request would be executed against. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/search_shards::query.preference' + - $ref: '#/components/parameters/search_shards::query.routing' + - $ref: '#/components/parameters/search_shards::query.local' + - $ref: '#/components/parameters/search_shards::query.ignore_unavailable' + - $ref: '#/components/parameters/search_shards::query.allow_no_indices' + - $ref: '#/components/parameters/search_shards::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/search_shards@200' + post: + operationId: search_shards.1 + x-operation-group: search_shards + x-version-added: '1.0' + description: Returns information about the indices and shards that a search request would be executed against. + parameters: + - $ref: '#/components/parameters/search_shards::query.preference' + - $ref: '#/components/parameters/search_shards::query.routing' + - $ref: '#/components/parameters/search_shards::query.local' + - $ref: '#/components/parameters/search_shards::query.ignore_unavailable' + - $ref: '#/components/parameters/search_shards::query.allow_no_indices' + - $ref: '#/components/parameters/search_shards::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/search_shards@200' + /_segments: + get: + operationId: indices.segments.0 + x-operation-group: indices.segments + x-version-added: '1.0' + description: Provides low-level information about segments in a Lucene index. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.segments::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.segments::query.allow_no_indices' + - $ref: '#/components/parameters/indices.segments::query.expand_wildcards' + - $ref: '#/components/parameters/indices.segments::query.verbose' + responses: + '200': + $ref: '#/components/responses/indices.segments@200' + /_settings: + get: + operationId: indices.get_settings.0 + x-operation-group: indices.get_settings + x-version-added: '1.0' + description: Returns settings for one or more indices. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/get-settings/ + parameters: + - $ref: '#/components/parameters/indices.get_settings::query.master_timeout' + - $ref: '#/components/parameters/indices.get_settings::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_settings::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_settings::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_settings::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_settings::query.flat_settings' + - $ref: '#/components/parameters/indices.get_settings::query.local' + - $ref: '#/components/parameters/indices.get_settings::query.include_defaults' + responses: + '200': + $ref: '#/components/responses/indices.get_settings@200' + put: + operationId: indices.put_settings.0 + x-operation-group: indices.put_settings + x-version-added: '1.0' + description: Updates the index settings. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/update-settings/ + parameters: + - $ref: '#/components/parameters/indices.put_settings::query.master_timeout' + - $ref: '#/components/parameters/indices.put_settings::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.put_settings::query.timeout' + - $ref: '#/components/parameters/indices.put_settings::query.preserve_existing' + - $ref: '#/components/parameters/indices.put_settings::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.put_settings::query.allow_no_indices' + - $ref: '#/components/parameters/indices.put_settings::query.expand_wildcards' + - $ref: '#/components/parameters/indices.put_settings::query.flat_settings' + requestBody: + $ref: '#/components/requestBodies/indices.put_settings' + responses: + '200': + $ref: '#/components/responses/indices.put_settings@200' + /_settings/{name}: + get: + operationId: indices.get_settings.1 + x-operation-group: indices.get_settings + x-version-added: '1.0' + description: Returns settings for one or more indices. + parameters: + - $ref: '#/components/parameters/indices.get_settings::path.name' + - $ref: '#/components/parameters/indices.get_settings::query.master_timeout' + - $ref: '#/components/parameters/indices.get_settings::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_settings::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_settings::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_settings::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_settings::query.flat_settings' + - $ref: '#/components/parameters/indices.get_settings::query.local' + - $ref: '#/components/parameters/indices.get_settings::query.include_defaults' + responses: + '200': + $ref: '#/components/responses/indices.get_settings@200' + /_shard_stores: + get: + operationId: indices.shard_stores.0 + x-operation-group: indices.shard_stores + x-version-added: '1.0' + description: Provides store information for shard copies of indices. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.shard_stores::query.status' + - $ref: '#/components/parameters/indices.shard_stores::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.shard_stores::query.allow_no_indices' + - $ref: '#/components/parameters/indices.shard_stores::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.shard_stores@200' + /_snapshot: + get: + operationId: snapshot.get_repository.0 + x-operation-group: snapshot.get_repository + x-version-added: '1.0' + description: Returns information about a repository. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/snapshots/get-snapshot-repository/ + parameters: + - $ref: '#/components/parameters/snapshot.get_repository::query.master_timeout' + - $ref: '#/components/parameters/snapshot.get_repository::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.get_repository::query.local' + responses: + '200': + $ref: '#/components/responses/snapshot.get_repository@200' + /_snapshot/_status: + get: + operationId: snapshot.status.0 + x-operation-group: snapshot.status + x-version-added: '1.0' + description: Returns information about the status of a snapshot. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/snapshots/get-snapshot-status/ + parameters: + - $ref: '#/components/parameters/snapshot.status::query.master_timeout' + - $ref: '#/components/parameters/snapshot.status::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.status::query.ignore_unavailable' + responses: + '200': + $ref: '#/components/responses/snapshot.status@200' + /_snapshot/{repository}: + delete: + operationId: snapshot.delete_repository.0 + x-operation-group: snapshot.delete_repository + x-version-added: '1.0' + description: Deletes a repository. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/snapshots/delete-snapshot-repository/ + parameters: + - $ref: '#/components/parameters/snapshot.delete_repository::path.repository' + - $ref: '#/components/parameters/snapshot.delete_repository::query.master_timeout' + - $ref: '#/components/parameters/snapshot.delete_repository::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.delete_repository::query.timeout' + responses: + '200': + $ref: '#/components/responses/snapshot.delete_repository@200' + get: + operationId: snapshot.get_repository.1 + x-operation-group: snapshot.get_repository + x-version-added: '1.0' + description: Returns information about a repository. + parameters: + - $ref: '#/components/parameters/snapshot.get_repository::path.repository' + - $ref: '#/components/parameters/snapshot.get_repository::query.master_timeout' + - $ref: '#/components/parameters/snapshot.get_repository::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.get_repository::query.local' + responses: + '200': + $ref: '#/components/responses/snapshot.get_repository@200' + post: + operationId: snapshot.create_repository.0 + x-operation-group: snapshot.create_repository + x-version-added: '1.0' + description: Creates a repository. + parameters: + - $ref: '#/components/parameters/snapshot.create_repository::path.repository' + - $ref: '#/components/parameters/snapshot.create_repository::query.master_timeout' + - $ref: '#/components/parameters/snapshot.create_repository::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.create_repository::query.timeout' + - $ref: '#/components/parameters/snapshot.create_repository::query.verify' + requestBody: + $ref: '#/components/requestBodies/snapshot.create_repository' + responses: + '200': + $ref: '#/components/responses/snapshot.create_repository@200' + put: + operationId: snapshot.create_repository.1 + x-operation-group: snapshot.create_repository + x-version-added: '1.0' + description: Creates a repository. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/snapshots/create-repository/ + parameters: + - $ref: '#/components/parameters/snapshot.create_repository::path.repository' + - $ref: '#/components/parameters/snapshot.create_repository::query.master_timeout' + - $ref: '#/components/parameters/snapshot.create_repository::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.create_repository::query.timeout' + - $ref: '#/components/parameters/snapshot.create_repository::query.verify' + requestBody: + $ref: '#/components/requestBodies/snapshot.create_repository' + responses: + '200': + $ref: '#/components/responses/snapshot.create_repository@200' + /_snapshot/{repository}/_cleanup: + post: + operationId: snapshot.cleanup_repository.0 + x-operation-group: snapshot.cleanup_repository + x-version-added: '1.0' + description: Removes stale data from repository. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/snapshot.cleanup_repository::path.repository' + - $ref: '#/components/parameters/snapshot.cleanup_repository::query.master_timeout' + - $ref: '#/components/parameters/snapshot.cleanup_repository::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.cleanup_repository::query.timeout' + responses: + '200': + $ref: '#/components/responses/snapshot.cleanup_repository@200' + /_snapshot/{repository}/_status: + get: + operationId: snapshot.status.1 + x-operation-group: snapshot.status + x-version-added: '1.0' + description: Returns information about the status of a snapshot. + parameters: + - $ref: '#/components/parameters/snapshot.status::path.repository' + - $ref: '#/components/parameters/snapshot.status::query.master_timeout' + - $ref: '#/components/parameters/snapshot.status::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.status::query.ignore_unavailable' + responses: + '200': + $ref: '#/components/responses/snapshot.status@200' + /_snapshot/{repository}/_verify: + post: + operationId: snapshot.verify_repository.0 + x-operation-group: snapshot.verify_repository + x-version-added: '1.0' + description: Verifies a repository. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/snapshots/verify-snapshot-repository/ + parameters: + - $ref: '#/components/parameters/snapshot.verify_repository::path.repository' + - $ref: '#/components/parameters/snapshot.verify_repository::query.master_timeout' + - $ref: '#/components/parameters/snapshot.verify_repository::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.verify_repository::query.timeout' + responses: + '200': + $ref: '#/components/responses/snapshot.verify_repository@200' + /_snapshot/{repository}/{snapshot}: + delete: + operationId: snapshot.delete.0 + x-operation-group: snapshot.delete + x-version-added: '1.0' + description: Deletes a snapshot. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/snapshots/delete-snapshot/ + parameters: + - $ref: '#/components/parameters/snapshot.delete::path.repository' + - $ref: '#/components/parameters/snapshot.delete::path.snapshot' + - $ref: '#/components/parameters/snapshot.delete::query.master_timeout' + - $ref: '#/components/parameters/snapshot.delete::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/snapshot.delete@200' + get: + operationId: snapshot.get.0 + x-operation-group: snapshot.get + x-version-added: '1.0' + description: Returns information about a snapshot. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/snapshot.get::path.repository' + - $ref: '#/components/parameters/snapshot.get::path.snapshot' + - $ref: '#/components/parameters/snapshot.get::query.master_timeout' + - $ref: '#/components/parameters/snapshot.get::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.get::query.ignore_unavailable' + - $ref: '#/components/parameters/snapshot.get::query.verbose' + responses: + '200': + $ref: '#/components/responses/snapshot.get@200' + post: + operationId: snapshot.create.0 + x-operation-group: snapshot.create + x-version-added: '1.0' + description: Creates a snapshot in a repository. + parameters: + - $ref: '#/components/parameters/snapshot.create::path.repository' + - $ref: '#/components/parameters/snapshot.create::path.snapshot' + - $ref: '#/components/parameters/snapshot.create::query.master_timeout' + - $ref: '#/components/parameters/snapshot.create::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.create::query.wait_for_completion' + requestBody: + $ref: '#/components/requestBodies/snapshot.create' + responses: + '200': + $ref: '#/components/responses/snapshot.create@200' + put: + operationId: snapshot.create.1 + x-operation-group: snapshot.create + x-version-added: '1.0' + description: Creates a snapshot in a repository. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/snapshots/create-snapshot/ + parameters: + - $ref: '#/components/parameters/snapshot.create::path.repository' + - $ref: '#/components/parameters/snapshot.create::path.snapshot' + - $ref: '#/components/parameters/snapshot.create::query.master_timeout' + - $ref: '#/components/parameters/snapshot.create::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.create::query.wait_for_completion' + requestBody: + $ref: '#/components/requestBodies/snapshot.create' + responses: + '200': + $ref: '#/components/responses/snapshot.create@200' + /_snapshot/{repository}/{snapshot}/_clone/{target_snapshot}: + put: + operationId: snapshot.clone.0 + x-operation-group: snapshot.clone + x-version-added: '1.0' + description: Clones indices from one snapshot into another snapshot in the same repository. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/snapshot.clone::path.repository' + - $ref: '#/components/parameters/snapshot.clone::path.snapshot' + - $ref: '#/components/parameters/snapshot.clone::path.target_snapshot' + - $ref: '#/components/parameters/snapshot.clone::query.master_timeout' + - $ref: '#/components/parameters/snapshot.clone::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/snapshot.clone' + responses: + '200': + $ref: '#/components/responses/snapshot.clone@200' + /_snapshot/{repository}/{snapshot}/_restore: + post: + operationId: snapshot.restore.0 + x-operation-group: snapshot.restore + x-version-added: '1.0' + description: Restores a snapshot. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/snapshots/restore-snapshot/ + parameters: + - $ref: '#/components/parameters/snapshot.restore::path.repository' + - $ref: '#/components/parameters/snapshot.restore::path.snapshot' + - $ref: '#/components/parameters/snapshot.restore::query.master_timeout' + - $ref: '#/components/parameters/snapshot.restore::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.restore::query.wait_for_completion' + requestBody: + $ref: '#/components/requestBodies/snapshot.restore' + responses: + '200': + $ref: '#/components/responses/snapshot.restore@200' + /_snapshot/{repository}/{snapshot}/_status: + get: + operationId: snapshot.status.2 + x-operation-group: snapshot.status + x-version-added: '1.0' + description: Returns information about the status of a snapshot. + parameters: + - $ref: '#/components/parameters/snapshot.status::path.repository' + - $ref: '#/components/parameters/snapshot.status::path.snapshot' + - $ref: '#/components/parameters/snapshot.status::query.master_timeout' + - $ref: '#/components/parameters/snapshot.status::query.cluster_manager_timeout' + - $ref: '#/components/parameters/snapshot.status::query.ignore_unavailable' + responses: + '200': + $ref: '#/components/responses/snapshot.status@200' + /_stats: + get: + operationId: indices.stats.0 + x-operation-group: indices.stats + x-version-added: '1.0' + description: Provides statistics on operations happening in an index. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.stats::query.completion_fields' + - $ref: '#/components/parameters/indices.stats::query.fielddata_fields' + - $ref: '#/components/parameters/indices.stats::query.fields' + - $ref: '#/components/parameters/indices.stats::query.groups' + - $ref: '#/components/parameters/indices.stats::query.level' + - $ref: '#/components/parameters/indices.stats::query.include_segment_file_sizes' + - $ref: '#/components/parameters/indices.stats::query.include_unloaded_segments' + - $ref: '#/components/parameters/indices.stats::query.expand_wildcards' + - $ref: '#/components/parameters/indices.stats::query.forbid_closed_indices' + responses: + '200': + $ref: '#/components/responses/indices.stats@200' + /_stats/{metric}: + get: + operationId: indices.stats.1 + x-operation-group: indices.stats + x-version-added: '1.0' + description: Provides statistics on operations happening in an index. + parameters: + - $ref: '#/components/parameters/indices.stats::path.metric' + - $ref: '#/components/parameters/indices.stats::query.completion_fields' + - $ref: '#/components/parameters/indices.stats::query.fielddata_fields' + - $ref: '#/components/parameters/indices.stats::query.fields' + - $ref: '#/components/parameters/indices.stats::query.groups' + - $ref: '#/components/parameters/indices.stats::query.level' + - $ref: '#/components/parameters/indices.stats::query.include_segment_file_sizes' + - $ref: '#/components/parameters/indices.stats::query.include_unloaded_segments' + - $ref: '#/components/parameters/indices.stats::query.expand_wildcards' + - $ref: '#/components/parameters/indices.stats::query.forbid_closed_indices' + responses: + '200': + $ref: '#/components/responses/indices.stats@200' + /_tasks: + get: + operationId: tasks.list.0 + x-operation-group: tasks.list + x-version-added: '1.0' + description: Returns a list of tasks. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/tasks/ + parameters: + - $ref: '#/components/parameters/tasks.list::query.nodes' + - $ref: '#/components/parameters/tasks.list::query.actions' + - $ref: '#/components/parameters/tasks.list::query.detailed' + - $ref: '#/components/parameters/tasks.list::query.parent_task_id' + - $ref: '#/components/parameters/tasks.list::query.wait_for_completion' + - $ref: '#/components/parameters/tasks.list::query.group_by' + - $ref: '#/components/parameters/tasks.list::query.timeout' + responses: + '200': + $ref: '#/components/responses/tasks.list@200' + /_tasks/_cancel: + post: + operationId: tasks.cancel.0 + x-operation-group: tasks.cancel + x-version-added: '1.0' + description: Cancels a task, if it can be cancelled through an API. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/tasks/#task-canceling + parameters: + - $ref: '#/components/parameters/tasks.cancel::query.nodes' + - $ref: '#/components/parameters/tasks.cancel::query.actions' + - $ref: '#/components/parameters/tasks.cancel::query.parent_task_id' + - $ref: '#/components/parameters/tasks.cancel::query.wait_for_completion' + responses: + '200': + $ref: '#/components/responses/tasks.cancel@200' + /_tasks/{task_id}: + get: + operationId: tasks.get.0 + x-operation-group: tasks.get + x-version-added: '1.0' + description: Returns information about a task. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/tasks/ + parameters: + - $ref: '#/components/parameters/tasks.get::path.task_id' + - $ref: '#/components/parameters/tasks.get::query.wait_for_completion' + - $ref: '#/components/parameters/tasks.get::query.timeout' + responses: + '200': + $ref: '#/components/responses/tasks.get@200' + /_tasks/{task_id}/_cancel: + post: + operationId: tasks.cancel.1 + x-operation-group: tasks.cancel + x-version-added: '1.0' + description: Cancels a task, if it can be cancelled through an API. + parameters: + - $ref: '#/components/parameters/tasks.cancel::path.task_id' + - $ref: '#/components/parameters/tasks.cancel::query.nodes' + - $ref: '#/components/parameters/tasks.cancel::query.actions' + - $ref: '#/components/parameters/tasks.cancel::query.parent_task_id' + - $ref: '#/components/parameters/tasks.cancel::query.wait_for_completion' + responses: + '200': + $ref: '#/components/responses/tasks.cancel@200' + /_template: + get: + operationId: indices.get_template.0 + x-operation-group: indices.get_template + x-version-added: '1.0' + description: Returns an index template. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.get_template::query.flat_settings' + - $ref: '#/components/parameters/indices.get_template::query.master_timeout' + - $ref: '#/components/parameters/indices.get_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_template::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_template@200' + /_template/{name}: + delete: + operationId: indices.delete_template.0 + x-operation-group: indices.delete_template + x-version-added: '1.0' + description: Deletes an index template. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.delete_template::path.name' + - $ref: '#/components/parameters/indices.delete_template::query.timeout' + - $ref: '#/components/parameters/indices.delete_template::query.master_timeout' + - $ref: '#/components/parameters/indices.delete_template::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/indices.delete_template@200' + get: + operationId: indices.get_template.1 + x-operation-group: indices.get_template + x-version-added: '1.0' + description: Returns an index template. + parameters: + - $ref: '#/components/parameters/indices.get_template::path.name' + - $ref: '#/components/parameters/indices.get_template::query.flat_settings' + - $ref: '#/components/parameters/indices.get_template::query.master_timeout' + - $ref: '#/components/parameters/indices.get_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_template::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_template@200' + head: + operationId: indices.exists_template.0 + x-operation-group: indices.exists_template + x-version-added: '1.0' + description: Returns information about whether a particular index template exists. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.exists_template::path.name' + - $ref: '#/components/parameters/indices.exists_template::query.flat_settings' + - $ref: '#/components/parameters/indices.exists_template::query.master_timeout' + - $ref: '#/components/parameters/indices.exists_template::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.exists_template::query.local' + responses: + '200': + $ref: '#/components/responses/indices.exists_template@200' + post: + operationId: indices.put_template.0 + x-operation-group: indices.put_template + x-version-added: '1.0' + description: Creates or updates an index template. + parameters: + - $ref: '#/components/parameters/indices.put_template::path.name' + - $ref: '#/components/parameters/indices.put_template::query.order' + - $ref: '#/components/parameters/indices.put_template::query.create' + - $ref: '#/components/parameters/indices.put_template::query.master_timeout' + - $ref: '#/components/parameters/indices.put_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.put_template' + responses: + '200': + $ref: '#/components/responses/indices.put_template@200' + put: + operationId: indices.put_template.1 + x-operation-group: indices.put_template + x-version-added: '1.0' + description: Creates or updates an index template. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-templates/ + parameters: + - $ref: '#/components/parameters/indices.put_template::path.name' + - $ref: '#/components/parameters/indices.put_template::query.order' + - $ref: '#/components/parameters/indices.put_template::query.create' + - $ref: '#/components/parameters/indices.put_template::query.master_timeout' + - $ref: '#/components/parameters/indices.put_template::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.put_template' + responses: + '200': + $ref: '#/components/responses/indices.put_template@200' + /_update_by_query/{task_id}/_rethrottle: + post: + operationId: update_by_query_rethrottle.0 + x-operation-group: update_by_query_rethrottle + x-version-added: '1.0' + description: Changes the number of requests per second for a particular Update By Query operation. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/update_by_query_rethrottle::path.task_id' + - $ref: '#/components/parameters/update_by_query_rethrottle::query.requests_per_second' + responses: + '200': + $ref: '#/components/responses/update_by_query_rethrottle@200' + /_upgrade: + get: + operationId: indices.get_upgrade.0 + x-operation-group: indices.get_upgrade + x-version-added: '1.0' + description: The _upgrade API is no longer useful and will be removed. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.get_upgrade::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_upgrade::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_upgrade::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.get_upgrade@200' + post: + operationId: indices.upgrade.0 + x-operation-group: indices.upgrade + x-version-added: '1.0' + description: The _upgrade API is no longer useful and will be removed. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.upgrade::query.allow_no_indices' + - $ref: '#/components/parameters/indices.upgrade::query.expand_wildcards' + - $ref: '#/components/parameters/indices.upgrade::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.upgrade::query.wait_for_completion' + - $ref: '#/components/parameters/indices.upgrade::query.only_ancient_segments' + responses: + '200': + $ref: '#/components/responses/indices.upgrade@200' + /_validate/query: + get: + operationId: indices.validate_query.0 + x-operation-group: indices.validate_query + x-version-added: '1.0' + description: Allows a user to validate a potentially expensive query without executing it. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.validate_query::query.explain' + - $ref: '#/components/parameters/indices.validate_query::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.validate_query::query.allow_no_indices' + - $ref: '#/components/parameters/indices.validate_query::query.expand_wildcards' + - $ref: '#/components/parameters/indices.validate_query::query.q' + - $ref: '#/components/parameters/indices.validate_query::query.analyzer' + - $ref: '#/components/parameters/indices.validate_query::query.analyze_wildcard' + - $ref: '#/components/parameters/indices.validate_query::query.default_operator' + - $ref: '#/components/parameters/indices.validate_query::query.df' + - $ref: '#/components/parameters/indices.validate_query::query.lenient' + - $ref: '#/components/parameters/indices.validate_query::query.rewrite' + - $ref: '#/components/parameters/indices.validate_query::query.all_shards' + requestBody: + $ref: '#/components/requestBodies/indices.validate_query' + responses: + '200': + $ref: '#/components/responses/indices.validate_query@200' + post: + operationId: indices.validate_query.1 + x-operation-group: indices.validate_query + x-version-added: '1.0' + description: Allows a user to validate a potentially expensive query without executing it. + parameters: + - $ref: '#/components/parameters/indices.validate_query::query.explain' + - $ref: '#/components/parameters/indices.validate_query::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.validate_query::query.allow_no_indices' + - $ref: '#/components/parameters/indices.validate_query::query.expand_wildcards' + - $ref: '#/components/parameters/indices.validate_query::query.q' + - $ref: '#/components/parameters/indices.validate_query::query.analyzer' + - $ref: '#/components/parameters/indices.validate_query::query.analyze_wildcard' + - $ref: '#/components/parameters/indices.validate_query::query.default_operator' + - $ref: '#/components/parameters/indices.validate_query::query.df' + - $ref: '#/components/parameters/indices.validate_query::query.lenient' + - $ref: '#/components/parameters/indices.validate_query::query.rewrite' + - $ref: '#/components/parameters/indices.validate_query::query.all_shards' + requestBody: + $ref: '#/components/requestBodies/indices.validate_query' + responses: + '200': + $ref: '#/components/responses/indices.validate_query@200' + /{alias}/_rollover: + post: + operationId: indices.rollover.0 + x-operation-group: indices.rollover + x-version-added: '1.0' + description: |- + Updates an alias to point to a new index when the existing index + is considered to be too large or too old. + externalDocs: + url: https://opensearch.org/docs/latest/dashboards/im-dashboards/rollover/ + parameters: + - $ref: '#/components/parameters/indices.rollover::path.alias' + - $ref: '#/components/parameters/indices.rollover::query.timeout' + - $ref: '#/components/parameters/indices.rollover::query.dry_run' + - $ref: '#/components/parameters/indices.rollover::query.master_timeout' + - $ref: '#/components/parameters/indices.rollover::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.rollover::query.wait_for_active_shards' + requestBody: + $ref: '#/components/requestBodies/indices.rollover' + responses: + '200': + $ref: '#/components/responses/indices.rollover@200' + /{alias}/_rollover/{new_index}: + post: + operationId: indices.rollover.1 + x-operation-group: indices.rollover + x-version-added: '1.0' + description: |- + Updates an alias to point to a new index when the existing index + is considered to be too large or too old. + parameters: + - $ref: '#/components/parameters/indices.rollover::path.alias' + - $ref: '#/components/parameters/indices.rollover::path.new_index' + - $ref: '#/components/parameters/indices.rollover::query.timeout' + - $ref: '#/components/parameters/indices.rollover::query.dry_run' + - $ref: '#/components/parameters/indices.rollover::query.master_timeout' + - $ref: '#/components/parameters/indices.rollover::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.rollover::query.wait_for_active_shards' + requestBody: + $ref: '#/components/requestBodies/indices.rollover' + responses: + '200': + $ref: '#/components/responses/indices.rollover@200' + /{index}: + delete: + operationId: indices.delete.0 + x-operation-group: indices.delete + x-version-added: '1.0' + description: Deletes an index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/delete-index/ + parameters: + - $ref: '#/components/parameters/indices.delete::path.index' + - $ref: '#/components/parameters/indices.delete::query.timeout' + - $ref: '#/components/parameters/indices.delete::query.master_timeout' + - $ref: '#/components/parameters/indices.delete::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.delete::query.allow_no_indices' + - $ref: '#/components/parameters/indices.delete::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.delete::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.delete@200' + get: + operationId: indices.get.0 + x-operation-group: indices.get + x-version-added: '1.0' + description: Returns information about one or more indices. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/get-index/ + parameters: + - $ref: '#/components/parameters/indices.get::path.index' + - $ref: '#/components/parameters/indices.get::query.local' + - $ref: '#/components/parameters/indices.get::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get::query.flat_settings' + - $ref: '#/components/parameters/indices.get::query.include_defaults' + - $ref: '#/components/parameters/indices.get::query.master_timeout' + - $ref: '#/components/parameters/indices.get::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/indices.get@200' + head: + operationId: indices.exists.0 + x-operation-group: indices.exists + x-version-added: '1.0' + description: Returns information about whether a particular index exists. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/exists/ + parameters: + - $ref: '#/components/parameters/indices.exists::path.index' + - $ref: '#/components/parameters/indices.exists::query.local' + - $ref: '#/components/parameters/indices.exists::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.exists::query.allow_no_indices' + - $ref: '#/components/parameters/indices.exists::query.expand_wildcards' + - $ref: '#/components/parameters/indices.exists::query.flat_settings' + - $ref: '#/components/parameters/indices.exists::query.include_defaults' + responses: + '200': + $ref: '#/components/responses/indices.exists@200' + put: + operationId: indices.create.0 + x-operation-group: indices.create + x-version-added: '1.0' + description: Creates an index with optional settings and mappings. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/create-index/ + parameters: + - $ref: '#/components/parameters/indices.create::path.index' + - $ref: '#/components/parameters/indices.create::query.wait_for_active_shards' + - $ref: '#/components/parameters/indices.create::query.timeout' + - $ref: '#/components/parameters/indices.create::query.master_timeout' + - $ref: '#/components/parameters/indices.create::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.create' + responses: + '200': + $ref: '#/components/responses/indices.create@200' + /{index}/_alias: + get: + operationId: indices.get_alias.2 + x-operation-group: indices.get_alias + x-version-added: '1.0' + description: Returns an alias. + parameters: + - $ref: '#/components/parameters/indices.get_alias::path.index' + - $ref: '#/components/parameters/indices.get_alias::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_alias::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_alias::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_alias::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_alias@200' + /{index}/_alias/{name}: + delete: + operationId: indices.delete_alias.0 + x-operation-group: indices.delete_alias + x-version-added: '1.0' + description: Deletes an alias. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-alias/#delete-aliases + parameters: + - $ref: '#/components/parameters/indices.delete_alias::path.index' + - $ref: '#/components/parameters/indices.delete_alias::path.name' + - $ref: '#/components/parameters/indices.delete_alias::query.timeout' + - $ref: '#/components/parameters/indices.delete_alias::query.master_timeout' + - $ref: '#/components/parameters/indices.delete_alias::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/indices.delete_alias@200' + get: + operationId: indices.get_alias.3 + x-operation-group: indices.get_alias + x-version-added: '1.0' + description: Returns an alias. + parameters: + - $ref: '#/components/parameters/indices.get_alias::path.index' + - $ref: '#/components/parameters/indices.get_alias::path.name' + - $ref: '#/components/parameters/indices.get_alias::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_alias::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_alias::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_alias::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_alias@200' + head: + operationId: indices.exists_alias.1 + x-operation-group: indices.exists_alias + x-version-added: '1.0' + description: Returns information about whether a particular alias exists. + parameters: + - $ref: '#/components/parameters/indices.exists_alias::path.index' + - $ref: '#/components/parameters/indices.exists_alias::path.name' + - $ref: '#/components/parameters/indices.exists_alias::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.exists_alias::query.allow_no_indices' + - $ref: '#/components/parameters/indices.exists_alias::query.expand_wildcards' + - $ref: '#/components/parameters/indices.exists_alias::query.local' + responses: + '200': + $ref: '#/components/responses/indices.exists_alias@200' + post: + operationId: indices.put_alias.0 + x-operation-group: indices.put_alias + x-version-added: '1.0' + description: Creates or updates an alias. + parameters: + - $ref: '#/components/parameters/indices.put_alias::path.index' + - $ref: '#/components/parameters/indices.put_alias::path.name' + - $ref: '#/components/parameters/indices.put_alias::query.timeout' + - $ref: '#/components/parameters/indices.put_alias::query.master_timeout' + - $ref: '#/components/parameters/indices.put_alias::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.put_alias' + responses: + '200': + $ref: '#/components/responses/indices.put_alias@200' + put: + operationId: indices.put_alias.1 + x-operation-group: indices.put_alias + x-version-added: '1.0' + description: Creates or updates an alias. + externalDocs: + url: https://opensearch.org/docs/latest/im-plugin/index-alias/#create-aliases + parameters: + - $ref: '#/components/parameters/indices.put_alias::path.index' + - $ref: '#/components/parameters/indices.put_alias::path.name' + - $ref: '#/components/parameters/indices.put_alias::query.timeout' + - $ref: '#/components/parameters/indices.put_alias::query.master_timeout' + - $ref: '#/components/parameters/indices.put_alias::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.put_alias' + responses: + '200': + $ref: '#/components/responses/indices.put_alias@200' + /{index}/_aliases/{name}: + delete: + operationId: indices.delete_alias.1 + x-operation-group: indices.delete_alias + x-version-added: '1.0' + description: Deletes an alias. + parameters: + - $ref: '#/components/parameters/indices.delete_alias::path.index' + - $ref: '#/components/parameters/indices.delete_alias::path.name' + - $ref: '#/components/parameters/indices.delete_alias::query.timeout' + - $ref: '#/components/parameters/indices.delete_alias::query.master_timeout' + - $ref: '#/components/parameters/indices.delete_alias::query.cluster_manager_timeout' + responses: + '200': + $ref: '#/components/responses/indices.delete_alias@200' + post: + operationId: indices.put_alias.2 + x-operation-group: indices.put_alias + x-version-added: '1.0' + description: Creates or updates an alias. + parameters: + - $ref: '#/components/parameters/indices.put_alias::path.index' + - $ref: '#/components/parameters/indices.put_alias::path.name' + - $ref: '#/components/parameters/indices.put_alias::query.timeout' + - $ref: '#/components/parameters/indices.put_alias::query.master_timeout' + - $ref: '#/components/parameters/indices.put_alias::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.put_alias' + responses: + '200': + $ref: '#/components/responses/indices.put_alias@200' + put: + operationId: indices.put_alias.3 + x-operation-group: indices.put_alias + x-version-added: '1.0' + description: Creates or updates an alias. + parameters: + - $ref: '#/components/parameters/indices.put_alias::path.index' + - $ref: '#/components/parameters/indices.put_alias::path.name' + - $ref: '#/components/parameters/indices.put_alias::query.timeout' + - $ref: '#/components/parameters/indices.put_alias::query.master_timeout' + - $ref: '#/components/parameters/indices.put_alias::query.cluster_manager_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.put_alias' + responses: + '200': + $ref: '#/components/responses/indices.put_alias@200' + /{index}/_analyze: + get: + operationId: indices.analyze.2 + x-operation-group: indices.analyze + x-version-added: '1.0' + description: Performs the analysis process on a text and return the tokens breakdown of the text. + parameters: + - $ref: '#/components/parameters/indices.analyze::path.index' + - $ref: '#/components/parameters/indices.analyze::query.index' + requestBody: + $ref: '#/components/requestBodies/indices.analyze' + responses: + '200': + $ref: '#/components/responses/indices.analyze@200' + post: + operationId: indices.analyze.3 + x-operation-group: indices.analyze + x-version-added: '1.0' + description: Performs the analysis process on a text and return the tokens breakdown of the text. + parameters: + - $ref: '#/components/parameters/indices.analyze::path.index' + - $ref: '#/components/parameters/indices.analyze::query.index' + requestBody: + $ref: '#/components/requestBodies/indices.analyze' + responses: + '200': + $ref: '#/components/responses/indices.analyze@200' + /{index}/_block/{block}: + put: + operationId: indices.add_block.0 + x-operation-group: indices.add_block + x-version-added: '1.0' + description: Adds a block to an index. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/indices.add_block::path.index' + - $ref: '#/components/parameters/indices.add_block::path.block' + - $ref: '#/components/parameters/indices.add_block::query.timeout' + - $ref: '#/components/parameters/indices.add_block::query.master_timeout' + - $ref: '#/components/parameters/indices.add_block::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.add_block::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.add_block::query.allow_no_indices' + - $ref: '#/components/parameters/indices.add_block::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.add_block@200' + /{index}/_bulk: + post: + operationId: bulk.2 + x-operation-group: bulk + x-version-added: '1.0' + description: Allows to perform multiple index/update/delete operations in a single request. + parameters: + - $ref: '#/components/parameters/bulk::path.index' + - $ref: '#/components/parameters/bulk::query.wait_for_active_shards' + - $ref: '#/components/parameters/bulk::query.refresh' + - $ref: '#/components/parameters/bulk::query.routing' + - $ref: '#/components/parameters/bulk::query.timeout' + - $ref: '#/components/parameters/bulk::query.type' + - $ref: '#/components/parameters/bulk::query._source' + - $ref: '#/components/parameters/bulk::query._source_excludes' + - $ref: '#/components/parameters/bulk::query._source_includes' + - $ref: '#/components/parameters/bulk::query.pipeline' + - $ref: '#/components/parameters/bulk::query.require_alias' + requestBody: + $ref: '#/components/requestBodies/bulk' + responses: + '200': + $ref: '#/components/responses/bulk@200' + put: + operationId: bulk.3 + x-operation-group: bulk + x-version-added: '1.0' + description: Allows to perform multiple index/update/delete operations in a single request. + parameters: + - $ref: '#/components/parameters/bulk::path.index' + - $ref: '#/components/parameters/bulk::query.wait_for_active_shards' + - $ref: '#/components/parameters/bulk::query.refresh' + - $ref: '#/components/parameters/bulk::query.routing' + - $ref: '#/components/parameters/bulk::query.timeout' + - $ref: '#/components/parameters/bulk::query.type' + - $ref: '#/components/parameters/bulk::query._source' + - $ref: '#/components/parameters/bulk::query._source_excludes' + - $ref: '#/components/parameters/bulk::query._source_includes' + - $ref: '#/components/parameters/bulk::query.pipeline' + - $ref: '#/components/parameters/bulk::query.require_alias' + requestBody: + $ref: '#/components/requestBodies/bulk' + responses: + '200': + $ref: '#/components/responses/bulk@200' + /{index}/_cache/clear: + post: + operationId: indices.clear_cache.1 + x-operation-group: indices.clear_cache + x-version-added: '1.0' + description: Clears all or specific caches for one or more indices. + parameters: + - $ref: '#/components/parameters/indices.clear_cache::path.index' + - $ref: '#/components/parameters/indices.clear_cache::query.fielddata' + - $ref: '#/components/parameters/indices.clear_cache::query.fields' + - $ref: '#/components/parameters/indices.clear_cache::query.query' + - $ref: '#/components/parameters/indices.clear_cache::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.clear_cache::query.allow_no_indices' + - $ref: '#/components/parameters/indices.clear_cache::query.expand_wildcards' + - $ref: '#/components/parameters/indices.clear_cache::query.index' + - $ref: '#/components/parameters/indices.clear_cache::query.request' + responses: + '200': + $ref: '#/components/responses/indices.clear_cache@200' + /{index}/_clone/{target}: + post: + operationId: indices.clone.0 + x-operation-group: indices.clone + x-version-added: '1.0' + description: Clones an index. + parameters: + - $ref: '#/components/parameters/indices.clone::path.index' + - $ref: '#/components/parameters/indices.clone::path.target' + - $ref: '#/components/parameters/indices.clone::query.timeout' + - $ref: '#/components/parameters/indices.clone::query.master_timeout' + - $ref: '#/components/parameters/indices.clone::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.clone::query.wait_for_active_shards' + - $ref: '#/components/parameters/indices.clone::query.wait_for_completion' + - $ref: '#/components/parameters/indices.clone::query.task_execution_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.clone' + responses: + '200': + $ref: '#/components/responses/indices.clone@200' + put: + operationId: indices.clone.1 + x-operation-group: indices.clone + x-version-added: '1.0' + description: Clones an index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/clone/ + parameters: + - $ref: '#/components/parameters/indices.clone::path.index' + - $ref: '#/components/parameters/indices.clone::path.target' + - $ref: '#/components/parameters/indices.clone::query.timeout' + - $ref: '#/components/parameters/indices.clone::query.master_timeout' + - $ref: '#/components/parameters/indices.clone::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.clone::query.wait_for_active_shards' + - $ref: '#/components/parameters/indices.clone::query.wait_for_completion' + - $ref: '#/components/parameters/indices.clone::query.task_execution_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.clone' + responses: + '200': + $ref: '#/components/responses/indices.clone@200' + /{index}/_close: + post: + operationId: indices.close.0 + x-operation-group: indices.close + x-version-added: '1.0' + description: Closes an index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/close-index/ + parameters: + - $ref: '#/components/parameters/indices.close::path.index' + - $ref: '#/components/parameters/indices.close::query.timeout' + - $ref: '#/components/parameters/indices.close::query.master_timeout' + - $ref: '#/components/parameters/indices.close::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.close::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.close::query.allow_no_indices' + - $ref: '#/components/parameters/indices.close::query.expand_wildcards' + - $ref: '#/components/parameters/indices.close::query.wait_for_active_shards' + responses: + '200': + $ref: '#/components/responses/indices.close@200' + /{index}/_count: + get: + operationId: count.2 + x-operation-group: count + x-version-added: '1.0' + description: Returns number of documents matching a query. + parameters: + - $ref: '#/components/parameters/count::path.index' + - $ref: '#/components/parameters/count::query.ignore_unavailable' + - $ref: '#/components/parameters/count::query.ignore_throttled' + - $ref: '#/components/parameters/count::query.allow_no_indices' + - $ref: '#/components/parameters/count::query.expand_wildcards' + - $ref: '#/components/parameters/count::query.min_score' + - $ref: '#/components/parameters/count::query.preference' + - $ref: '#/components/parameters/count::query.routing' + - $ref: '#/components/parameters/count::query.q' + - $ref: '#/components/parameters/count::query.analyzer' + - $ref: '#/components/parameters/count::query.analyze_wildcard' + - $ref: '#/components/parameters/count::query.default_operator' + - $ref: '#/components/parameters/count::query.df' + - $ref: '#/components/parameters/count::query.lenient' + - $ref: '#/components/parameters/count::query.terminate_after' + requestBody: + $ref: '#/components/requestBodies/count' + responses: + '200': + $ref: '#/components/responses/count@200' + post: + operationId: count.3 + x-operation-group: count + x-version-added: '1.0' + description: Returns number of documents matching a query. + parameters: + - $ref: '#/components/parameters/count::path.index' + - $ref: '#/components/parameters/count::query.ignore_unavailable' + - $ref: '#/components/parameters/count::query.ignore_throttled' + - $ref: '#/components/parameters/count::query.allow_no_indices' + - $ref: '#/components/parameters/count::query.expand_wildcards' + - $ref: '#/components/parameters/count::query.min_score' + - $ref: '#/components/parameters/count::query.preference' + - $ref: '#/components/parameters/count::query.routing' + - $ref: '#/components/parameters/count::query.q' + - $ref: '#/components/parameters/count::query.analyzer' + - $ref: '#/components/parameters/count::query.analyze_wildcard' + - $ref: '#/components/parameters/count::query.default_operator' + - $ref: '#/components/parameters/count::query.df' + - $ref: '#/components/parameters/count::query.lenient' + - $ref: '#/components/parameters/count::query.terminate_after' + requestBody: + $ref: '#/components/requestBodies/count' + responses: + '200': + $ref: '#/components/responses/count@200' + /{index}/_create/{id}: + post: + operationId: create.0 + x-operation-group: create + x-version-added: '1.0' + description: |- + Creates a new document in the index. + + Returns a 409 response when a document with a same ID already exists in the index. + parameters: + - $ref: '#/components/parameters/create::path.id' + - $ref: '#/components/parameters/create::path.index' + - $ref: '#/components/parameters/create::query.wait_for_active_shards' + - $ref: '#/components/parameters/create::query.refresh' + - $ref: '#/components/parameters/create::query.routing' + - $ref: '#/components/parameters/create::query.timeout' + - $ref: '#/components/parameters/create::query.version' + - $ref: '#/components/parameters/create::query.version_type' + - $ref: '#/components/parameters/create::query.pipeline' + requestBody: + $ref: '#/components/requestBodies/create' + responses: + '200': + $ref: '#/components/responses/create@200' + put: + operationId: create.1 + x-operation-group: create + x-version-added: '1.0' + description: |- + Creates a new document in the index. + + Returns a 409 response when a document with a same ID already exists in the index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/index-document/ + parameters: + - $ref: '#/components/parameters/create::path.id' + - $ref: '#/components/parameters/create::path.index' + - $ref: '#/components/parameters/create::query.wait_for_active_shards' + - $ref: '#/components/parameters/create::query.refresh' + - $ref: '#/components/parameters/create::query.routing' + - $ref: '#/components/parameters/create::query.timeout' + - $ref: '#/components/parameters/create::query.version' + - $ref: '#/components/parameters/create::query.version_type' + - $ref: '#/components/parameters/create::query.pipeline' + requestBody: + $ref: '#/components/requestBodies/create' + responses: + '200': + $ref: '#/components/responses/create@200' + /{index}/_delete_by_query: + post: + operationId: delete_by_query.0 + x-operation-group: delete_by_query + x-version-added: '1.0' + description: Deletes documents matching the provided query. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/delete-by-query/ + parameters: + - $ref: '#/components/parameters/delete_by_query::path.index' + - $ref: '#/components/parameters/delete_by_query::query.analyzer' + - $ref: '#/components/parameters/delete_by_query::query.analyze_wildcard' + - $ref: '#/components/parameters/delete_by_query::query.default_operator' + - $ref: '#/components/parameters/delete_by_query::query.df' + - $ref: '#/components/parameters/delete_by_query::query.from' + - $ref: '#/components/parameters/delete_by_query::query.ignore_unavailable' + - $ref: '#/components/parameters/delete_by_query::query.allow_no_indices' + - $ref: '#/components/parameters/delete_by_query::query.conflicts' + - $ref: '#/components/parameters/delete_by_query::query.expand_wildcards' + - $ref: '#/components/parameters/delete_by_query::query.lenient' + - $ref: '#/components/parameters/delete_by_query::query.preference' + - $ref: '#/components/parameters/delete_by_query::query.q' + - $ref: '#/components/parameters/delete_by_query::query.routing' + - $ref: '#/components/parameters/delete_by_query::query.scroll' + - $ref: '#/components/parameters/delete_by_query::query.search_type' + - $ref: '#/components/parameters/delete_by_query::query.search_timeout' + - $ref: '#/components/parameters/delete_by_query::query.size' + - $ref: '#/components/parameters/delete_by_query::query.max_docs' + - $ref: '#/components/parameters/delete_by_query::query.sort' + - $ref: '#/components/parameters/delete_by_query::query._source' + - $ref: '#/components/parameters/delete_by_query::query._source_excludes' + - $ref: '#/components/parameters/delete_by_query::query._source_includes' + - $ref: '#/components/parameters/delete_by_query::query.terminate_after' + - $ref: '#/components/parameters/delete_by_query::query.stats' + - $ref: '#/components/parameters/delete_by_query::query.version' + - $ref: '#/components/parameters/delete_by_query::query.request_cache' + - $ref: '#/components/parameters/delete_by_query::query.refresh' + - $ref: '#/components/parameters/delete_by_query::query.timeout' + - $ref: '#/components/parameters/delete_by_query::query.wait_for_active_shards' + - $ref: '#/components/parameters/delete_by_query::query.scroll_size' + - $ref: '#/components/parameters/delete_by_query::query.wait_for_completion' + - $ref: '#/components/parameters/delete_by_query::query.requests_per_second' + - $ref: '#/components/parameters/delete_by_query::query.slices' + requestBody: + $ref: '#/components/requestBodies/delete_by_query' + responses: + '200': + $ref: '#/components/responses/delete_by_query@200' + /{index}/_doc: + post: + operationId: index.0 + x-operation-group: index + x-version-added: '1.0' + description: Creates or updates a document in an index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/index-document/ + parameters: + - $ref: '#/components/parameters/index::path.index' + - $ref: '#/components/parameters/index::query.wait_for_active_shards' + - $ref: '#/components/parameters/index::query.op_type' + - $ref: '#/components/parameters/index::query.refresh' + - $ref: '#/components/parameters/index::query.routing' + - $ref: '#/components/parameters/index::query.timeout' + - $ref: '#/components/parameters/index::query.version' + - $ref: '#/components/parameters/index::query.version_type' + - $ref: '#/components/parameters/index::query.if_seq_no' + - $ref: '#/components/parameters/index::query.if_primary_term' + - $ref: '#/components/parameters/index::query.pipeline' + - $ref: '#/components/parameters/index::query.require_alias' + requestBody: + $ref: '#/components/requestBodies/index' + responses: + '200': + $ref: '#/components/responses/index@200' + /{index}/_doc/{id}: + delete: + operationId: delete.0 + x-operation-group: delete + x-version-added: '1.0' + description: Removes a document from the index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/delete-document/ + parameters: + - $ref: '#/components/parameters/delete::path.id' + - $ref: '#/components/parameters/delete::path.index' + - $ref: '#/components/parameters/delete::query.wait_for_active_shards' + - $ref: '#/components/parameters/delete::query.refresh' + - $ref: '#/components/parameters/delete::query.routing' + - $ref: '#/components/parameters/delete::query.timeout' + - $ref: '#/components/parameters/delete::query.if_seq_no' + - $ref: '#/components/parameters/delete::query.if_primary_term' + - $ref: '#/components/parameters/delete::query.version' + - $ref: '#/components/parameters/delete::query.version_type' + responses: + '200': + $ref: '#/components/responses/delete@200' + get: + operationId: get.0 + x-operation-group: get + x-version-added: '1.0' + description: Returns a document. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/ + parameters: + - $ref: '#/components/parameters/get::path.id' + - $ref: '#/components/parameters/get::path.index' + - $ref: '#/components/parameters/get::query.stored_fields' + - $ref: '#/components/parameters/get::query.preference' + - $ref: '#/components/parameters/get::query.realtime' + - $ref: '#/components/parameters/get::query.refresh' + - $ref: '#/components/parameters/get::query.routing' + - $ref: '#/components/parameters/get::query._source' + - $ref: '#/components/parameters/get::query._source_excludes' + - $ref: '#/components/parameters/get::query._source_includes' + - $ref: '#/components/parameters/get::query.version' + - $ref: '#/components/parameters/get::query.version_type' + responses: + '200': + $ref: '#/components/responses/get@200' + head: + operationId: exists.0 + x-operation-group: exists + x-version-added: '1.0' + description: Returns information about whether a document exists in an index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/ + parameters: + - $ref: '#/components/parameters/exists::path.id' + - $ref: '#/components/parameters/exists::path.index' + - $ref: '#/components/parameters/exists::query.stored_fields' + - $ref: '#/components/parameters/exists::query.preference' + - $ref: '#/components/parameters/exists::query.realtime' + - $ref: '#/components/parameters/exists::query.refresh' + - $ref: '#/components/parameters/exists::query.routing' + - $ref: '#/components/parameters/exists::query._source' + - $ref: '#/components/parameters/exists::query._source_excludes' + - $ref: '#/components/parameters/exists::query._source_includes' + - $ref: '#/components/parameters/exists::query.version' + - $ref: '#/components/parameters/exists::query.version_type' + responses: + '200': + $ref: '#/components/responses/exists@200' + post: + operationId: index.1 + x-operation-group: index + x-version-added: '1.0' + description: Creates or updates a document in an index. + parameters: + - $ref: '#/components/parameters/index::path.id' + - $ref: '#/components/parameters/index::path.index' + - $ref: '#/components/parameters/index::query.wait_for_active_shards' + - $ref: '#/components/parameters/index::query.op_type' + - $ref: '#/components/parameters/index::query.refresh' + - $ref: '#/components/parameters/index::query.routing' + - $ref: '#/components/parameters/index::query.timeout' + - $ref: '#/components/parameters/index::query.version' + - $ref: '#/components/parameters/index::query.version_type' + - $ref: '#/components/parameters/index::query.if_seq_no' + - $ref: '#/components/parameters/index::query.if_primary_term' + - $ref: '#/components/parameters/index::query.pipeline' + - $ref: '#/components/parameters/index::query.require_alias' + requestBody: + $ref: '#/components/requestBodies/index' + responses: + '200': + $ref: '#/components/responses/index@200' + put: + operationId: index.2 + x-operation-group: index + x-version-added: '1.0' + description: Creates or updates a document in an index. + parameters: + - $ref: '#/components/parameters/index::path.id' + - $ref: '#/components/parameters/index::path.index' + - $ref: '#/components/parameters/index::query.wait_for_active_shards' + - $ref: '#/components/parameters/index::query.op_type' + - $ref: '#/components/parameters/index::query.refresh' + - $ref: '#/components/parameters/index::query.routing' + - $ref: '#/components/parameters/index::query.timeout' + - $ref: '#/components/parameters/index::query.version' + - $ref: '#/components/parameters/index::query.version_type' + - $ref: '#/components/parameters/index::query.if_seq_no' + - $ref: '#/components/parameters/index::query.if_primary_term' + - $ref: '#/components/parameters/index::query.pipeline' + - $ref: '#/components/parameters/index::query.require_alias' + requestBody: + $ref: '#/components/requestBodies/index' + responses: + '200': + $ref: '#/components/responses/index@200' + /{index}/_explain/{id}: + get: + operationId: explain.0 + x-operation-group: explain + x-version-added: '1.0' + description: Returns information about why a specific matches (or doesn't match) a query. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/explain/ + parameters: + - $ref: '#/components/parameters/explain::path.id' + - $ref: '#/components/parameters/explain::path.index' + - $ref: '#/components/parameters/explain::query.analyze_wildcard' + - $ref: '#/components/parameters/explain::query.analyzer' + - $ref: '#/components/parameters/explain::query.default_operator' + - $ref: '#/components/parameters/explain::query.df' + - $ref: '#/components/parameters/explain::query.stored_fields' + - $ref: '#/components/parameters/explain::query.lenient' + - $ref: '#/components/parameters/explain::query.preference' + - $ref: '#/components/parameters/explain::query.q' + - $ref: '#/components/parameters/explain::query.routing' + - $ref: '#/components/parameters/explain::query._source' + - $ref: '#/components/parameters/explain::query._source_excludes' + - $ref: '#/components/parameters/explain::query._source_includes' + requestBody: + $ref: '#/components/requestBodies/explain' + responses: + '200': + $ref: '#/components/responses/explain@200' + post: + operationId: explain.1 + x-operation-group: explain + x-version-added: '1.0' + description: Returns information about why a specific matches (or doesn't match) a query. + parameters: + - $ref: '#/components/parameters/explain::path.id' + - $ref: '#/components/parameters/explain::path.index' + - $ref: '#/components/parameters/explain::query.analyze_wildcard' + - $ref: '#/components/parameters/explain::query.analyzer' + - $ref: '#/components/parameters/explain::query.default_operator' + - $ref: '#/components/parameters/explain::query.df' + - $ref: '#/components/parameters/explain::query.stored_fields' + - $ref: '#/components/parameters/explain::query.lenient' + - $ref: '#/components/parameters/explain::query.preference' + - $ref: '#/components/parameters/explain::query.q' + - $ref: '#/components/parameters/explain::query.routing' + - $ref: '#/components/parameters/explain::query._source' + - $ref: '#/components/parameters/explain::query._source_excludes' + - $ref: '#/components/parameters/explain::query._source_includes' + requestBody: + $ref: '#/components/requestBodies/explain' + responses: + '200': + $ref: '#/components/responses/explain@200' + /{index}/_field_caps: + get: + operationId: field_caps.2 + x-operation-group: field_caps + x-version-added: '1.0' + description: Returns the information about the capabilities of fields among multiple indices. + parameters: + - $ref: '#/components/parameters/field_caps::path.index' + - $ref: '#/components/parameters/field_caps::query.fields' + - $ref: '#/components/parameters/field_caps::query.ignore_unavailable' + - $ref: '#/components/parameters/field_caps::query.allow_no_indices' + - $ref: '#/components/parameters/field_caps::query.expand_wildcards' + - $ref: '#/components/parameters/field_caps::query.include_unmapped' + requestBody: + $ref: '#/components/requestBodies/field_caps' + responses: + '200': + $ref: '#/components/responses/field_caps@200' + post: + operationId: field_caps.3 + x-operation-group: field_caps + x-version-added: '1.0' + description: Returns the information about the capabilities of fields among multiple indices. + parameters: + - $ref: '#/components/parameters/field_caps::path.index' + - $ref: '#/components/parameters/field_caps::query.fields' + - $ref: '#/components/parameters/field_caps::query.ignore_unavailable' + - $ref: '#/components/parameters/field_caps::query.allow_no_indices' + - $ref: '#/components/parameters/field_caps::query.expand_wildcards' + - $ref: '#/components/parameters/field_caps::query.include_unmapped' + requestBody: + $ref: '#/components/requestBodies/field_caps' + responses: + '200': + $ref: '#/components/responses/field_caps@200' + /{index}/_flush: + get: + operationId: indices.flush.2 + x-operation-group: indices.flush + x-version-added: '1.0' + description: Performs the flush operation on one or more indices. + parameters: + - $ref: '#/components/parameters/indices.flush::path.index' + - $ref: '#/components/parameters/indices.flush::query.force' + - $ref: '#/components/parameters/indices.flush::query.wait_if_ongoing' + - $ref: '#/components/parameters/indices.flush::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.flush::query.allow_no_indices' + - $ref: '#/components/parameters/indices.flush::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.flush@200' + post: + operationId: indices.flush.3 + x-operation-group: indices.flush + x-version-added: '1.0' + description: Performs the flush operation on one or more indices. + parameters: + - $ref: '#/components/parameters/indices.flush::path.index' + - $ref: '#/components/parameters/indices.flush::query.force' + - $ref: '#/components/parameters/indices.flush::query.wait_if_ongoing' + - $ref: '#/components/parameters/indices.flush::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.flush::query.allow_no_indices' + - $ref: '#/components/parameters/indices.flush::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.flush@200' + /{index}/_forcemerge: + post: + operationId: indices.forcemerge.1 + x-operation-group: indices.forcemerge + x-version-added: '1.0' + description: Performs the force merge operation on one or more indices. + parameters: + - $ref: '#/components/parameters/indices.forcemerge::path.index' + - $ref: '#/components/parameters/indices.forcemerge::query.flush' + - $ref: '#/components/parameters/indices.forcemerge::query.primary_only' + - $ref: '#/components/parameters/indices.forcemerge::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.forcemerge::query.allow_no_indices' + - $ref: '#/components/parameters/indices.forcemerge::query.expand_wildcards' + - $ref: '#/components/parameters/indices.forcemerge::query.max_num_segments' + - $ref: '#/components/parameters/indices.forcemerge::query.only_expunge_deletes' + - $ref: '#/components/parameters/indices.forcemerge::query.wait_for_completion' + responses: + '200': + $ref: '#/components/responses/indices.forcemerge@200' + /{index}/_mapping: + get: + operationId: indices.get_mapping.1 + x-operation-group: indices.get_mapping + x-version-added: '1.0' + description: Returns mappings for one or more indices. + parameters: + - $ref: '#/components/parameters/indices.get_mapping::path.index' + - $ref: '#/components/parameters/indices.get_mapping::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_mapping::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_mapping::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_mapping::query.master_timeout' + - $ref: '#/components/parameters/indices.get_mapping::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_mapping::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_mapping@200' + post: + operationId: indices.put_mapping.0 + x-operation-group: indices.put_mapping + x-version-added: '1.0' + description: Updates the index mappings. + parameters: + - $ref: '#/components/parameters/indices.put_mapping::path.index' + - $ref: '#/components/parameters/indices.put_mapping::query.timeout' + - $ref: '#/components/parameters/indices.put_mapping::query.master_timeout' + - $ref: '#/components/parameters/indices.put_mapping::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.put_mapping::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.put_mapping::query.allow_no_indices' + - $ref: '#/components/parameters/indices.put_mapping::query.expand_wildcards' + - $ref: '#/components/parameters/indices.put_mapping::query.write_index_only' + requestBody: + $ref: '#/components/requestBodies/indices.put_mapping' + responses: + '200': + $ref: '#/components/responses/indices.put_mapping@200' + put: + operationId: indices.put_mapping.1 + x-operation-group: indices.put_mapping + x-version-added: '1.0' + description: Updates the index mappings. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/put-mapping/ + parameters: + - $ref: '#/components/parameters/indices.put_mapping::path.index' + - $ref: '#/components/parameters/indices.put_mapping::query.timeout' + - $ref: '#/components/parameters/indices.put_mapping::query.master_timeout' + - $ref: '#/components/parameters/indices.put_mapping::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.put_mapping::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.put_mapping::query.allow_no_indices' + - $ref: '#/components/parameters/indices.put_mapping::query.expand_wildcards' + - $ref: '#/components/parameters/indices.put_mapping::query.write_index_only' + requestBody: + $ref: '#/components/requestBodies/indices.put_mapping' + responses: + '200': + $ref: '#/components/responses/indices.put_mapping@200' + /{index}/_mapping/field/{fields}: + get: + operationId: indices.get_field_mapping.1 + x-operation-group: indices.get_field_mapping + x-version-added: '1.0' + description: Returns mapping for one or more fields. + parameters: + - $ref: '#/components/parameters/indices.get_field_mapping::path.index' + - $ref: '#/components/parameters/indices.get_field_mapping::path.fields' + - $ref: '#/components/parameters/indices.get_field_mapping::query.include_defaults' + - $ref: '#/components/parameters/indices.get_field_mapping::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_field_mapping::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_field_mapping::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_field_mapping::query.local' + responses: + '200': + $ref: '#/components/responses/indices.get_field_mapping@200' + /{index}/_mget: + get: + operationId: mget.2 + x-operation-group: mget + x-version-added: '1.0' + description: Allows to get multiple documents in one request. + parameters: + - $ref: '#/components/parameters/mget::path.index' + - $ref: '#/components/parameters/mget::query.stored_fields' + - $ref: '#/components/parameters/mget::query.preference' + - $ref: '#/components/parameters/mget::query.realtime' + - $ref: '#/components/parameters/mget::query.refresh' + - $ref: '#/components/parameters/mget::query.routing' + - $ref: '#/components/parameters/mget::query._source' + - $ref: '#/components/parameters/mget::query._source_excludes' + - $ref: '#/components/parameters/mget::query._source_includes' + requestBody: + $ref: '#/components/requestBodies/mget' + responses: + '200': + $ref: '#/components/responses/mget@200' + post: + operationId: mget.3 + x-operation-group: mget + x-version-added: '1.0' + description: Allows to get multiple documents in one request. + parameters: + - $ref: '#/components/parameters/mget::path.index' + - $ref: '#/components/parameters/mget::query.stored_fields' + - $ref: '#/components/parameters/mget::query.preference' + - $ref: '#/components/parameters/mget::query.realtime' + - $ref: '#/components/parameters/mget::query.refresh' + - $ref: '#/components/parameters/mget::query.routing' + - $ref: '#/components/parameters/mget::query._source' + - $ref: '#/components/parameters/mget::query._source_excludes' + - $ref: '#/components/parameters/mget::query._source_includes' + requestBody: + $ref: '#/components/requestBodies/mget' + responses: + '200': + $ref: '#/components/responses/mget@200' + /{index}/_msearch: + get: + operationId: msearch.2 + x-operation-group: msearch + x-version-added: '1.0' + description: Allows to execute several search operations in one request. + parameters: + - $ref: '#/components/parameters/msearch::path.index' + - $ref: '#/components/parameters/msearch::query.search_type' + - $ref: '#/components/parameters/msearch::query.max_concurrent_searches' + - $ref: '#/components/parameters/msearch::query.typed_keys' + - $ref: '#/components/parameters/msearch::query.pre_filter_shard_size' + - $ref: '#/components/parameters/msearch::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/msearch::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/msearch::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/msearch' + responses: + '200': + $ref: '#/components/responses/msearch@200' + post: + operationId: msearch.3 + x-operation-group: msearch + x-version-added: '1.0' + description: Allows to execute several search operations in one request. + parameters: + - $ref: '#/components/parameters/msearch::path.index' + - $ref: '#/components/parameters/msearch::query.search_type' + - $ref: '#/components/parameters/msearch::query.max_concurrent_searches' + - $ref: '#/components/parameters/msearch::query.typed_keys' + - $ref: '#/components/parameters/msearch::query.pre_filter_shard_size' + - $ref: '#/components/parameters/msearch::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/msearch::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/msearch::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/msearch' + responses: + '200': + $ref: '#/components/responses/msearch@200' + /{index}/_msearch/template: + get: + operationId: msearch_template.2 + x-operation-group: msearch_template + x-version-added: '1.0' + description: Allows to execute several search template operations in one request. + parameters: + - $ref: '#/components/parameters/msearch_template::path.index' + - $ref: '#/components/parameters/msearch_template::query.search_type' + - $ref: '#/components/parameters/msearch_template::query.typed_keys' + - $ref: '#/components/parameters/msearch_template::query.max_concurrent_searches' + - $ref: '#/components/parameters/msearch_template::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/msearch_template::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/msearch_template' + responses: + '200': + $ref: '#/components/responses/msearch_template@200' + post: + operationId: msearch_template.3 + x-operation-group: msearch_template + x-version-added: '1.0' + description: Allows to execute several search template operations in one request. + parameters: + - $ref: '#/components/parameters/msearch_template::path.index' + - $ref: '#/components/parameters/msearch_template::query.search_type' + - $ref: '#/components/parameters/msearch_template::query.typed_keys' + - $ref: '#/components/parameters/msearch_template::query.max_concurrent_searches' + - $ref: '#/components/parameters/msearch_template::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/msearch_template::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/msearch_template' + responses: + '200': + $ref: '#/components/responses/msearch_template@200' + /{index}/_mtermvectors: + get: + operationId: mtermvectors.2 + x-operation-group: mtermvectors + x-version-added: '1.0' + description: Returns multiple termvectors in one request. + parameters: + - $ref: '#/components/parameters/mtermvectors::path.index' + - $ref: '#/components/parameters/mtermvectors::query.ids' + - $ref: '#/components/parameters/mtermvectors::query.term_statistics' + - $ref: '#/components/parameters/mtermvectors::query.field_statistics' + - $ref: '#/components/parameters/mtermvectors::query.fields' + - $ref: '#/components/parameters/mtermvectors::query.offsets' + - $ref: '#/components/parameters/mtermvectors::query.positions' + - $ref: '#/components/parameters/mtermvectors::query.payloads' + - $ref: '#/components/parameters/mtermvectors::query.preference' + - $ref: '#/components/parameters/mtermvectors::query.routing' + - $ref: '#/components/parameters/mtermvectors::query.realtime' + - $ref: '#/components/parameters/mtermvectors::query.version' + - $ref: '#/components/parameters/mtermvectors::query.version_type' + requestBody: + $ref: '#/components/requestBodies/mtermvectors' + responses: + '200': + $ref: '#/components/responses/mtermvectors@200' + post: + operationId: mtermvectors.3 + x-operation-group: mtermvectors + x-version-added: '1.0' + description: Returns multiple termvectors in one request. + parameters: + - $ref: '#/components/parameters/mtermvectors::path.index' + - $ref: '#/components/parameters/mtermvectors::query.ids' + - $ref: '#/components/parameters/mtermvectors::query.term_statistics' + - $ref: '#/components/parameters/mtermvectors::query.field_statistics' + - $ref: '#/components/parameters/mtermvectors::query.fields' + - $ref: '#/components/parameters/mtermvectors::query.offsets' + - $ref: '#/components/parameters/mtermvectors::query.positions' + - $ref: '#/components/parameters/mtermvectors::query.payloads' + - $ref: '#/components/parameters/mtermvectors::query.preference' + - $ref: '#/components/parameters/mtermvectors::query.routing' + - $ref: '#/components/parameters/mtermvectors::query.realtime' + - $ref: '#/components/parameters/mtermvectors::query.version' + - $ref: '#/components/parameters/mtermvectors::query.version_type' + requestBody: + $ref: '#/components/requestBodies/mtermvectors' + responses: + '200': + $ref: '#/components/responses/mtermvectors@200' + /{index}/_open: + post: + operationId: indices.open.0 + x-operation-group: indices.open + x-version-added: '1.0' + description: Opens an index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/open-index/ + parameters: + - $ref: '#/components/parameters/indices.open::path.index' + - $ref: '#/components/parameters/indices.open::query.timeout' + - $ref: '#/components/parameters/indices.open::query.master_timeout' + - $ref: '#/components/parameters/indices.open::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.open::query.allow_no_indices' + - $ref: '#/components/parameters/indices.open::query.expand_wildcards' + - $ref: '#/components/parameters/indices.open::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.open::query.wait_for_active_shards' + - $ref: '#/components/parameters/indices.open::query.wait_for_completion' + - $ref: '#/components/parameters/indices.open::query.task_execution_timeout' + responses: + '200': + $ref: '#/components/responses/indices.open@200' + /{index}/_rank_eval: + get: + operationId: rank_eval.2 + x-operation-group: rank_eval + x-version-added: '1.0' + description: Allows to evaluate the quality of ranked search results over a set of typical search queries. + parameters: + - $ref: '#/components/parameters/rank_eval::path.index' + - $ref: '#/components/parameters/rank_eval::query.ignore_unavailable' + - $ref: '#/components/parameters/rank_eval::query.allow_no_indices' + - $ref: '#/components/parameters/rank_eval::query.expand_wildcards' + - $ref: '#/components/parameters/rank_eval::query.search_type' + requestBody: + $ref: '#/components/requestBodies/rank_eval' + responses: + '200': + $ref: '#/components/responses/rank_eval@200' + post: + operationId: rank_eval.3 + x-operation-group: rank_eval + x-version-added: '1.0' + description: Allows to evaluate the quality of ranked search results over a set of typical search queries. + parameters: + - $ref: '#/components/parameters/rank_eval::path.index' + - $ref: '#/components/parameters/rank_eval::query.ignore_unavailable' + - $ref: '#/components/parameters/rank_eval::query.allow_no_indices' + - $ref: '#/components/parameters/rank_eval::query.expand_wildcards' + - $ref: '#/components/parameters/rank_eval::query.search_type' + requestBody: + $ref: '#/components/requestBodies/rank_eval' + responses: + '200': + $ref: '#/components/responses/rank_eval@200' + /{index}/_recovery: + get: + operationId: indices.recovery.1 + x-operation-group: indices.recovery + x-version-added: '1.0' + description: Returns information about ongoing index shard recoveries. + parameters: + - $ref: '#/components/parameters/indices.recovery::path.index' + - $ref: '#/components/parameters/indices.recovery::query.detailed' + - $ref: '#/components/parameters/indices.recovery::query.active_only' + responses: + '200': + $ref: '#/components/responses/indices.recovery@200' + /{index}/_refresh: + get: + operationId: indices.refresh.2 + x-operation-group: indices.refresh + x-version-added: '1.0' + description: Performs the refresh operation in one or more indices. + parameters: + - $ref: '#/components/parameters/indices.refresh::path.index' + - $ref: '#/components/parameters/indices.refresh::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.refresh::query.allow_no_indices' + - $ref: '#/components/parameters/indices.refresh::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.refresh@200' + post: + operationId: indices.refresh.3 + x-operation-group: indices.refresh + x-version-added: '1.0' + description: Performs the refresh operation in one or more indices. + parameters: + - $ref: '#/components/parameters/indices.refresh::path.index' + - $ref: '#/components/parameters/indices.refresh::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.refresh::query.allow_no_indices' + - $ref: '#/components/parameters/indices.refresh::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.refresh@200' + /{index}/_search: + get: + operationId: search.2 + x-operation-group: search + x-version-added: '1.0' + description: Returns results matching a query. + parameters: + - $ref: '#/components/parameters/search::path.index' + - $ref: '#/components/parameters/search::query.analyzer' + - $ref: '#/components/parameters/search::query.analyze_wildcard' + - $ref: '#/components/parameters/search::query.ccs_minimize_roundtrips' + - $ref: '#/components/parameters/search::query.default_operator' + - $ref: '#/components/parameters/search::query.df' + - $ref: '#/components/parameters/search::query.explain' + - $ref: '#/components/parameters/search::query.stored_fields' + - $ref: '#/components/parameters/search::query.docvalue_fields' + - $ref: '#/components/parameters/search::query.from' + - $ref: '#/components/parameters/search::query.ignore_unavailable' + - $ref: '#/components/parameters/search::query.ignore_throttled' + - $ref: '#/components/parameters/search::query.allow_no_indices' + - $ref: '#/components/parameters/search::query.expand_wildcards' + - $ref: '#/components/parameters/search::query.lenient' + - $ref: '#/components/parameters/search::query.preference' + - $ref: '#/components/parameters/search::query.q' + - $ref: '#/components/parameters/search::query.routing' + - $ref: '#/components/parameters/search::query.scroll' + - $ref: '#/components/parameters/search::query.search_type' + - $ref: '#/components/parameters/search::query.size' + - $ref: '#/components/parameters/search::query.sort' + - $ref: '#/components/parameters/search::query._source' + - $ref: '#/components/parameters/search::query._source_excludes' + - $ref: '#/components/parameters/search::query._source_includes' + - $ref: '#/components/parameters/search::query.terminate_after' + - $ref: '#/components/parameters/search::query.stats' + - $ref: '#/components/parameters/search::query.suggest_field' + - $ref: '#/components/parameters/search::query.suggest_mode' + - $ref: '#/components/parameters/search::query.suggest_size' + - $ref: '#/components/parameters/search::query.suggest_text' + - $ref: '#/components/parameters/search::query.timeout' + - $ref: '#/components/parameters/search::query.track_scores' + - $ref: '#/components/parameters/search::query.track_total_hits' + - $ref: '#/components/parameters/search::query.allow_partial_search_results' + - $ref: '#/components/parameters/search::query.typed_keys' + - $ref: '#/components/parameters/search::query.version' + - $ref: '#/components/parameters/search::query.seq_no_primary_term' + - $ref: '#/components/parameters/search::query.request_cache' + - $ref: '#/components/parameters/search::query.batched_reduce_size' + - $ref: '#/components/parameters/search::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/search::query.pre_filter_shard_size' + - $ref: '#/components/parameters/search::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/search::query.search_pipeline' + - $ref: '#/components/parameters/search::query.include_named_queries_score' + requestBody: + $ref: '#/components/requestBodies/search' + responses: + '200': + $ref: '#/components/responses/search@200' + post: + operationId: search.3 + x-operation-group: search + x-version-added: '1.0' + description: Returns results matching a query. + parameters: + - $ref: '#/components/parameters/search::path.index' + - $ref: '#/components/parameters/search::query.analyzer' + - $ref: '#/components/parameters/search::query.analyze_wildcard' + - $ref: '#/components/parameters/search::query.ccs_minimize_roundtrips' + - $ref: '#/components/parameters/search::query.default_operator' + - $ref: '#/components/parameters/search::query.df' + - $ref: '#/components/parameters/search::query.explain' + - $ref: '#/components/parameters/search::query.stored_fields' + - $ref: '#/components/parameters/search::query.docvalue_fields' + - $ref: '#/components/parameters/search::query.from' + - $ref: '#/components/parameters/search::query.ignore_unavailable' + - $ref: '#/components/parameters/search::query.ignore_throttled' + - $ref: '#/components/parameters/search::query.allow_no_indices' + - $ref: '#/components/parameters/search::query.expand_wildcards' + - $ref: '#/components/parameters/search::query.lenient' + - $ref: '#/components/parameters/search::query.preference' + - $ref: '#/components/parameters/search::query.q' + - $ref: '#/components/parameters/search::query.routing' + - $ref: '#/components/parameters/search::query.scroll' + - $ref: '#/components/parameters/search::query.search_type' + - $ref: '#/components/parameters/search::query.size' + - $ref: '#/components/parameters/search::query.sort' + - $ref: '#/components/parameters/search::query._source' + - $ref: '#/components/parameters/search::query._source_excludes' + - $ref: '#/components/parameters/search::query._source_includes' + - $ref: '#/components/parameters/search::query.terminate_after' + - $ref: '#/components/parameters/search::query.stats' + - $ref: '#/components/parameters/search::query.suggest_field' + - $ref: '#/components/parameters/search::query.suggest_mode' + - $ref: '#/components/parameters/search::query.suggest_size' + - $ref: '#/components/parameters/search::query.suggest_text' + - $ref: '#/components/parameters/search::query.timeout' + - $ref: '#/components/parameters/search::query.track_scores' + - $ref: '#/components/parameters/search::query.track_total_hits' + - $ref: '#/components/parameters/search::query.allow_partial_search_results' + - $ref: '#/components/parameters/search::query.typed_keys' + - $ref: '#/components/parameters/search::query.version' + - $ref: '#/components/parameters/search::query.seq_no_primary_term' + - $ref: '#/components/parameters/search::query.request_cache' + - $ref: '#/components/parameters/search::query.batched_reduce_size' + - $ref: '#/components/parameters/search::query.max_concurrent_shard_requests' + - $ref: '#/components/parameters/search::query.pre_filter_shard_size' + - $ref: '#/components/parameters/search::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/search::query.search_pipeline' + - $ref: '#/components/parameters/search::query.include_named_queries_score' + requestBody: + $ref: '#/components/requestBodies/search' + responses: + '200': + $ref: '#/components/responses/search@200' + /{index}/_search/point_in_time: + post: + operationId: create_pit.0 + x-operation-group: create_pit + x-version-added: '2.4' + description: Creates point in time context. + externalDocs: + url: https://opensearch.org/docs/latest/search-plugins/point-in-time-api/#create-a-pit + parameters: + - $ref: '#/components/parameters/create_pit::path.index' + - $ref: '#/components/parameters/create_pit::query.allow_partial_pit_creation' + - $ref: '#/components/parameters/create_pit::query.keep_alive' + - $ref: '#/components/parameters/create_pit::query.preference' + - $ref: '#/components/parameters/create_pit::query.routing' + - $ref: '#/components/parameters/create_pit::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/create_pit@200' + /{index}/_search/template: + get: + operationId: search_template.2 + x-operation-group: search_template + x-version-added: '1.0' + description: Allows to use the Mustache language to pre-render a search definition. + parameters: + - $ref: '#/components/parameters/search_template::path.index' + - $ref: '#/components/parameters/search_template::query.ignore_unavailable' + - $ref: '#/components/parameters/search_template::query.ignore_throttled' + - $ref: '#/components/parameters/search_template::query.allow_no_indices' + - $ref: '#/components/parameters/search_template::query.expand_wildcards' + - $ref: '#/components/parameters/search_template::query.preference' + - $ref: '#/components/parameters/search_template::query.routing' + - $ref: '#/components/parameters/search_template::query.scroll' + - $ref: '#/components/parameters/search_template::query.search_type' + - $ref: '#/components/parameters/search_template::query.explain' + - $ref: '#/components/parameters/search_template::query.profile' + - $ref: '#/components/parameters/search_template::query.typed_keys' + - $ref: '#/components/parameters/search_template::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/search_template::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/search_template' + responses: + '200': + $ref: '#/components/responses/search_template@200' + post: + operationId: search_template.3 + x-operation-group: search_template + x-version-added: '1.0' + description: Allows to use the Mustache language to pre-render a search definition. + parameters: + - $ref: '#/components/parameters/search_template::path.index' + - $ref: '#/components/parameters/search_template::query.ignore_unavailable' + - $ref: '#/components/parameters/search_template::query.ignore_throttled' + - $ref: '#/components/parameters/search_template::query.allow_no_indices' + - $ref: '#/components/parameters/search_template::query.expand_wildcards' + - $ref: '#/components/parameters/search_template::query.preference' + - $ref: '#/components/parameters/search_template::query.routing' + - $ref: '#/components/parameters/search_template::query.scroll' + - $ref: '#/components/parameters/search_template::query.search_type' + - $ref: '#/components/parameters/search_template::query.explain' + - $ref: '#/components/parameters/search_template::query.profile' + - $ref: '#/components/parameters/search_template::query.typed_keys' + - $ref: '#/components/parameters/search_template::query.rest_total_hits_as_int' + - $ref: '#/components/parameters/search_template::query.ccs_minimize_roundtrips' + requestBody: + $ref: '#/components/requestBodies/search_template' + responses: + '200': + $ref: '#/components/responses/search_template@200' + /{index}/_search_shards: + get: + operationId: search_shards.2 + x-operation-group: search_shards + x-version-added: '1.0' + description: Returns information about the indices and shards that a search request would be executed against. + parameters: + - $ref: '#/components/parameters/search_shards::path.index' + - $ref: '#/components/parameters/search_shards::query.preference' + - $ref: '#/components/parameters/search_shards::query.routing' + - $ref: '#/components/parameters/search_shards::query.local' + - $ref: '#/components/parameters/search_shards::query.ignore_unavailable' + - $ref: '#/components/parameters/search_shards::query.allow_no_indices' + - $ref: '#/components/parameters/search_shards::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/search_shards@200' + post: + operationId: search_shards.3 + x-operation-group: search_shards + x-version-added: '1.0' + description: Returns information about the indices and shards that a search request would be executed against. + parameters: + - $ref: '#/components/parameters/search_shards::path.index' + - $ref: '#/components/parameters/search_shards::query.preference' + - $ref: '#/components/parameters/search_shards::query.routing' + - $ref: '#/components/parameters/search_shards::query.local' + - $ref: '#/components/parameters/search_shards::query.ignore_unavailable' + - $ref: '#/components/parameters/search_shards::query.allow_no_indices' + - $ref: '#/components/parameters/search_shards::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/search_shards@200' + /{index}/_segments: + get: + operationId: indices.segments.1 + x-operation-group: indices.segments + x-version-added: '1.0' + description: Provides low-level information about segments in a Lucene index. + parameters: + - $ref: '#/components/parameters/indices.segments::path.index' + - $ref: '#/components/parameters/indices.segments::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.segments::query.allow_no_indices' + - $ref: '#/components/parameters/indices.segments::query.expand_wildcards' + - $ref: '#/components/parameters/indices.segments::query.verbose' + responses: + '200': + $ref: '#/components/responses/indices.segments@200' + /{index}/_settings: + get: + operationId: indices.get_settings.2 + x-operation-group: indices.get_settings + x-version-added: '1.0' + description: Returns settings for one or more indices. + parameters: + - $ref: '#/components/parameters/indices.get_settings::path.index' + - $ref: '#/components/parameters/indices.get_settings::query.master_timeout' + - $ref: '#/components/parameters/indices.get_settings::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_settings::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_settings::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_settings::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_settings::query.flat_settings' + - $ref: '#/components/parameters/indices.get_settings::query.local' + - $ref: '#/components/parameters/indices.get_settings::query.include_defaults' + responses: + '200': + $ref: '#/components/responses/indices.get_settings@200' + put: + operationId: indices.put_settings.1 + x-operation-group: indices.put_settings + x-version-added: '1.0' + description: Updates the index settings. + parameters: + - $ref: '#/components/parameters/indices.put_settings::path.index' + - $ref: '#/components/parameters/indices.put_settings::query.master_timeout' + - $ref: '#/components/parameters/indices.put_settings::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.put_settings::query.timeout' + - $ref: '#/components/parameters/indices.put_settings::query.preserve_existing' + - $ref: '#/components/parameters/indices.put_settings::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.put_settings::query.allow_no_indices' + - $ref: '#/components/parameters/indices.put_settings::query.expand_wildcards' + - $ref: '#/components/parameters/indices.put_settings::query.flat_settings' + requestBody: + $ref: '#/components/requestBodies/indices.put_settings' + responses: + '200': + $ref: '#/components/responses/indices.put_settings@200' + /{index}/_settings/{name}: + get: + operationId: indices.get_settings.3 + x-operation-group: indices.get_settings + x-version-added: '1.0' + description: Returns settings for one or more indices. + parameters: + - $ref: '#/components/parameters/indices.get_settings::path.index' + - $ref: '#/components/parameters/indices.get_settings::path.name' + - $ref: '#/components/parameters/indices.get_settings::query.master_timeout' + - $ref: '#/components/parameters/indices.get_settings::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.get_settings::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_settings::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_settings::query.expand_wildcards' + - $ref: '#/components/parameters/indices.get_settings::query.flat_settings' + - $ref: '#/components/parameters/indices.get_settings::query.local' + - $ref: '#/components/parameters/indices.get_settings::query.include_defaults' + responses: + '200': + $ref: '#/components/responses/indices.get_settings@200' + /{index}/_shard_stores: + get: + operationId: indices.shard_stores.1 + x-operation-group: indices.shard_stores + x-version-added: '1.0' + description: Provides store information for shard copies of indices. + parameters: + - $ref: '#/components/parameters/indices.shard_stores::path.index' + - $ref: '#/components/parameters/indices.shard_stores::query.status' + - $ref: '#/components/parameters/indices.shard_stores::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.shard_stores::query.allow_no_indices' + - $ref: '#/components/parameters/indices.shard_stores::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.shard_stores@200' + /{index}/_shrink/{target}: + post: + operationId: indices.shrink.0 + x-operation-group: indices.shrink + x-version-added: '1.0' + description: Allow to shrink an existing index into a new index with fewer primary shards. + parameters: + - $ref: '#/components/parameters/indices.shrink::path.index' + - $ref: '#/components/parameters/indices.shrink::path.target' + - $ref: '#/components/parameters/indices.shrink::query.copy_settings' + - $ref: '#/components/parameters/indices.shrink::query.timeout' + - $ref: '#/components/parameters/indices.shrink::query.master_timeout' + - $ref: '#/components/parameters/indices.shrink::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.shrink::query.wait_for_active_shards' + - $ref: '#/components/parameters/indices.shrink::query.wait_for_completion' + - $ref: '#/components/parameters/indices.shrink::query.task_execution_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.shrink' + responses: + '200': + $ref: '#/components/responses/indices.shrink@200' + put: + operationId: indices.shrink.1 + x-operation-group: indices.shrink + x-version-added: '1.0' + description: Allow to shrink an existing index into a new index with fewer primary shards. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/shrink-index/ + parameters: + - $ref: '#/components/parameters/indices.shrink::path.index' + - $ref: '#/components/parameters/indices.shrink::path.target' + - $ref: '#/components/parameters/indices.shrink::query.copy_settings' + - $ref: '#/components/parameters/indices.shrink::query.timeout' + - $ref: '#/components/parameters/indices.shrink::query.master_timeout' + - $ref: '#/components/parameters/indices.shrink::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.shrink::query.wait_for_active_shards' + - $ref: '#/components/parameters/indices.shrink::query.wait_for_completion' + - $ref: '#/components/parameters/indices.shrink::query.task_execution_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.shrink' + responses: + '200': + $ref: '#/components/responses/indices.shrink@200' + /{index}/_source/{id}: + get: + operationId: get_source.0 + x-operation-group: get_source + x-version-added: '1.0' + description: Returns the source of a document. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/ + parameters: + - $ref: '#/components/parameters/get_source::path.id' + - $ref: '#/components/parameters/get_source::path.index' + - $ref: '#/components/parameters/get_source::query.preference' + - $ref: '#/components/parameters/get_source::query.realtime' + - $ref: '#/components/parameters/get_source::query.refresh' + - $ref: '#/components/parameters/get_source::query.routing' + - $ref: '#/components/parameters/get_source::query._source' + - $ref: '#/components/parameters/get_source::query._source_excludes' + - $ref: '#/components/parameters/get_source::query._source_includes' + - $ref: '#/components/parameters/get_source::query.version' + - $ref: '#/components/parameters/get_source::query.version_type' + responses: + '200': + $ref: '#/components/responses/get_source@200' + head: + operationId: exists_source.0 + x-operation-group: exists_source + x-version-added: '1.0' + description: Returns information about whether a document source exists in an index. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/get-documents/ + parameters: + - $ref: '#/components/parameters/exists_source::path.id' + - $ref: '#/components/parameters/exists_source::path.index' + - $ref: '#/components/parameters/exists_source::query.preference' + - $ref: '#/components/parameters/exists_source::query.realtime' + - $ref: '#/components/parameters/exists_source::query.refresh' + - $ref: '#/components/parameters/exists_source::query.routing' + - $ref: '#/components/parameters/exists_source::query._source' + - $ref: '#/components/parameters/exists_source::query._source_excludes' + - $ref: '#/components/parameters/exists_source::query._source_includes' + - $ref: '#/components/parameters/exists_source::query.version' + - $ref: '#/components/parameters/exists_source::query.version_type' + responses: + '200': + $ref: '#/components/responses/exists_source@200' + /{index}/_split/{target}: + post: + operationId: indices.split.0 + x-operation-group: indices.split + x-version-added: '1.0' + description: Allows you to split an existing index into a new index with more primary shards. + parameters: + - $ref: '#/components/parameters/indices.split::path.index' + - $ref: '#/components/parameters/indices.split::path.target' + - $ref: '#/components/parameters/indices.split::query.copy_settings' + - $ref: '#/components/parameters/indices.split::query.timeout' + - $ref: '#/components/parameters/indices.split::query.master_timeout' + - $ref: '#/components/parameters/indices.split::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.split::query.wait_for_active_shards' + - $ref: '#/components/parameters/indices.split::query.wait_for_completion' + - $ref: '#/components/parameters/indices.split::query.task_execution_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.split' + responses: + '200': + $ref: '#/components/responses/indices.split@200' + put: + operationId: indices.split.1 + x-operation-group: indices.split + x-version-added: '1.0' + description: Allows you to split an existing index into a new index with more primary shards. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/index-apis/split/ + parameters: + - $ref: '#/components/parameters/indices.split::path.index' + - $ref: '#/components/parameters/indices.split::path.target' + - $ref: '#/components/parameters/indices.split::query.copy_settings' + - $ref: '#/components/parameters/indices.split::query.timeout' + - $ref: '#/components/parameters/indices.split::query.master_timeout' + - $ref: '#/components/parameters/indices.split::query.cluster_manager_timeout' + - $ref: '#/components/parameters/indices.split::query.wait_for_active_shards' + - $ref: '#/components/parameters/indices.split::query.wait_for_completion' + - $ref: '#/components/parameters/indices.split::query.task_execution_timeout' + requestBody: + $ref: '#/components/requestBodies/indices.split' + responses: + '200': + $ref: '#/components/responses/indices.split@200' + /{index}/_stats: + get: + operationId: indices.stats.2 + x-operation-group: indices.stats + x-version-added: '1.0' + description: Provides statistics on operations happening in an index. + parameters: + - $ref: '#/components/parameters/indices.stats::path.index' + - $ref: '#/components/parameters/indices.stats::query.completion_fields' + - $ref: '#/components/parameters/indices.stats::query.fielddata_fields' + - $ref: '#/components/parameters/indices.stats::query.fields' + - $ref: '#/components/parameters/indices.stats::query.groups' + - $ref: '#/components/parameters/indices.stats::query.level' + - $ref: '#/components/parameters/indices.stats::query.include_segment_file_sizes' + - $ref: '#/components/parameters/indices.stats::query.include_unloaded_segments' + - $ref: '#/components/parameters/indices.stats::query.expand_wildcards' + - $ref: '#/components/parameters/indices.stats::query.forbid_closed_indices' + responses: + '200': + $ref: '#/components/responses/indices.stats@200' + /{index}/_stats/{metric}: + get: + operationId: indices.stats.3 + x-operation-group: indices.stats + x-version-added: '1.0' + description: Provides statistics on operations happening in an index. + parameters: + - $ref: '#/components/parameters/indices.stats::path.index' + - $ref: '#/components/parameters/indices.stats::path.metric' + - $ref: '#/components/parameters/indices.stats::query.completion_fields' + - $ref: '#/components/parameters/indices.stats::query.fielddata_fields' + - $ref: '#/components/parameters/indices.stats::query.fields' + - $ref: '#/components/parameters/indices.stats::query.groups' + - $ref: '#/components/parameters/indices.stats::query.level' + - $ref: '#/components/parameters/indices.stats::query.include_segment_file_sizes' + - $ref: '#/components/parameters/indices.stats::query.include_unloaded_segments' + - $ref: '#/components/parameters/indices.stats::query.expand_wildcards' + - $ref: '#/components/parameters/indices.stats::query.forbid_closed_indices' + responses: + '200': + $ref: '#/components/responses/indices.stats@200' + /{index}/_termvectors: + get: + operationId: termvectors.0 + x-operation-group: termvectors + x-version-added: '1.0' + description: Returns information and statistics about terms in the fields of a particular document. + externalDocs: + url: https://opensearch.org/docs/latest + parameters: + - $ref: '#/components/parameters/termvectors::path.index' + - $ref: '#/components/parameters/termvectors::query.term_statistics' + - $ref: '#/components/parameters/termvectors::query.field_statistics' + - $ref: '#/components/parameters/termvectors::query.fields' + - $ref: '#/components/parameters/termvectors::query.offsets' + - $ref: '#/components/parameters/termvectors::query.positions' + - $ref: '#/components/parameters/termvectors::query.payloads' + - $ref: '#/components/parameters/termvectors::query.preference' + - $ref: '#/components/parameters/termvectors::query.routing' + - $ref: '#/components/parameters/termvectors::query.realtime' + - $ref: '#/components/parameters/termvectors::query.version' + - $ref: '#/components/parameters/termvectors::query.version_type' + requestBody: + $ref: '#/components/requestBodies/termvectors' + responses: + '200': + $ref: '#/components/responses/termvectors@200' + post: + operationId: termvectors.1 + x-operation-group: termvectors + x-version-added: '1.0' + description: Returns information and statistics about terms in the fields of a particular document. + parameters: + - $ref: '#/components/parameters/termvectors::path.index' + - $ref: '#/components/parameters/termvectors::query.term_statistics' + - $ref: '#/components/parameters/termvectors::query.field_statistics' + - $ref: '#/components/parameters/termvectors::query.fields' + - $ref: '#/components/parameters/termvectors::query.offsets' + - $ref: '#/components/parameters/termvectors::query.positions' + - $ref: '#/components/parameters/termvectors::query.payloads' + - $ref: '#/components/parameters/termvectors::query.preference' + - $ref: '#/components/parameters/termvectors::query.routing' + - $ref: '#/components/parameters/termvectors::query.realtime' + - $ref: '#/components/parameters/termvectors::query.version' + - $ref: '#/components/parameters/termvectors::query.version_type' + requestBody: + $ref: '#/components/requestBodies/termvectors' + responses: + '200': + $ref: '#/components/responses/termvectors@200' + /{index}/_termvectors/{id}: + get: + operationId: termvectors.2 + x-operation-group: termvectors + x-version-added: '1.0' + description: Returns information and statistics about terms in the fields of a particular document. + parameters: + - $ref: '#/components/parameters/termvectors::path.index' + - $ref: '#/components/parameters/termvectors::path.id' + - $ref: '#/components/parameters/termvectors::query.term_statistics' + - $ref: '#/components/parameters/termvectors::query.field_statistics' + - $ref: '#/components/parameters/termvectors::query.fields' + - $ref: '#/components/parameters/termvectors::query.offsets' + - $ref: '#/components/parameters/termvectors::query.positions' + - $ref: '#/components/parameters/termvectors::query.payloads' + - $ref: '#/components/parameters/termvectors::query.preference' + - $ref: '#/components/parameters/termvectors::query.routing' + - $ref: '#/components/parameters/termvectors::query.realtime' + - $ref: '#/components/parameters/termvectors::query.version' + - $ref: '#/components/parameters/termvectors::query.version_type' + requestBody: + $ref: '#/components/requestBodies/termvectors' + responses: + '200': + $ref: '#/components/responses/termvectors@200' + post: + operationId: termvectors.3 + x-operation-group: termvectors + x-version-added: '1.0' + description: Returns information and statistics about terms in the fields of a particular document. + parameters: + - $ref: '#/components/parameters/termvectors::path.index' + - $ref: '#/components/parameters/termvectors::path.id' + - $ref: '#/components/parameters/termvectors::query.term_statistics' + - $ref: '#/components/parameters/termvectors::query.field_statistics' + - $ref: '#/components/parameters/termvectors::query.fields' + - $ref: '#/components/parameters/termvectors::query.offsets' + - $ref: '#/components/parameters/termvectors::query.positions' + - $ref: '#/components/parameters/termvectors::query.payloads' + - $ref: '#/components/parameters/termvectors::query.preference' + - $ref: '#/components/parameters/termvectors::query.routing' + - $ref: '#/components/parameters/termvectors::query.realtime' + - $ref: '#/components/parameters/termvectors::query.version' + - $ref: '#/components/parameters/termvectors::query.version_type' + requestBody: + $ref: '#/components/requestBodies/termvectors' + responses: + '200': + $ref: '#/components/responses/termvectors@200' + /{index}/_update/{id}: + post: + operationId: update.0 + x-operation-group: update + x-version-added: '1.0' + description: Updates a document with a script or partial document. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/update-document/ + parameters: + - $ref: '#/components/parameters/update::path.id' + - $ref: '#/components/parameters/update::path.index' + - $ref: '#/components/parameters/update::query.wait_for_active_shards' + - $ref: '#/components/parameters/update::query._source' + - $ref: '#/components/parameters/update::query._source_excludes' + - $ref: '#/components/parameters/update::query._source_includes' + - $ref: '#/components/parameters/update::query.lang' + - $ref: '#/components/parameters/update::query.refresh' + - $ref: '#/components/parameters/update::query.retry_on_conflict' + - $ref: '#/components/parameters/update::query.routing' + - $ref: '#/components/parameters/update::query.timeout' + - $ref: '#/components/parameters/update::query.if_seq_no' + - $ref: '#/components/parameters/update::query.if_primary_term' + - $ref: '#/components/parameters/update::query.require_alias' + requestBody: + $ref: '#/components/requestBodies/update' + responses: + '200': + $ref: '#/components/responses/update@200' + /{index}/_update_by_query: + post: + operationId: update_by_query.0 + x-operation-group: update_by_query + x-version-added: '1.0' + description: |- + Performs an update on every document in the index without changing the source, + for example to pick up a mapping change. + externalDocs: + url: https://opensearch.org/docs/latest/api-reference/document-apis/update-by-query/ + parameters: + - $ref: '#/components/parameters/update_by_query::path.index' + - $ref: '#/components/parameters/update_by_query::query.analyzer' + - $ref: '#/components/parameters/update_by_query::query.analyze_wildcard' + - $ref: '#/components/parameters/update_by_query::query.default_operator' + - $ref: '#/components/parameters/update_by_query::query.df' + - $ref: '#/components/parameters/update_by_query::query.from' + - $ref: '#/components/parameters/update_by_query::query.ignore_unavailable' + - $ref: '#/components/parameters/update_by_query::query.allow_no_indices' + - $ref: '#/components/parameters/update_by_query::query.conflicts' + - $ref: '#/components/parameters/update_by_query::query.expand_wildcards' + - $ref: '#/components/parameters/update_by_query::query.lenient' + - $ref: '#/components/parameters/update_by_query::query.pipeline' + - $ref: '#/components/parameters/update_by_query::query.preference' + - $ref: '#/components/parameters/update_by_query::query.q' + - $ref: '#/components/parameters/update_by_query::query.routing' + - $ref: '#/components/parameters/update_by_query::query.scroll' + - $ref: '#/components/parameters/update_by_query::query.search_type' + - $ref: '#/components/parameters/update_by_query::query.search_timeout' + - $ref: '#/components/parameters/update_by_query::query.size' + - $ref: '#/components/parameters/update_by_query::query.max_docs' + - $ref: '#/components/parameters/update_by_query::query.sort' + - $ref: '#/components/parameters/update_by_query::query._source' + - $ref: '#/components/parameters/update_by_query::query._source_excludes' + - $ref: '#/components/parameters/update_by_query::query._source_includes' + - $ref: '#/components/parameters/update_by_query::query.terminate_after' + - $ref: '#/components/parameters/update_by_query::query.stats' + - $ref: '#/components/parameters/update_by_query::query.version' + - $ref: '#/components/parameters/update_by_query::query.request_cache' + - $ref: '#/components/parameters/update_by_query::query.refresh' + - $ref: '#/components/parameters/update_by_query::query.timeout' + - $ref: '#/components/parameters/update_by_query::query.wait_for_active_shards' + - $ref: '#/components/parameters/update_by_query::query.scroll_size' + - $ref: '#/components/parameters/update_by_query::query.wait_for_completion' + - $ref: '#/components/parameters/update_by_query::query.requests_per_second' + - $ref: '#/components/parameters/update_by_query::query.slices' + requestBody: + $ref: '#/components/requestBodies/update_by_query' + responses: + '200': + $ref: '#/components/responses/update_by_query@200' + /{index}/_upgrade: + get: + operationId: indices.get_upgrade.1 + x-operation-group: indices.get_upgrade + x-version-added: '1.0' + description: The _upgrade API is no longer useful and will be removed. + parameters: + - $ref: '#/components/parameters/indices.get_upgrade::path.index' + - $ref: '#/components/parameters/indices.get_upgrade::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.get_upgrade::query.allow_no_indices' + - $ref: '#/components/parameters/indices.get_upgrade::query.expand_wildcards' + responses: + '200': + $ref: '#/components/responses/indices.get_upgrade@200' + post: + operationId: indices.upgrade.1 + x-operation-group: indices.upgrade + x-version-added: '1.0' + description: The _upgrade API is no longer useful and will be removed. + parameters: + - $ref: '#/components/parameters/indices.upgrade::path.index' + - $ref: '#/components/parameters/indices.upgrade::query.allow_no_indices' + - $ref: '#/components/parameters/indices.upgrade::query.expand_wildcards' + - $ref: '#/components/parameters/indices.upgrade::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.upgrade::query.wait_for_completion' + - $ref: '#/components/parameters/indices.upgrade::query.only_ancient_segments' + responses: + '200': + $ref: '#/components/responses/indices.upgrade@200' + /{index}/_validate/query: + get: + operationId: indices.validate_query.2 + x-operation-group: indices.validate_query + x-version-added: '1.0' + description: Allows a user to validate a potentially expensive query without executing it. + parameters: + - $ref: '#/components/parameters/indices.validate_query::path.index' + - $ref: '#/components/parameters/indices.validate_query::query.explain' + - $ref: '#/components/parameters/indices.validate_query::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.validate_query::query.allow_no_indices' + - $ref: '#/components/parameters/indices.validate_query::query.expand_wildcards' + - $ref: '#/components/parameters/indices.validate_query::query.q' + - $ref: '#/components/parameters/indices.validate_query::query.analyzer' + - $ref: '#/components/parameters/indices.validate_query::query.analyze_wildcard' + - $ref: '#/components/parameters/indices.validate_query::query.default_operator' + - $ref: '#/components/parameters/indices.validate_query::query.df' + - $ref: '#/components/parameters/indices.validate_query::query.lenient' + - $ref: '#/components/parameters/indices.validate_query::query.rewrite' + - $ref: '#/components/parameters/indices.validate_query::query.all_shards' + requestBody: + $ref: '#/components/requestBodies/indices.validate_query' + responses: + '200': + $ref: '#/components/responses/indices.validate_query@200' + post: + operationId: indices.validate_query.3 + x-operation-group: indices.validate_query + x-version-added: '1.0' + description: Allows a user to validate a potentially expensive query without executing it. + parameters: + - $ref: '#/components/parameters/indices.validate_query::path.index' + - $ref: '#/components/parameters/indices.validate_query::query.explain' + - $ref: '#/components/parameters/indices.validate_query::query.ignore_unavailable' + - $ref: '#/components/parameters/indices.validate_query::query.allow_no_indices' + - $ref: '#/components/parameters/indices.validate_query::query.expand_wildcards' + - $ref: '#/components/parameters/indices.validate_query::query.q' + - $ref: '#/components/parameters/indices.validate_query::query.analyzer' + - $ref: '#/components/parameters/indices.validate_query::query.analyze_wildcard' + - $ref: '#/components/parameters/indices.validate_query::query.default_operator' + - $ref: '#/components/parameters/indices.validate_query::query.df' + - $ref: '#/components/parameters/indices.validate_query::query.lenient' + - $ref: '#/components/parameters/indices.validate_query::query.rewrite' + - $ref: '#/components/parameters/indices.validate_query::query.all_shards' + requestBody: + $ref: '#/components/requestBodies/indices.validate_query' + responses: + '200': + $ref: '#/components/responses/indices.validate_query@200' +components: + parameters: + bulk::path.index: + in: path + name: index + description: Name of the data stream, index, or index alias to perform bulk actions on. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + bulk::query._source: + in: query + name: _source + description: '`true` or `false` to return the `_source` field or not, or a list of fields to return.' + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + bulk::query._source_excludes: + in: query + name: _source_excludes + description: A comma-separated list of source fields to exclude from the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + bulk::query._source_includes: + in: query + name: _source_includes + description: A comma-separated list of source fields to include in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + bulk::query.pipeline: + in: query + name: pipeline + description: |- + ID of the pipeline to use to preprocess incoming documents. + If the index has a default ingest pipeline specified, then setting the value to `_none` disables the default ingest pipeline for this request. + If a final pipeline is configured it will always run, regardless of the value of this parameter. + schema: + type: string + style: form + bulk::query.refresh: + in: query + name: refresh + description: |- + If `true`, Opensearch refreshes the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` do nothing with refreshes. + Valid values: `true`, `false`, `wait_for`. + schema: + $ref: '#/components/schemas/_common:Refresh' + style: form + bulk::query.require_alias: + in: query + name: require_alias + description: If `true`, the request’s actions must target an index alias. + schema: + type: boolean + style: form + bulk::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + bulk::query.timeout: + in: query + name: timeout + description: 'Period each action waits for the following operations: automatic index creation, dynamic mapping updates, waiting for active shards.' + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + bulk::query.type: + name: type + in: query + description: Default document type for items which don't provide one. + schema: + type: string + description: Default document type for items which don't provide one. + bulk::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + cat.aliases::path.name: + in: path + name: name + description: A comma-separated list of aliases to retrieve. Supports wildcards (`*`). To retrieve all aliases, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + cat.aliases::query.expand_wildcards: + in: query + name: expand_wildcards + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + cat.aliases::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.aliases::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.aliases::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.aliases::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.aliases::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.aliases::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.all_pit_segments::query.bytes: + name: bytes + in: query + description: The unit in which to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + cat.all_pit_segments::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.all_pit_segments::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.all_pit_segments::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.all_pit_segments::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.all_pit_segments::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.allocation::path.node_id: + in: path + name: node_id + description: Comma-separated list of node identifiers or names used to limit the returned information. + required: true + schema: + $ref: '#/components/schemas/_common:NodeIds' + style: simple + cat.allocation::query.bytes: + in: query + name: bytes + description: The unit used to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + style: form + cat.allocation::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.allocation::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.allocation::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.allocation::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.allocation::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.allocation::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.allocation::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.allocation::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.cluster_manager::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.cluster_manager::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.cluster_manager::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.cluster_manager::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.cluster_manager::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.cluster_manager::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.cluster_manager::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.cluster_manager::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.count::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + cat.count::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.count::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.count::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.count::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.count::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.fielddata::path.fields: + in: path + name: fields + description: |- + Comma-separated list of fields used to limit returned information. + To retrieve all fields, omit this parameter. + required: true + schema: + $ref: '#/components/schemas/_common:Fields' + style: simple + cat.fielddata::query.bytes: + in: query + name: bytes + description: The unit used to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + style: form + cat.fielddata::query.fields: + in: query + name: fields + description: Comma-separated list of fields used to limit returned information. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + cat.fielddata::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.fielddata::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.fielddata::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.fielddata::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.fielddata::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.health::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.health::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.health::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.health::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.health::query.time: + in: query + name: time + description: The unit used to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + style: form + cat.health::query.ts: + in: query + name: ts + description: If true, returns `HH:MM:SS` and Unix epoch timestamps. + schema: + type: boolean + style: form + cat.health::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.help::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.help::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.indices::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + cat.indices::query.bytes: + in: query + name: bytes + description: The unit used to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + style: form + cat.indices::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.indices::query.expand_wildcards: + in: query + name: expand_wildcards + description: The type of index that wildcard patterns can match. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + cat.indices::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.indices::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.indices::query.health: + in: query + name: health + description: The health status used to limit returned indices. By default, the response includes indices of any health status. + schema: + $ref: '#/components/schemas/_common:HealthStatus' + style: form + cat.indices::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.indices::query.include_unloaded_segments: + in: query + name: include_unloaded_segments + description: If true, the response includes information from segments that are not loaded into memory. + schema: + type: boolean + style: form + cat.indices::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.indices::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.indices::query.pri: + in: query + name: pri + description: If true, the response only includes information from primary shards. + schema: + type: boolean + style: form + cat.indices::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.indices::query.time: + in: query + name: time + description: The unit used to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + style: form + cat.indices::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.master::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.master::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.master::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.master::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.master::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.master::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.master::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.master::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.nodeattrs::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.nodeattrs::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.nodeattrs::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.nodeattrs::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.nodeattrs::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.nodeattrs::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.nodeattrs::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.nodeattrs::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.nodes::query.bytes: + in: query + name: bytes + description: The unit used to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + style: form + cat.nodes::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.nodes::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.nodes::query.full_id: + in: query + name: full_id + description: If `true`, return the full node ID. If `false`, return the shortened node ID. + schema: + oneOf: + - type: boolean + - type: string + style: form + cat.nodes::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.nodes::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.nodes::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + x-version-deprecated: '1.0' + x-deprecation-message: This parameter does not cause this API to act locally. + deprecated: true + cat.nodes::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.nodes::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.nodes::query.time: + name: time + in: query + description: The unit in which to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + cat.nodes::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.pending_tasks::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.pending_tasks::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.pending_tasks::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.pending_tasks::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.pending_tasks::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.pending_tasks::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.pending_tasks::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.pending_tasks::query.time: + name: time + in: query + description: The unit in which to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + cat.pending_tasks::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.pit_segments::query.bytes: + name: bytes + in: query + description: The unit in which to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + cat.pit_segments::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.pit_segments::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.pit_segments::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.pit_segments::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.pit_segments::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.plugins::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.plugins::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.plugins::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.plugins::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.plugins::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.plugins::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.plugins::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.plugins::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.recovery::path.index: + in: path + name: index + description: |- + A comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + cat.recovery::query.active_only: + in: query + name: active_only + description: If `true`, the response only includes ongoing shard recoveries. + schema: + type: boolean + style: form + cat.recovery::query.bytes: + in: query + name: bytes + description: The unit used to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + style: form + cat.recovery::query.detailed: + in: query + name: detailed + description: If `true`, the response includes detailed information about shard recoveries. + schema: + type: boolean + style: form + cat.recovery::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.recovery::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.recovery::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.recovery::query.index: + name: index + in: query + description: Comma-separated list or wildcard expression of index names to limit the returned information. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list or wildcard expression of index names to limit the returned information. + explode: true + cat.recovery::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.recovery::query.time: + name: time + in: query + description: The unit in which to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + cat.recovery::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.repositories::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.repositories::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.repositories::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.repositories::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.repositories::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.repositories::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.repositories::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.repositories::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.segment_replication::path.index: + name: index + in: path + description: Comma-separated list or wildcard expression of index names to limit the returned information. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Comma-separated list or wildcard expression of index names to limit the returned information. + x-data-type: array + required: true + cat.segment_replication::query.active_only: + name: active_only + in: query + description: If `true`, the response only includes ongoing segment replication events. + schema: + type: boolean + default: false + description: If `true`, the response only includes ongoing segment replication events. + cat.segment_replication::query.allow_no_indices: + name: allow_no_indices + in: query + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified). + schema: + type: boolean + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified). + cat.segment_replication::query.bytes: + name: bytes + in: query + description: The unit in which to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + cat.segment_replication::query.completed_only: + name: completed_only + in: query + description: If `true`, the response only includes latest completed segment replication events. + schema: + type: boolean + default: false + description: If `true`, the response only includes latest completed segment replication events. + cat.segment_replication::query.detailed: + name: detailed + in: query + description: If `true`, the response includes detailed information about segment replications. + schema: + type: boolean + default: false + description: If `true`, the response includes detailed information about segment replications. + cat.segment_replication::query.expand_wildcards: + name: expand_wildcards + in: query + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + cat.segment_replication::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.segment_replication::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.segment_replication::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.segment_replication::query.ignore_throttled: + name: ignore_throttled + in: query + description: Whether specified concrete, expanded or aliased indices should be ignored when throttled. + schema: + type: boolean + description: Whether specified concrete, expanded or aliased indices should be ignored when throttled. + cat.segment_replication::query.ignore_unavailable: + name: ignore_unavailable + in: query + description: Whether specified concrete indices should be ignored when unavailable (missing or closed). + schema: + type: boolean + description: Whether specified concrete indices should be ignored when unavailable (missing or closed). + cat.segment_replication::query.index: + name: index + in: query + description: Comma-separated list or wildcard expression of index names to limit the returned information. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list or wildcard expression of index names to limit the returned information. + explode: true + cat.segment_replication::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.segment_replication::query.shards: + name: shards + in: query + description: Comma-separated list of shards to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of shards to display. + explode: true + cat.segment_replication::query.time: + name: time + in: query + description: The unit in which to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + cat.segment_replication::query.timeout: + name: timeout + in: query + description: Operation timeout. + schema: + $ref: '#/components/schemas/_common:Duration' + cat.segment_replication::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.segments::path.index: + in: path + name: index + description: |- + A comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + cat.segments::query.bytes: + in: query + name: bytes + description: The unit used to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + style: form + cat.segments::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.segments::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.segments::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.segments::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.segments::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.segments::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.segments::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.shards::path.index: + in: path + name: index + description: |- + A comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + cat.shards::query.bytes: + in: query + name: bytes + description: The unit used to display byte values. + schema: + $ref: '#/components/schemas/_common:Bytes' + style: form + cat.shards::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.shards::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.shards::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.shards::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.shards::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.shards::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.shards::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.shards::query.time: + name: time + in: query + description: The unit in which to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + cat.shards::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.snapshots::path.repository: + in: path + name: repository + description: |- + A comma-separated list of snapshot repositories used to limit the request. + Accepts wildcard expressions. + `_all` returns all repositories. + If any repository fails during the request, Opensearch returns an error. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + cat.snapshots::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.snapshots::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.snapshots::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.snapshots::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.snapshots::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `true`, the response does not include information from unavailable snapshots. + schema: + type: boolean + style: form + cat.snapshots::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.snapshots::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.snapshots::query.time: + name: time + in: query + description: The unit in which to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + cat.snapshots::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.tasks::query.actions: + in: query + name: actions + description: The task action names, which are used to limit the response. + schema: + type: array + items: + type: string + style: form + cat.tasks::query.detailed: + in: query + name: detailed + description: If `true`, the response includes detailed information about shard recoveries. + schema: + type: boolean + style: form + cat.tasks::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.tasks::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.tasks::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.tasks::query.nodes: + name: nodes + in: query + description: 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. + style: form + schema: + type: array + items: + type: string + description: 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. + explode: true + cat.tasks::query.parent_task_id: + in: query + name: parent_task_id + description: The parent task identifier, which is used to limit the response. + schema: + type: string + style: form + cat.tasks::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.tasks::query.time: + name: time + in: query + description: The unit in which to display time values. + schema: + $ref: '#/components/schemas/_common:TimeUnit' + cat.tasks::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.templates::path.name: + in: path + name: name + description: |- + The name of the template to return. + Accepts wildcard expressions. If omitted, all templates are returned. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + cat.templates::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.templates::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.templates::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.templates::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.templates::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.templates::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.templates::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.templates::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + cat.thread_pool::path.thread_pool_patterns: + in: path + name: thread_pool_patterns + description: |- + A comma-separated list of thread pool names used to limit the request. + Accepts wildcard expressions. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + cat.thread_pool::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cat.thread_pool::query.format: + name: format + in: query + description: A short version of the Accept header, e.g. json, yaml. + schema: + type: string + description: A short version of the Accept header, e.g. json, yaml. + cat.thread_pool::query.h: + name: h + in: query + description: Comma-separated list of column names to display. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names to display. + explode: true + cat.thread_pool::query.help: + name: help + in: query + description: Return help information. + schema: + type: boolean + default: false + description: Return help information. + cat.thread_pool::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + cat.thread_pool::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + cat.thread_pool::query.s: + name: s + in: query + description: Comma-separated list of column names or column aliases to sort by. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of column names or column aliases to sort by. + explode: true + cat.thread_pool::query.size: + name: size + in: query + description: The multiplier in which to display values. + schema: + type: integer + description: The multiplier in which to display values. + format: int32 + cat.thread_pool::query.v: + name: v + in: query + description: Verbose mode. Display column headers. + schema: + type: boolean + default: false + description: Verbose mode. Display column headers. + clear_scroll::path.scroll_id: + in: path + name: scroll_id + description: |- + Comma-separated list of scroll IDs to clear. + To clear all scroll IDs, use `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:ScrollIds' + style: simple + cluster.allocation_explain::query.include_disk_info: + in: query + name: include_disk_info + description: If true, returns information about disk usage and shard sizes. + schema: + type: boolean + style: form + cluster.allocation_explain::query.include_yes_decisions: + in: query + name: include_yes_decisions + description: If true, returns YES decisions in explanation. + schema: + type: boolean + style: form + cluster.delete_component_template::path.name: + in: path + name: name + description: |- + Name of the component template to delete. + Wildcard (*) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + cluster.delete_component_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.delete_component_template::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.delete_component_template::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + cluster.delete_voting_config_exclusions::query.wait_for_removal: + in: query + name: wait_for_removal + description: |- + Specifies whether to wait for all excluded nodes to be removed from the + cluster before clearing the voting configuration exclusions list. + Defaults to true, meaning that all excluded nodes must be removed from + the cluster before this API takes any action. If set to false then the + voting configuration exclusions list is cleared even if some excluded + nodes are still in the cluster. + schema: + type: boolean + style: form + cluster.exists_component_template::path.name: + in: path + name: name + description: |- + Name of the component template to check existence of. + Wildcard (*) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + cluster.exists_component_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.exists_component_template::query.local: + in: query + name: local + description: |- + If true, the request retrieves information from the local node only. + Defaults to false, which means information is retrieved from the master node. + schema: + type: boolean + style: form + cluster.exists_component_template::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. If no response is + received before the timeout expires, the request fails and returns an + error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.get_component_template::path.name: + in: path + name: name + description: |- + Name of the component template to retrieve. + Wildcard (`*`) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + cluster.get_component_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.get_component_template::query.local: + in: query + name: local + description: |- + If `true`, the request retrieves information from the local node only. + If `false`, information is retrieved from the master node. + schema: + type: boolean + style: form + cluster.get_component_template::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.get_decommission_awareness::path.awareness_attribute_name: + name: awareness_attribute_name + in: path + description: Awareness attribute name. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Awareness attribute name. + required: true + cluster.get_settings::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.get_settings::query.flat_settings: + in: query + name: flat_settings + description: If `true`, returns settings in flat format. + schema: + type: boolean + style: form + cluster.get_settings::query.include_defaults: + in: query + name: include_defaults + description: If `true`, returns default cluster settings from the local node. + schema: + type: boolean + style: form + cluster.get_settings::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.get_settings::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + cluster.get_weighted_routing::path.attribute: + name: attribute + in: path + description: Awareness attribute name. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Awareness attribute name. + required: true + cluster.health::path.index: + in: path + name: index + description: Comma-separated list of data streams, indices, and index aliases used to limit the request. Wildcard expressions (*) are supported. To target all data streams and indices in a cluster, omit this parameter or use _all or *. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + cluster.health::query.awareness_attribute: + name: awareness_attribute + in: query + description: The awareness attribute for which the health is required. + schema: + type: string + description: The awareness attribute for which the health is required. + cluster.health::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.health::query.expand_wildcards: + in: query + name: expand_wildcards + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + cluster.health::query.level: + in: query + name: level + description: Can be one of cluster, indices or shards. Controls the details level of the health information returned. + schema: + $ref: '#/components/schemas/cluster.health:Level' + style: form + cluster.health::query.local: + in: query + name: local + description: If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. + schema: + type: boolean + style: form + cluster.health::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.health::query.timeout: + in: query + name: timeout + description: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + cluster.health::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: A number controlling to how many active shards to wait for, all to wait for all shards in the cluster to be active, or 0 to not wait. + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + cluster.health::query.wait_for_events: + in: query + name: wait_for_events + description: Can be one of immediate, urgent, high, normal, low, languid. Wait until all currently queued events with the given priority are processed. + schema: + $ref: '#/components/schemas/_common:WaitForEvents' + style: form + cluster.health::query.wait_for_no_initializing_shards: + in: query + name: wait_for_no_initializing_shards + description: A boolean value which controls whether to wait (until the timeout provided) for the cluster to have no shard initializations. Defaults to false, which means it will not wait for initializing shards. + schema: + type: boolean + style: form + cluster.health::query.wait_for_no_relocating_shards: + in: query + name: wait_for_no_relocating_shards + description: A boolean value which controls whether to wait (until the timeout provided) for the cluster to have no shard relocations. Defaults to false, which means it will not wait for relocating shards. + schema: + type: boolean + style: form + cluster.health::query.wait_for_nodes: + in: query + name: wait_for_nodes + description: The request waits until the specified number N of nodes is available. It also accepts >=N, <=N, >N and yellow > red. By default, will not wait for any status. + schema: + $ref: '#/components/schemas/_common:HealthStatus' + style: form + cluster.pending_tasks::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.pending_tasks::query.local: + in: query + name: local + description: |- + If `true`, the request retrieves information from the local node only. + If `false`, information is retrieved from the master node. + schema: + type: boolean + style: form + cluster.pending_tasks::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.post_voting_config_exclusions::query.node_ids: + in: query + name: node_ids + description: |- + A comma-separated list of the persistent ids of the nodes to exclude + from the voting configuration. If specified, you may not also specify node_names. + schema: + $ref: '#/components/schemas/_common:Ids' + style: form + cluster.post_voting_config_exclusions::query.node_names: + in: query + name: node_names + description: |- + A comma-separated list of the names of the nodes to exclude from the + voting configuration. If specified, you may not also specify node_ids. + schema: + $ref: '#/components/schemas/_common:Names' + style: form + cluster.post_voting_config_exclusions::query.timeout: + in: query + name: timeout + description: |- + When adding a voting configuration exclusion, the API waits for the + specified nodes to be excluded from the voting configuration before + returning. If the timeout expires before the appropriate condition + is satisfied, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + cluster.put_component_template::path.name: + in: path + name: name + description: |- + Name of the component template to create. + Opensearch includes the following built-in component templates: `logs-mappings`; 'logs-settings`; `metrics-mappings`; `metrics-settings`;`synthetics-mapping`; `synthetics-settings`. + Opensearch Agent uses these templates to configure backing indices for its data streams. + If you use Opensearch Agent and want to overwrite one of these templates, set the `version` for your replacement template higher than the current version. + If you don’t use Opensearch Agent and want to disable all built-in component and index templates, set `stack.templates.enabled` to `false` using the cluster update settings API. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + cluster.put_component_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.put_component_template::query.create: + in: query + name: create + description: If `true`, this request cannot replace or update existing component templates. + schema: + type: boolean + style: form + cluster.put_component_template::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.put_component_template::query.timeout: + name: timeout + in: query + description: Operation timeout. + schema: + $ref: '#/components/schemas/_common:Duration' + cluster.put_decommission_awareness::path.awareness_attribute_name: + name: awareness_attribute_name + in: path + description: Awareness attribute name. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Awareness attribute name. + required: true + cluster.put_decommission_awareness::path.awareness_attribute_value: + name: awareness_attribute_value + in: path + description: Awareness attribute value. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Awareness attribute value. + required: true + cluster.put_settings::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.put_settings::query.flat_settings: + in: query + name: flat_settings + description: 'Return settings in flat format (default: false)' + schema: + type: boolean + style: form + cluster.put_settings::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.put_settings::query.timeout: + in: query + name: timeout + description: Explicit operation timeout + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + cluster.put_weighted_routing::path.attribute: + name: attribute + in: path + description: Awareness attribute name. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Awareness attribute name. + required: true + cluster.reroute::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.reroute::query.dry_run: + in: query + name: dry_run + description: If true, then the request simulates the operation only and returns the resulting state. + schema: + type: boolean + style: form + cluster.reroute::query.explain: + in: query + name: explain + description: If true, then the response contains an explanation of why the commands can or cannot be executed. + schema: + type: boolean + style: form + cluster.reroute::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.reroute::query.metric: + in: query + name: metric + description: Limits the information returned to the specified metrics. + schema: + $ref: '#/components/schemas/_common:Metrics' + style: form + cluster.reroute::query.retry_failed: + in: query + name: retry_failed + description: If true, then retries allocation of shards that are blocked due to too many subsequent allocation failures. + schema: + type: boolean + style: form + cluster.reroute::query.timeout: + in: query + name: timeout + description: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + cluster.state::path.index: + in: path + name: index + description: A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + cluster.state::path.metric: + in: path + name: metric + description: Limit the information returned to the specified metrics + required: true + schema: + type: array + items: + $ref: '#/components/schemas/cluster.state:Metric' + style: simple + cluster.state::query.allow_no_indices: + in: query + name: allow_no_indices + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified) + schema: + type: boolean + style: form + cluster.state::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + cluster.state::query.expand_wildcards: + in: query + name: expand_wildcards + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + cluster.state::query.flat_settings: + in: query + name: flat_settings + description: 'Return settings in flat format (default: false)' + schema: + type: boolean + style: form + cluster.state::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: Whether specified concrete indices should be ignored when unavailable (missing or closed) + schema: + type: boolean + style: form + cluster.state::query.local: + in: query + name: local + description: 'Return local information, do not retrieve the state from cluster-manager node (default: false)' + schema: + type: boolean + style: form + cluster.state::query.master_timeout: + in: query + name: master_timeout + description: Specify timeout for connection to master + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + cluster.state::query.wait_for_metadata_version: + in: query + name: wait_for_metadata_version + description: Wait for the metadata version to be equal or greater than the specified metadata version + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + cluster.state::query.wait_for_timeout: + in: query + name: wait_for_timeout + description: The maximum time to wait for wait_for_metadata_version before timing out + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + cluster.stats::path.node_id: + in: path + name: node_id + description: Comma-separated list of node filters used to limit returned information. Defaults to all nodes in the cluster. + required: true + schema: + $ref: '#/components/schemas/_common:NodeIds' + style: simple + cluster.stats::query.flat_settings: + in: query + name: flat_settings + description: If `true`, returns settings in flat format. + schema: + type: boolean + style: form + cluster.stats::query.timeout: + in: query + name: timeout + description: |- + Period to wait for each node to respond. + If a node does not respond before its timeout expires, the response does not include its stats. + However, timed out nodes are included in the response’s `_nodes.failed` property. Defaults to no timeout. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + count::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases to search. + Supports wildcards (`*`). + To search all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + count::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + count::query.analyze_wildcard: + in: query + name: analyze_wildcard + description: |- + If `true`, wildcard and prefix queries are analyzed. + This parameter can only be used when the `q` query string parameter is specified. + schema: + type: boolean + style: form + count::query.analyzer: + in: query + name: analyzer + description: |- + Analyzer to use for the query string. + This parameter can only be used when the `q` query string parameter is specified. + schema: + type: string + style: form + count::query.default_operator: + in: query + name: default_operator + description: |- + The default operator for query string query: `AND` or `OR`. + This parameter can only be used when the `q` query string parameter is specified. + schema: + $ref: '#/components/schemas/_common.query_dsl:Operator' + style: form + count::query.df: + in: query + name: df + description: |- + Field to use as default where no field prefix is given in the query string. + This parameter can only be used when the `q` query string parameter is specified. + schema: + type: string + style: form + count::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + count::query.ignore_throttled: + in: query + name: ignore_throttled + description: If `true`, concrete, expanded or aliased indices are ignored when frozen. + schema: + type: boolean + style: form + count::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + count::query.lenient: + in: query + name: lenient + description: If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. + schema: + type: boolean + style: form + count::query.min_score: + in: query + name: min_score + description: Sets the minimum `_score` value that documents must have to be included in the result. + schema: + type: number + style: form + count::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + count::query.q: + in: query + name: q + description: Query in the Lucene query string syntax. + schema: + type: string + style: form + count::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + count::query.terminate_after: + in: query + name: terminate_after + description: |- + Maximum number of documents to collect for each shard. + If a query reaches this limit, Opensearch terminates the query early. + Opensearch collects documents before sorting. + schema: + type: number + style: form + create::path.id: + in: path + name: id + description: Unique identifier for the document. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + create::path.index: + in: path + name: index + description: |- + Name of the data stream or index to target. + If the target doesn’t exist and matches the name or wildcard (`*`) pattern of an index template with a `data_stream` definition, this request creates the data stream. + If the target doesn’t exist and doesn’t match a data stream template, this request creates the index. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + create::query.pipeline: + in: query + name: pipeline + description: |- + ID of the pipeline to use to preprocess incoming documents. + If the index has a default ingest pipeline specified, then setting the value to `_none` disables the default ingest pipeline for this request. + If a final pipeline is configured it will always run, regardless of the value of this parameter. + schema: + type: string + style: form + create::query.refresh: + in: query + name: refresh + description: |- + If `true`, Opensearch refreshes the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` do nothing with refreshes. + Valid values: `true`, `false`, `wait_for`. + schema: + $ref: '#/components/schemas/_common:Refresh' + style: form + create::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + create::query.timeout: + in: query + name: timeout + description: 'Period the request waits for the following operations: automatic index creation, dynamic mapping updates, waiting for active shards.' + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + create::query.version: + in: query + name: version + description: |- + Explicit version number for concurrency control. + The specified version must match the current version of the document for the request to succeed. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + create::query.version_type: + in: query + name: version_type + description: 'Specific version type: `external`, `external_gte`.' + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + create::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + create_pit::path.index: + name: index + in: path + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + x-data-type: array + required: true + create_pit::query.allow_partial_pit_creation: + name: allow_partial_pit_creation + in: query + description: Allow if point in time can be created with partial failures. + schema: + type: boolean + description: Allow if point in time can be created with partial failures. + create_pit::query.expand_wildcards: + name: expand_wildcards + in: query + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + create_pit::query.keep_alive: + name: keep_alive + in: query + description: Specify the keep alive for point in time. + schema: + $ref: '#/components/schemas/_common:Duration' + create_pit::query.preference: + name: preference + in: query + description: Specify the node or shard the operation should be performed on. + schema: + type: string + default: random + description: Specify the node or shard the operation should be performed on. + create_pit::query.routing: + name: routing + in: query + description: Comma-separated list of specific routing values. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of specific routing values. + explode: true + dangling_indices.delete_dangling_index::path.index_uuid: + in: path + name: index_uuid + description: The UUID of the dangling index + required: true + schema: + $ref: '#/components/schemas/_common:Uuid' + style: simple + dangling_indices.delete_dangling_index::query.accept_data_loss: + in: query + name: accept_data_loss + description: Must be set to true in order to delete the dangling index + required: true + schema: + type: boolean + style: form + dangling_indices.delete_dangling_index::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + dangling_indices.delete_dangling_index::query.master_timeout: + in: query + name: master_timeout + description: Specify timeout for connection to master + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + dangling_indices.delete_dangling_index::query.timeout: + in: query + name: timeout + description: Explicit operation timeout + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + dangling_indices.import_dangling_index::path.index_uuid: + in: path + name: index_uuid + description: The UUID of the dangling index + required: true + schema: + $ref: '#/components/schemas/_common:Uuid' + style: simple + dangling_indices.import_dangling_index::query.accept_data_loss: + in: query + name: accept_data_loss + description: Must be set to true in order to import the dangling index + required: true + schema: + type: boolean + style: form + dangling_indices.import_dangling_index::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + dangling_indices.import_dangling_index::query.master_timeout: + in: query + name: master_timeout + description: Specify timeout for connection to master + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + dangling_indices.import_dangling_index::query.timeout: + in: query + name: timeout + description: Explicit operation timeout + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + delete::path.id: + in: path + name: id + description: Unique identifier for the document. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + delete::path.index: + in: path + name: index + description: Name of the target index. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + delete::query.if_primary_term: + in: query + name: if_primary_term + description: Only perform the operation if the document has this primary term. + schema: + type: number + style: form + delete::query.if_seq_no: + in: query + name: if_seq_no + description: Only perform the operation if the document has this sequence number. + schema: + $ref: '#/components/schemas/_common:SequenceNumber' + style: form + delete::query.refresh: + in: query + name: refresh + description: |- + If `true`, Opensearch refreshes the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` do nothing with refreshes. + Valid values: `true`, `false`, `wait_for`. + schema: + $ref: '#/components/schemas/_common:Refresh' + style: form + delete::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + delete::query.timeout: + in: query + name: timeout + description: Period to wait for active shards. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + delete::query.version: + in: query + name: version + description: |- + Explicit version number for concurrency control. + The specified version must match the current version of the document for the request to succeed. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + delete::query.version_type: + in: query + name: version_type + description: 'Specific version type: `external`, `external_gte`.' + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + delete::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + delete_by_query::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases to search. + Supports wildcards (`*`). + To search all data streams or indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + delete_by_query::query._source: + name: _source + in: query + description: True or false to return the _source field or not, or a list of fields to return. + style: form + schema: + type: array + items: + type: string + description: True or false to return the _source field or not, or a list of fields to return. + explode: true + delete_by_query::query._source_excludes: + name: _source_excludes + in: query + description: List of fields to exclude from the returned _source field. + style: form + schema: + type: array + items: + type: string + description: List of fields to exclude from the returned _source field. + explode: true + delete_by_query::query._source_includes: + name: _source_includes + in: query + description: List of fields to extract and return from the _source field. + style: form + schema: + type: array + items: + type: string + description: List of fields to extract and return from the _source field. + explode: true + delete_by_query::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. + schema: + type: boolean + style: form + delete_by_query::query.analyze_wildcard: + in: query + name: analyze_wildcard + description: If `true`, wildcard and prefix queries are analyzed. + schema: + type: boolean + style: form + delete_by_query::query.analyzer: + in: query + name: analyzer + description: Analyzer to use for the query string. + schema: + type: string + style: form + delete_by_query::query.conflicts: + in: query + name: conflicts + description: 'What to do if delete by query hits version conflicts: `abort` or `proceed`.' + schema: + $ref: '#/components/schemas/_common:Conflicts' + style: form + delete_by_query::query.default_operator: + in: query + name: default_operator + description: 'The default operator for query string query: `AND` or `OR`.' + schema: + $ref: '#/components/schemas/_common.query_dsl:Operator' + style: form + delete_by_query::query.df: + in: query + name: df + description: Field to use as default where no field prefix is given in the query string. + schema: + type: string + style: form + delete_by_query::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + delete_by_query::query.from: + in: query + name: from + description: 'Starting offset (default: 0)' + schema: + type: number + style: form + delete_by_query::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + delete_by_query::query.lenient: + in: query + name: lenient + description: If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. + schema: + type: boolean + style: form + delete_by_query::query.max_docs: + in: query + name: max_docs + description: |- + Maximum number of documents to process. + Defaults to all documents. + schema: + type: number + style: form + delete_by_query::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + delete_by_query::query.q: + in: query + name: q + description: Query in the Lucene query string syntax. + schema: + type: string + style: form + delete_by_query::query.refresh: + in: query + name: refresh + description: If `true`, Opensearch refreshes all shards involved in the delete by query after the request completes. + schema: + type: boolean + style: form + delete_by_query::query.request_cache: + in: query + name: request_cache + description: |- + If `true`, the request cache is used for this request. + Defaults to the index-level setting. + schema: + type: boolean + style: form + delete_by_query::query.requests_per_second: + in: query + name: requests_per_second + description: The throttle for this request in sub-requests per second. + schema: + type: number + style: form + delete_by_query::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + delete_by_query::query.scroll: + in: query + name: scroll + description: Period to retain the search context for scrolling. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + delete_by_query::query.scroll_size: + in: query + name: scroll_size + description: Size of the scroll request that powers the operation. + schema: + type: number + style: form + delete_by_query::query.search_timeout: + in: query + name: search_timeout + description: |- + Explicit timeout for each search request. + Defaults to no timeout. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + delete_by_query::query.search_type: + in: query + name: search_type + description: |- + The type of the search operation. + Available options: `query_then_fetch`, `dfs_query_then_fetch`. + schema: + $ref: '#/components/schemas/_common:SearchType' + style: form + delete_by_query::query.size: + name: size + in: query + description: Deprecated, please use `max_docs` instead. + schema: + type: integer + description: Deprecated, please use `max_docs` instead. + format: int32 + delete_by_query::query.slices: + in: query + name: slices + description: The number of slices this task should be divided into. + schema: + $ref: '#/components/schemas/_common:Slices' + style: form + delete_by_query::query.sort: + in: query + name: sort + description: A comma-separated list of : pairs. + schema: + type: array + items: + type: string + style: form + delete_by_query::query.stats: + in: query + name: stats + description: Specific `tag` of the request for logging and statistical purposes. + schema: + type: array + items: + type: string + style: form + delete_by_query::query.terminate_after: + in: query + name: terminate_after + description: |- + Maximum number of documents to collect for each shard. + If a query reaches this limit, Opensearch terminates the query early. + Opensearch collects documents before sorting. + Use with caution. + Opensearch applies this parameter to each shard handling the request. + When possible, let Opensearch perform early termination automatically. + Avoid specifying this parameter for requests that target data streams with backing indices across multiple data tiers. + schema: + type: number + style: form + delete_by_query::query.timeout: + in: query + name: timeout + description: Period each deletion request waits for active shards. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + delete_by_query::query.version: + in: query + name: version + description: If `true`, returns the document version as part of a hit. + schema: + type: boolean + style: form + delete_by_query::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + delete_by_query::query.wait_for_completion: + in: query + name: wait_for_completion + description: If `true`, the request blocks until the operation is complete. + schema: + type: boolean + style: form + delete_by_query_rethrottle::path.task_id: + in: path + name: task_id + description: The ID for the task. + required: true + schema: + $ref: '#/components/schemas/_common:TaskId' + style: simple + delete_by_query_rethrottle::query.requests_per_second: + in: query + name: requests_per_second + description: The throttle for this request in sub-requests per second. + schema: + type: number + style: form + delete_script::path.id: + in: path + name: id + description: Identifier for the stored script or search template. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + delete_script::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + delete_script::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + delete_script::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + exists::path.id: + in: path + name: id + description: Identifier of the document. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + exists::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases. + Supports wildcards (`*`). + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + exists::query._source: + in: query + name: _source + description: '`true` or `false` to return the `_source` field or not, or a list of fields to return.' + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + exists::query._source_excludes: + in: query + name: _source_excludes + description: A comma-separated list of source fields to exclude in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + exists::query._source_includes: + in: query + name: _source_includes + description: A comma-separated list of source fields to include in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + exists::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + exists::query.realtime: + in: query + name: realtime + description: If `true`, the request is real-time as opposed to near-real-time. + schema: + type: boolean + style: form + exists::query.refresh: + in: query + name: refresh + description: If `true`, Opensearch refreshes all shards involved in the delete by query after the request completes. + schema: + type: boolean + style: form + exists::query.routing: + in: query + name: routing + description: Target the specified primary shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + exists::query.stored_fields: + in: query + name: stored_fields + description: |- + List of stored fields to return as part of a hit. + If no fields are specified, no stored fields are included in the response. + If this field is specified, the `_source` parameter defaults to false. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + exists::query.version: + in: query + name: version + description: |- + Explicit version number for concurrency control. + The specified version must match the current version of the document for the request to succeed. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + exists::query.version_type: + in: query + name: version_type + description: 'Specific version type: `external`, `external_gte`.' + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + exists_source::path.id: + in: path + name: id + description: Identifier of the document. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + exists_source::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases. + Supports wildcards (`*`). + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + exists_source::query._source: + in: query + name: _source + description: '`true` or `false` to return the `_source` field or not, or a list of fields to return.' + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + exists_source::query._source_excludes: + in: query + name: _source_excludes + description: A comma-separated list of source fields to exclude in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + exists_source::query._source_includes: + in: query + name: _source_includes + description: A comma-separated list of source fields to include in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + exists_source::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + exists_source::query.realtime: + in: query + name: realtime + description: If true, the request is real-time as opposed to near-real-time. + schema: + type: boolean + style: form + exists_source::query.refresh: + in: query + name: refresh + description: If `true`, Opensearch refreshes all shards involved in the delete by query after the request completes. + schema: + type: boolean + style: form + exists_source::query.routing: + in: query + name: routing + description: Target the specified primary shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + exists_source::query.version: + in: query + name: version + description: |- + Explicit version number for concurrency control. + The specified version must match the current version of the document for the request to succeed. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + exists_source::query.version_type: + in: query + name: version_type + description: 'Specific version type: `external`, `external_gte`.' + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + explain::path.id: + in: path + name: id + description: Defines the document ID. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + explain::path.index: + in: path + name: index + description: |- + Index names used to limit the request. + Only a single index name can be provided to this parameter. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + explain::query._source: + in: query + name: _source + description: True or false to return the `_source` field or not, or a list of fields to return. + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + explain::query._source_excludes: + in: query + name: _source_excludes + description: A comma-separated list of source fields to exclude from the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + explain::query._source_includes: + in: query + name: _source_includes + description: A comma-separated list of source fields to include in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + explain::query.analyze_wildcard: + in: query + name: analyze_wildcard + description: If `true`, wildcard and prefix queries are analyzed. + schema: + type: boolean + style: form + explain::query.analyzer: + in: query + name: analyzer + description: |- + Analyzer to use for the query string. + This parameter can only be used when the `q` query string parameter is specified. + schema: + type: string + style: form + explain::query.default_operator: + in: query + name: default_operator + description: 'The default operator for query string query: `AND` or `OR`.' + schema: + $ref: '#/components/schemas/_common.query_dsl:Operator' + style: form + explain::query.df: + in: query + name: df + description: Field to use as default where no field prefix is given in the query string. + schema: + type: string + style: form + explain::query.lenient: + in: query + name: lenient + description: If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. + schema: + type: boolean + style: form + explain::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + explain::query.q: + in: query + name: q + description: Query in the Lucene query string syntax. + schema: + type: string + style: form + explain::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + explain::query.stored_fields: + in: query + name: stored_fields + description: A comma-separated list of stored fields to return in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + field_caps::path.index: + in: path + name: index + description: Comma-separated list of data streams, indices, and aliases used to limit the request. Supports wildcards (*). To target all data streams and indices, omit this parameter or use * or _all. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + field_caps::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If false, the request returns an error if any wildcard expression, index alias, + or `_all` value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request + targeting `foo*,bar*` returns an error if an index starts with foo but no index starts with bar. + schema: + type: boolean + style: form + field_caps::query.expand_wildcards: + in: query + name: expand_wildcards + description: Type of index that wildcard patterns can match. If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. Supports comma-separated values, such as `open,hidden`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + field_caps::query.fields: + in: query + name: fields + description: Comma-separated list of fields to retrieve capabilities for. Wildcard (`*`) expressions are supported. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + field_caps::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `true`, missing or closed indices are not included in the response. + schema: + type: boolean + style: form + field_caps::query.include_unmapped: + in: query + name: include_unmapped + description: If true, unmapped fields are included in the response. + schema: + type: boolean + style: form + get::path.id: + in: path + name: id + description: Unique identifier of the document. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + get::path.index: + in: path + name: index + description: Name of the index that contains the document. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + get::query._source: + in: query + name: _source + description: True or false to return the _source field or not, or a list of fields to return. + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + get::query._source_excludes: + in: query + name: _source_excludes + description: A comma-separated list of source fields to exclude in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + get::query._source_includes: + in: query + name: _source_includes + description: A comma-separated list of source fields to include in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + get::query.preference: + in: query + name: preference + description: Specifies the node or shard the operation should be performed on. Random by default. + schema: + type: string + style: form + get::query.realtime: + in: query + name: realtime + description: If `true`, the request is real-time as opposed to near-real-time. + schema: + type: boolean + style: form + get::query.refresh: + in: query + name: refresh + description: If true, Opensearch refreshes the affected shards to make this operation visible to search. If false, do nothing with refreshes. + schema: + type: boolean + style: form + get::query.routing: + in: query + name: routing + description: Target the specified primary shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + get::query.stored_fields: + in: query + name: stored_fields + description: |- + List of stored fields to return as part of a hit. + If no fields are specified, no stored fields are included in the response. + If this field is specified, the `_source` parameter defaults to false. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + get::query.version: + in: query + name: version + description: Explicit version number for concurrency control. The specified version must match the current version of the document for the request to succeed. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + get::query.version_type: + in: query + name: version_type + description: 'Specific version type: internal, external, external_gte.' + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + get_script::path.id: + in: path + name: id + description: Identifier for the stored script or search template. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + get_script::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + get_script::query.master_timeout: + in: query + name: master_timeout + description: Specify timeout for connection to master + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + get_source::path.id: + in: path + name: id + description: Unique identifier of the document. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + get_source::path.index: + in: path + name: index + description: Name of the index that contains the document. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + get_source::query._source: + in: query + name: _source + description: True or false to return the _source field or not, or a list of fields to return. + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + get_source::query._source_excludes: + in: query + name: _source_excludes + description: A comma-separated list of source fields to exclude in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + get_source::query._source_includes: + in: query + name: _source_includes + description: A comma-separated list of source fields to include in the response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + get_source::query.preference: + in: query + name: preference + description: Specifies the node or shard the operation should be performed on. Random by default. + schema: + type: string + style: form + get_source::query.realtime: + in: query + name: realtime + description: Boolean) If true, the request is real-time as opposed to near-real-time. + schema: + type: boolean + style: form + get_source::query.refresh: + in: query + name: refresh + description: If true, Opensearch refreshes the affected shards to make this operation visible to search. If false, do nothing with refreshes. + schema: + type: boolean + style: form + get_source::query.routing: + in: query + name: routing + description: Target the specified primary shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + get_source::query.version: + in: query + name: version + description: Explicit version number for concurrency control. The specified version must match the current version of the document for the request to succeed. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + get_source::query.version_type: + in: query + name: version_type + description: 'Specific version type: internal, external, external_gte.' + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + index::path.id: + in: path + name: id + description: Unique identifier for the document. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + index::path.index: + in: path + name: index + description: Name of the data stream or index to target. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + index::query.if_primary_term: + in: query + name: if_primary_term + description: Only perform the operation if the document has this primary term. + schema: + type: number + style: form + index::query.if_seq_no: + in: query + name: if_seq_no + description: Only perform the operation if the document has this sequence number. + schema: + $ref: '#/components/schemas/_common:SequenceNumber' + style: form + index::query.op_type: + in: query + name: op_type + description: |- + Set to create to only index the document if it does not already exist (put if absent). + If a document with the specified `_id` already exists, the indexing operation will fail. + Same as using the `/_create` endpoint. + Valid values: `index`, `create`. + If document id is specified, it defaults to `index`. + Otherwise, it defaults to `create`. + schema: + $ref: '#/components/schemas/_common:OpType' + style: form + index::query.pipeline: + in: query + name: pipeline + description: |- + ID of the pipeline to use to preprocess incoming documents. + If the index has a default ingest pipeline specified, then setting the value to `_none` disables the default ingest pipeline for this request. + If a final pipeline is configured it will always run, regardless of the value of this parameter. + schema: + type: string + style: form + index::query.refresh: + in: query + name: refresh + description: |- + If `true`, Opensearch refreshes the affected shards to make this operation visible to search, if `wait_for` then wait for a refresh to make this operation visible to search, if `false` do nothing with refreshes. + Valid values: `true`, `false`, `wait_for`. + schema: + $ref: '#/components/schemas/_common:Refresh' + style: form + index::query.require_alias: + in: query + name: require_alias + description: If `true`, the destination must be an index alias. + schema: + type: boolean + style: form + index::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + index::query.timeout: + in: query + name: timeout + description: 'Period the request waits for the following operations: automatic index creation, dynamic mapping updates, waiting for active shards.' + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + index::query.version: + in: query + name: version + description: |- + Explicit version number for concurrency control. + The specified version must match the current version of the document for the request to succeed. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + index::query.version_type: + in: query + name: version_type + description: 'Specific version type: `external`, `external_gte`.' + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + index::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + indices.add_block::path.block: + in: path + name: block + description: The block to add (one of read, write, read_only or metadata) + required: true + schema: + $ref: '#/components/schemas/indices.add_block:IndicesBlockOptions' + style: simple + indices.add_block::path.index: + in: path + name: index + description: A comma separated list of indices to add a block to + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.add_block::query.allow_no_indices: + in: query + name: allow_no_indices + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified) + schema: + type: boolean + style: form + indices.add_block::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.add_block::query.expand_wildcards: + in: query + name: expand_wildcards + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.add_block::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: Whether specified concrete indices should be ignored when unavailable (missing or closed) + schema: + type: boolean + style: form + indices.add_block::query.master_timeout: + in: query + name: master_timeout + description: Specify timeout for connection to master + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.add_block::query.timeout: + in: query + name: timeout + description: Explicit operation timeout + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.analyze::path.index: + in: path + name: index + description: |- + Index used to derive the analyzer. + If specified, the `analyzer` or field parameter overrides this value. + If no index is specified or the index does not have a default analyzer, the analyze API uses the standard analyzer. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.analyze::query.index: + name: index + in: query + description: The name of the index to scope the operation. + schema: + type: string + description: The name of the index to scope the operation. + indices.clear_cache::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.clear_cache::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.clear_cache::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.clear_cache::query.fielddata: + in: query + name: fielddata + description: |- + If `true`, clears the fields cache. + Use the `fields` parameter to clear the cache of specific fields only. + schema: + type: boolean + style: form + indices.clear_cache::query.fields: + in: query + name: fields + description: Comma-separated list of field names used to limit the `fielddata` parameter. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + indices.clear_cache::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.clear_cache::query.index: + name: index + in: query + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + explode: true + indices.clear_cache::query.query: + in: query + name: query + description: If `true`, clears the query cache. + schema: + type: boolean + style: form + indices.clear_cache::query.request: + in: query + name: request + description: If `true`, clears the request cache. + schema: + type: boolean + style: form + indices.clone::path.index: + in: path + name: index + description: Name of the source index to clone. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.clone::path.target: + in: path + name: target + description: Name of the target index to create. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.clone::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.clone::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.clone::query.task_execution_timeout: + name: task_execution_timeout + in: query + description: Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h. + schema: + $ref: '#/components/schemas/_common:Duration' + indices.clone::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.clone::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + indices.clone::query.wait_for_completion: + name: wait_for_completion + in: query + description: Should this request wait until the operation has completed before returning. + schema: + type: boolean + default: true + description: Should this request wait until the operation has completed before returning. + indices.close::path.index: + in: path + name: index + description: Comma-separated list or wildcard expression of index names used to limit the request. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.close::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.close::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.close::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.close::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.close::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.close::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.close::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + indices.create::path.index: + in: path + name: index + description: Name of the index you wish to create. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.create::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.create::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.create::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.create::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + indices.create_data_stream::path.name: + in: path + name: name + description: |- + Name of the data stream, which must meet the following criteria: + Lowercase only; + Cannot include `\`, `/`, `*`, `?`, `"`, `<`, `>`, `|`, `,`, `#`, `:`, or a space character; + Cannot start with `-`, `_`, `+`, or `.ds-`; + Cannot be `.` or `..`; + Cannot be longer than 255 bytes. Multi-byte characters count towards this limit faster. + required: true + schema: + $ref: '#/components/schemas/_common:DataStreamName' + style: simple + indices.data_streams_stats::path.name: + in: path + name: name + description: |- + Comma-separated list of data streams used to limit the request. + Wildcard expressions (`*`) are supported. + To target all data streams in a cluster, omit this parameter or use `*`. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.delete::path.index: + in: path + name: index + description: |- + Comma-separated list of indices to delete. + You cannot specify index aliases. + By default, this parameter does not support wildcards (`*`) or `_all`. + To use wildcards or `_all`, set the `action.destructive_requires_name` cluster setting to `false`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.delete::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.delete::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.delete::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.delete::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.delete::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.delete::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.delete_alias::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams or indices used to limit the request. + Supports wildcards (`*`). + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.delete_alias::path.name: + in: path + name: name + description: |- + Comma-separated list of aliases to remove. + Supports wildcards (`*`). To remove all aliases, use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + indices.delete_alias::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.delete_alias::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.delete_alias::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.delete_data_stream::path.name: + in: path + name: name + description: Comma-separated list of data streams to delete. Wildcard (`*`) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:DataStreamNames' + style: simple + indices.delete_index_template::path.name: + in: path + name: name + description: Name of the index template to delete. Wildcard (*) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.delete_index_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.delete_index_template::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.delete_index_template::query.timeout: + in: query + name: timeout + description: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.delete_template::path.name: + in: path + name: name + description: |- + The name of the legacy index template to delete. + Wildcard (`*`) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.delete_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.delete_template::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.delete_template::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.exists::path.index: + in: path + name: index + description: Comma-separated list of data streams, indices, and aliases. Supports wildcards (`*`). + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.exists::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.exists::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.exists::query.flat_settings: + in: query + name: flat_settings + description: If `true`, returns settings in flat format. + schema: + type: boolean + style: form + indices.exists::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.exists::query.include_defaults: + in: query + name: include_defaults + description: If `true`, return all default settings in the response. + schema: + type: boolean + style: form + indices.exists::query.local: + in: query + name: local + description: If `true`, the request retrieves information from the local node only. + schema: + type: boolean + style: form + indices.exists_alias::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams or indices used to limit the request. Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.exists_alias::path.name: + in: path + name: name + description: Comma-separated list of aliases to check. Supports wildcards (`*`). + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + indices.exists_alias::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.exists_alias::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.exists_alias::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, requests that include a missing data stream or index in the target indices or data streams return an error. + schema: + type: boolean + style: form + indices.exists_alias::query.local: + in: query + name: local + description: If `true`, the request retrieves information from the local node only. + schema: + type: boolean + style: form + indices.exists_index_template::path.name: + in: path + name: name + description: Name of the index template to check existence of. Wildcard (*) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.exists_index_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.exists_index_template::query.flat_settings: + name: flat_settings + in: query + description: Return settings in flat format. + schema: + type: boolean + default: false + description: Return settings in flat format. + indices.exists_index_template::query.local: + name: local + in: query + description: Return local information, do not retrieve the state from cluster-manager node. + schema: + type: boolean + default: false + description: Return local information, do not retrieve the state from cluster-manager node. + indices.exists_index_template::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.exists_template::path.name: + in: path + name: name + description: The comma separated names of the index templates + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + indices.exists_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.exists_template::query.flat_settings: + in: query + name: flat_settings + description: 'Return settings in flat format (default: false)' + schema: + type: boolean + style: form + indices.exists_template::query.local: + in: query + name: local + description: 'Return local information, do not retrieve the state from cluster-manager node (default: false)' + schema: + type: boolean + style: form + indices.exists_template::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.flush::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases to flush. + Supports wildcards (`*`). + To flush all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.flush::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.flush::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.flush::query.force: + in: query + name: force + description: If `true`, the request forces a flush even if there are no changes to commit to the index. + schema: + type: boolean + style: form + indices.flush::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.flush::query.wait_if_ongoing: + in: query + name: wait_if_ongoing + description: |- + If `true`, the flush operation blocks until execution when another flush operation is running. + If `false`, Opensearch returns an error if you request a flush when another flush operation is running. + schema: + type: boolean + style: form + indices.forcemerge::path.index: + in: path + name: index + description: A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.forcemerge::query.allow_no_indices: + in: query + name: allow_no_indices + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified) + schema: + type: boolean + style: form + indices.forcemerge::query.expand_wildcards: + in: query + name: expand_wildcards + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.forcemerge::query.flush: + in: query + name: flush + description: 'Specify whether the index should be flushed after performing the operation (default: true)' + schema: + type: boolean + style: form + indices.forcemerge::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: Whether specified concrete indices should be ignored when unavailable (missing or closed) + schema: + type: boolean + style: form + indices.forcemerge::query.max_num_segments: + in: query + name: max_num_segments + description: 'The number of segments the index should be merged into (default: dynamic)' + schema: + type: number + style: form + indices.forcemerge::query.only_expunge_deletes: + in: query + name: only_expunge_deletes + description: Specify whether the operation should only expunge deleted documents + schema: + type: boolean + style: form + indices.forcemerge::query.primary_only: + name: primary_only + in: query + description: Specify whether the operation should only perform on primary shards. Defaults to false. + schema: + type: boolean + default: false + description: Specify whether the operation should only perform on primary shards. Defaults to false. + indices.forcemerge::query.wait_for_completion: + in: query + name: wait_for_completion + description: Should the request wait until the force merge is completed. + schema: + type: boolean + style: form + indices.get::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and index aliases used to limit the request. + Wildcard expressions (*) are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.get::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If false, the request returns an error if any wildcard expression, index alias, or _all value targets only + missing or closed indices. This behavior applies even if the request targets other open indices. For example, + a request targeting foo*,bar* returns an error if an index starts with foo but no index starts with bar. + schema: + type: boolean + style: form + indices.get::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.get::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard expressions can match. If the request can target data streams, this argument + determines whether wildcard expressions match hidden data streams. Supports comma-separated values, + such as open,hidden. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.get::query.flat_settings: + in: query + name: flat_settings + description: If true, returns settings in flat format. + schema: + type: boolean + style: form + indices.get::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If false, requests that target a missing index return an error. + schema: + type: boolean + style: form + indices.get::query.include_defaults: + in: query + name: include_defaults + description: If true, return all default settings in the response. + schema: + type: boolean + style: form + indices.get::query.local: + in: query + name: local + description: If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. + schema: + type: boolean + style: form + indices.get::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.get_alias::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams or indices used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.get_alias::path.name: + in: path + name: name + description: |- + Comma-separated list of aliases to retrieve. + Supports wildcards (`*`). + To retrieve all aliases, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + indices.get_alias::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.get_alias::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.get_alias::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.get_alias::query.local: + in: query + name: local + description: If `true`, the request retrieves information from the local node only. + schema: + type: boolean + style: form + indices.get_data_stream::path.name: + in: path + name: name + description: |- + Comma-separated list of data stream names used to limit the request. + Wildcard (`*`) expressions are supported. If omitted, all data streams are returned. + required: true + schema: + $ref: '#/components/schemas/_common:DataStreamNames' + style: simple + indices.get_field_mapping::path.fields: + in: path + name: fields + description: Comma-separated list or wildcard expression of fields used to limit returned information. + required: true + schema: + $ref: '#/components/schemas/_common:Fields' + style: simple + indices.get_field_mapping::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.get_field_mapping::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.get_field_mapping::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.get_field_mapping::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.get_field_mapping::query.include_defaults: + in: query + name: include_defaults + description: If `true`, return all default settings in the response. + schema: + type: boolean + style: form + indices.get_field_mapping::query.local: + in: query + name: local + description: If `true`, the request retrieves information from the local node only. + schema: + type: boolean + style: form + indices.get_index_template::path.name: + in: path + name: name + description: Name of the index template to retrieve. Wildcard (*) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.get_index_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.get_index_template::query.flat_settings: + in: query + name: flat_settings + description: If true, returns settings in flat format. + schema: + type: boolean + style: form + indices.get_index_template::query.local: + in: query + name: local + description: If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. + schema: + type: boolean + style: form + indices.get_index_template::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.get_mapping::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.get_mapping::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.get_mapping::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.get_mapping::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.get_mapping::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.get_mapping::query.local: + in: query + name: local + description: If `true`, the request retrieves information from the local node only. + schema: + type: boolean + style: form + indices.get_mapping::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.get_settings::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit + the request. Supports wildcards (`*`). To target all data streams and + indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.get_settings::path.name: + in: path + name: name + description: Comma-separated list or wildcard expression of settings to retrieve. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + indices.get_settings::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index + alias, or `_all` value targets only missing or closed indices. This + behavior applies even if the request targets other open indices. For + example, a request targeting `foo*,bar*` returns an error if an index + starts with foo but no index starts with `bar`. + schema: + type: boolean + style: form + indices.get_settings::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.get_settings::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.get_settings::query.flat_settings: + in: query + name: flat_settings + description: If `true`, returns settings in flat format. + schema: + type: boolean + style: form + indices.get_settings::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.get_settings::query.include_defaults: + in: query + name: include_defaults + description: If `true`, return all default settings in the response. + schema: + type: boolean + style: form + indices.get_settings::query.local: + in: query + name: local + description: |- + If `true`, the request retrieves information from the local node only. If + `false`, information is retrieved from the master node. + schema: + type: boolean + style: form + indices.get_settings::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. If no response is + received before the timeout expires, the request fails and returns an + error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.get_template::path.name: + in: path + name: name + description: |- + Comma-separated list of index template names used to limit the request. + Wildcard (`*`) expressions are supported. + To return all index templates, omit this parameter or use a value of `_all` or `*`. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + indices.get_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.get_template::query.flat_settings: + in: query + name: flat_settings + description: If `true`, returns settings in flat format. + schema: + type: boolean + style: form + indices.get_template::query.local: + in: query + name: local + description: If `true`, the request retrieves information from the local node only. + schema: + type: boolean + style: form + indices.get_template::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.get_upgrade::path.index: + name: index + in: path + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + x-data-type: array + required: true + indices.get_upgrade::query.allow_no_indices: + name: allow_no_indices + in: query + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified). + schema: + type: boolean + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified). + indices.get_upgrade::query.expand_wildcards: + name: expand_wildcards + in: query + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + indices.get_upgrade::query.ignore_unavailable: + name: ignore_unavailable + in: query + description: Whether specified concrete indices should be ignored when unavailable (missing or closed). + schema: + type: boolean + description: Whether specified concrete indices should be ignored when unavailable (missing or closed). + indices.open::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + By default, you must explicitly name the indices you using to limit the request. + To limit a request using `_all`, `*`, or other wildcard expressions, change the `action.destructive_requires_name` setting to false. + You can update this setting in the `opensearch.yml` file or using the cluster update settings API. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.open::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.open::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.open::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.open::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.open::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.open::query.task_execution_timeout: + name: task_execution_timeout + in: query + description: Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h. + schema: + $ref: '#/components/schemas/_common:Duration' + indices.open::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.open::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + indices.open::query.wait_for_completion: + name: wait_for_completion + in: query + description: Should this request wait until the operation has completed before returning. + schema: + type: boolean + default: true + description: Should this request wait until the operation has completed before returning. + indices.put_alias::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams or indices to add. + Supports wildcards (`*`). + Wildcard patterns that match both data streams and indices return an error. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.put_alias::path.name: + in: path + name: name + description: |- + Alias to update. + If the alias doesn’t exist, the request creates it. + Index alias names support date math. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.put_alias::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.put_alias::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.put_alias::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.put_index_template::path.name: + in: path + name: name + description: Index or template name + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.put_index_template::query.cause: + name: cause + in: query + description: User defined reason for creating/updating the index template. + schema: + type: string + default: 'false' + description: User defined reason for creating/updating the index template. + indices.put_index_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.put_index_template::query.create: + in: query + name: create + description: If `true`, this request cannot replace or update existing index templates. + schema: + type: boolean + style: form + indices.put_index_template::query.master_timeout: + name: master_timeout + in: query + description: Operation timeout for connection to master node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + deprecated: true + indices.put_mapping::path.index: + in: path + name: index + description: A comma-separated list of index names the mapping should be added to (supports wildcards); use `_all` or omit to add the mapping on all indices. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.put_mapping::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.put_mapping::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.put_mapping::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.put_mapping::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.put_mapping::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.put_mapping::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.put_mapping::query.write_index_only: + in: query + name: write_index_only + description: If `true`, the mappings are applied only to the current write index for the target. + schema: + type: boolean + style: form + indices.put_settings::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit + the request. Supports wildcards (`*`). To target all data streams and + indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.put_settings::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index + alias, or `_all` value targets only missing or closed indices. This + behavior applies even if the request targets other open indices. For + example, a request targeting `foo*,bar*` returns an error if an index + starts with `foo` but no index starts with `bar`. + schema: + type: boolean + style: form + indices.put_settings::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.put_settings::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. If the request can target + data streams, this argument determines whether wildcard expressions match + hidden data streams. Supports comma-separated values, such as + `open,hidden`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.put_settings::query.flat_settings: + in: query + name: flat_settings + description: If `true`, returns settings in flat format. + schema: + type: boolean + style: form + indices.put_settings::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `true`, returns settings in flat format. + schema: + type: boolean + style: form + indices.put_settings::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. If no response is + received before the timeout expires, the request fails and returns an + error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.put_settings::query.preserve_existing: + in: query + name: preserve_existing + description: If `true`, existing index settings remain unchanged. + schema: + type: boolean + style: form + indices.put_settings::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. If no response is received before the + timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.put_template::path.name: + in: path + name: name + description: The name of the template + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.put_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.put_template::query.create: + in: query + name: create + description: If true, this request cannot replace or update existing index templates. + schema: + type: boolean + style: form + indices.put_template::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. If no response is + received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.put_template::query.order: + in: query + name: order + description: |- + Order in which Opensearch applies this template if index + matches multiple templates. + + Templates with lower 'order' values are merged first. Templates with higher + 'order' values are merged later, overriding templates with lower values. + schema: + type: number + style: form + indices.recovery::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.recovery::query.active_only: + in: query + name: active_only + description: If `true`, the response only includes ongoing shard recoveries. + schema: + type: boolean + style: form + indices.recovery::query.detailed: + in: query + name: detailed + description: If `true`, the response includes detailed information about shard recoveries. + schema: + type: boolean + style: form + indices.refresh::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.refresh::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.refresh::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.refresh::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.resolve_index::path.name: + in: path + name: name + description: |- + Comma-separated name(s) or index pattern(s) of the indices, aliases, and data streams to resolve. + Resources on remote clusters can be specified using the ``:`` syntax. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + indices.resolve_index::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.rollover::path.alias: + in: path + name: alias + description: Name of the data stream or index alias to roll over. + required: true + schema: + $ref: '#/components/schemas/_common:IndexAlias' + style: simple + indices.rollover::path.new_index: + in: path + name: new_index + description: |- + Name of the index to create. + Supports date math. + Data streams do not support this parameter. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.rollover::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.rollover::query.dry_run: + in: query + name: dry_run + description: If `true`, checks whether the current index satisfies the specified conditions but does not perform a rollover. + schema: + type: boolean + style: form + indices.rollover::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.rollover::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.rollover::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + indices.segments::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases used to limit the request. + Supports wildcards (`*`). + To target all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.segments::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.segments::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.segments::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.segments::query.verbose: + in: query + name: verbose + description: If `true`, the request returns a verbose response. + schema: + type: boolean + style: form + indices.shard_stores::path.index: + in: path + name: index + description: List of data streams, indices, and aliases used to limit the request. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.shard_stores::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If false, the request returns an error if any wildcard expression, index alias, or _all + value targets only missing or closed indices. This behavior applies even if the request + targets other open indices. + schema: + type: boolean + style: form + indices.shard_stores::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. If the request can target data streams, + this argument determines whether wildcard expressions match hidden data streams. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.shard_stores::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If true, missing or closed indices are not included in the response. + schema: + type: boolean + style: form + indices.shard_stores::query.status: + in: query + name: status + description: List of shard health statuses used to limit the request. + schema: + oneOf: + - $ref: '#/components/schemas/indices.shard_stores:ShardStoreStatus' + - type: array + items: + $ref: '#/components/schemas/indices.shard_stores:ShardStoreStatus' + style: form + indices.shrink::path.index: + in: path + name: index + description: Name of the source index to shrink. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.shrink::path.target: + in: path + name: target + description: Name of the target index to create. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.shrink::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.shrink::query.copy_settings: + name: copy_settings + in: query + description: whether or not to copy settings from the source index. + schema: + type: boolean + default: false + description: whether or not to copy settings from the source index. + indices.shrink::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.shrink::query.task_execution_timeout: + name: task_execution_timeout + in: query + description: Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h. + schema: + $ref: '#/components/schemas/_common:Duration' + indices.shrink::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.shrink::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + indices.shrink::query.wait_for_completion: + name: wait_for_completion + in: query + description: Should this request wait until the operation has completed before returning. + schema: + type: boolean + default: true + description: Should this request wait until the operation has completed before returning. + indices.simulate_index_template::path.name: + in: path + name: name + description: Index or template name to simulate + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.simulate_index_template::query.cause: + name: cause + in: query + description: User defined reason for dry-run creating the new template for simulation purposes. + schema: + type: string + default: 'false' + description: User defined reason for dry-run creating the new template for simulation purposes. + indices.simulate_index_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.simulate_index_template::query.create: + in: query + name: create + description: |- + If `true`, the template passed in the body is only used if no existing + templates match the same index patterns. If `false`, the simulation uses + the template with the highest priority. Note that the template is not + permanently added or updated in either case; it is only used for the + simulation. + schema: + type: boolean + style: form + indices.simulate_index_template::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. If no response is received + before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.simulate_template::path.name: + in: path + name: name + description: |- + Name of the index template to simulate. To test a template configuration before you add it to the cluster, omit + this parameter and specify the template configuration in the request body. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + indices.simulate_template::query.cause: + name: cause + in: query + description: User defined reason for dry-run creating the new template for simulation purposes. + schema: + type: string + default: 'false' + description: User defined reason for dry-run creating the new template for simulation purposes. + indices.simulate_template::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.simulate_template::query.create: + in: query + name: create + description: If true, the template passed in the body is only used if no existing templates match the same index patterns. If false, the simulation uses the template with the highest priority. Note that the template is not permanently added or updated in either case; it is only used for the simulation. + schema: + type: boolean + style: form + indices.simulate_template::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.split::path.index: + in: path + name: index + description: Name of the source index to split. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.split::path.target: + in: path + name: target + description: Name of the target index to create. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + indices.split::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.split::query.copy_settings: + name: copy_settings + in: query + description: whether or not to copy settings from the source index. + schema: + type: boolean + default: false + description: whether or not to copy settings from the source index. + indices.split::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.split::query.task_execution_timeout: + name: task_execution_timeout + in: query + description: Explicit task execution timeout, only useful when wait_for_completion is false, defaults to 1h. + schema: + $ref: '#/components/schemas/_common:Duration' + indices.split::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.split::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + indices.split::query.wait_for_completion: + name: wait_for_completion + in: query + description: Should this request wait until the operation has completed before returning. + schema: + type: boolean + default: true + description: Should this request wait until the operation has completed before returning. + indices.stats::path.index: + in: path + name: index + description: A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.stats::path.metric: + in: path + name: metric + description: Limit the information returned the specific metrics. + required: true + schema: + $ref: '#/components/schemas/_common:Metrics' + style: simple + indices.stats::query.completion_fields: + in: query + name: completion_fields + description: Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + indices.stats::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. If the request can target data streams, this argument + determines whether wildcard expressions match hidden data streams. Supports comma-separated values, + such as `open,hidden`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.stats::query.fielddata_fields: + in: query + name: fielddata_fields + description: Comma-separated list or wildcard expressions of fields to include in fielddata statistics. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + indices.stats::query.fields: + in: query + name: fields + description: Comma-separated list or wildcard expressions of fields to include in the statistics. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + indices.stats::query.forbid_closed_indices: + in: query + name: forbid_closed_indices + description: If true, statistics are not collected from closed indices. + schema: + type: boolean + style: form + indices.stats::query.groups: + in: query + name: groups + description: Comma-separated list of search groups to include in the search statistics. + schema: + oneOf: + - type: string + - type: array + items: + type: string + style: form + indices.stats::query.include_segment_file_sizes: + in: query + name: include_segment_file_sizes + description: If true, the call reports the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested). + schema: + type: boolean + style: form + indices.stats::query.include_unloaded_segments: + in: query + name: include_unloaded_segments + description: If true, the response includes information from segments that are not loaded into memory. + schema: + type: boolean + style: form + indices.stats::query.level: + in: query + name: level + description: Indicates whether statistics are aggregated at the cluster, index, or shard level. + schema: + $ref: '#/components/schemas/_common:Level' + style: form + indices.update_aliases::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + indices.update_aliases::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + indices.update_aliases::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + indices.upgrade::path.index: + name: index + in: path + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + x-data-type: array + required: true + indices.upgrade::query.allow_no_indices: + name: allow_no_indices + in: query + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified). + schema: + type: boolean + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified). + indices.upgrade::query.expand_wildcards: + name: expand_wildcards + in: query + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + indices.upgrade::query.ignore_unavailable: + name: ignore_unavailable + in: query + description: Whether specified concrete indices should be ignored when unavailable (missing or closed). + schema: + type: boolean + description: Whether specified concrete indices should be ignored when unavailable (missing or closed). + indices.upgrade::query.only_ancient_segments: + name: only_ancient_segments + in: query + description: If true, only ancient (an older Lucene major release) segments will be upgraded. + schema: + type: boolean + description: If true, only ancient (an older Lucene major release) segments will be upgraded. + indices.upgrade::query.wait_for_completion: + name: wait_for_completion + in: query + description: Should this request wait until the operation has completed before returning. + schema: + type: boolean + default: false + description: Should this request wait until the operation has completed before returning. + indices.validate_query::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases to search. + Supports wildcards (`*`). + To search all data streams or indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + indices.validate_query::query.all_shards: + in: query + name: all_shards + description: If `true`, the validation is executed on all shards instead of one random shard per index. + schema: + type: boolean + style: form + indices.validate_query::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + schema: + type: boolean + style: form + indices.validate_query::query.analyze_wildcard: + in: query + name: analyze_wildcard + description: If `true`, wildcard and prefix queries are analyzed. + schema: + type: boolean + style: form + indices.validate_query::query.analyzer: + in: query + name: analyzer + description: |- + Analyzer to use for the query string. + This parameter can only be used when the `q` query string parameter is specified. + schema: + type: string + style: form + indices.validate_query::query.default_operator: + in: query + name: default_operator + description: 'The default operator for query string query: `AND` or `OR`.' + schema: + $ref: '#/components/schemas/_common.query_dsl:Operator' + style: form + indices.validate_query::query.df: + in: query + name: df + description: |- + Field to use as default where no field prefix is given in the query string. + This parameter can only be used when the `q` query string parameter is specified. + schema: + type: string + style: form + indices.validate_query::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + indices.validate_query::query.explain: + in: query + name: explain + description: If `true`, the response returns detailed information if an error has occurred. + schema: + type: boolean + style: form + indices.validate_query::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + indices.validate_query::query.lenient: + in: query + name: lenient + description: If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. + schema: + type: boolean + style: form + indices.validate_query::query.q: + in: query + name: q + description: Query in the Lucene query string syntax. + schema: + type: string + style: form + indices.validate_query::query.rewrite: + in: query + name: rewrite + description: If `true`, returns a more detailed explanation showing the actual Lucene query that will be executed. + schema: + type: boolean + style: form + ingest.delete_pipeline::path.id: + in: path + name: id + description: |- + Pipeline ID or wildcard expression of pipeline IDs used to limit the request. + To delete all ingest pipelines in a cluster, use a value of `*`. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + ingest.delete_pipeline::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + ingest.delete_pipeline::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + ingest.delete_pipeline::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + ingest.get_pipeline::path.id: + in: path + name: id + description: |- + Comma-separated list of pipeline IDs to retrieve. + Wildcard (`*`) expressions are supported. + To get all ingest pipelines, omit this parameter or use `*`. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + ingest.get_pipeline::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + ingest.get_pipeline::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + ingest.put_pipeline::path.id: + in: path + name: id + description: ID of the ingest pipeline to create or update. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + ingest.put_pipeline::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + ingest.put_pipeline::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + ingest.put_pipeline::query.timeout: + in: query + name: timeout + description: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + ingest.simulate::path.id: + in: path + name: id + description: |- + Pipeline to test. + If you don’t specify a `pipeline` in the request body, this parameter is required. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + ingest.simulate::query.verbose: + in: query + name: verbose + description: If `true`, the response includes output data for each processor in the executed pipeline. + schema: + type: boolean + style: form + knn.delete_model::path.model_id: + name: model_id + in: path + description: The id of the model. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: The id of the model. + required: true + knn.get_model::path.model_id: + name: model_id + in: path + description: The id of the model. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: The id of the model. + required: true + knn.search_models::query._source: + name: _source + in: query + description: True or false to return the _source field or not, or a list of fields to return. + style: form + schema: + type: array + items: + type: string + description: True or false to return the _source field or not, or a list of fields to return. + explode: true + knn.search_models::query._source_excludes: + name: _source_excludes + in: query + description: List of fields to exclude from the returned _source field. + style: form + schema: + type: array + items: + type: string + description: List of fields to exclude from the returned _source field. + explode: true + knn.search_models::query._source_includes: + name: _source_includes + in: query + description: List of fields to extract and return from the _source field. + style: form + schema: + type: array + items: + type: string + description: List of fields to extract and return from the _source field. + explode: true + knn.search_models::query.allow_no_indices: + name: allow_no_indices + in: query + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified). + schema: + type: boolean + description: Whether to ignore if a wildcard indices expression resolves into no concrete indices. (This includes `_all` string or when no indices have been specified). + knn.search_models::query.allow_partial_search_results: + name: allow_partial_search_results + in: query + description: Indicate if an error should be returned if there is a partial search failure or timeout. + schema: + type: boolean + default: true + description: Indicate if an error should be returned if there is a partial search failure or timeout. + knn.search_models::query.analyze_wildcard: + name: analyze_wildcard + in: query + description: Specify whether wildcard and prefix queries should be analyzed. + schema: + type: boolean + default: false + description: Specify whether wildcard and prefix queries should be analyzed. + knn.search_models::query.analyzer: + name: analyzer + in: query + description: The analyzer to use for the query string. + schema: + type: string + description: The analyzer to use for the query string. + knn.search_models::query.batched_reduce_size: + name: batched_reduce_size + in: query + description: The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large. + schema: + type: integer + default: 512 + description: The number of shard results that should be reduced at once on the coordinating node. This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large. + format: int32 + knn.search_models::query.ccs_minimize_roundtrips: + name: ccs_minimize_roundtrips + in: query + description: Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution. + schema: + type: boolean + default: true + description: Indicates whether network round-trips should be minimized as part of cross-cluster search requests execution. + knn.search_models::query.default_operator: + name: default_operator + in: query + description: The default operator for query string query (AND or OR). + schema: + $ref: '#/components/schemas/knn._common:DefaultOperator' + knn.search_models::query.df: + name: df + in: query + description: The field to use as default where no field prefix is given in the query string. + schema: + type: string + description: The field to use as default where no field prefix is given in the query string. + knn.search_models::query.docvalue_fields: + name: docvalue_fields + in: query + description: Comma-separated list of fields to return as the docvalue representation of a field for each hit. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of fields to return as the docvalue representation of a field for each hit. + explode: true + knn.search_models::query.expand_wildcards: + name: expand_wildcards + in: query + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + knn.search_models::query.explain: + name: explain + in: query + description: Specify whether to return detailed information about score computation as part of a hit. + schema: + type: boolean + description: Specify whether to return detailed information about score computation as part of a hit. + knn.search_models::query.from: + name: from + in: query + description: Starting offset. + schema: + type: integer + default: 0 + description: Starting offset. + format: int32 + knn.search_models::query.ignore_throttled: + name: ignore_throttled + in: query + description: Whether specified concrete, expanded or aliased indices should be ignored when throttled. + schema: + type: boolean + description: Whether specified concrete, expanded or aliased indices should be ignored when throttled. + knn.search_models::query.ignore_unavailable: + name: ignore_unavailable + in: query + description: Whether specified concrete indices should be ignored when unavailable (missing or closed). + schema: + type: boolean + description: Whether specified concrete indices should be ignored when unavailable (missing or closed). + knn.search_models::query.lenient: + name: lenient + in: query + description: Specify whether format-based query failures (such as providing text to a numeric field) should be ignored. + schema: + type: boolean + description: Specify whether format-based query failures (such as providing text to a numeric field) should be ignored. + knn.search_models::query.max_concurrent_shard_requests: + name: max_concurrent_shard_requests + in: query + description: 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. + schema: + type: integer + default: 5 + description: 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. + format: int32 + knn.search_models::query.pre_filter_shard_size: + name: pre_filter_shard_size + in: query + description: Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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. + schema: + type: integer + description: Threshold that enforces a pre-filter round-trip to prefilter search shards based on query rewriting if the number of shards the search request expands to exceeds the threshold. This filter round-trip 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. + format: int32 + knn.search_models::query.preference: + name: preference + in: query + description: Specify the node or shard the operation should be performed on. + schema: + type: string + default: random + description: Specify the node or shard the operation should be performed on. + knn.search_models::query.q: + name: q + in: query + description: Query in the Lucene query string syntax. + schema: + type: string + description: Query in the Lucene query string syntax. + knn.search_models::query.request_cache: + name: request_cache + in: query + description: Specify if request cache should be used for this request or not, defaults to index level setting. + schema: + type: boolean + description: Specify if request cache should be used for this request or not, defaults to index level setting. + knn.search_models::query.rest_total_hits_as_int: + name: rest_total_hits_as_int + in: query + description: Indicates whether hits.total should be rendered as an integer or an object in the rest search response. + schema: + type: boolean + default: false + description: Indicates whether hits.total should be rendered as an integer or an object in the rest search response. + knn.search_models::query.routing: + name: routing + in: query + description: Comma-separated list of specific routing values. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of specific routing values. + explode: true + knn.search_models::query.scroll: + name: scroll + in: query + description: Specify how long a consistent view of the index should be maintained for scrolled search. + schema: + $ref: '#/components/schemas/_common:Duration' + knn.search_models::query.search_type: + name: search_type + in: query + description: Search operation type. + schema: + $ref: '#/components/schemas/knn._common:SearchType' + knn.search_models::query.seq_no_primary_term: + name: seq_no_primary_term + in: query + description: Specify whether to return sequence number and primary term of the last modification of each hit. + schema: + type: boolean + description: Specify whether to return sequence number and primary term of the last modification of each hit. + knn.search_models::query.size: + name: size + in: query + description: Number of hits to return. + schema: + type: integer + default: 10 + description: Number of hits to return. + format: int32 + knn.search_models::query.sort: + name: sort + in: query + description: Comma-separated list of : pairs. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of : pairs. + explode: true + knn.search_models::query.stats: + name: stats + in: query + description: Specific 'tag' of the request for logging and statistical purposes. + style: form + schema: + type: array + items: + type: string + description: Specific 'tag' of the request for logging and statistical purposes. + explode: true + knn.search_models::query.stored_fields: + name: stored_fields + in: query + description: Comma-separated list of stored fields to return. + style: form + schema: + type: array + items: + type: string + description: Comma-separated list of stored fields to return. + explode: true + knn.search_models::query.suggest_field: + name: suggest_field + in: query + description: Specify which field to use for suggestions. + schema: + type: string + description: Specify which field to use for suggestions. + knn.search_models::query.suggest_mode: + name: suggest_mode + in: query + description: Specify suggest mode. + schema: + $ref: '#/components/schemas/knn._common:SuggestMode' + knn.search_models::query.suggest_size: + name: suggest_size + in: query + description: How many suggestions to return in response. + schema: + type: integer + description: How many suggestions to return in response. + format: int32 + knn.search_models::query.suggest_text: + name: suggest_text + in: query + description: The source text for which the suggestions should be returned. + schema: + type: string + description: The source text for which the suggestions should be returned. + knn.search_models::query.terminate_after: + name: terminate_after + in: query + description: The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early. + schema: + type: integer + description: The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early. + format: int32 + knn.search_models::query.timeout: + name: timeout + in: query + description: Operation timeout. + schema: + $ref: '#/components/schemas/_common:Duration' + knn.search_models::query.track_scores: + name: track_scores + in: query + description: Whether to calculate and return scores even if they are not used for sorting. + schema: + type: boolean + description: Whether to calculate and return scores even if they are not used for sorting. + knn.search_models::query.track_total_hits: + name: track_total_hits + in: query + description: Indicate if the number of documents that match the query should be tracked. + schema: + type: boolean + description: Indicate if the number of documents that match the query should be tracked. + knn.search_models::query.typed_keys: + name: typed_keys + in: query + description: Specify whether aggregation and suggester names should be prefixed by their respective types in the response. + schema: + type: boolean + description: Specify whether aggregation and suggester names should be prefixed by their respective types in the response. + knn.search_models::query.version: + name: version + in: query + description: Whether to return document version as part of a hit. + schema: + type: boolean + description: Whether to return document version as part of a hit. + knn.stats::path.node_id: + name: node_id + in: path + description: 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. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: 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. + x-data-type: array + required: true + knn.stats::path.stat: + name: stat + in: path + description: Comma-separated list of stats to retrieve; use `_all` or empty string to retrieve all stats. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Comma-separated list of stats to retrieve; use `_all` or empty string to retrieve all stats. + x-enum-options: + - circuit_breaker_triggered + - total_load_time + - eviction_count + - hit_count + - miss_count + - graph_memory_usage + - graph_memory_usage_percentage + - graph_index_requests + - graph_index_errors + - graph_query_requests + - graph_query_errors + - knn_query_requests + - cache_capacity_reached + - load_success_count + - load_exception_count + - indices_in_cache + - script_compilations + - script_compilation_errors + - script_query_requests + - script_query_errors + - nmslib_initialized + - faiss_initialized + - model_index_status + - indexing_from_model_degraded + - training_requests + - training_errors + - training_memory_usage + - training_memory_usage_percentage + x-data-type: array + required: true + knn.stats::query.timeout: + name: timeout + in: query + description: Operation timeout. + schema: + $ref: '#/components/schemas/_common:Duration' + knn.train_model::path.model_id: + name: model_id + in: path + description: The id of the model. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: The id of the model. + required: true + knn.train_model::query.preference: + name: preference + in: query + description: Preferred node to execute training. + schema: + type: string + description: Preferred node to execute training. + knn.warmup::path.index: + name: index + in: path + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: Comma-separated list of indices; use `_all` or empty string to perform the operation on all indices. + x-data-type: array + required: true + mget::path.index: + in: path + name: index + description: Name of the index to retrieve documents from when `ids` are specified, or when a document in the `docs` array does not specify an index. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + mget::query._source: + in: query + name: _source + description: True or false to return the `_source` field or not, or a list of fields to return. + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + mget::query._source_excludes: + in: query + name: _source_excludes + description: |- + A comma-separated list of source fields to exclude from the response. + You can also use this parameter to exclude fields from the subset specified in `_source_includes` query parameter. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + mget::query._source_includes: + in: query + name: _source_includes + description: |- + A comma-separated list of source fields to include in the response. + If this parameter is specified, only these source fields are returned. You can exclude fields from this subset using the `_source_excludes` query parameter. + If the `_source` parameter is `false`, this parameter is ignored. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + mget::query.preference: + in: query + name: preference + description: Specifies the node or shard the operation should be performed on. Random by default. + schema: + type: string + style: form + mget::query.realtime: + in: query + name: realtime + description: If `true`, the request is real-time as opposed to near-real-time. + schema: + type: boolean + style: form + mget::query.refresh: + in: query + name: refresh + description: If `true`, the request refreshes relevant shards before retrieving documents. + schema: + type: boolean + style: form + mget::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + mget::query.stored_fields: + in: query + name: stored_fields + description: If `true`, retrieves the document fields stored in the index rather than the document `_source`. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + msearch::path.index: + in: path + name: index + description: Comma-separated list of data streams, indices, and index aliases to search. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + msearch::query.ccs_minimize_roundtrips: + in: query + name: ccs_minimize_roundtrips + description: If true, network roundtrips between the coordinating node and remote clusters are minimized for cross-cluster search requests. + schema: + type: boolean + style: form + msearch::query.max_concurrent_searches: + in: query + name: max_concurrent_searches + description: Maximum number of concurrent searches the multi search API can execute. + schema: + type: number + style: form + msearch::query.max_concurrent_shard_requests: + in: query + name: max_concurrent_shard_requests + description: Maximum number of concurrent shard requests that each sub-search request executes per node. + schema: + type: number + style: form + msearch::query.pre_filter_shard_size: + in: query + name: pre_filter_shard_size + description: Defines 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 i.e., if date filters are mandatory to match but the shard bounds and the query are disjoint. + schema: + type: number + style: form + msearch::query.rest_total_hits_as_int: + in: query + name: rest_total_hits_as_int + description: If true, hits.total are returned as an integer in the response. Defaults to false, which returns an object. + schema: + type: boolean + style: form + msearch::query.search_type: + in: query + name: search_type + description: Indicates whether global term and document frequencies should be used when scoring returned documents. + schema: + $ref: '#/components/schemas/_common:SearchType' + style: form + msearch::query.typed_keys: + in: query + name: typed_keys + description: Specifies whether aggregation and suggester names should be prefixed by their respective types in the response. + schema: + type: boolean + style: form + msearch_template::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases to search. + Supports wildcards (`*`). + To search all data streams and indices, omit this parameter or use `*`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + msearch_template::query.ccs_minimize_roundtrips: + in: query + name: ccs_minimize_roundtrips + description: If `true`, network round-trips are minimized for cross-cluster search requests. + schema: + type: boolean + style: form + msearch_template::query.max_concurrent_searches: + in: query + name: max_concurrent_searches + description: Maximum number of concurrent searches the API can run. + schema: + type: number + style: form + msearch_template::query.rest_total_hits_as_int: + in: query + name: rest_total_hits_as_int + description: |- + If `true`, the response returns `hits.total` as an integer. + If `false`, it returns `hits.total` as an object. + schema: + type: boolean + style: form + msearch_template::query.search_type: + in: query + name: search_type + description: |- + The type of the search operation. + Available options: `query_then_fetch`, `dfs_query_then_fetch`. + schema: + $ref: '#/components/schemas/_common:SearchType' + style: form + msearch_template::query.typed_keys: + in: query + name: typed_keys + description: If `true`, the response prefixes aggregation and suggester names with their respective types. + schema: + type: boolean + style: form + mtermvectors::path.index: + in: path + name: index + description: Name of the index that contains the documents. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + mtermvectors::query.field_statistics: + in: query + name: field_statistics + description: If `true`, the response includes the document count, sum of document frequencies, and sum of total term frequencies. + schema: + type: boolean + style: form + mtermvectors::query.fields: + in: query + name: fields + description: |- + Comma-separated list or wildcard expressions of fields to include in the statistics. + Used as the default list unless a specific field list is provided in the `completion_fields` or `fielddata_fields` parameters. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + mtermvectors::query.ids: + in: query + name: ids + description: A comma-separated list of documents ids. You must define ids as parameter or set "ids" or "docs" in the request body + schema: + type: array + items: + $ref: '#/components/schemas/_common:Id' + style: form + mtermvectors::query.offsets: + in: query + name: offsets + description: If `true`, the response includes term offsets. + schema: + type: boolean + style: form + mtermvectors::query.payloads: + in: query + name: payloads + description: If `true`, the response includes term payloads. + schema: + type: boolean + style: form + mtermvectors::query.positions: + in: query + name: positions + description: If `true`, the response includes term positions. + schema: + type: boolean + style: form + mtermvectors::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + mtermvectors::query.realtime: + in: query + name: realtime + description: If true, the request is real-time as opposed to near-real-time. + schema: + type: boolean + style: form + mtermvectors::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + mtermvectors::query.term_statistics: + in: query + name: term_statistics + description: If true, the response includes term frequency and document frequency. + schema: + type: boolean + style: form + mtermvectors::query.version: + in: query + name: version + description: If `true`, returns the document version as part of a hit. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + mtermvectors::query.version_type: + in: query + name: version_type + description: Specific version type. + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + nodes.hot_threads::path.node_id: + name: node_id + in: path + description: 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. + schema: + type: string + pattern: ^(?!_|template|query|field|point|clear|usage|stats|hot|reload|painless).+$ + description: 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. + x-data-type: array + required: true + nodes.hot_threads::query.ignore_idle_threads: + name: ignore_idle_threads + in: query + description: Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue. + schema: + type: boolean + default: true + description: Don't show threads that are in known-idle places, such as waiting on a socket select or pulling from an empty task queue. + nodes.hot_threads::query.interval: + name: interval + in: query + description: The interval for the second sampling of threads. + schema: + $ref: '#/components/schemas/_common:Duration' + nodes.hot_threads::query.snapshots: + name: snapshots + in: query + description: Number of samples of thread stacktrace. + schema: + type: integer + default: 10 + description: Number of samples of thread stacktrace. + format: int32 + nodes.hot_threads::query.threads: + name: threads + in: query + description: Specify the number of threads to provide information for. + schema: + type: integer + default: 3 + description: Specify the number of threads to provide information for. + format: int32 + nodes.hot_threads::query.timeout: + name: timeout + in: query + description: Operation timeout. + schema: + $ref: '#/components/schemas/_common:Duration' + nodes.hot_threads::query.type: + name: type + in: query + description: The type to sample. + schema: + $ref: '#/components/schemas/nodes._common:SampleType' + nodes.info::path.metric: + in: path + name: metric + description: Limits the information returned to the specific metrics. Supports a comma-separated list, such as http,ingest. + required: true + schema: + type: array + items: + $ref: '#/components/schemas/nodes.info:Metric' + style: simple + nodes.info::path.node_id: + in: path + name: node_id + description: Comma-separated list of node IDs or names used to limit returned information. + required: true + schema: + $ref: '#/components/schemas/_common:NodeIds' + style: simple + nodes.info::query.flat_settings: + in: query + name: flat_settings + description: If true, returns settings in flat format. + schema: + type: boolean + style: form + nodes.info::query.timeout: + in: query + name: timeout + description: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + nodes.reload_secure_settings::path.node_id: + in: path + name: node_id + description: The names of particular nodes in the cluster to target. + required: true + schema: + $ref: '#/components/schemas/_common:NodeIds' + style: simple + nodes.reload_secure_settings::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + nodes.stats::path.index_metric: + in: path + name: index_metric + description: Limit the information returned for indices metric to the specific index metrics. It can be used only if indices (or all) metric is specified. + required: true + schema: + type: array + items: + $ref: '#/components/schemas/nodes.stats:IndexMetric' + style: simple + nodes.stats::path.metric: + in: path + name: metric + description: Limit the information returned to the specified metrics + required: true + schema: + type: array + items: + $ref: '#/components/schemas/nodes.stats:Metric' + style: simple + nodes.stats::path.node_id: + in: path + name: node_id + description: Comma-separated list of node IDs or names used to limit returned information. + required: true + schema: + $ref: '#/components/schemas/_common:NodeIds' + style: simple + nodes.stats::query.completion_fields: + in: query + name: completion_fields + description: Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + nodes.stats::query.fielddata_fields: + in: query + name: fielddata_fields + description: Comma-separated list or wildcard expressions of fields to include in fielddata statistics. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + nodes.stats::query.fields: + in: query + name: fields + description: Comma-separated list or wildcard expressions of fields to include in the statistics. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + nodes.stats::query.groups: + in: query + name: groups + description: Comma-separated list of search groups to include in the search statistics. + schema: + type: array + items: + type: string + style: form + nodes.stats::query.include_segment_file_sizes: + in: query + name: include_segment_file_sizes + description: If true, the call reports the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested). + schema: + type: boolean + style: form + nodes.stats::query.level: + in: query + name: level + description: Indicates whether statistics are aggregated at the cluster, index, or shard level. + schema: + $ref: '#/components/schemas/_common:Level' + style: form + nodes.stats::query.timeout: + in: query + name: timeout + description: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + nodes.stats::query.types: + in: query + name: types + description: A comma-separated list of document types for the indexing index metric. + schema: + type: array + items: + type: string + style: form + nodes.usage::path.metric: + in: path + name: metric + description: |- + Limits the information returned to the specific metrics. + A comma-separated list of the following options: `_all`, `rest_actions`. + required: true + schema: + type: array + items: + $ref: '#/components/schemas/nodes.usage:Metric' + style: simple + nodes.usage::path.node_id: + in: path + name: node_id + description: 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 + required: true + schema: + $ref: '#/components/schemas/_common:NodeIds' + style: simple + nodes.usage::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + notifications.delete_config::path.config_id: + name: config_id + in: path + description: The ID of the channel configuration to delete. + schema: + type: string + required: true + notifications.delete_configs::query.config_id: + name: config_id + in: query + description: The ID of the channel configuration to delete. + schema: + type: string + required: true + notifications.delete_configs::query.config_id_list: + name: config_id_list + in: query + description: A comma-separated list of channel IDs to delete. + schema: + type: string + notifications.get_config::path.config_id: + name: config_id + in: path + schema: + type: string + required: true + notifications.get_configs::query.chime.url: + name: chime.url + in: query + schema: + type: string + notifications.get_configs::query.chime.url.keyword: + name: chime.url.keyword + in: query + schema: + type: string + notifications.get_configs::query.config_type: + name: config_type + in: query + description: Type of notification configuration. + schema: + $ref: '#/components/schemas/notifications._common:NotificationConfigType' + notifications.get_configs::query.created_time_ms: + name: created_time_ms + in: query + schema: + type: integer + format: int64 + notifications.get_configs::query.description: + name: description + in: query + schema: + type: string + notifications.get_configs::query.description.keyword: + name: description.keyword + in: query + schema: + type: string + notifications.get_configs::query.email.email_account_id: + name: email.email_account_id + in: query + schema: + type: string + notifications.get_configs::query.email.email_group_id_list: + name: email.email_group_id_list + in: query + schema: + type: string + notifications.get_configs::query.email.recipient_list.recipient: + name: email.recipient_list.recipient + in: query + schema: + type: string + notifications.get_configs::query.email.recipient_list.recipient.keyword: + name: email.recipient_list.recipient.keyword + in: query + schema: + type: string + notifications.get_configs::query.email_group.recipient_list.recipient: + name: email_group.recipient_list.recipient + in: query + schema: + type: string + notifications.get_configs::query.email_group.recipient_list.recipient.keyword: + name: email_group.recipient_list.recipient.keyword + in: query + schema: + type: string + notifications.get_configs::query.is_enabled: + name: is_enabled + in: query + schema: + type: boolean + notifications.get_configs::query.last_updated_time_ms: + name: last_updated_time_ms + in: query + schema: + type: integer + format: int64 + notifications.get_configs::query.microsoft_teams.url: + name: microsoft_teams.url + in: query + schema: + type: string + notifications.get_configs::query.microsoft_teams.url.keyword: + name: microsoft_teams.url.keyword + in: query + schema: + type: string + notifications.get_configs::query.name: + name: name + in: query + schema: + type: string + notifications.get_configs::query.name.keyword: + name: name.keyword + in: query + schema: + type: string + notifications.get_configs::query.query: + name: query + in: query + schema: + type: string + notifications.get_configs::query.ses_account.from_address: + name: ses_account.from_address + in: query + schema: + type: string + notifications.get_configs::query.ses_account.from_address.keyword: + name: ses_account.from_address.keyword + in: query + schema: + type: string + notifications.get_configs::query.ses_account.region: + name: ses_account.region + in: query + schema: + type: string + notifications.get_configs::query.ses_account.role_arn: + name: ses_account.role_arn + in: query + schema: + type: string + notifications.get_configs::query.ses_account.role_arn.keyword: + name: ses_account.role_arn.keyword + in: query + schema: + type: string + notifications.get_configs::query.slack.url: + name: slack.url + in: query + schema: + type: string + notifications.get_configs::query.slack.url.keyword: + name: slack.url.keyword + in: query + schema: + type: string + notifications.get_configs::query.smtp_account.from_address: + name: smtp_account.from_address + in: query + schema: + type: string + notifications.get_configs::query.smtp_account.from_address.keyword: + name: smtp_account.from_address.keyword + in: query + schema: + type: string + notifications.get_configs::query.smtp_account.host: + name: smtp_account.host + in: query + schema: + type: string + notifications.get_configs::query.smtp_account.host.keyword: + name: smtp_account.host.keyword + in: query + schema: + type: string + notifications.get_configs::query.smtp_account.method: + name: smtp_account.method + in: query + schema: + type: string + notifications.get_configs::query.sns.role_arn: + name: sns.role_arn + in: query + schema: + type: string + notifications.get_configs::query.sns.role_arn.keyword: + name: sns.role_arn.keyword + in: query + schema: + type: string + notifications.get_configs::query.sns.topic_arn: + name: sns.topic_arn + in: query + schema: + type: string + notifications.get_configs::query.sns.topic_arn.keyword: + name: sns.topic_arn.keyword + in: query + schema: + type: string + notifications.get_configs::query.text_query: + name: text_query + in: query + schema: + type: string + notifications.get_configs::query.webhook.url: + name: webhook.url + in: query + schema: + type: string + notifications.get_configs::query.webhook.url.keyword: + name: webhook.url.keyword + in: query + schema: + type: string + notifications.send_test::path.config_id: + name: config_id + in: path + schema: + type: string + required: true + notifications.update_config::path.config_id: + name: config_id + in: path + schema: + type: string + required: true + put_script::path.context: + in: path + name: context + description: |- + Context in which the script or search template should run. + To prevent errors, the API immediately compiles the script or template in this context. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + put_script::path.id: + in: path + name: id + description: |- + Identifier for the stored script or search template. + Must be unique within the cluster. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + put_script::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + put_script::query.master_timeout: + in: query + name: master_timeout + description: |- + Period to wait for a connection to the master node. + If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + put_script::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + rank_eval::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and index aliases used to limit the request. Wildcard (`*`) expressions are supported. + To target all data streams and indices in a cluster, omit this parameter or use `_all` or `*`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + rank_eval::query.allow_no_indices: + in: query + name: allow_no_indices + description: If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. This behavior applies even if the request targets other open indices. For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. + schema: + type: boolean + style: form + rank_eval::query.expand_wildcards: + in: query + name: expand_wildcards + description: Whether to expand wildcard expression to concrete indices that are open, closed or both. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + rank_eval::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `true`, missing or closed indices are not included in the response. + schema: + type: boolean + style: form + rank_eval::query.search_type: + in: query + name: search_type + description: Search operation type + schema: + type: string + style: form + reindex::query.max_docs: + name: max_docs + in: query + description: 'Maximum number of documents to process (default: all documents).' + schema: + type: integer + description: 'Maximum number of documents to process (default: all documents).' + format: int32 + reindex::query.refresh: + in: query + name: refresh + description: If `true`, the request refreshes affected shards to make this operation visible to search. + schema: + type: boolean + style: form + reindex::query.requests_per_second: + in: query + name: requests_per_second + description: |- + The throttle for this request in sub-requests per second. + Defaults to no throttle. + schema: + type: number + style: form + reindex::query.scroll: + in: query + name: scroll + description: Specifies how long a consistent view of the index should be maintained for scrolled search. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + reindex::query.slices: + in: query + name: slices + description: |- + The number of slices this task should be divided into. + Defaults to 1 slice, meaning the task isn’t sliced into subtasks. + schema: + $ref: '#/components/schemas/_common:Slices' + style: form + reindex::query.timeout: + in: query + name: timeout + description: Period each indexing waits for automatic index creation, dynamic mapping updates, and waiting for active shards. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + reindex::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + reindex::query.wait_for_completion: + in: query + name: wait_for_completion + description: If `true`, the request blocks until the operation is complete. + schema: + type: boolean + style: form + reindex_rethrottle::path.task_id: + in: path + name: task_id + description: Identifier for the task. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + reindex_rethrottle::query.requests_per_second: + in: query + name: requests_per_second + description: The throttle for this request in sub-requests per second. + schema: + type: number + style: form + remote_store.restore::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + remote_store.restore::query.wait_for_completion: + name: wait_for_completion + in: query + description: Should this request wait until the operation has completed before returning. + schema: + type: boolean + default: false + description: Should this request wait until the operation has completed before returning. + render_search_template::path.id: + in: path + name: id + description: |- + ID of the search template to render. + If no `source` is specified, this or the `id` request body parameter is required. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + scroll::path.scroll_id: + in: path + name: scroll_id + description: The scroll ID + required: true + deprecated: true + schema: + $ref: '#/components/schemas/_common:ScrollId' + style: simple + scroll::query.rest_total_hits_as_int: + in: query + name: rest_total_hits_as_int + description: If true, the API response’s hit.total property is returned as an integer. If false, the API response’s hit.total property is returned as an object. + schema: + type: boolean + style: form + scroll::query.scroll: + in: query + name: scroll + description: Period to retain the search context for scrolling. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + scroll::query.scroll_id: + in: query + name: scroll_id + description: The scroll ID for scrolled search + deprecated: true + schema: + $ref: '#/components/schemas/_common:ScrollId' + style: form + search::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases to search. + Supports wildcards (`*`). + To search all data streams and indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + search::query._source: + in: query + name: _source + description: |- + Indicates which source fields are returned for matching documents. + These fields are returned in the `hits._source` property of the search response. + Valid values are: + `true` to return the entire document source; + `false` to not return the document source; + `` to return the source fields that are specified as a comma-separated list (supports wildcard (`*`) patterns). + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + search::query._source_excludes: + in: query + name: _source_excludes + description: |- + A comma-separated list of source fields to exclude from the response. + You can also use this parameter to exclude fields from the subset specified in `_source_includes` query parameter. + If the `_source` parameter is `false`, this parameter is ignored. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + search::query._source_includes: + in: query + name: _source_includes + description: |- + A comma-separated list of source fields to include in the response. + If this parameter is specified, only these source fields are returned. + You can exclude fields from this subset using the `_source_excludes` query parameter. + If the `_source` parameter is `false`, this parameter is ignored. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + search::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. + schema: + type: boolean + style: form + search::query.allow_partial_search_results: + in: query + name: allow_partial_search_results + description: If true, returns partial results if there are shard request timeouts or shard failures. If false, returns an error with no partial results. + schema: + type: boolean + style: form + search::query.analyze_wildcard: + in: query + name: analyze_wildcard + description: |- + If true, wildcard and prefix queries are analyzed. + This parameter can only be used when the q query string parameter is specified. + schema: + type: boolean + style: form + search::query.analyzer: + in: query + name: analyzer + description: |- + Analyzer to use for the query string. + This parameter can only be used when the q query string parameter is specified. + schema: + type: string + style: form + search::query.batched_reduce_size: + in: query + name: batched_reduce_size + description: |- + The number of shard results that should be reduced at once on the coordinating node. + This value should be used as a protection mechanism to reduce the memory overhead per search request if the potential number of shards in the request can be large. + schema: + type: number + style: form + search::query.ccs_minimize_roundtrips: + in: query + name: ccs_minimize_roundtrips + description: If true, network round-trips between the coordinating node and the remote clusters are minimized when executing cross-cluster search (CCS) requests. + schema: + type: boolean + style: form + search::query.default_operator: + in: query + name: default_operator + description: |- + The default operator for query string query: AND or OR. + This parameter can only be used when the `q` query string parameter is specified. + schema: + $ref: '#/components/schemas/_common.query_dsl:Operator' + style: form + search::query.df: + in: query + name: df + description: |- + Field to use as default where no field prefix is given in the query string. + This parameter can only be used when the q query string parameter is specified. + schema: + type: string + style: form + search::query.docvalue_fields: + in: query + name: docvalue_fields + description: A comma-separated list of fields to return as the docvalue representation for each hit. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + search::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + search::query.explain: + in: query + name: explain + description: If `true`, returns detailed information about score computation as part of a hit. + schema: + type: boolean + style: form + search::query.from: + in: query + name: from + description: |- + Starting document offset. + Needs to be non-negative. + By default, you cannot page through more than 10,000 hits using the `from` and `size` parameters. + To page through more hits, use the `search_after` parameter. + schema: + type: number + style: form + search::query.ignore_throttled: + in: query + name: ignore_throttled + description: If `true`, concrete, expanded or aliased indices will be ignored when frozen. + schema: + type: boolean + style: form + search::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + search::query.include_named_queries_score: + name: include_named_queries_score + in: query + description: Indicates whether hit.matched_queries should be rendered as a map that includes the name of the matched query associated with its score (true) or as an array containing the name of the matched queries (false) + schema: + type: boolean + default: false + description: Indicates whether hit.matched_queries should be rendered as a map that includes the name of the matched query associated with its score (true) or as an array containing the name of the matched queries (false) + search::query.lenient: + in: query + name: lenient + description: |- + If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. + This parameter can only be used when the `q` query string parameter is specified. + schema: + type: boolean + style: form + search::query.max_concurrent_shard_requests: + in: query + name: max_concurrent_shard_requests + description: |- + Defines 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. + schema: + type: number + style: form + search::query.pre_filter_shard_size: + in: query + name: pre_filter_shard_size + description: |- + Defines 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 (if date filters are mandatory to match but the shard bounds and the query are disjoint). + When unspecified, the pre-filter phase is executed if any of these conditions is met: + the request targets more than 128 shards; + the request targets one or more read-only index; + the primary sort of the query targets an indexed field. + schema: + type: number + style: form + search::query.preference: + in: query + name: preference + description: |- + Nodes and shards used for the search. + By default, Opensearch selects from eligible nodes and shards using adaptive replica selection, accounting for allocation awareness. Valid values are: + `_only_local` to run the search only on shards on the local node; + `_local` to, if possible, run the search on shards on the local node, or if not, select shards using the default method; + `_only_nodes:,` to run the search on only the specified nodes IDs, where, if suitable shards exist on more than one selected node, use shards on those nodes using the default method, or if none of the specified nodes are available, select shards from any available node using the default method; + `_prefer_nodes:,` to if possible, run the search on the specified nodes IDs, or if not, select shards using the default method; + `_shards:,` to run the search only on the specified shards; + `` (any string that does not start with `_`) to route searches with the same `` to the same shards in the same order. + schema: + type: string + style: form + search::query.q: + in: query + name: q + description: |- + Query in the Lucene query string syntax using query parameter search. + Query parameter searches do not support the full Opensearch Query DSL but are handy for testing. + schema: + type: string + style: form + search::query.request_cache: + in: query + name: request_cache + description: |- + If `true`, the caching of search results is enabled for requests where `size` is `0`. + Defaults to index level settings. + schema: + type: boolean + style: form + search::query.rest_total_hits_as_int: + in: query + name: rest_total_hits_as_int + description: Indicates whether `hits.total` should be rendered as an integer or an object in the rest search response. + schema: + type: boolean + style: form + search::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + search::query.scroll: + in: query + name: scroll + description: |- + Period to retain the search context for scrolling. See Scroll search results. + By default, this value cannot exceed `1d` (24 hours). + You can change this limit using the `search.max_keep_alive` cluster-level setting. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + search::query.search_pipeline: + name: search_pipeline + in: query + description: Customizable sequence of processing stages applied to search queries. + schema: + type: string + description: Customizable sequence of processing stages applied to search queries. + search::query.search_type: + in: query + name: search_type + description: How distributed term frequencies are calculated for relevance scoring. + schema: + $ref: '#/components/schemas/_common:SearchType' + style: form + search::query.seq_no_primary_term: + in: query + name: seq_no_primary_term + description: If `true`, returns sequence number and primary term of the last modification of each hit. + schema: + type: boolean + style: form + search::query.size: + in: query + name: size + description: |- + Defines the number of hits to return. + By default, you cannot page through more than 10,000 hits using the `from` and `size` parameters. + To page through more hits, use the `search_after` parameter. + schema: + type: number + style: form + search::query.sort: + in: query + name: sort + description: A comma-separated list of : pairs. + schema: + oneOf: + - type: string + - type: array + items: + type: string + style: form + search::query.stats: + in: query + name: stats + description: Specific `tag` of the request for logging and statistical purposes. + schema: + type: array + items: + type: string + style: form + search::query.stored_fields: + in: query + name: stored_fields + description: |- + A comma-separated list of stored fields to return as part of a hit. + If no fields are specified, no stored fields are included in the response. + If this field is specified, the `_source` parameter defaults to `false`. + You can pass `_source: true` to return both source fields and stored fields in the search response. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + search::query.suggest_field: + in: query + name: suggest_field + description: Specifies which field to use for suggestions. + schema: + $ref: '#/components/schemas/_common:Field' + style: form + search::query.suggest_mode: + in: query + name: suggest_mode + description: |- + Specifies the suggest mode. + This parameter can only be used when the `suggest_field` and `suggest_text` query string parameters are specified. + schema: + $ref: '#/components/schemas/_common:SuggestMode' + style: form + search::query.suggest_size: + in: query + name: suggest_size + description: |- + Number of suggestions to return. + This parameter can only be used when the `suggest_field` and `suggest_text` query string parameters are specified. + schema: + type: number + style: form + search::query.suggest_text: + in: query + name: suggest_text + description: |- + The source text for which the suggestions should be returned. + This parameter can only be used when the `suggest_field` and `suggest_text` query string parameters are specified. + schema: + type: string + style: form + search::query.terminate_after: + in: query + name: terminate_after + description: |- + Maximum number of documents to collect for each shard. + If a query reaches this limit, Opensearch terminates the query early. + Opensearch collects documents before sorting. + Use with caution. + Opensearch applies this parameter to each shard handling the request. + When possible, let Opensearch perform early termination automatically. + Avoid specifying this parameter for requests that target data streams with backing indices across multiple data tiers. + If set to `0` (default), the query does not terminate early. + schema: + type: number + style: form + search::query.timeout: + in: query + name: timeout + description: |- + Specifies the period of time to wait for a response from each shard. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + search::query.track_scores: + in: query + name: track_scores + description: If `true`, calculate and return document scores, even if the scores are not used for sorting. + schema: + type: boolean + style: form + search::query.track_total_hits: + in: query + name: track_total_hits + description: |- + Number of hits matching the query to count accurately. + If `true`, the exact number of hits is returned at the cost of some performance. + If `false`, the response does not include the total number of hits matching the query. + schema: + $ref: '#/components/schemas/_core.search:TrackHits' + style: form + search::query.typed_keys: + in: query + name: typed_keys + description: If `true`, aggregation and suggester names are be prefixed by their respective types in the response. + schema: + type: boolean + style: form + search::query.version: + in: query + name: version + description: If `true`, returns document version as part of a hit. + schema: + type: boolean + style: form + search_pipeline.create::path.pipeline: + name: pipeline + in: path + schema: + type: string + required: true + search_pipeline.get::path.pipeline: + name: pipeline + in: path + schema: + type: string + required: true + search_shards::path.index: + in: path + name: index + description: Returns the indices and shards that a search request would be executed against. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + search_shards::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. + schema: + type: boolean + style: form + search_shards::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + search_shards::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + search_shards::query.local: + in: query + name: local + description: If `true`, the request retrieves information from the local node only. + schema: + type: boolean + style: form + search_shards::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + search_shards::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + search_template::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, + and aliases to search. Supports wildcards (*). + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + search_template::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. + schema: + type: boolean + style: form + search_template::query.ccs_minimize_roundtrips: + in: query + name: ccs_minimize_roundtrips + description: If `true`, network round-trips are minimized for cross-cluster search requests. + schema: + type: boolean + style: form + search_template::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + search_template::query.explain: + in: query + name: explain + description: If `true`, the response includes additional details about score computation as part of a hit. + schema: + type: boolean + style: form + search_template::query.ignore_throttled: + in: query + name: ignore_throttled + description: If `true`, specified concrete, expanded, or aliased indices are not included in the response when throttled. + schema: + type: boolean + style: form + search_template::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + search_template::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + search_template::query.profile: + in: query + name: profile + description: If `true`, the query execution is profiled. + schema: + type: boolean + style: form + search_template::query.rest_total_hits_as_int: + in: query + name: rest_total_hits_as_int + description: If true, hits.total are rendered as an integer in the response. + schema: + type: boolean + style: form + search_template::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + search_template::query.scroll: + in: query + name: scroll + description: |- + Specifies how long a consistent view of the index + should be maintained for scrolled search. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + search_template::query.search_type: + in: query + name: search_type + description: The type of the search operation. + schema: + $ref: '#/components/schemas/_common:SearchType' + style: form + search_template::query.typed_keys: + in: query + name: typed_keys + description: If `true`, the response prefixes aggregation and suggester names with their respective types. + schema: + type: boolean + style: form + security.create_action_group::path.action_group: + name: action_group + in: path + description: The name of the action group to create or replace + schema: + type: string + description: The name of the action group to create or replace + required: true + security.create_role::path.role: + name: role + in: path + schema: + type: string + required: true + security.create_role_mapping::path.role: + name: role + in: path + schema: + type: string + required: true + security.create_tenant::path.tenant: + name: tenant + in: path + schema: + type: string + required: true + security.create_user::path.username: + name: username + in: path + schema: + type: string + required: true + security.delete_action_group::path.action_group: + name: action_group + in: path + description: Action group to delete. + schema: + type: string + description: Action group to delete. + required: true + security.delete_distinguished_names::path.cluster_name: + name: cluster_name + in: path + schema: + type: string + required: true + security.delete_role::path.role: + name: role + in: path + schema: + type: string + required: true + security.delete_role_mapping::path.role: + name: role + in: path + schema: + type: string + required: true + security.delete_tenant::path.tenant: + name: tenant + in: path + schema: + type: string + required: true + security.delete_user::path.username: + name: username + in: path + schema: + type: string + required: true + security.get_action_group::path.action_group: + name: action_group + in: path + description: Action group to retrieve. + schema: + type: string + description: Action group to retrieve. + required: true + security.get_distinguished_names::path.cluster_name: + name: cluster_name + in: path + schema: + type: string + required: true + security.get_role::path.role: + name: role + in: path + schema: + type: string + required: true + security.get_role_mapping::path.role: + name: role + in: path + schema: + type: string + required: true + security.get_tenant::path.tenant: + name: tenant + in: path + schema: + type: string + required: true + security.get_user::path.username: + name: username + in: path + schema: + type: string + required: true + security.patch_action_group::path.action_group: + name: action_group + in: path + schema: + type: string + required: true + security.patch_role::path.role: + name: role + in: path + schema: + type: string + required: true + security.patch_role_mapping::path.role: + name: role + in: path + schema: + type: string + required: true + security.patch_tenant::path.tenant: + name: tenant + in: path + schema: + type: string + required: true + security.patch_user::path.username: + name: username + in: path + schema: + type: string + required: true + security.update_distinguished_names::path.cluster_name: + name: cluster_name + in: path + schema: + type: string + required: true + snapshot.cleanup_repository::path.repository: + in: path + name: repository + description: Snapshot repository to clean up. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.cleanup_repository::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.cleanup_repository::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.cleanup_repository::query.timeout: + in: query + name: timeout + description: Period to wait for a response. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + snapshot.clone::path.repository: + in: path + name: repository + description: A repository name + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.clone::path.snapshot: + in: path + name: snapshot + description: The name of the snapshot to clone from + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.clone::path.target_snapshot: + in: path + name: target_snapshot + description: The name of the cloned snapshot to create + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.clone::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.clone::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.create::path.repository: + in: path + name: repository + description: Repository for the snapshot. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.create::path.snapshot: + in: path + name: snapshot + description: Name of the snapshot. Must be unique in the repository. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.create::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.create::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.create::query.wait_for_completion: + in: query + name: wait_for_completion + description: If `true`, the request returns a response when the snapshot is complete. If `false`, the request returns a response when the snapshot initializes. + schema: + type: boolean + style: form + snapshot.create_repository::path.repository: + in: path + name: repository + description: A repository name + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.create_repository::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.create_repository::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.create_repository::query.timeout: + in: query + name: timeout + description: Explicit operation timeout + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + snapshot.create_repository::query.verify: + in: query + name: verify + description: Whether to verify the repository after creation + schema: + type: boolean + style: form + snapshot.delete::path.repository: + in: path + name: repository + description: A repository name + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.delete::path.snapshot: + in: path + name: snapshot + description: A comma-separated list of snapshot names + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.delete::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.delete::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.delete_repository::path.repository: + in: path + name: repository + description: Name of the snapshot repository to unregister. Wildcard (`*`) patterns are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + snapshot.delete_repository::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.delete_repository::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.delete_repository::query.timeout: + in: query + name: timeout + description: Explicit operation timeout + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + snapshot.get::path.repository: + in: path + name: repository + description: Comma-separated list of snapshot repository names used to limit the request. Wildcard (*) expressions are supported. + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.get::path.snapshot: + in: path + name: snapshot + description: |- + Comma-separated list of snapshot names to retrieve. Also accepts wildcards (*). + - To get information about all snapshots in a registered repository, use a wildcard (*) or _all. + - To get information about any snapshots that are currently running, use _current. + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + snapshot.get::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.get::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If false, the request returns an error for any snapshots that are unavailable. + schema: + type: boolean + style: form + snapshot.get::query.master_timeout: + in: query + name: master_timeout + description: Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.get::query.verbose: + in: query + name: verbose + description: If true, returns additional information about each snapshot such as the version of Opensearch which took the snapshot, the start and end times of the snapshot, and the number of shards snapshotted. + schema: + type: boolean + style: form + snapshot.get_repository::path.repository: + in: path + name: repository + description: A comma-separated list of repository names + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + snapshot.get_repository::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.get_repository::query.local: + in: query + name: local + description: 'Return local information, do not retrieve the state from cluster-manager node (default: false)' + schema: + type: boolean + style: form + snapshot.get_repository::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.restore::path.repository: + in: path + name: repository + description: A repository name + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.restore::path.snapshot: + in: path + name: snapshot + description: A snapshot name + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.restore::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.restore::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.restore::query.wait_for_completion: + in: query + name: wait_for_completion + description: Should this request wait until the operation has completed before returning + schema: + type: boolean + style: form + snapshot.status::path.repository: + in: path + name: repository + description: A repository name + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.status::path.snapshot: + in: path + name: snapshot + description: A comma-separated list of snapshot names + required: true + schema: + $ref: '#/components/schemas/_common:Names' + style: simple + snapshot.status::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.status::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown + schema: + type: boolean + style: form + snapshot.status::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.verify_repository::path.repository: + in: path + name: repository + description: A repository name + required: true + schema: + $ref: '#/components/schemas/_common:Name' + style: simple + snapshot.verify_repository::query.cluster_manager_timeout: + name: cluster_manager_timeout + in: query + description: Operation timeout for connection to cluster-manager node. + schema: + $ref: '#/components/schemas/_common:Duration' + x-version-added: 2.0.0 + snapshot.verify_repository::query.master_timeout: + in: query + name: master_timeout + description: Explicit operation timeout for connection to master node + deprecated: true + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager_timeout' instead. + snapshot.verify_repository::query.timeout: + in: query + name: timeout + description: Explicit operation timeout + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + tasks.cancel::path.task_id: + in: path + name: task_id + description: ID of the task. + required: true + schema: + $ref: '#/components/schemas/_common:TaskId' + style: simple + tasks.cancel::query.actions: + in: query + name: actions + description: Comma-separated list or wildcard expression of actions used to limit the request. + schema: + oneOf: + - type: string + - type: array + items: + type: string + style: form + tasks.cancel::query.nodes: + in: query + name: nodes + description: Comma-separated list of node IDs or names used to limit the request. + schema: + type: array + items: + type: string + style: form + tasks.cancel::query.parent_task_id: + in: query + name: parent_task_id + description: Parent task ID used to limit the tasks. + schema: + type: string + style: form + tasks.cancel::query.wait_for_completion: + in: query + name: wait_for_completion + description: Should the request block until the cancellation of the task and its descendant tasks is completed. Defaults to false + schema: + type: boolean + style: form + tasks.get::path.task_id: + in: path + name: task_id + description: ID of the task. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + tasks.get::query.timeout: + in: query + name: timeout + description: |- + Period to wait for a response. + If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + tasks.get::query.wait_for_completion: + in: query + name: wait_for_completion + description: If `true`, the request blocks until the task has completed. + schema: + type: boolean + style: form + tasks.list::query.actions: + in: query + name: actions + description: Comma-separated list or wildcard expression of actions used to limit the request. + schema: + oneOf: + - type: string + - type: array + items: + type: string + style: form + tasks.list::query.detailed: + in: query + name: detailed + description: If `true`, the response includes detailed information about shard recoveries. + schema: + type: boolean + style: form + tasks.list::query.group_by: + in: query + name: group_by + description: Key used to group tasks in the response. + schema: + $ref: '#/components/schemas/tasks._common:GroupBy' + style: form + tasks.list::query.nodes: + name: nodes + in: query + description: 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. + style: form + schema: + type: array + items: + type: string + description: 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. + explode: true + tasks.list::query.parent_task_id: + in: query + name: parent_task_id + description: Parent task ID used to limit returned information. To return all tasks, omit this parameter or use a value of `-1`. + schema: + $ref: '#/components/schemas/_common:Id' + style: form + tasks.list::query.timeout: + in: query + name: timeout + description: Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + tasks.list::query.wait_for_completion: + in: query + name: wait_for_completion + description: If `true`, the request blocks until the operation is complete. + schema: + type: boolean + style: form + termvectors::path.id: + in: path + name: id + description: Unique identifier of the document. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + termvectors::path.index: + in: path + name: index + description: Name of the index that contains the document. + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + termvectors::query.field_statistics: + in: query + name: field_statistics + description: If `true`, the response includes the document count, sum of document frequencies, and sum of total term frequencies. + schema: + type: boolean + style: form + termvectors::query.fields: + in: query + name: fields + description: |- + Comma-separated list or wildcard expressions of fields to include in the statistics. + Used as the default list unless a specific field list is provided in the `completion_fields` or `fielddata_fields` parameters. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + termvectors::query.offsets: + in: query + name: offsets + description: If `true`, the response includes term offsets. + schema: + type: boolean + style: form + termvectors::query.payloads: + in: query + name: payloads + description: If `true`, the response includes term payloads. + schema: + type: boolean + style: form + termvectors::query.positions: + in: query + name: positions + description: If `true`, the response includes term positions. + schema: + type: boolean + style: form + termvectors::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + termvectors::query.realtime: + in: query + name: realtime + description: If true, the request is real-time as opposed to near-real-time. + schema: + type: boolean + style: form + termvectors::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + termvectors::query.term_statistics: + in: query + name: term_statistics + description: If `true`, the response includes term frequency and document frequency. + schema: + type: boolean + style: form + termvectors::query.version: + in: query + name: version + description: If `true`, returns the document version as part of a hit. + schema: + $ref: '#/components/schemas/_common:VersionNumber' + style: form + termvectors::query.version_type: + in: query + name: version_type + description: Specific version type. + schema: + $ref: '#/components/schemas/_common:VersionType' + style: form + update::path.id: + in: path + name: id + description: Document ID + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + update::path.index: + in: path + name: index + description: The name of the index + required: true + schema: + $ref: '#/components/schemas/_common:IndexName' + style: simple + update::query._source: + in: query + name: _source + description: |- + Set to false to disable source retrieval. You can also specify a comma-separated + list of the fields you want to retrieve. + schema: + $ref: '#/components/schemas/_core.search:SourceConfigParam' + style: form + update::query._source_excludes: + in: query + name: _source_excludes + description: Specify the source fields you want to exclude. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + update::query._source_includes: + in: query + name: _source_includes + description: Specify the source fields you want to retrieve. + schema: + $ref: '#/components/schemas/_common:Fields' + style: form + update::query.if_primary_term: + in: query + name: if_primary_term + description: Only perform the operation if the document has this primary term. + schema: + type: number + style: form + update::query.if_seq_no: + in: query + name: if_seq_no + description: Only perform the operation if the document has this sequence number. + schema: + $ref: '#/components/schemas/_common:SequenceNumber' + style: form + update::query.lang: + in: query + name: lang + description: The script language. + schema: + type: string + style: form + update::query.refresh: + in: query + name: refresh + description: |- + If 'true', Opensearch refreshes the affected shards to make this operation + visible to search, if 'wait_for' then wait for a refresh to make this operation + visible to search, if 'false' do nothing with refreshes. + schema: + $ref: '#/components/schemas/_common:Refresh' + style: form + update::query.require_alias: + in: query + name: require_alias + description: If true, the destination must be an index alias. + schema: + type: boolean + style: form + update::query.retry_on_conflict: + in: query + name: retry_on_conflict + description: Specify how many times should the operation be retried when a conflict occurs. + schema: + type: number + style: form + update::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + update::query.timeout: + in: query + name: timeout + description: |- + Period to wait for dynamic mapping updates and active shards. + This guarantees Opensearch waits for at least the timeout before failing. + The actual wait time could be longer, particularly when multiple waits occur. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + update::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operations. + Set to 'all' or any positive integer up to the total number of shards in the index + (number_of_replicas+1). Defaults to 1 meaning the primary shard. + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + update_by_query::path.index: + in: path + name: index + description: |- + Comma-separated list of data streams, indices, and aliases to search. + Supports wildcards (`*`). + To search all data streams or indices, omit this parameter or use `*` or `_all`. + required: true + schema: + $ref: '#/components/schemas/_common:Indices' + style: simple + update_by_query::query._source: + name: _source + in: query + description: True or false to return the _source field or not, or a list of fields to return. + style: form + schema: + type: array + items: + type: string + description: True or false to return the _source field or not, or a list of fields to return. + explode: true + update_by_query::query._source_excludes: + name: _source_excludes + in: query + description: List of fields to exclude from the returned _source field. + style: form + schema: + type: array + items: + type: string + description: List of fields to exclude from the returned _source field. + explode: true + update_by_query::query._source_includes: + name: _source_includes + in: query + description: List of fields to extract and return from the _source field. + style: form + schema: + type: array + items: + type: string + description: List of fields to extract and return from the _source field. + explode: true + update_by_query::query.allow_no_indices: + in: query + name: allow_no_indices + description: |- + If `false`, the request returns an error if any wildcard expression, index alias, or `_all` value targets only missing or closed indices. + This behavior applies even if the request targets other open indices. + For example, a request targeting `foo*,bar*` returns an error if an index starts with `foo` but no index starts with `bar`. + schema: + type: boolean + style: form + update_by_query::query.analyze_wildcard: + in: query + name: analyze_wildcard + description: If `true`, wildcard and prefix queries are analyzed. + schema: + type: boolean + style: form + update_by_query::query.analyzer: + in: query + name: analyzer + description: Analyzer to use for the query string. + schema: + type: string + style: form + update_by_query::query.conflicts: + in: query + name: conflicts + description: 'What to do if update by query hits version conflicts: `abort` or `proceed`.' + schema: + $ref: '#/components/schemas/_common:Conflicts' + style: form + update_by_query::query.default_operator: + in: query + name: default_operator + description: 'The default operator for query string query: `AND` or `OR`.' + schema: + $ref: '#/components/schemas/_common.query_dsl:Operator' + style: form + update_by_query::query.df: + in: query + name: df + description: Field to use as default where no field prefix is given in the query string. + schema: + type: string + style: form + update_by_query::query.expand_wildcards: + in: query + name: expand_wildcards + description: |- + Type of index that wildcard patterns can match. + If the request can target data streams, this argument determines whether wildcard expressions match hidden data streams. + Supports comma-separated values, such as `open,hidden`. + Valid values are: `all`, `open`, `closed`, `hidden`, `none`. + schema: + $ref: '#/components/schemas/_common:ExpandWildcards' + style: form + update_by_query::query.from: + in: query + name: from + description: 'Starting offset (default: 0)' + schema: + type: number + style: form + update_by_query::query.ignore_unavailable: + in: query + name: ignore_unavailable + description: If `false`, the request returns an error if it targets a missing or closed index. + schema: + type: boolean + style: form + update_by_query::query.lenient: + in: query + name: lenient + description: If `true`, format-based query failures (such as providing text to a numeric field) in the query string will be ignored. + schema: + type: boolean + style: form + update_by_query::query.max_docs: + in: query + name: max_docs + description: |- + Maximum number of documents to process. + Defaults to all documents. + schema: + type: number + style: form + update_by_query::query.pipeline: + in: query + name: pipeline + description: |- + ID of the pipeline to use to preprocess incoming documents. + If the index has a default ingest pipeline specified, then setting the value to `_none` disables the default ingest pipeline for this request. + If a final pipeline is configured it will always run, regardless of the value of this parameter. + schema: + type: string + style: form + update_by_query::query.preference: + in: query + name: preference + description: |- + Specifies the node or shard the operation should be performed on. + Random by default. + schema: + type: string + style: form + update_by_query::query.q: + name: q + in: query + description: Query in the Lucene query string syntax. + schema: + type: string + description: Query in the Lucene query string syntax. + update_by_query::query.refresh: + in: query + name: refresh + description: If `true`, Opensearch refreshes affected shards to make the operation visible to search. + schema: + type: boolean + style: form + update_by_query::query.request_cache: + in: query + name: request_cache + description: If `true`, the request cache is used for this request. + schema: + type: boolean + style: form + update_by_query::query.requests_per_second: + in: query + name: requests_per_second + description: The throttle for this request in sub-requests per second. + schema: + type: number + style: form + update_by_query::query.routing: + in: query + name: routing + description: Custom value used to route operations to a specific shard. + schema: + $ref: '#/components/schemas/_common:Routing' + style: form + update_by_query::query.scroll: + in: query + name: scroll + description: Period to retain the search context for scrolling. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + update_by_query::query.scroll_size: + in: query + name: scroll_size + description: Size of the scroll request that powers the operation. + schema: + type: number + style: form + update_by_query::query.search_timeout: + in: query + name: search_timeout + description: Explicit timeout for each search request. + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + update_by_query::query.search_type: + in: query + name: search_type + description: 'The type of the search operation. Available options: `query_then_fetch`, `dfs_query_then_fetch`.' + schema: + $ref: '#/components/schemas/_common:SearchType' + style: form + update_by_query::query.size: + name: size + in: query + description: Deprecated, please use `max_docs` instead. + schema: + type: integer + description: Deprecated, please use `max_docs` instead. + format: int32 + update_by_query::query.slices: + in: query + name: slices + description: The number of slices this task should be divided into. + schema: + $ref: '#/components/schemas/_common:Slices' + style: form + update_by_query::query.sort: + in: query + name: sort + description: A comma-separated list of : pairs. + schema: + type: array + items: + type: string + style: form + update_by_query::query.stats: + in: query + name: stats + description: Specific `tag` of the request for logging and statistical purposes. + schema: + type: array + items: + type: string + style: form + update_by_query::query.terminate_after: + in: query + name: terminate_after + description: |- + Maximum number of documents to collect for each shard. + If a query reaches this limit, Opensearch terminates the query early. + Opensearch collects documents before sorting. + Use with caution. + Opensearch applies this parameter to each shard handling the request. + When possible, let Opensearch perform early termination automatically. + Avoid specifying this parameter for requests that target data streams with backing indices across multiple data tiers. + schema: + type: number + style: form + update_by_query::query.timeout: + in: query + name: timeout + description: 'Period each update request waits for the following operations: dynamic mapping updates, waiting for active shards.' + schema: + $ref: '#/components/schemas/_common:Duration' + style: form + update_by_query::query.version: + in: query + name: version + description: If `true`, returns the document version as part of a hit. + schema: + type: boolean + style: form + update_by_query::query.wait_for_active_shards: + in: query + name: wait_for_active_shards + description: |- + The number of shard copies that must be active before proceeding with the operation. + Set to `all` or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). + schema: + $ref: '#/components/schemas/_common:WaitForActiveShards' + style: form + update_by_query::query.wait_for_completion: + in: query + name: wait_for_completion + description: If `true`, the request blocks until the operation is complete. + schema: + type: boolean + style: form + update_by_query_rethrottle::path.task_id: + in: path + name: task_id + description: The ID for the task. + required: true + schema: + $ref: '#/components/schemas/_common:Id' + style: simple + update_by_query_rethrottle::query.requests_per_second: + in: query + name: requests_per_second + description: The throttle for this request in sub-requests per second. + schema: + type: number + style: form + requestBodies: + bulk: + content: + application/json: + schema: + type: array + items: + oneOf: + - $ref: '#/components/schemas/_core.bulk:OperationContainer' + - $ref: '#/components/schemas/_core.bulk:UpdateAction' + - type: object + description: The operation definition and data (action-data pairs), separated by newlines + x-serialize: bulk + required: true + cat.pit_segments: + content: + application/json: + schema: + type: object + properties: + pit_id: + type: array + items: + type: string + required: + - pit_id + clear_scroll: + content: + application/json: + schema: + type: object + properties: + scroll_id: + $ref: '#/components/schemas/_common:ScrollIds' + description: Comma-separated list of scroll IDs to clear if none was specified via the scroll_id parameter + cluster.allocation_explain: + content: + application/json: + schema: + type: object + properties: + current_node: + description: Specifies the node ID or the name of the node to only explain a shard that is currently located on the specified node. + type: string + index: + $ref: '#/components/schemas/_common:IndexName' + primary: + description: If true, returns explanation for the primary shard for the given shard ID. + type: boolean + shard: + description: Specifies the ID of the shard that you would like an explanation for. + type: number + description: The index, shard, and primary flag to explain. Empty means 'explain the first unassigned shard' + cluster.put_component_template: + content: + application/json: + schema: + type: object + properties: + allow_auto_create: + description: |- + This setting overrides the value of the `action.auto_create_index` cluster setting. + If set to `true` in a template, then indices can be automatically created using that + template even if auto-creation of indices is disabled via `actions.auto_create_index`. + If set to `false` then data streams matching the template must always be explicitly created. + type: boolean + template: + $ref: '#/components/schemas/indices._common:IndexState' + version: + $ref: '#/components/schemas/_common:VersionNumber' + _meta: + $ref: '#/components/schemas/_common:Metadata' + required: + - template + description: The template definition + required: true + cluster.put_settings: + content: + application/json: + schema: + type: object + properties: + persistent: + type: object + additionalProperties: + type: object + transient: + type: object + additionalProperties: + type: object + description: The settings to be updated. Can be either `transient` or `persistent` (survives cluster restart). + required: true + cluster.reroute: + content: + application/json: + schema: + type: object + properties: + commands: + description: Defines the commands to perform. + type: array + items: + $ref: '#/components/schemas/cluster.reroute:Command' + description: The definition of `commands` to perform (`move`, `cancel`, `allocate`) + count: + content: + application/json: + schema: + type: object + properties: + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + description: Query to restrict the results specified with the Query DSL (optional) + create: + content: + application/json: + schema: + type: object + description: The document + required: true + delete_by_query: + content: + application/json: + schema: + type: object + properties: + max_docs: + description: The maximum number of documents to delete. + type: number + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + slice: + $ref: '#/components/schemas/_common:SlicedScroll' + description: The search definition using the Query DSL + required: true + delete_pit: + content: + application/json: + schema: + type: object + description: The point-in-time ids to be deleted + properties: + pit_id: + type: array + items: + type: string + required: + - pit_id + explain: + content: + application/json: + schema: + type: object + properties: + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + description: The query definition using the Query DSL + field_caps: + content: + application/json: + schema: + type: object + properties: + fields: + $ref: '#/components/schemas/_common:Fields' + index_filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + runtime_mappings: + $ref: '#/components/schemas/_common.mapping:RuntimeFields' + description: An index filter specified with the Query DSL + index: + content: + application/json: + schema: + type: object + description: The document + required: true + indices.analyze: + content: + application/json: + schema: + type: object + properties: + analyzer: + description: |- + The name of the analyzer that should be applied to the provided `text`. + This could be a built-in analyzer, or an analyzer that’s been configured in the index. + type: string + attributes: + description: Array of token attributes used to filter the output of the `explain` parameter. + type: array + items: + type: string + char_filter: + description: Array of character filters used to preprocess characters before the tokenizer. + type: array + items: + $ref: '#/components/schemas/_common.analysis:CharFilter' + explain: + description: If `true`, the response includes token attributes and additional details. + type: boolean + field: + $ref: '#/components/schemas/_common:Field' + filter: + description: Array of token filters used to apply after the tokenizer. + type: array + items: + $ref: '#/components/schemas/_common.analysis:TokenFilter' + normalizer: + description: Normalizer to use to convert text into a single token. + type: string + text: + $ref: '#/components/schemas/indices.analyze:TextToAnalyze' + tokenizer: + $ref: '#/components/schemas/_common.analysis:Tokenizer' + description: Define analyzer/tokenizer parameters and the text on which the analysis should be performed + indices.clone: + content: + application/json: + schema: + type: object + properties: + aliases: + description: Aliases for the resulting index. + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + settings: + description: Configuration options for the target index. + type: object + additionalProperties: + type: object + description: The configuration for the target index (`settings` and `aliases`) + indices.create: + content: + application/json: + schema: + type: object + properties: + aliases: + description: Aliases for the index. + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + settings: + $ref: '#/components/schemas/indices._common:IndexSettings' + description: The configuration for the index (`settings` and `mappings`) + indices.create_data_stream: + content: + application/json: + schema: + type: object + description: The data stream definition + indices.put_alias: + content: + application/json: + schema: + type: object + properties: + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + index_routing: + $ref: '#/components/schemas/_common:Routing' + is_write_index: + description: |- + If `true`, sets the write index or data stream for the alias. + If an alias points to multiple indices or data streams and `is_write_index` isn’t set, the alias rejects write requests. + If an index alias points to one index and `is_write_index` isn’t set, the index automatically acts as the write index. + Data stream aliases don’t automatically set a write data stream, even if the alias points to one data stream. + type: boolean + routing: + $ref: '#/components/schemas/_common:Routing' + search_routing: + $ref: '#/components/schemas/_common:Routing' + description: The settings for the alias, such as `routing` or `filter` + indices.put_index_template: + content: + application/json: + schema: + type: object + properties: + index_patterns: + $ref: '#/components/schemas/_common:Indices' + composed_of: + description: |- + An ordered list of component template names. + Component templates are merged in the order specified, meaning that the last component template specified has the highest precedence. + type: array + items: + $ref: '#/components/schemas/_common:Name' + template: + $ref: '#/components/schemas/indices.put_index_template:IndexTemplateMapping' + data_stream: + $ref: '#/components/schemas/indices._common:DataStreamVisibility' + priority: + description: |- + Priority to determine index template precedence when a new data stream or index is created. + The index template with the highest priority is chosen. + If no priority is specified the template is treated as though it is of priority 0 (lowest priority). + This number is not automatically generated by Opensearch. + type: number + version: + $ref: '#/components/schemas/_common:VersionNumber' + _meta: + $ref: '#/components/schemas/_common:Metadata' + description: The template definition + required: true + indices.put_mapping: + content: + application/json: + schema: + type: object + properties: + date_detection: + description: Controls whether dynamic date detection is enabled. + type: boolean + dynamic: + $ref: '#/components/schemas/_common.mapping:DynamicMapping' + dynamic_date_formats: + description: |- + If date detection is enabled then new string fields are checked + against 'dynamic_date_formats' and if the value matches then + a new date field is added instead of string. + type: array + items: + type: string + dynamic_templates: + description: Specify dynamic templates for the mapping. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:DynamicTemplate' + - type: array + items: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:DynamicTemplate' + _field_names: + $ref: '#/components/schemas/_common.mapping:FieldNamesField' + _meta: + $ref: '#/components/schemas/_common:Metadata' + numeric_detection: + description: Automatically map strings into numeric data types for all fields. + type: boolean + properties: + description: |- + Mapping for a field. For new fields, this mapping can include: + + - Field name + - Field data type + - Mapping parameters + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:Property' + _routing: + $ref: '#/components/schemas/_common.mapping:RoutingField' + _source: + $ref: '#/components/schemas/_common.mapping:SourceField' + runtime: + $ref: '#/components/schemas/_common.mapping:RuntimeFields' + description: The mapping definition + required: true + indices.put_settings: + content: + application/json: + schema: + $ref: '#/components/schemas/indices._common:IndexSettings' + required: true + indices.put_template: + content: + application/json: + schema: + type: object + properties: + aliases: + description: Aliases for the index. + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + index_patterns: + description: |- + Array of wildcard expressions used to match the names + of indices during creation. + oneOf: + - type: string + - type: array + items: + type: string + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + order: + description: |- + Order in which Opensearch applies this template if index + matches multiple templates. + + Templates with lower 'order' values are merged first. Templates with higher + 'order' values are merged later, overriding templates with lower values. + type: number + settings: + description: Configuration options for the index. + type: object + additionalProperties: + type: object + version: + $ref: '#/components/schemas/_common:VersionNumber' + description: The template definition + required: true + indices.rollover: + content: + application/json: + schema: + type: object + properties: + aliases: + description: |- + Aliases for the target index. + Data streams do not support this parameter. + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + conditions: + $ref: '#/components/schemas/indices.rollover:RolloverConditions' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + settings: + description: |- + Configuration options for the index. + Data streams do not support this parameter. + type: object + additionalProperties: + type: object + description: The conditions that needs to be met for executing rollover + indices.shrink: + content: + application/json: + schema: + type: object + properties: + aliases: + description: |- + The key is the alias name. + Index alias names support date math. + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + settings: + description: Configuration options for the target index. + type: object + additionalProperties: + type: object + description: The configuration for the target index (`settings` and `aliases`) + indices.simulate_index_template: + content: + application/json: + schema: + type: object + properties: + allow_auto_create: + description: |- + This setting overrides the value of the `action.auto_create_index` cluster setting. + If set to `true` in a template, then indices can be automatically created using that template even if auto-creation of indices is disabled via `actions.auto_create_index`. + If set to `false`, then indices or data streams matching the template must always be explicitly created, and may never be automatically created. + type: boolean + index_patterns: + $ref: '#/components/schemas/_common:Indices' + composed_of: + description: |- + An ordered list of component template names. + Component templates are merged in the order specified, meaning that the last component template specified has the highest precedence. + type: array + items: + $ref: '#/components/schemas/_common:Name' + template: + $ref: '#/components/schemas/indices.put_index_template:IndexTemplateMapping' + data_stream: + $ref: '#/components/schemas/indices._common:DataStreamVisibility' + priority: + description: |- + Priority to determine index template precedence when a new data stream or index is created. + The index template with the highest priority is chosen. + If no priority is specified the template is treated as though it is of priority 0 (lowest priority). + This number is not automatically generated by Opensearch. + type: number + version: + $ref: '#/components/schemas/_common:VersionNumber' + _meta: + $ref: '#/components/schemas/_common:Metadata' + description: New index template definition, which will be included in the simulation, as if it already exists in the system + indices.simulate_template: + content: + application/json: + schema: + $ref: '#/components/schemas/indices._common:IndexTemplate' + indices.split: + content: + application/json: + schema: + type: object + properties: + aliases: + description: Aliases for the resulting index. + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + settings: + description: Configuration options for the target index. + type: object + additionalProperties: + type: object + description: The configuration for the target index (`settings` and `aliases`) + indices.update_aliases: + content: + application/json: + schema: + type: object + properties: + actions: + description: Actions to perform. + type: array + items: + $ref: '#/components/schemas/indices.update_aliases:Action' + description: The definition of `actions` to perform + required: true + indices.validate_query: + content: + application/json: + schema: + type: object + properties: + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + description: The query definition specified with the Query DSL + ingest.put_pipeline: + content: + application/json: + schema: + type: object + properties: + _meta: + $ref: '#/components/schemas/_common:Metadata' + description: + description: Description of the ingest pipeline. + type: string + on_failure: + description: Processors to run immediately after a processor failure. Each processor supports a processor-level `on_failure` value. If a processor without an `on_failure` value fails, Opensearch uses this pipeline-level parameter as a fallback. The processors in this parameter run sequentially in the order specified. Opensearch will not attempt to run the pipeline's remaining processors. + type: array + items: + $ref: '#/components/schemas/ingest._common:ProcessorContainer' + processors: + description: Processors used to perform transformations on documents before indexing. Processors run sequentially in the order specified. + type: array + items: + $ref: '#/components/schemas/ingest._common:ProcessorContainer' + version: + $ref: '#/components/schemas/_common:VersionNumber' + description: The ingest definition + required: true + ingest.simulate: + content: + application/json: + schema: + type: object + properties: + docs: + description: Sample documents to test in the pipeline. + type: array + items: + $ref: '#/components/schemas/ingest.simulate:Document' + pipeline: + $ref: '#/components/schemas/ingest._common:Pipeline' + description: The simulate definition + required: true + knn.search_models: + content: + application/json: + schema: + type: object + knn.train_model: + content: + application/json: + schema: + type: object + properties: + training_index: + type: string + training_field: + type: string + dimension: + type: integer + format: int32 + max_training_vector_count: + type: integer + format: int32 + search_size: + type: integer + format: int32 + description: + type: string + method: + type: string + required: + - dimension + - method + - training_field + - training_index + required: true + mget: + content: + application/json: + schema: + type: object + properties: + docs: + description: The documents you want to retrieve. Required if no index is specified in the request URI. + type: array + items: + $ref: '#/components/schemas/_core.mget:Operation' + ids: + $ref: '#/components/schemas/_common:Ids' + description: Document identifiers; can be either `docs` (containing full document information) or `ids` (when index is provided in the URL. + required: true + msearch: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/_core.msearch:RequestItem' + description: The request definitions (metadata-search request definition pairs), separated by newlines + x-serialize: bulk + required: true + msearch_template: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/_core.msearch_template:RequestItem' + description: The request definitions (metadata-search request definition pairs), separated by newlines + x-serialize: bulk + required: true + mtermvectors: + content: + application/json: + schema: + type: object + properties: + docs: + description: Array of existing or artificial documents. + type: array + items: + $ref: '#/components/schemas/_core.mtermvectors:Operation' + ids: + description: Simplified syntax to specify documents by their ID if they're in the same index. + type: array + items: + $ref: '#/components/schemas/_common:Id' + description: Define ids, documents, parameters or a list of parameters per document here. You must at least provide a list of document ids. See documentation. + nodes.reload_secure_settings: + content: + application/json: + schema: + type: object + properties: + secure_settings_password: + $ref: '#/components/schemas/_common:Password' + description: An object containing the password for the opensearch keystore + notifications.create_config: + content: + application/json: + schema: + $ref: '#/components/schemas/notifications._common:NotificationsConfig' + required: true + notifications.get_configs: + content: + application/json: + schema: + type: object + properties: + config_id_list: + type: array + items: + type: string + sort_field: + type: string + sort_order: + type: string + from_index: + type: integer + format: int32 + max_items: + type: integer + format: int32 + notifications.update_config: + content: + application/json: + schema: + $ref: '#/components/schemas/notifications._common:NotificationsConfig' + required: true + put_script: + content: + application/json: + schema: + type: object + properties: + script: + $ref: '#/components/schemas/_common:StoredScript' + required: + - script + description: The document + required: true + rank_eval: + content: + application/json: + schema: + type: object + properties: + requests: + description: A set of typical search requests, together with their provided ratings. + type: array + items: + $ref: '#/components/schemas/_core.rank_eval:RankEvalRequestItem' + metric: + $ref: '#/components/schemas/_core.rank_eval:RankEvalMetric' + required: + - requests + description: The ranking evaluation search definition, including search requests, document ratings and ranking metric definition. + required: true + reindex: + content: + application/json: + schema: + type: object + properties: + conflicts: + $ref: '#/components/schemas/_common:Conflicts' + dest: + $ref: '#/components/schemas/_core.reindex:Destination' + max_docs: + description: The maximum number of documents to reindex. + type: number + script: + $ref: '#/components/schemas/_common:Script' + size: + type: number + source: + $ref: '#/components/schemas/_core.reindex:Source' + required: + - dest + - source + description: The search definition using the Query DSL and the prototype for the index request. + required: true + remote_store.restore: + content: + application/json: + schema: + type: object + description: Comma-separated list of index IDs + properties: + indices: + type: array + items: + type: string + required: + - indices + examples: + RemoteStoreRestore_example1: + summary: Examples for Post Remote Storage Restore Operation. + description: '' + value: + indices: + - books + required: true + render_search_template: + content: + application/json: + schema: + type: object + properties: + file: + type: string + params: + description: |- + Key-value pairs used to replace Mustache variables in the template. + The key is the variable name. + The value is the variable value. + type: object + additionalProperties: + type: object + source: + description: |- + An inline search template. + Supports the same parameters as the search API's request body. + These parameters also support Mustache variables. + If no `id` or `` is specified, this parameter is required. + type: string + description: The search definition template and its params + scripts_painless_execute: + content: + application/json: + schema: + type: object + properties: + context: + description: The context that the script should run in. + type: string + context_setup: + $ref: '#/components/schemas/_core.scripts_painless_execute:PainlessContextSetup' + script: + $ref: '#/components/schemas/_common:InlineScript' + description: The script to execute + scroll: + content: + application/json: + schema: + type: object + properties: + scroll: + $ref: '#/components/schemas/_common:Duration' + scroll_id: + $ref: '#/components/schemas/_common:ScrollId' + required: + - scroll_id + description: The scroll ID if not passed by URL or query parameter. + search: + content: + application/json: + schema: + type: object + properties: + aggregations: + description: Defines the aggregations that are run as part of the search request. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:AggregationContainer' + collapse: + $ref: '#/components/schemas/_core.search:FieldCollapse' + explain: + description: If true, returns detailed information about score computation as part of a hit. + type: boolean + ext: + description: Configuration of search extensions defined by Opensearch plugins. + type: object + additionalProperties: + type: object + from: + description: |- + Starting document offset. + Needs to be non-negative. + By default, you cannot page through more than 10,000 hits using the `from` and `size` parameters. + To page through more hits, use the `search_after` parameter. + type: number + highlight: + $ref: '#/components/schemas/_core.search:Highlight' + track_total_hits: + $ref: '#/components/schemas/_core.search:TrackHits' + indices_boost: + description: Boosts the _score of documents from specified indices. + type: array + items: + type: object + additionalProperties: + type: number + docvalue_fields: + description: |- + Array of wildcard (`*`) patterns. + The request returns doc values for field names matching these patterns in the `hits.fields` property of the response. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:FieldAndFormat' + knn: + description: Defines the approximate kNN search to run. + oneOf: + - $ref: '#/components/schemas/_common:KnnQuery' + - type: array + items: + $ref: '#/components/schemas/_common:KnnQuery' + rank: + $ref: '#/components/schemas/_common:RankContainer' + min_score: + description: |- + Minimum `_score` for matching documents. + Documents with a lower `_score` are not included in the search results. + type: number + post_filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + profile: + description: |- + Set to `true` to return detailed timing information about the execution of individual components in a search request. + NOTE: This is a debugging tool and adds significant overhead to search execution. + type: boolean + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + rescore: + description: Can be used to improve precision by reordering just the top (for example 100 - 500) documents returned by the `query` and `post_filter` phases. + oneOf: + - $ref: '#/components/schemas/_core.search:Rescore' + - type: array + items: + $ref: '#/components/schemas/_core.search:Rescore' + script_fields: + description: Retrieve a script evaluation (based on different fields) for each hit. + type: object + additionalProperties: + $ref: '#/components/schemas/_common:ScriptField' + search_after: + $ref: '#/components/schemas/_common:SortResults' + size: + description: |- + The number of hits to return. + By default, you cannot page through more than 10,000 hits using the `from` and `size` parameters. + To page through more hits, use the `search_after` parameter. + type: number + slice: + $ref: '#/components/schemas/_common:SlicedScroll' + sort: + $ref: '#/components/schemas/_common:Sort' + _source: + $ref: '#/components/schemas/_core.search:SourceConfig' + fields: + description: |- + Array of wildcard (`*`) patterns. + The request returns values for field names matching these patterns in the `hits.fields` property of the response. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:FieldAndFormat' + suggest: + $ref: '#/components/schemas/_core.search:Suggester' + terminate_after: + description: |- + Maximum number of documents to collect for each shard. + If a query reaches this limit, Opensearch terminates the query early. + Opensearch collects documents before sorting. + Use with caution. + Opensearch applies this parameter to each shard handling the request. + When possible, let Opensearch perform early termination automatically. + Avoid specifying this parameter for requests that target data streams with backing indices across multiple data tiers. + If set to `0` (default), the query does not terminate early. + type: number + timeout: + description: |- + Specifies the period of time to wait for a response from each shard. + If no response is received before the timeout expires, the request fails and returns an error. + Defaults to no timeout. + type: string + track_scores: + description: If true, calculate and return document scores, even if the scores are not used for sorting. + type: boolean + version: + description: If true, returns document version as part of a hit. + type: boolean + seq_no_primary_term: + description: If `true`, returns sequence number and primary term of the last modification of each hit. + type: boolean + stored_fields: + $ref: '#/components/schemas/_common:Fields' + pit: + $ref: '#/components/schemas/_core.search:PointInTimeReference' + runtime_mappings: + $ref: '#/components/schemas/_common.mapping:RuntimeFields' + stats: + description: |- + Stats groups to associate with the search. + Each group maintains a statistics aggregation for its associated searches. + You can retrieve these stats using the indices stats API. + type: array + items: + type: string + description: The search definition using the Query DSL + search_pipeline.create: + content: + application/json: + schema: + $ref: '#/components/schemas/search_pipeline._common:SearchPipelineStructure' + required: true + search_template: + content: + application/json: + schema: + type: object + properties: + explain: + description: If `true`, returns detailed information about score calculation as part of each hit. + type: boolean + id: + $ref: '#/components/schemas/_common:Id' + params: + description: |- + Key-value pairs used to replace Mustache variables in the template. + The key is the variable name. + The value is the variable value. + type: object + additionalProperties: + type: object + profile: + description: If `true`, the query execution is profiled. + type: boolean + source: + description: |- + An inline search template. Supports the same parameters as the search API's + request body. Also supports Mustache variables. If no id is specified, this + parameter is required. + type: string + description: The search definition template and its params + required: true + security.change_password: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:ChangePasswordRequestContent' + required: true + security.create_action_group: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:Action_Group' + required: true + security.create_role: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:Role' + required: true + security.create_role_mapping: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:RoleMapping' + required: true + security.create_tenant: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:CreateTenantParams' + required: true + security.create_user: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:User' + required: true + security.patch_action_group: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_action_groups: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_audit_configuration: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_configuration: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_distinguished_names: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_role: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_role_mapping: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_role_mappings: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_roles: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_tenant: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_tenants: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_user: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.patch_users: + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/security._common:PatchOperation' + required: true + security.update_audit_configuration: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:AuditConfig' + required: true + security.update_configuration: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:DynamicConfig' + required: true + security.update_distinguished_names: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:DistinguishedNames' + snapshot.clone: + content: + application/json: + schema: + type: object + properties: + indices: + type: string + required: + - indices + description: The snapshot clone definition + required: true + snapshot.create: + content: + application/json: + schema: + type: object + properties: + ignore_unavailable: + description: If `true`, the request ignores data streams and indices in `indices` that are missing or closed. If `false`, the request returns an error for any data stream or index that is missing or closed. + type: boolean + include_global_state: + description: If `true`, the current cluster state is included in the snapshot. The cluster state includes persistent cluster settings, composable index templates, legacy index templates, ingest pipelines, and ILM policies. It also includes data stored in system indices, such as Watches and task records (configurable via `feature_states`). + type: boolean + indices: + $ref: '#/components/schemas/_common:Indices' + feature_states: + description: Feature states to include in the snapshot. Each feature state includes one or more system indices containing related data. You can view a list of eligible features using the get features API. If `include_global_state` is `true`, all current feature states are included by default. If `include_global_state` is `false`, no feature states are included by default. + type: array + items: + type: string + metadata: + $ref: '#/components/schemas/_common:Metadata' + partial: + description: If `true`, allows restoring a partial snapshot of indices with unavailable shards. Only shards that were successfully included in the snapshot will be restored. All missing shards will be recreated as empty. If `false`, the entire restore operation will fail if one or more indices included in the snapshot do not have all primary shards available. + type: boolean + description: The snapshot definition + snapshot.create_repository: + content: + application/json: + schema: + type: object + properties: + repository: + $ref: '#/components/schemas/snapshot._common:Repository' + type: + type: string + settings: + $ref: '#/components/schemas/snapshot._common:RepositorySettings' + required: + - type + - settings + description: The repository definition + required: true + snapshot.restore: + content: + application/json: + schema: + type: object + properties: + feature_states: + type: array + items: + type: string + ignore_index_settings: + type: array + items: + type: string + ignore_unavailable: + type: boolean + include_aliases: + type: boolean + include_global_state: + type: boolean + index_settings: + $ref: '#/components/schemas/indices._common:IndexSettings' + indices: + $ref: '#/components/schemas/_common:Indices' + partial: + type: boolean + rename_pattern: + type: string + rename_replacement: + type: string + description: Details of what to restore + termvectors: + content: + application/json: + schema: + type: object + properties: + doc: + description: An artificial document (a document not present in the index) for which you want to retrieve term vectors. + type: object + filter: + $ref: '#/components/schemas/_core.termvectors:Filter' + per_field_analyzer: + description: Overrides the default per-field analyzer. + type: object + additionalProperties: + type: string + description: Define parameters and or supply a document to get termvectors for. See documentation. + update: + content: + application/json: + schema: + type: object + properties: + detect_noop: + description: |- + Set to false to disable setting 'result' in the response + to 'noop' if no change to the document occurred. + type: boolean + doc: + description: A partial update to an existing document. + type: object + doc_as_upsert: + description: Set to true to use the contents of 'doc' as the value of 'upsert' + type: boolean + script: + $ref: '#/components/schemas/_common:Script' + scripted_upsert: + description: Set to true to execute the script whether or not the document exists. + type: boolean + _source: + $ref: '#/components/schemas/_core.search:SourceConfig' + upsert: + description: |- + If the document does not already exist, the contents of 'upsert' are inserted as a + new document. If the document exists, the 'script' is executed. + type: object + description: The request definition requires either `script` or partial `doc` + required: true + update_by_query: + content: + application/json: + schema: + type: object + properties: + max_docs: + description: The maximum number of documents to update. + type: number + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + script: + $ref: '#/components/schemas/_common:Script' + slice: + $ref: '#/components/schemas/_common:SlicedScroll' + conflicts: + $ref: '#/components/schemas/_common:Conflicts' + description: The search definition using the Query DSL + responses: + bulk@200: + description: '' + content: + application/json: + schema: + type: object + properties: + errors: + type: boolean + items: + type: array + items: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.bulk:ResponseItem' + minProperties: 1 + maxProperties: 1 + took: + type: number + ingest_took: + type: number + required: + - errors + - items + - took + cat.aliases@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.aliases:AliasesRecord' + cat.all_pit_segments@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat._common:CatPitSegmentsRecord' + cat.allocation@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.allocation:AllocationRecord' + cat.cluster_manager@200: + description: '' + cat.count@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.count:CountRecord' + cat.fielddata@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.fielddata:FielddataRecord' + cat.health@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.health:HealthRecord' + cat.help@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.help:HelpRecord' + cat.indices@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.indices:IndicesRecord' + cat.master@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.master:MasterRecord' + cat.nodeattrs@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.nodeattrs:NodeAttributesRecord' + cat.nodes@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.nodes:NodesRecord' + cat.pending_tasks@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.pending_tasks:PendingTasksRecord' + cat.pit_segments@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat._common:CatPitSegmentsRecord' + cat.plugins@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.plugins:PluginsRecord' + cat.recovery@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.recovery:RecoveryRecord' + cat.repositories@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.repositories:RepositoriesRecord' + cat.segment_replication@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat._common:CatSegmentReplicationRecord' + cat.segments@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.segments:SegmentsRecord' + cat.shards@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.shards:ShardsRecord' + cat.snapshots@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.snapshots:SnapshotsRecord' + cat.tasks@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.tasks:TasksRecord' + cat.templates@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.templates:TemplatesRecord' + cat.thread_pool@200: + description: '' + content: + application/json: + schema: + type: array + items: + $ref: '#/components/schemas/cat.thread_pool:ThreadPoolRecord' + clear_scroll@200: + description: '' + content: + application/json: + schema: + type: object + properties: + succeeded: + type: boolean + num_freed: + type: number + required: + - succeeded + - num_freed + cluster.allocation_explain@200: + description: '' + content: + application/json: + schema: + type: object + properties: + allocate_explanation: + type: string + allocation_delay: + $ref: '#/components/schemas/_common:Duration' + allocation_delay_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + can_allocate: + $ref: '#/components/schemas/cluster.allocation_explain:Decision' + can_move_to_other_node: + $ref: '#/components/schemas/cluster.allocation_explain:Decision' + can_rebalance_cluster: + $ref: '#/components/schemas/cluster.allocation_explain:Decision' + can_rebalance_cluster_decisions: + type: array + items: + $ref: '#/components/schemas/cluster.allocation_explain:AllocationDecision' + can_rebalance_to_other_node: + $ref: '#/components/schemas/cluster.allocation_explain:Decision' + can_remain_decisions: + type: array + items: + $ref: '#/components/schemas/cluster.allocation_explain:AllocationDecision' + can_remain_on_current_node: + $ref: '#/components/schemas/cluster.allocation_explain:Decision' + cluster_info: + $ref: '#/components/schemas/cluster.allocation_explain:ClusterInfo' + configured_delay: + $ref: '#/components/schemas/_common:Duration' + configured_delay_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + current_node: + $ref: '#/components/schemas/cluster.allocation_explain:CurrentNode' + current_state: + type: string + index: + $ref: '#/components/schemas/_common:IndexName' + move_explanation: + type: string + node_allocation_decisions: + type: array + items: + $ref: '#/components/schemas/cluster.allocation_explain:NodeAllocationExplanation' + primary: + type: boolean + rebalance_explanation: + type: string + remaining_delay: + $ref: '#/components/schemas/_common:Duration' + remaining_delay_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + shard: + type: number + unassigned_info: + $ref: '#/components/schemas/cluster.allocation_explain:UnassignedInformation' + note: + type: string + required: + - current_state + - index + - primary + - shard + cluster.delete_component_template@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + cluster.delete_decommission_awareness@200: + description: '' + cluster.delete_voting_config_exclusions@200: + description: '' + content: + application/json: {} + cluster.delete_weighted_routing@200: + description: '' + cluster.exists_component_template@200: + description: '' + content: + application/json: {} + cluster.get_component_template@200: + description: '' + content: + application/json: + schema: + type: object + properties: + component_templates: + type: array + items: + $ref: '#/components/schemas/cluster._common:ComponentTemplate' + required: + - component_templates + cluster.get_decommission_awareness@200: + description: '' + cluster.get_settings@200: + description: '' + content: + application/json: + schema: + type: object + properties: + persistent: + type: object + additionalProperties: + type: object + transient: + type: object + additionalProperties: + type: object + defaults: + type: object + additionalProperties: + type: object + required: + - persistent + - transient + cluster.get_weighted_routing@200: + description: '' + cluster.health@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/cluster.health:HealthResponseBody' + cluster.pending_tasks@200: + description: '' + content: + application/json: + schema: + type: object + properties: + tasks: + type: array + items: + $ref: '#/components/schemas/cluster.pending_tasks:PendingTask' + required: + - tasks + cluster.post_voting_config_exclusions@200: + description: '' + content: + application/json: {} + cluster.put_component_template@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + cluster.put_decommission_awareness@200: + description: '' + cluster.put_settings@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + persistent: + type: object + additionalProperties: + type: object + transient: + type: object + additionalProperties: + type: object + required: + - acknowledged + - persistent + - transient + cluster.put_weighted_routing@200: + description: '' + cluster.remote_info@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/cluster.remote_info:ClusterRemoteInfo' + cluster.reroute@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + explanations: + type: array + items: + $ref: '#/components/schemas/cluster.reroute:RerouteExplanation' + state: + description: |- + There aren't any guarantees on the output/structure of the raw cluster state. + Here you will find the internal representation of the cluster, which can + differ from the external representation. + type: object + required: + - acknowledged + cluster.state@200: + description: '' + content: + application/json: + schema: + type: object + cluster.stats@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/cluster.stats:StatsResponseBase' + count@200: + description: '' + content: + application/json: + schema: + type: object + properties: + count: + type: number + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + required: + - count + - _shards + create@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:WriteResponseBase' + create_pit@200: + description: '' + content: + application/json: + schema: + type: object + properties: + pit_id: + type: string + _shards: + $ref: '#/components/schemas/_core._common:ShardStatistics' + creation_time: + type: integer + format: int64 + dangling_indices.delete_dangling_index@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + dangling_indices.import_dangling_index@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + dangling_indices.list_dangling_indices@200: + description: '' + content: + application/json: + schema: + type: object + properties: + dangling_indices: + type: array + items: + $ref: '#/components/schemas/dangling_indices.list_dangling_indices:DanglingIndex' + required: + - dangling_indices + delete@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:WriteResponseBase' + delete_all_pits@200: + description: '' + content: + application/json: + schema: + type: object + properties: + pits: + type: array + items: + $ref: '#/components/schemas/_core._common:PitsDetailsDeleteAll' + delete_by_query@200: + description: '' + content: + application/json: + schema: + type: object + properties: + batches: + type: number + deleted: + type: number + failures: + type: array + items: + $ref: '#/components/schemas/_common:BulkIndexByScrollFailure' + noops: + type: number + requests_per_second: + type: number + retries: + $ref: '#/components/schemas/_common:Retries' + slice_id: + type: number + task: + $ref: '#/components/schemas/_common:TaskId' + throttled: + $ref: '#/components/schemas/_common:Duration' + throttled_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + throttled_until: + $ref: '#/components/schemas/_common:Duration' + throttled_until_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + timed_out: + type: boolean + took: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total: + type: number + version_conflicts: + type: number + delete_by_query_rethrottle@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/tasks._common:TaskListResponseBase' + delete_pit@200: + description: '' + content: + application/json: + schema: + type: object + properties: + pits: + type: array + items: + $ref: '#/components/schemas/_core._common:DeletedPit' + delete_script@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + exists@200: + description: '' + content: + application/json: {} + exists_source@200: + description: '' + content: + application/json: {} + explain@200: + description: '' + content: + application/json: + schema: + type: object + properties: + _index: + $ref: '#/components/schemas/_common:IndexName' + _id: + $ref: '#/components/schemas/_common:Id' + matched: + type: boolean + explanation: + $ref: '#/components/schemas/_core.explain:ExplanationDetail' + get: + $ref: '#/components/schemas/_common:InlineGet' + required: + - _index + - _id + - matched + field_caps@200: + description: '' + content: + application/json: + schema: + type: object + properties: + indices: + $ref: '#/components/schemas/_common:Indices' + fields: + type: object + additionalProperties: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.field_caps:FieldCapability' + required: + - indices + - fields + get@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_core.get:GetResult' + get_all_pits@200: + description: '' + content: + application/json: + schema: + type: object + properties: + pits: + type: array + items: + $ref: '#/components/schemas/_core._common:PitDetail' + get_script@200: + description: '' + content: + application/json: + schema: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + found: + type: boolean + script: + $ref: '#/components/schemas/_common:StoredScript' + required: + - _id + - found + get_script_context@200: + description: '' + content: + application/json: + schema: + type: object + properties: + contexts: + type: array + items: + $ref: '#/components/schemas/_core.get_script_context:Context' + required: + - contexts + get_script_languages@200: + description: '' + content: + application/json: + schema: + type: object + properties: + language_contexts: + type: array + items: + $ref: '#/components/schemas/_core.get_script_languages:LanguageContext' + types_allowed: + type: array + items: + type: string + required: + - language_contexts + - types_allowed + get_source@200: + description: '' + content: + application/json: + schema: + type: object + index@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:WriteResponseBase' + indices.add_block@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + shards_acknowledged: + type: boolean + indices: + type: array + items: + $ref: '#/components/schemas/indices.add_block:IndicesBlockStatus' + required: + - acknowledged + - shards_acknowledged + - indices + indices.analyze@200: + description: '' + content: + application/json: + schema: + type: object + properties: + detail: + $ref: '#/components/schemas/indices.analyze:AnalyzeDetail' + tokens: + type: array + items: + $ref: '#/components/schemas/indices.analyze:AnalyzeToken' + indices.clear_cache@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:ShardsOperationResponseBase' + indices.clone@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + index: + $ref: '#/components/schemas/_common:IndexName' + shards_acknowledged: + type: boolean + required: + - acknowledged + - index + - shards_acknowledged + indices.close@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.close:CloseIndexResult' + shards_acknowledged: + type: boolean + required: + - acknowledged + - indices + - shards_acknowledged + indices.create@200: + description: '' + content: + application/json: + schema: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + shards_acknowledged: + type: boolean + acknowledged: + type: boolean + required: + - index + - shards_acknowledged + - acknowledged + indices.create_data_stream@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.data_streams_stats@200: + description: '' + content: + application/json: + schema: + type: object + properties: + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + backing_indices: + description: Total number of backing indices for the selected data streams. + type: number + data_stream_count: + description: Total number of selected data streams. + type: number + data_streams: + description: Contains statistics for the selected data streams. + type: array + items: + $ref: '#/components/schemas/indices.data_streams_stats:DataStreamsStatsItem' + total_store_sizes: + $ref: '#/components/schemas/_common:ByteSize' + total_store_size_bytes: + description: Total size, in bytes, of all shards for the selected data streams. + type: number + required: + - _shards + - backing_indices + - data_stream_count + - data_streams + - total_store_size_bytes + indices.delete@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:IndicesResponseBase' + indices.delete_alias@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.delete_data_stream@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.delete_index_template@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.delete_template@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.exists@200: + description: '' + content: + application/json: {} + indices.exists_alias@200: + description: '' + content: + application/json: {} + indices.exists_index_template@200: + description: '' + content: + application/json: {} + indices.exists_template@200: + description: '' + content: + application/json: {} + indices.flush@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:ShardsOperationResponseBase' + indices.forcemerge@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/indices.forcemerge._types:ForceMergeResponseBody' + indices.get@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:IndexState' + indices.get_alias@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.get_alias:IndexAliases' + indices.get_data_stream@200: + description: '' + content: + application/json: + schema: + type: object + properties: + data_streams: + type: array + items: + $ref: '#/components/schemas/indices._common:DataStream' + required: + - data_streams + indices.get_field_mapping@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.get_field_mapping:TypeFieldMappings' + indices.get_index_template@200: + description: '' + content: + application/json: + schema: + type: object + properties: + index_templates: + type: array + items: + $ref: '#/components/schemas/indices.get_index_template:IndexTemplateItem' + required: + - index_templates + indices.get_mapping@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.get_mapping:IndexMappingRecord' + indices.get_settings@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:IndexState' + indices.get_template@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:TemplateMapping' + indices.get_upgrade@200: + description: '' + indices.open@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + shards_acknowledged: + type: boolean + required: + - acknowledged + - shards_acknowledged + indices.put_alias@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.put_index_template@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.put_mapping@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:IndicesResponseBase' + indices.put_settings@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.put_template@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.recovery@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.recovery:RecoveryStatus' + indices.refresh@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:ShardsOperationResponseBase' + indices.resolve_index@200: + description: '' + content: + application/json: + schema: + type: object + properties: + indices: + type: array + items: + $ref: '#/components/schemas/indices.resolve_index:ResolveIndexItem' + aliases: + type: array + items: + $ref: '#/components/schemas/indices.resolve_index:ResolveIndexAliasItem' + data_streams: + type: array + items: + $ref: '#/components/schemas/indices.resolve_index:ResolveIndexDataStreamsItem' + required: + - indices + - aliases + - data_streams + indices.rollover@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + conditions: + type: object + additionalProperties: + type: boolean + dry_run: + type: boolean + new_index: + type: string + old_index: + type: string + rolled_over: + type: boolean + shards_acknowledged: + type: boolean + required: + - acknowledged + - conditions + - dry_run + - new_index + - old_index + - rolled_over + - shards_acknowledged + indices.segments@200: + description: '' + content: + application/json: + schema: + type: object + properties: + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.segments:IndexSegment' + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + required: + - indices + - _shards + indices.shard_stores@200: + description: '' + content: + application/json: + schema: + type: object + properties: + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.shard_stores:IndicesShardStores' + required: + - indices + indices.shrink@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + shards_acknowledged: + type: boolean + index: + $ref: '#/components/schemas/_common:IndexName' + required: + - acknowledged + - shards_acknowledged + - index + indices.simulate_index_template@200: + description: '' + content: + application/json: + schema: + type: object + indices.simulate_template@200: + description: '' + content: + application/json: + schema: + type: object + properties: + overlapping: + type: array + items: + $ref: '#/components/schemas/indices.simulate_template:Overlapping' + template: + $ref: '#/components/schemas/indices.simulate_template:Template' + required: + - template + indices.split@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + shards_acknowledged: + type: boolean + index: + $ref: '#/components/schemas/_common:IndexName' + required: + - acknowledged + - shards_acknowledged + - index + indices.stats@200: + description: '' + content: + application/json: + schema: + type: object + properties: + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.stats:IndicesStats' + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + _all: + $ref: '#/components/schemas/indices.stats:IndicesStats' + required: + - _shards + - _all + indices.update_aliases@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + indices.upgrade@200: + description: '' + indices.validate_query@200: + description: '' + content: + application/json: + schema: + type: object + properties: + explanations: + type: array + items: + $ref: '#/components/schemas/indices.validate_query:IndicesValidationExplanation' + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + valid: + type: boolean + error: + type: string + required: + - valid + info@200: + description: '' + content: + application/json: + schema: + type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common:Name' + cluster_uuid: + $ref: '#/components/schemas/_common:Uuid' + name: + $ref: '#/components/schemas/_common:Name' + tagline: + type: string + version: + $ref: '#/components/schemas/_common:OpensearchVersionInfo' + required: + - cluster_name + - cluster_uuid + - name + - tagline + - version + ingest.delete_pipeline@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + ingest.get_pipeline@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/ingest._common:Pipeline' + ingest.processor_grok@200: + description: '' + content: + application/json: + schema: + type: object + properties: + patterns: + type: object + additionalProperties: + type: string + required: + - patterns + ingest.put_pipeline@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + ingest.simulate@200: + description: '' + content: + application/json: + schema: + type: object + properties: + docs: + type: array + items: + $ref: '#/components/schemas/ingest.simulate:PipelineSimulation' + required: + - docs + knn.delete_model@200: + description: '' + knn.get_model@200: + description: '' + knn.search_models@200: + description: '' + knn.stats@200: + description: '' + knn.train_model@200: + description: '' + knn.warmup@200: + description: '' + mget@200: + description: '' + content: + application/json: + schema: + type: object + properties: + docs: + type: array + items: + $ref: '#/components/schemas/_core.mget:ResponseItem' + required: + - docs + msearch@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_core.msearch:MultiSearchResult' + msearch_template@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_core.msearch:MultiSearchResult' + mtermvectors@200: + description: '' + content: + application/json: + schema: + type: object + properties: + docs: + type: array + items: + $ref: '#/components/schemas/_core.mtermvectors:TermVectorsResult' + required: + - docs + nodes.hot_threads@200: + description: '' + nodes.info@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/nodes.info:ResponseBase' + nodes.reload_secure_settings@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/nodes.reload_secure_settings:ResponseBase' + nodes.stats@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/nodes.stats:ResponseBase' + nodes.usage@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/nodes.usage:ResponseBase' + notifications.create_config@200: + description: '' + content: + application/json: + schema: + type: object + properties: + config_id: + type: string + notifications.delete_config@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/notifications._common:DeleteConfigsResponse' + notifications.delete_configs@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/notifications._common:DeleteConfigsResponse' + notifications.get_config@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/notifications._common:GetConfigsResponse' + notifications.get_configs@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/notifications._common:GetConfigsResponse' + notifications.list_features@200: + description: '' + content: + application/json: + schema: + type: object + properties: + allowed_config_type_list: + type: array + items: + $ref: '#/components/schemas/notifications._common:NotificationConfigType' + plugin_features: + $ref: '#/components/schemas/notifications._common:NotificationsPluginFeaturesMap' + notifications.send_test@200: + description: '' + content: + application/json: + schema: + type: object + properties: + event_source: + $ref: '#/components/schemas/notifications._common:EventSource' + status_list: + type: array + items: + $ref: '#/components/schemas/notifications._common:EventStatus' + notifications.update_config@200: + description: '' + content: + application/json: + schema: + type: object + properties: + config_id: + type: string + ping@200: + description: '' + content: + application/json: {} + put_script@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + rank_eval@200: + description: '' + content: + application/json: + schema: + type: object + properties: + metric_score: + description: The overall evaluation quality calculated by the defined metric + type: number + details: + description: The details section contains one entry for every query in the original requests section, keyed by the search request id + type: object + additionalProperties: + $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricDetail' + failures: + type: object + additionalProperties: + type: object + required: + - metric_score + - details + - failures + reindex@200: + description: '' + content: + application/json: + schema: + type: object + properties: + batches: + type: number + created: + type: number + deleted: + type: number + failures: + type: array + items: + $ref: '#/components/schemas/_common:BulkIndexByScrollFailure' + noops: + type: number + retries: + $ref: '#/components/schemas/_common:Retries' + requests_per_second: + type: number + slice_id: + type: number + task: + $ref: '#/components/schemas/_common:TaskId' + throttled_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + throttled_until_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + timed_out: + type: boolean + took: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total: + type: number + updated: + type: number + version_conflicts: + type: number + reindex_rethrottle@200: + description: '' + content: + application/json: + schema: + type: object + properties: + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.reindex_rethrottle:ReindexNode' + required: + - nodes + remote_store.restore@200: + description: '' + content: + application/json: + schema: + type: object + properties: + accepted: + type: boolean + remote_store: + $ref: '#/components/schemas/remote_store._common:RemoteStoreRestoreInfo' + examples: + RemoteStoreRestore_example1: + summary: Examples for Post Remote Storage Restore Operation. + description: '' + value: + remote_store: + indices: + - books + shards: + total: 1 + failed: 0 + successful: 1 + render_search_template@200: + description: '' + content: + application/json: + schema: + type: object + properties: + template_output: + type: object + additionalProperties: + type: object + required: + - template_output + scripts_painless_execute@200: + description: '' + content: + application/json: + schema: + type: object + properties: + result: + type: object + required: + - result + scroll@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_core.search:ResponseBody' + search@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_core.search:ResponseBody' + search_pipeline.create@200: + description: '' + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + search_pipeline.get@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/search_pipeline._common:SearchPipelineMap' + search_shards@200: + description: '' + content: + application/json: + schema: + type: object + properties: + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:NodeAttributes' + shards: + type: array + items: + type: array + items: + $ref: '#/components/schemas/_common:NodeShard' + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.search_shards:ShardStoreIndex' + required: + - nodes + - shards + - indices + search_template@200: + description: '' + content: + application/json: + schema: + type: object + properties: + took: + type: number + timed_out: + type: boolean + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + hits: + $ref: '#/components/schemas/_core.search:HitsMetadata' + aggregations: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:Aggregate' + _clusters: + $ref: '#/components/schemas/_common:ClusterStatistics' + fields: + type: object + additionalProperties: + type: object + max_score: + type: number + num_reduce_phases: + type: number + profile: + $ref: '#/components/schemas/_core.search:Profile' + pit_id: + $ref: '#/components/schemas/_common:Id' + _scroll_id: + $ref: '#/components/schemas/_common:ScrollId' + suggest: + type: object + additionalProperties: + type: array + items: + $ref: '#/components/schemas/_core.search:Suggest' + terminated_early: + type: boolean + required: + - took + - timed_out + - _shards + - hits + security.change_password@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.create_action_group@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.create_role@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.create_role_mapping@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.create_tenant@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.create_user@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.delete_action_group@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.delete_distinguished_names@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.delete_role@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.delete_role_mapping@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.delete_tenant@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.delete_user@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.flush_cache@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.get_account_details@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:AccountDetails' + security.get_action_group@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:ActionGroupsMap' + security.get_action_groups@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:ActionGroupsMap' + security.get_audit_configuration@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:AuditConfigWithReadOnly' + security.get_certificates@200: + description: '' + content: + application/json: + schema: + type: object + properties: + http_certificates_list: + type: array + items: + $ref: '#/components/schemas/security._common:CertificatesDetail' + transport_certificates_list: + type: array + items: + $ref: '#/components/schemas/security._common:CertificatesDetail' + security.get_configuration@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:DynamicConfig' + security.get_distinguished_names@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:DistinguishedNamesMap' + security.get_role@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:RolesMap' + security.get_role_mapping@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:RoleMappings' + security.get_role_mappings@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:RoleMappings' + security.get_roles@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:RolesMap' + security.get_tenant@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:TenantsMap' + security.get_tenants@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:TenantsMap' + security.get_user@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:UsersMap' + security.get_users@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/security._common:UsersMap' + security.health@200: + description: '' + content: + application/json: + schema: + type: object + properties: + message: + type: string + mode: + type: string + status: + type: string + security.patch_action_group@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_action_groups@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_audit_configuration@200: + description: '' + security.patch_configuration@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_distinguished_names@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_role@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_role_mapping@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_role_mappings@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_roles@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_tenant@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_tenants@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_user@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.patch_users@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.reload_http_certificates@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.reload_transport_certificates@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.update_audit_configuration@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.update_configuration@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + security.update_distinguished_names@200: + description: '' + content: + application/json: + schema: + type: object + properties: + status: + type: string + description: Security Operation Status + message: + type: string + description: Security Operation Message + snapshot.cleanup_repository@200: + description: '' + content: + application/json: + schema: + type: object + properties: + results: + $ref: '#/components/schemas/snapshot.cleanup_repository:CleanupRepositoryResults' + required: + - results + snapshot.clone@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + snapshot.create@200: + description: '' + content: + application/json: + schema: + type: object + properties: + accepted: + description: Equals `true` if the snapshot was accepted. Present when the request had `wait_for_completion` set to `false` + type: boolean + snapshot: + $ref: '#/components/schemas/snapshot._common:SnapshotInfo' + snapshot.create_repository@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + snapshot.delete@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + snapshot.delete_repository@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + snapshot.get@200: + description: '' + content: + application/json: + schema: + type: object + properties: + responses: + type: array + items: + $ref: '#/components/schemas/snapshot.get:SnapshotResponseItem' + snapshots: + type: array + items: + $ref: '#/components/schemas/snapshot._common:SnapshotInfo' + total: + description: The total number of snapshots that match the request when ignoring size limit or after query parameter. + type: number + remaining: + description: The number of remaining snapshots that were not returned due to size limits and that can be fetched by additional requests using the next field value. + type: number + required: + - total + - remaining + snapshot.get_repository@200: + description: '' + content: + application/json: + schema: + type: object + additionalProperties: + $ref: '#/components/schemas/snapshot._common:Repository' + snapshot.restore@200: + description: '' + content: + application/json: + schema: + type: object + properties: + snapshot: + $ref: '#/components/schemas/snapshot.restore:SnapshotRestore' + required: + - snapshot + snapshot.status@200: + description: '' + content: + application/json: + schema: + type: object + properties: + snapshots: + type: array + items: + $ref: '#/components/schemas/snapshot._common:Status' + required: + - snapshots + snapshot.verify_repository@200: + description: '' + content: + application/json: + schema: + type: object + properties: + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/snapshot.verify_repository:CompactNodeInfo' + required: + - nodes + tasks.cancel@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/tasks._common:TaskListResponseBase' + tasks.get@200: + description: '' + content: + application/json: + schema: + type: object + properties: + completed: + type: boolean + task: + $ref: '#/components/schemas/tasks._common:TaskInfo' + response: + type: object + error: + $ref: '#/components/schemas/_common:ErrorCause' + required: + - completed + - task + tasks.list@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/tasks._common:TaskListResponseBase' + termvectors@200: + description: '' + content: + application/json: + schema: + type: object + properties: + found: + type: boolean + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + term_vectors: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.termvectors:TermVector' + took: + type: number + _version: + $ref: '#/components/schemas/_common:VersionNumber' + required: + - found + - _id + - _index + - took + - _version + update@200: + description: '' + content: + application/json: + schema: + $ref: '#/components/schemas/_core.update:UpdateWriteResponseBase' + update_by_query@200: + description: '' + content: + application/json: + schema: + type: object + properties: + batches: + type: number + failures: + type: array + items: + $ref: '#/components/schemas/_common:BulkIndexByScrollFailure' + noops: + type: number + deleted: + type: number + requests_per_second: + type: number + retries: + $ref: '#/components/schemas/_common:Retries' + task: + $ref: '#/components/schemas/_common:TaskId' + timed_out: + type: boolean + took: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total: + type: number + updated: + type: number + version_conflicts: + type: number + throttled: + $ref: '#/components/schemas/_common:Duration' + throttled_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + throttled_until: + $ref: '#/components/schemas/_common:Duration' + throttled_until_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + update_by_query_rethrottle@200: + description: '' + content: + application/json: + schema: + type: object + properties: + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.update_by_query_rethrottle:UpdateByQueryRethrottleNode' + required: + - nodes + schemas: + _common.aggregations:AdjacencyMatrixAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseAdjacencyMatrixBucket' + - type: object + _common.aggregations:AdjacencyMatrixAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + filters: + description: |- + Filters used to create buckets. + At least one filter is required. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + _common.aggregations:AdjacencyMatrixBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + type: string + required: + - key + _common.aggregations:Aggregate: + oneOf: + - $ref: '#/components/schemas/_common.aggregations:CardinalityAggregate' + - $ref: '#/components/schemas/_common.aggregations:HdrPercentilesAggregate' + - $ref: '#/components/schemas/_common.aggregations:HdrPercentileRanksAggregate' + - $ref: '#/components/schemas/_common.aggregations:TDigestPercentilesAggregate' + - $ref: '#/components/schemas/_common.aggregations:TDigestPercentileRanksAggregate' + - $ref: '#/components/schemas/_common.aggregations:PercentilesBucketAggregate' + - $ref: '#/components/schemas/_common.aggregations:MedianAbsoluteDeviationAggregate' + - $ref: '#/components/schemas/_common.aggregations:MinAggregate' + - $ref: '#/components/schemas/_common.aggregations:MaxAggregate' + - $ref: '#/components/schemas/_common.aggregations:SumAggregate' + - $ref: '#/components/schemas/_common.aggregations:AvgAggregate' + - $ref: '#/components/schemas/_common.aggregations:WeightedAvgAggregate' + - $ref: '#/components/schemas/_common.aggregations:ValueCountAggregate' + - $ref: '#/components/schemas/_common.aggregations:SimpleValueAggregate' + - $ref: '#/components/schemas/_common.aggregations:DerivativeAggregate' + - $ref: '#/components/schemas/_common.aggregations:BucketMetricValueAggregate' + - $ref: '#/components/schemas/_common.aggregations:StatsAggregate' + - $ref: '#/components/schemas/_common.aggregations:StatsBucketAggregate' + - $ref: '#/components/schemas/_common.aggregations:ExtendedStatsAggregate' + - $ref: '#/components/schemas/_common.aggregations:ExtendedStatsBucketAggregate' + - $ref: '#/components/schemas/_common.aggregations:GeoBoundsAggregate' + - $ref: '#/components/schemas/_common.aggregations:GeoCentroidAggregate' + - $ref: '#/components/schemas/_common.aggregations:HistogramAggregate' + - $ref: '#/components/schemas/_common.aggregations:DateHistogramAggregate' + - $ref: '#/components/schemas/_common.aggregations:AutoDateHistogramAggregate' + - $ref: '#/components/schemas/_common.aggregations:VariableWidthHistogramAggregate' + - $ref: '#/components/schemas/_common.aggregations:StringTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:LongTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:DoubleTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:UnmappedTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:LongRareTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:StringRareTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:UnmappedRareTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:MultiTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:MissingAggregate' + - $ref: '#/components/schemas/_common.aggregations:NestedAggregate' + - $ref: '#/components/schemas/_common.aggregations:ReverseNestedAggregate' + - $ref: '#/components/schemas/_common.aggregations:GlobalAggregate' + - $ref: '#/components/schemas/_common.aggregations:FilterAggregate' + - $ref: '#/components/schemas/_common.aggregations:ChildrenAggregate' + - $ref: '#/components/schemas/_common.aggregations:ParentAggregate' + - $ref: '#/components/schemas/_common.aggregations:SamplerAggregate' + - $ref: '#/components/schemas/_common.aggregations:UnmappedSamplerAggregate' + - $ref: '#/components/schemas/_common.aggregations:GeoHashGridAggregate' + - $ref: '#/components/schemas/_common.aggregations:GeoTileGridAggregate' + - $ref: '#/components/schemas/_common.aggregations:GeoHexGridAggregate' + - $ref: '#/components/schemas/_common.aggregations:RangeAggregate' + - $ref: '#/components/schemas/_common.aggregations:DateRangeAggregate' + - $ref: '#/components/schemas/_common.aggregations:GeoDistanceAggregate' + - $ref: '#/components/schemas/_common.aggregations:IpRangeAggregate' + - $ref: '#/components/schemas/_common.aggregations:IpPrefixAggregate' + - $ref: '#/components/schemas/_common.aggregations:FiltersAggregate' + - $ref: '#/components/schemas/_common.aggregations:AdjacencyMatrixAggregate' + - $ref: '#/components/schemas/_common.aggregations:SignificantLongTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:SignificantStringTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:UnmappedSignificantTermsAggregate' + - $ref: '#/components/schemas/_common.aggregations:CompositeAggregate' + - $ref: '#/components/schemas/_common.aggregations:FrequentItemSetsAggregate' + - $ref: '#/components/schemas/_common.aggregations:ScriptedMetricAggregate' + - $ref: '#/components/schemas/_common.aggregations:TopHitsAggregate' + - $ref: '#/components/schemas/_common.aggregations:InferenceAggregate' + - $ref: '#/components/schemas/_common.aggregations:StringStatsAggregate' + - $ref: '#/components/schemas/_common.aggregations:BoxPlotAggregate' + - $ref: '#/components/schemas/_common.aggregations:TopMetricsAggregate' + - $ref: '#/components/schemas/_common.aggregations:TTestAggregate' + - $ref: '#/components/schemas/_common.aggregations:RateAggregate' + - $ref: '#/components/schemas/_common.aggregations:CumulativeCardinalityAggregate' + - $ref: '#/components/schemas/_common.aggregations:MatrixStatsAggregate' + - $ref: '#/components/schemas/_common.aggregations:GeoLineAggregate' + _common.aggregations:AggregateBase: + type: object + properties: + meta: + $ref: '#/components/schemas/_common:Metadata' + _common.aggregations:AggregateOrder: + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common:SortOrder' + minProperties: 1 + maxProperties: 1 + - type: array + items: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:SortOrder' + minProperties: 1 + maxProperties: 1 + _common.aggregations:Aggregation: + type: object + properties: + meta: + $ref: '#/components/schemas/_common:Metadata' + name: + type: string + _common.aggregations:AggregationContainer: + allOf: + - type: object + properties: + aggregations: + description: |- + Sub-aggregations for this aggregation. + Only applies to bucket aggregations. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:AggregationContainer' + meta: + $ref: '#/components/schemas/_common:Metadata' + - type: object + properties: + adjacency_matrix: + $ref: '#/components/schemas/_common.aggregations:AdjacencyMatrixAggregation' + auto_date_histogram: + $ref: '#/components/schemas/_common.aggregations:AutoDateHistogramAggregation' + avg: + $ref: '#/components/schemas/_common.aggregations:AverageAggregation' + avg_bucket: + $ref: '#/components/schemas/_common.aggregations:AverageBucketAggregation' + boxplot: + $ref: '#/components/schemas/_common.aggregations:BoxplotAggregation' + bucket_script: + $ref: '#/components/schemas/_common.aggregations:BucketScriptAggregation' + bucket_selector: + $ref: '#/components/schemas/_common.aggregations:BucketSelectorAggregation' + bucket_sort: + $ref: '#/components/schemas/_common.aggregations:BucketSortAggregation' + bucket_count_ks_test: + $ref: '#/components/schemas/_common.aggregations:BucketKsAggregation' + bucket_correlation: + $ref: '#/components/schemas/_common.aggregations:BucketCorrelationAggregation' + cardinality: + $ref: '#/components/schemas/_common.aggregations:CardinalityAggregation' + categorize_text: + $ref: '#/components/schemas/_common.aggregations:CategorizeTextAggregation' + children: + $ref: '#/components/schemas/_common.aggregations:ChildrenAggregation' + composite: + $ref: '#/components/schemas/_common.aggregations:CompositeAggregation' + cumulative_cardinality: + $ref: '#/components/schemas/_common.aggregations:CumulativeCardinalityAggregation' + cumulative_sum: + $ref: '#/components/schemas/_common.aggregations:CumulativeSumAggregation' + date_histogram: + $ref: '#/components/schemas/_common.aggregations:DateHistogramAggregation' + date_range: + $ref: '#/components/schemas/_common.aggregations:DateRangeAggregation' + derivative: + $ref: '#/components/schemas/_common.aggregations:DerivativeAggregation' + diversified_sampler: + $ref: '#/components/schemas/_common.aggregations:DiversifiedSamplerAggregation' + extended_stats: + $ref: '#/components/schemas/_common.aggregations:ExtendedStatsAggregation' + extended_stats_bucket: + $ref: '#/components/schemas/_common.aggregations:ExtendedStatsBucketAggregation' + frequent_item_sets: + $ref: '#/components/schemas/_common.aggregations:FrequentItemSetsAggregation' + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + filters: + $ref: '#/components/schemas/_common.aggregations:FiltersAggregation' + geo_bounds: + $ref: '#/components/schemas/_common.aggregations:GeoBoundsAggregation' + geo_centroid: + $ref: '#/components/schemas/_common.aggregations:GeoCentroidAggregation' + geo_distance: + $ref: '#/components/schemas/_common.aggregations:GeoDistanceAggregation' + geohash_grid: + $ref: '#/components/schemas/_common.aggregations:GeoHashGridAggregation' + geo_line: + $ref: '#/components/schemas/_common.aggregations:GeoLineAggregation' + geotile_grid: + $ref: '#/components/schemas/_common.aggregations:GeoTileGridAggregation' + geohex_grid: + $ref: '#/components/schemas/_common.aggregations:GeohexGridAggregation' + global: + $ref: '#/components/schemas/_common.aggregations:GlobalAggregation' + histogram: + $ref: '#/components/schemas/_common.aggregations:HistogramAggregation' + ip_range: + $ref: '#/components/schemas/_common.aggregations:IpRangeAggregation' + ip_prefix: + $ref: '#/components/schemas/_common.aggregations:IpPrefixAggregation' + inference: + $ref: '#/components/schemas/_common.aggregations:InferenceAggregation' + line: + $ref: '#/components/schemas/_common.aggregations:GeoLineAggregation' + matrix_stats: + $ref: '#/components/schemas/_common.aggregations:MatrixStatsAggregation' + max: + $ref: '#/components/schemas/_common.aggregations:MaxAggregation' + max_bucket: + $ref: '#/components/schemas/_common.aggregations:MaxBucketAggregation' + median_absolute_deviation: + $ref: '#/components/schemas/_common.aggregations:MedianAbsoluteDeviationAggregation' + min: + $ref: '#/components/schemas/_common.aggregations:MinAggregation' + min_bucket: + $ref: '#/components/schemas/_common.aggregations:MinBucketAggregation' + missing: + $ref: '#/components/schemas/_common.aggregations:MissingAggregation' + moving_avg: + $ref: '#/components/schemas/_common.aggregations:MovingAverageAggregation' + moving_percentiles: + $ref: '#/components/schemas/_common.aggregations:MovingPercentilesAggregation' + moving_fn: + $ref: '#/components/schemas/_common.aggregations:MovingFunctionAggregation' + multi_terms: + $ref: '#/components/schemas/_common.aggregations:MultiTermsAggregation' + nested: + $ref: '#/components/schemas/_common.aggregations:NestedAggregation' + normalize: + $ref: '#/components/schemas/_common.aggregations:NormalizeAggregation' + parent: + $ref: '#/components/schemas/_common.aggregations:ParentAggregation' + percentile_ranks: + $ref: '#/components/schemas/_common.aggregations:PercentileRanksAggregation' + percentiles: + $ref: '#/components/schemas/_common.aggregations:PercentilesAggregation' + percentiles_bucket: + $ref: '#/components/schemas/_common.aggregations:PercentilesBucketAggregation' + range: + $ref: '#/components/schemas/_common.aggregations:RangeAggregation' + rare_terms: + $ref: '#/components/schemas/_common.aggregations:RareTermsAggregation' + rate: + $ref: '#/components/schemas/_common.aggregations:RateAggregation' + reverse_nested: + $ref: '#/components/schemas/_common.aggregations:ReverseNestedAggregation' + sampler: + $ref: '#/components/schemas/_common.aggregations:SamplerAggregation' + scripted_metric: + $ref: '#/components/schemas/_common.aggregations:ScriptedMetricAggregation' + serial_diff: + $ref: '#/components/schemas/_common.aggregations:SerialDifferencingAggregation' + significant_terms: + $ref: '#/components/schemas/_common.aggregations:SignificantTermsAggregation' + significant_text: + $ref: '#/components/schemas/_common.aggregations:SignificantTextAggregation' + stats: + $ref: '#/components/schemas/_common.aggregations:StatsAggregation' + stats_bucket: + $ref: '#/components/schemas/_common.aggregations:StatsBucketAggregation' + string_stats: + $ref: '#/components/schemas/_common.aggregations:StringStatsAggregation' + sum: + $ref: '#/components/schemas/_common.aggregations:SumAggregation' + sum_bucket: + $ref: '#/components/schemas/_common.aggregations:SumBucketAggregation' + terms: + $ref: '#/components/schemas/_common.aggregations:TermsAggregation' + top_hits: + $ref: '#/components/schemas/_common.aggregations:TopHitsAggregation' + t_test: + $ref: '#/components/schemas/_common.aggregations:TTestAggregation' + top_metrics: + $ref: '#/components/schemas/_common.aggregations:TopMetricsAggregation' + value_count: + $ref: '#/components/schemas/_common.aggregations:ValueCountAggregation' + weighted_avg: + $ref: '#/components/schemas/_common.aggregations:WeightedAverageAggregation' + variable_width_histogram: + $ref: '#/components/schemas/_common.aggregations:VariableWidthHistogramAggregation' + minProperties: 1 + maxProperties: 1 + _common.aggregations:AggregationRange: + type: object + properties: + from: + description: Start of the range (inclusive). + oneOf: + - type: number + - type: string + - nullable: true + type: string + key: + description: Custom key to return the range with. + type: string + to: + description: End of the range (exclusive). + oneOf: + - type: number + - type: string + - nullable: true + type: string + _common.aggregations:ArrayPercentilesItem: + type: object + properties: + key: + type: string + value: + oneOf: + - type: number + - nullable: true + type: string + value_as_string: + type: string + required: + - key + - value + _common.aggregations:AutoDateHistogramAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseDateHistogramBucket' + - type: object + properties: + interval: + $ref: '#/components/schemas/_common:DurationLarge' + required: + - interval + _common.aggregations:AutoDateHistogramAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + buckets: + description: The target number of buckets. + type: number + field: + $ref: '#/components/schemas/_common:Field' + format: + description: |- + The date format used to format `key_as_string` in the response. + If no `format` is specified, the first date format specified in the field mapping is used. + type: string + minimum_interval: + $ref: '#/components/schemas/_common.aggregations:MinimumInterval' + missing: + $ref: '#/components/schemas/_common:DateTime' + offset: + description: Time zone specified as a ISO 8601 UTC offset. + type: string + params: + type: object + additionalProperties: + type: object + script: + $ref: '#/components/schemas/_common:Script' + time_zone: + $ref: '#/components/schemas/_common:TimeZone' + _common.aggregations:AverageAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + _common.aggregations:AverageBucketAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + _common.aggregations:AvgAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + _common.aggregations:BoxPlotAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + min: + type: number + max: + type: number + q1: + type: number + q2: + type: number + q3: + type: number + lower: + type: number + upper: + type: number + min_as_string: + type: string + max_as_string: + type: string + q1_as_string: + type: string + q2_as_string: + type: string + q3_as_string: + type: string + lower_as_string: + type: string + upper_as_string: + type: string + required: + - min + - max + - q1 + - q2 + - q3 + - lower + - upper + _common.aggregations:BoxplotAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + compression: + description: Limits the maximum number of nodes used by the underlying TDigest algorithm to `20 * compression`, enabling control of memory usage and approximation error. + type: number + _common.aggregations:BucketAggregationBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:Aggregation' + - type: object + _common.aggregations:BucketCorrelationAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketPathAggregation' + - type: object + properties: + function: + $ref: '#/components/schemas/_common.aggregations:BucketCorrelationFunction' + required: + - function + _common.aggregations:BucketCorrelationFunction: + type: object + properties: + count_correlation: + $ref: '#/components/schemas/_common.aggregations:BucketCorrelationFunctionCountCorrelation' + required: + - count_correlation + _common.aggregations:BucketCorrelationFunctionCountCorrelation: + type: object + properties: + indicator: + $ref: '#/components/schemas/_common.aggregations:BucketCorrelationFunctionCountCorrelationIndicator' + required: + - indicator + _common.aggregations:BucketCorrelationFunctionCountCorrelationIndicator: + type: object + properties: + doc_count: + description: |- + The total number of documents that initially created the expectations. It’s required to be greater + than or equal to the sum of all values in the buckets_path as this is the originating superset of data + to which the term values are correlated. + type: number + expectations: + description: |- + An array of numbers with which to correlate the configured `bucket_path` values. + The length of this value must always equal the number of buckets returned by the `bucket_path`. + type: array + items: + type: number + fractions: + description: |- + An array of fractions to use when averaging and calculating variance. This should be used if + the pre-calculated data and the buckets_path have known gaps. The length of fractions, if provided, + must equal expectations. + type: array + items: + type: number + required: + - doc_count + - expectations + _common.aggregations:BucketKsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketPathAggregation' + - type: object + properties: + alternative: + description: |- + A list of string values indicating which K-S test alternative to calculate. The valid values + are: "greater", "less", "two_sided". This parameter is key for determining the K-S statistic used + when calculating the K-S test. Default value is all possible alternative hypotheses. + type: array + items: + type: string + fractions: + description: |- + A list of doubles indicating the distribution of the samples with which to compare to the `buckets_path` results. + In typical usage this is the overall proportion of documents in each bucket, which is compared with the actual + document proportions in each bucket from the sibling aggregation counts. The default is to assume that overall + documents are uniformly distributed on these buckets, which they would be if one used equal percentiles of a + metric to define the bucket end points. + type: array + items: + type: number + sampling_method: + description: |- + Indicates the sampling methodology when calculating the K-S test. Note, this is sampling of the returned values. + This determines the cumulative distribution function (CDF) points used comparing the two samples. Default is + `upper_tail`, which emphasizes the upper end of the CDF points. Valid options are: `upper_tail`, `uniform`, + and `lower_tail`. + type: string + _common.aggregations:BucketMetricValueAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + properties: + keys: + type: array + items: + type: string + required: + - keys + _common.aggregations:BucketPathAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:Aggregation' + - type: object + properties: + buckets_path: + $ref: '#/components/schemas/_common.aggregations:BucketsPath' + _common.aggregations:BucketScriptAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + script: + $ref: '#/components/schemas/_common:Script' + _common.aggregations:BucketSelectorAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + script: + $ref: '#/components/schemas/_common:Script' + _common.aggregations:BucketSortAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:Aggregation' + - type: object + properties: + from: + description: Buckets in positions prior to `from` will be truncated. + type: number + gap_policy: + $ref: '#/components/schemas/_common.aggregations:GapPolicy' + size: + description: |- + The number of buckets to return. + Defaults to all buckets of the parent aggregation. + type: number + sort: + $ref: '#/components/schemas/_common:Sort' + _common.aggregations:BucketsAdjacencyMatrixBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:AdjacencyMatrixBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:AdjacencyMatrixBucket' + _common.aggregations:BucketsCompositeBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:CompositeBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:CompositeBucket' + _common.aggregations:BucketsDateHistogramBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:DateHistogramBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:DateHistogramBucket' + _common.aggregations:BucketsDoubleTermsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:DoubleTermsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:DoubleTermsBucket' + _common.aggregations:BucketsFiltersBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:FiltersBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:FiltersBucket' + _common.aggregations:BucketsFrequentItemSetsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:FrequentItemSetsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:FrequentItemSetsBucket' + _common.aggregations:BucketsGeoHashGridBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:GeoHashGridBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:GeoHashGridBucket' + _common.aggregations:BucketsGeoHexGridBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:GeoHexGridBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:GeoHexGridBucket' + _common.aggregations:BucketsGeoTileGridBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:GeoTileGridBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:GeoTileGridBucket' + _common.aggregations:BucketsHistogramBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:HistogramBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:HistogramBucket' + _common.aggregations:BucketsIpPrefixBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:IpPrefixBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:IpPrefixBucket' + _common.aggregations:BucketsIpRangeBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:IpRangeBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:IpRangeBucket' + _common.aggregations:BucketsLongRareTermsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:LongRareTermsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:LongRareTermsBucket' + _common.aggregations:BucketsLongTermsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:LongTermsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:LongTermsBucket' + _common.aggregations:BucketsMultiTermsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:MultiTermsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:MultiTermsBucket' + _common.aggregations:BucketsPath: + description: |- + Buckets path can be expressed in different ways, and an aggregation may accept some or all of these + forms depending on its type. Please refer to each aggregation's documentation to know what buckets + path forms they accept. + oneOf: + - type: string + - type: array + items: + type: string + - type: object + additionalProperties: + type: string + _common.aggregations:BucketsQueryContainer: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + _common.aggregations:BucketsRangeBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:RangeBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:RangeBucket' + _common.aggregations:BucketsSignificantLongTermsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:SignificantLongTermsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:SignificantLongTermsBucket' + _common.aggregations:BucketsSignificantStringTermsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:SignificantStringTermsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:SignificantStringTermsBucket' + _common.aggregations:BucketsStringRareTermsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:StringRareTermsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:StringRareTermsBucket' + _common.aggregations:BucketsStringTermsBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:StringTermsBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:StringTermsBucket' + _common.aggregations:BucketsVariableWidthHistogramBucket: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:VariableWidthHistogramBucket' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:VariableWidthHistogramBucket' + _common.aggregations:BucketsVoid: + description: |- + Aggregation buckets. By default they are returned as an array, but if the aggregation has keys configured for + the different buckets, the result is a dictionary. + oneOf: + - type: object + additionalProperties: + $ref: '#/components/schemas/_common:Void' + - type: array + items: + $ref: '#/components/schemas/_common:Void' + _common.aggregations:CalendarInterval: + type: string + enum: + - second + - minute + - hour + - day + - week + - month + - quarter + - year + _common.aggregations:CardinalityAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + value: + type: number + required: + - value + _common.aggregations:CardinalityAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + precision_threshold: + description: |- + A unique count below which counts are expected to be close to accurate. + This allows to trade memory for accuracy. + type: number + rehash: + type: boolean + execution_hint: + $ref: '#/components/schemas/_common.aggregations:CardinalityExecutionMode' + _common.aggregations:CardinalityExecutionMode: + type: string + enum: + - global_ordinals + - segment_ordinals + - direct + - save_memory_heuristic + - save_time_heuristic + _common.aggregations:CategorizeTextAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:Aggregation' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + max_unique_tokens: + description: |- + The maximum number of unique tokens at any position up to max_matched_tokens. Must be larger than 1. + Smaller values use less memory and create fewer categories. Larger values will use more memory and + create narrower categories. Max allowed value is 100. + type: number + max_matched_tokens: + description: |- + The maximum number of token positions to match on before attempting to merge categories. Larger + values will use more memory and create narrower categories. Max allowed value is 100. + type: number + similarity_threshold: + description: |- + The minimum percentage of tokens that must match for text to be added to the category bucket. Must + be between 1 and 100. The larger the value the narrower the categories. Larger values will increase memory + usage and create narrower categories. + type: number + categorization_filters: + description: |- + This property expects an array of regular expressions. The expressions are used to filter out matching + sequences from the categorization field values. You can use this functionality to fine tune the categorization + by excluding sequences from consideration when categories are defined. For example, you can exclude SQL + statements that appear in your log files. This property cannot be used at the same time as categorization_analyzer. + If you only want to define simple regular expression filters that are applied prior to tokenization, setting + this property is the easiest method. If you also want to customize the tokenizer or post-tokenization filtering, + use the categorization_analyzer property instead and include the filters as pattern_replace character filters. + type: array + items: + type: string + categorization_analyzer: + $ref: '#/components/schemas/_common.aggregations:CategorizeTextAnalyzer' + shard_size: + description: The number of categorization buckets to return from each shard before merging all the results. + type: number + size: + description: The number of buckets to return. + type: number + min_doc_count: + description: The minimum number of documents in a bucket to be returned to the results. + type: number + shard_min_doc_count: + description: The minimum number of documents in a bucket to be returned from the shard before merging. + type: number + required: + - field + _common.aggregations:CategorizeTextAnalyzer: + oneOf: + - type: string + - $ref: '#/components/schemas/_common.aggregations:CustomCategorizeTextAnalyzer' + _common.aggregations:ChiSquareHeuristic: + type: object + properties: + background_is_superset: + description: Set to `false` if you defined a custom background filter that represents a different set of documents that you want to compare to. + type: boolean + include_negatives: + description: Set to `false` to filter out the terms that appear less often in the subset than in documents outside the subset. + type: boolean + required: + - background_is_superset + - include_negatives + _common.aggregations:ChildrenAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:ChildrenAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + type: + $ref: '#/components/schemas/_common:RelationName' + _common.aggregations:ClassificationInferenceOptions: + type: object + properties: + num_top_classes: + description: Specifies the number of top class predictions to return. Defaults to 0. + type: number + num_top_feature_importance_values: + description: Specifies the maximum number of feature importance values per document. + type: number + prediction_field_type: + description: 'Specifies the type of the predicted field to write. Acceptable values are: string, number, boolean. When boolean is provided 1.0 is transformed to true and 0.0 to false.' + type: string + results_field: + description: The field that is added to incoming documents to contain the inference prediction. Defaults to predicted_value. + type: string + top_classes_results_field: + description: Specifies the field to which the top classes are written. Defaults to top_classes. + type: string + _common.aggregations:CompositeAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseCompositeBucket' + - type: object + properties: + after_key: + $ref: '#/components/schemas/_common.aggregations:CompositeAggregateKey' + _common.aggregations:CompositeAggregateKey: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:FieldValue' + _common.aggregations:CompositeAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + after: + $ref: '#/components/schemas/_common.aggregations:CompositeAggregateKey' + size: + description: The number of composite buckets that should be returned. + type: number + sources: + description: |- + The value sources used to build composite buckets. + Keys are returned in the order of the `sources` definition. + type: array + items: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:CompositeAggregationSource' + _common.aggregations:CompositeAggregationBase: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + missing_bucket: + type: boolean + missing_order: + $ref: '#/components/schemas/_common.aggregations:MissingOrder' + script: + $ref: '#/components/schemas/_common:Script' + value_type: + $ref: '#/components/schemas/_common.aggregations:ValueType' + order: + $ref: '#/components/schemas/_common:SortOrder' + _common.aggregations:CompositeAggregationSource: + type: object + properties: + terms: + $ref: '#/components/schemas/_common.aggregations:CompositeTermsAggregation' + histogram: + $ref: '#/components/schemas/_common.aggregations:CompositeHistogramAggregation' + date_histogram: + $ref: '#/components/schemas/_common.aggregations:CompositeDateHistogramAggregation' + geotile_grid: + $ref: '#/components/schemas/_common.aggregations:CompositeGeoTileGridAggregation' + _common.aggregations:CompositeBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + $ref: '#/components/schemas/_common.aggregations:CompositeAggregateKey' + required: + - key + _common.aggregations:CompositeDateHistogramAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:CompositeAggregationBase' + - type: object + properties: + format: + type: string + calendar_interval: + $ref: '#/components/schemas/_common:DurationLarge' + fixed_interval: + $ref: '#/components/schemas/_common:DurationLarge' + offset: + $ref: '#/components/schemas/_common:Duration' + time_zone: + $ref: '#/components/schemas/_common:TimeZone' + _common.aggregations:CompositeGeoTileGridAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:CompositeAggregationBase' + - type: object + properties: + precision: + type: number + bounds: + $ref: '#/components/schemas/_common:GeoBounds' + _common.aggregations:CompositeHistogramAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:CompositeAggregationBase' + - type: object + properties: + interval: + type: number + required: + - interval + _common.aggregations:CompositeTermsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:CompositeAggregationBase' + - type: object + _common.aggregations:CumulativeCardinalityAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + value: + type: number + value_as_string: + type: string + required: + - value + _common.aggregations:CumulativeCardinalityAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + _common.aggregations:CumulativeSumAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + _common.aggregations:CustomCategorizeTextAnalyzer: + type: object + properties: + char_filter: + type: array + items: + type: string + tokenizer: + type: string + filter: + type: array + items: + type: string + _common.aggregations:DateHistogramAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseDateHistogramBucket' + - type: object + _common.aggregations:DateHistogramAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + calendar_interval: + $ref: '#/components/schemas/_common.aggregations:CalendarInterval' + extended_bounds: + $ref: '#/components/schemas/_common.aggregations:ExtendedBoundsFieldDateMath' + hard_bounds: + $ref: '#/components/schemas/_common.aggregations:ExtendedBoundsFieldDateMath' + field: + $ref: '#/components/schemas/_common:Field' + fixed_interval: + $ref: '#/components/schemas/_common:Duration' + format: + description: |- + The date format used to format `key_as_string` in the response. + If no `format` is specified, the first date format specified in the field mapping is used. + type: string + interval: + $ref: '#/components/schemas/_common:Duration' + min_doc_count: + description: |- + Only returns buckets that have `min_doc_count` number of documents. + By default, all buckets between the first bucket that matches documents and the last one are returned. + type: number + missing: + $ref: '#/components/schemas/_common:DateTime' + offset: + $ref: '#/components/schemas/_common:Duration' + order: + $ref: '#/components/schemas/_common.aggregations:AggregateOrder' + params: + type: object + additionalProperties: + type: object + script: + $ref: '#/components/schemas/_common:Script' + time_zone: + $ref: '#/components/schemas/_common:TimeZone' + keyed: + description: Set to `true` to associate a unique string key with each bucket and return the ranges as a hash rather than an array. + type: boolean + _common.aggregations:DateHistogramBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key_as_string: + type: string + key: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + required: + - key + _common.aggregations:DateRangeAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:RangeAggregate' + - type: object + _common.aggregations:DateRangeAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + format: + description: The date format used to format `from` and `to` in the response. + type: string + missing: + $ref: '#/components/schemas/_common.aggregations:Missing' + ranges: + description: Array of date ranges. + type: array + items: + $ref: '#/components/schemas/_common.aggregations:DateRangeExpression' + time_zone: + $ref: '#/components/schemas/_common:TimeZone' + keyed: + description: Set to `true` to associate a unique string key with each bucket and returns the ranges as a hash rather than an array. + type: boolean + _common.aggregations:DateRangeExpression: + type: object + properties: + from: + $ref: '#/components/schemas/_common.aggregations:FieldDateMath' + key: + description: Custom key to return the range with. + type: string + to: + $ref: '#/components/schemas/_common.aggregations:FieldDateMath' + _common.aggregations:DerivativeAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + properties: + normalized_value: + type: number + normalized_value_as_string: + type: string + _common.aggregations:DerivativeAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + _common.aggregations:DiversifiedSamplerAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + execution_hint: + $ref: '#/components/schemas/_common.aggregations:SamplerAggregationExecutionHint' + max_docs_per_value: + description: Limits how many documents are permitted per choice of de-duplicating value. + type: number + script: + $ref: '#/components/schemas/_common:Script' + shard_size: + description: Limits how many top-scoring documents are collected in the sample processed on each shard. + type: number + field: + $ref: '#/components/schemas/_common:Field' + _common.aggregations:DoubleTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:TermsAggregateBaseDoubleTermsBucket' + - type: object + _common.aggregations:DoubleTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:TermsBucketBase' + - type: object + properties: + key: + type: number + key_as_string: + type: string + required: + - key + _common.aggregations:EwmaModelSettings: + type: object + properties: + alpha: + type: number + _common.aggregations:EwmaMovingAverageAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MovingAverageAggregationBase' + - type: object + properties: + model: + type: string + enum: + - ewma + settings: + $ref: '#/components/schemas/_common.aggregations:EwmaModelSettings' + required: + - model + - settings + _common.aggregations:ExtendedBoundsFieldDateMath: + type: object + properties: + max: + $ref: '#/components/schemas/_common.aggregations:FieldDateMath' + min: + $ref: '#/components/schemas/_common.aggregations:FieldDateMath' + required: + - max + - min + _common.aggregations:ExtendedBoundsdouble: + type: object + properties: + max: + description: Maximum value for the bound. + type: number + min: + description: Minimum value for the bound. + type: number + required: + - max + - min + _common.aggregations:ExtendedStatsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:StatsAggregate' + - type: object + properties: + sum_of_squares: + oneOf: + - type: number + - nullable: true + type: string + variance: + oneOf: + - type: number + - nullable: true + type: string + variance_population: + oneOf: + - type: number + - nullable: true + type: string + variance_sampling: + oneOf: + - type: number + - nullable: true + type: string + std_deviation: + oneOf: + - type: number + - nullable: true + type: string + std_deviation_population: + oneOf: + - type: number + - nullable: true + type: string + std_deviation_sampling: + oneOf: + - type: number + - nullable: true + type: string + std_deviation_bounds: + $ref: '#/components/schemas/_common.aggregations:StandardDeviationBounds' + sum_of_squares_as_string: + type: string + variance_as_string: + type: string + variance_population_as_string: + type: string + variance_sampling_as_string: + type: string + std_deviation_as_string: + type: string + std_deviation_bounds_as_string: + $ref: '#/components/schemas/_common.aggregations:StandardDeviationBoundsAsString' + required: + - sum_of_squares + - variance + - variance_population + - variance_sampling + - std_deviation + - std_deviation_population + - std_deviation_sampling + _common.aggregations:ExtendedStatsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + properties: + sigma: + description: The number of standard deviations above/below the mean to display. + type: number + _common.aggregations:ExtendedStatsBucketAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:ExtendedStatsAggregate' + - type: object + _common.aggregations:ExtendedStatsBucketAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + sigma: + description: The number of standard deviations above/below the mean to display. + type: number + _common.aggregations:FieldDateMath: + description: |- + A date range limit, represented either as a DateMath expression or a number expressed + according to the target field's precision. + oneOf: + - $ref: '#/components/schemas/_common:DateMath' + - type: number + _common.aggregations:FilterAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:FiltersAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseFiltersBucket' + - type: object + _common.aggregations:FiltersAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + filters: + $ref: '#/components/schemas/_common.aggregations:BucketsQueryContainer' + other_bucket: + description: Set to `true` to add a bucket to the response which will contain all documents that do not match any of the given filters. + type: boolean + other_bucket_key: + description: The key with which the other bucket is returned. + type: string + keyed: + description: |- + By default, the named filters aggregation returns the buckets as an object. + Set to `false` to return the buckets as an array of objects. + type: boolean + _common.aggregations:FiltersBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + _common.aggregations:FormatMetricAggregationBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + format: + type: string + _common.aggregations:FormattableMetricAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + format: + type: string + _common.aggregations:FrequentItemSetsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseFrequentItemSetsBucket' + - type: object + _common.aggregations:FrequentItemSetsAggregation: + type: object + properties: + fields: + description: Fields to analyze. + type: array + items: + $ref: '#/components/schemas/_common.aggregations:FrequentItemSetsField' + minimum_set_size: + description: The minimum size of one item set. + type: number + minimum_support: + description: The minimum support of one item set. + type: number + size: + description: The number of top item sets to return. + type: number + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + required: + - fields + _common.aggregations:FrequentItemSetsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + type: object + additionalProperties: + type: array + items: + type: string + support: + type: number + required: + - key + - support + _common.aggregations:FrequentItemSetsField: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + exclude: + $ref: '#/components/schemas/_common.aggregations:TermsExclude' + include: + $ref: '#/components/schemas/_common.aggregations:TermsInclude' + required: + - field + _common.aggregations:GapPolicy: + type: string + enum: + - skip + - insert_zeros + - keep_values + _common.aggregations:GeoBoundsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + bounds: + $ref: '#/components/schemas/_common:GeoBounds' + _common.aggregations:GeoBoundsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + wrap_longitude: + description: Specifies whether the bounding box should be allowed to overlap the international date line. + type: boolean + _common.aggregations:GeoCentroidAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + count: + type: number + location: + $ref: '#/components/schemas/_common:GeoLocation' + required: + - count + _common.aggregations:GeoCentroidAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + count: + type: number + location: + $ref: '#/components/schemas/_common:GeoLocation' + _common.aggregations:GeoDistanceAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:RangeAggregate' + - type: object + _common.aggregations:GeoDistanceAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + distance_type: + $ref: '#/components/schemas/_common:GeoDistanceType' + field: + $ref: '#/components/schemas/_common:Field' + origin: + $ref: '#/components/schemas/_common:GeoLocation' + ranges: + description: An array of ranges used to bucket documents. + type: array + items: + $ref: '#/components/schemas/_common.aggregations:AggregationRange' + unit: + $ref: '#/components/schemas/_common:DistanceUnit' + _common.aggregations:GeoHashGridAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseGeoHashGridBucket' + - type: object + _common.aggregations:GeoHashGridAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + bounds: + $ref: '#/components/schemas/_common:GeoBounds' + field: + $ref: '#/components/schemas/_common:Field' + precision: + $ref: '#/components/schemas/_common:GeoHashPrecision' + shard_size: + description: |- + Allows for more accurate counting of the top cells returned in the final result the aggregation. + Defaults to returning `max(10,(size x number-of-shards))` buckets from each shard. + type: number + size: + description: The maximum number of geohash buckets to return. + type: number + _common.aggregations:GeoHashGridBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + $ref: '#/components/schemas/_common:GeoHash' + required: + - key + _common.aggregations:GeoHexGridAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseGeoHexGridBucket' + - type: object + _common.aggregations:GeoHexGridBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + $ref: '#/components/schemas/_common:GeoHexCell' + required: + - key + _common.aggregations:GeoLineAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + type: + type: string + geometry: + $ref: '#/components/schemas/_common:GeoLine' + properties: + type: object + required: + - type + - geometry + - properties + _common.aggregations:GeoLineAggregation: + type: object + properties: + point: + $ref: '#/components/schemas/_common.aggregations:GeoLinePoint' + sort: + $ref: '#/components/schemas/_common.aggregations:GeoLineSort' + include_sort: + description: When `true`, returns an additional array of the sort values in the feature properties. + type: boolean + sort_order: + $ref: '#/components/schemas/_common:SortOrder' + size: + description: |- + The maximum length of the line represented in the aggregation. + Valid sizes are between 1 and 10000. + type: number + required: + - point + - sort + _common.aggregations:GeoLinePoint: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + required: + - field + _common.aggregations:GeoLineSort: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + required: + - field + _common.aggregations:GeoTileGridAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseGeoTileGridBucket' + - type: object + _common.aggregations:GeoTileGridAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + precision: + $ref: '#/components/schemas/_common:GeoTilePrecision' + shard_size: + description: |- + Allows for more accurate counting of the top cells returned in the final result the aggregation. + Defaults to returning `max(10,(size x number-of-shards))` buckets from each shard. + type: number + size: + description: The maximum number of buckets to return. + type: number + bounds: + $ref: '#/components/schemas/_common:GeoBounds' + _common.aggregations:GeoTileGridBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + $ref: '#/components/schemas/_common:GeoTile' + required: + - key + _common.aggregations:GeohexGridAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + precision: + description: |- + Integer zoom of the key used to defined cells or buckets + in the results. Value should be between 0-15. + type: number + bounds: + $ref: '#/components/schemas/_common:GeoBounds' + size: + description: Maximum number of buckets to return. + type: number + shard_size: + description: Number of buckets returned from each shard. + type: number + required: + - field + _common.aggregations:GlobalAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:GlobalAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + _common.aggregations:GoogleNormalizedDistanceHeuristic: + type: object + properties: + background_is_superset: + description: Set to `false` if you defined a custom background filter that represents a different set of documents that you want to compare to. + type: boolean + _common.aggregations:HdrMethod: + type: object + properties: + number_of_significant_value_digits: + description: Specifies the resolution of values for the histogram in number of significant digits. + type: number + _common.aggregations:HdrPercentileRanksAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PercentilesAggregateBase' + - type: object + _common.aggregations:HdrPercentilesAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PercentilesAggregateBase' + - type: object + _common.aggregations:HistogramAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseHistogramBucket' + - type: object + _common.aggregations:HistogramAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + extended_bounds: + $ref: '#/components/schemas/_common.aggregations:ExtendedBoundsdouble' + hard_bounds: + $ref: '#/components/schemas/_common.aggregations:ExtendedBoundsdouble' + field: + $ref: '#/components/schemas/_common:Field' + interval: + description: |- + The interval for the buckets. + Must be a positive decimal. + type: number + min_doc_count: + description: |- + Only returns buckets that have `min_doc_count` number of documents. + By default, the response will fill gaps in the histogram with empty buckets. + type: number + missing: + description: |- + The value to apply to documents that do not have a value. + By default, documents without a value are ignored. + type: number + offset: + description: |- + By default, the bucket keys start with 0 and then continue in even spaced steps of `interval`. + The bucket boundaries can be shifted by using the `offset` option. + type: number + order: + $ref: '#/components/schemas/_common.aggregations:AggregateOrder' + script: + $ref: '#/components/schemas/_common:Script' + format: + type: string + keyed: + description: If `true`, returns buckets as a hash instead of an array, keyed by the bucket keys. + type: boolean + _common.aggregations:HistogramBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key_as_string: + type: string + key: + type: number + required: + - key + _common.aggregations:HoltLinearModelSettings: + type: object + properties: + alpha: + type: number + beta: + type: number + _common.aggregations:HoltMovingAverageAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MovingAverageAggregationBase' + - type: object + properties: + model: + type: string + enum: + - holt + settings: + $ref: '#/components/schemas/_common.aggregations:HoltLinearModelSettings' + required: + - model + - settings + _common.aggregations:HoltWintersModelSettings: + type: object + properties: + alpha: + type: number + beta: + type: number + gamma: + type: number + pad: + type: boolean + period: + type: number + type: + $ref: '#/components/schemas/_common.aggregations:HoltWintersType' + _common.aggregations:HoltWintersMovingAverageAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MovingAverageAggregationBase' + - type: object + properties: + model: + type: string + enum: + - holt_winters + settings: + $ref: '#/components/schemas/_common.aggregations:HoltWintersModelSettings' + required: + - model + - settings + _common.aggregations:HoltWintersType: + type: string + enum: + - add + - mult + _common.aggregations:InferenceAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + value: + $ref: '#/components/schemas/_common:FieldValue' + feature_importance: + type: array + items: + $ref: '#/components/schemas/_common.aggregations:InferenceFeatureImportance' + top_classes: + type: array + items: + $ref: '#/components/schemas/_common.aggregations:InferenceTopClassEntry' + warning: + type: string + _common.aggregations:InferenceAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + model_id: + $ref: '#/components/schemas/_common:Name' + inference_config: + $ref: '#/components/schemas/_common.aggregations:InferenceConfigContainer' + required: + - model_id + _common.aggregations:InferenceClassImportance: + type: object + properties: + class_name: + type: string + importance: + type: number + required: + - class_name + - importance + _common.aggregations:InferenceConfigContainer: + type: object + properties: + regression: + $ref: '#/components/schemas/_common.aggregations:RegressionInferenceOptions' + classification: + $ref: '#/components/schemas/_common.aggregations:ClassificationInferenceOptions' + minProperties: 1 + maxProperties: 1 + _common.aggregations:InferenceFeatureImportance: + type: object + properties: + feature_name: + type: string + importance: + type: number + classes: + type: array + items: + $ref: '#/components/schemas/_common.aggregations:InferenceClassImportance' + required: + - feature_name + _common.aggregations:InferenceTopClassEntry: + type: object + properties: + class_name: + $ref: '#/components/schemas/_common:FieldValue' + class_probability: + type: number + class_score: + type: number + required: + - class_name + - class_probability + - class_score + _common.aggregations:IpPrefixAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseIpPrefixBucket' + - type: object + _common.aggregations:IpPrefixAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + prefix_length: + description: |- + Length of the network prefix. For IPv4 addresses the accepted range is [0, 32]. + For IPv6 addresses the accepted range is [0, 128]. + type: number + is_ipv6: + description: Defines whether the prefix applies to IPv6 addresses. + type: boolean + append_prefix_length: + description: Defines whether the prefix length is appended to IP address keys in the response. + type: boolean + keyed: + description: Defines whether buckets are returned as a hash rather than an array in the response. + type: boolean + min_doc_count: + description: Minimum number of documents in a bucket for it to be included in the response. + type: number + required: + - field + - prefix_length + _common.aggregations:IpPrefixBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + is_ipv6: + type: boolean + key: + type: string + prefix_length: + type: number + netmask: + type: string + required: + - is_ipv6 + - key + - prefix_length + _common.aggregations:IpRangeAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseIpRangeBucket' + - type: object + _common.aggregations:IpRangeAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ranges: + description: Array of IP ranges. + type: array + items: + $ref: '#/components/schemas/_common.aggregations:IpRangeAggregationRange' + _common.aggregations:IpRangeAggregationRange: + type: object + properties: + from: + description: Start of the range. + oneOf: + - type: string + - nullable: true + type: string + mask: + description: IP range defined as a CIDR mask. + type: string + to: + description: End of the range. + oneOf: + - type: string + - nullable: true + type: string + _common.aggregations:IpRangeBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + type: string + from: + type: string + to: + type: string + _common.aggregations:KeyedPercentiles: + type: object + additionalProperties: + oneOf: + - type: string + - type: number + - nullable: true + type: string + _common.aggregations:LinearMovingAverageAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MovingAverageAggregationBase' + - type: object + properties: + model: + type: string + enum: + - linear + settings: + $ref: '#/components/schemas/_common:EmptyObject' + required: + - model + - settings + _common.aggregations:LongRareTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseLongRareTermsBucket' + - type: object + _common.aggregations:LongRareTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + type: number + key_as_string: + type: string + required: + - key + _common.aggregations:LongTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:TermsAggregateBaseLongTermsBucket' + - type: object + _common.aggregations:LongTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:TermsBucketBase' + - type: object + properties: + key: + type: number + key_as_string: + type: string + required: + - key + _common.aggregations:MatrixAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:Aggregation' + - type: object + properties: + fields: + $ref: '#/components/schemas/_common:Fields' + missing: + description: |- + The value to apply to documents that do not have a value. + By default, documents without a value are ignored. + type: object + additionalProperties: + type: number + _common.aggregations:MatrixStatsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + doc_count: + type: number + fields: + type: array + items: + $ref: '#/components/schemas/_common.aggregations:MatrixStatsFields' + required: + - doc_count + _common.aggregations:MatrixStatsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MatrixAggregation' + - type: object + properties: + mode: + $ref: '#/components/schemas/_common:SortMode' + _common.aggregations:MatrixStatsFields: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Field' + count: + type: number + mean: + type: number + variance: + type: number + skewness: + type: number + kurtosis: + type: number + covariance: + type: object + additionalProperties: + type: number + correlation: + type: object + additionalProperties: + type: number + required: + - name + - count + - mean + - variance + - skewness + - kurtosis + - covariance + - correlation + _common.aggregations:MaxAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + _common.aggregations:MaxAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + _common.aggregations:MaxBucketAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + _common.aggregations:MedianAbsoluteDeviationAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + _common.aggregations:MedianAbsoluteDeviationAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + properties: + compression: + description: Limits the maximum number of nodes used by the underlying TDigest algorithm to `20 * compression`, enabling control of memory usage and approximation error. + type: number + _common.aggregations:MetricAggregationBase: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + missing: + $ref: '#/components/schemas/_common.aggregations:Missing' + script: + $ref: '#/components/schemas/_common:Script' + _common.aggregations:MinAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + _common.aggregations:MinAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + _common.aggregations:MinBucketAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + _common.aggregations:MinimumInterval: + type: string + enum: + - second + - minute + - hour + - day + - month + - year + _common.aggregations:Missing: + oneOf: + - type: string + - type: number + - type: number + - type: boolean + _common.aggregations:MissingAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:MissingAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + missing: + $ref: '#/components/schemas/_common.aggregations:Missing' + _common.aggregations:MissingOrder: + type: string + enum: + - first + - last + - default + _common.aggregations:MovingAverageAggregation: + discriminator: + propertyName: model + oneOf: + - $ref: '#/components/schemas/_common.aggregations:LinearMovingAverageAggregation' + - $ref: '#/components/schemas/_common.aggregations:SimpleMovingAverageAggregation' + - $ref: '#/components/schemas/_common.aggregations:EwmaMovingAverageAggregation' + - $ref: '#/components/schemas/_common.aggregations:HoltMovingAverageAggregation' + - $ref: '#/components/schemas/_common.aggregations:HoltWintersMovingAverageAggregation' + _common.aggregations:MovingAverageAggregationBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + minimize: + type: boolean + predict: + type: number + window: + type: number + _common.aggregations:MovingFunctionAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + script: + description: The script that should be executed on each window of data. + type: string + shift: + description: |- + By default, the window consists of the last n values excluding the current bucket. + Increasing `shift` by 1, moves the starting window position by 1 to the right. + type: number + window: + description: The size of window to "slide" across the histogram. + type: number + _common.aggregations:MovingPercentilesAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + window: + description: The size of window to "slide" across the histogram. + type: number + shift: + description: |- + By default, the window consists of the last n values excluding the current bucket. + Increasing `shift` by 1, moves the starting window position by 1 to the right. + type: number + keyed: + type: boolean + _common.aggregations:MultiBucketAggregateBaseAdjacencyMatrixBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsAdjacencyMatrixBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseCompositeBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsCompositeBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseDateHistogramBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsDateHistogramBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseDoubleTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsDoubleTermsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseFiltersBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsFiltersBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseFrequentItemSetsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsFrequentItemSetsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseGeoHashGridBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsGeoHashGridBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseGeoHexGridBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsGeoHexGridBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseGeoTileGridBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsGeoTileGridBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseHistogramBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsHistogramBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseIpPrefixBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsIpPrefixBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseIpRangeBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsIpRangeBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseLongRareTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsLongRareTermsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseLongTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsLongTermsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseMultiTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsMultiTermsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseRangeBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsRangeBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseSignificantLongTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsSignificantLongTermsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseSignificantStringTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsSignificantStringTermsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseStringRareTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsStringRareTermsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseStringTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsStringTermsBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseVariableWidthHistogramBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsVariableWidthHistogramBucket' + required: + - buckets + _common.aggregations:MultiBucketAggregateBaseVoid: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + buckets: + $ref: '#/components/schemas/_common.aggregations:BucketsVoid' + required: + - buckets + _common.aggregations:MultiBucketBase: + type: object + properties: + doc_count: + type: number + required: + - doc_count + _common.aggregations:MultiTermLookup: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + missing: + $ref: '#/components/schemas/_common.aggregations:Missing' + required: + - field + _common.aggregations:MultiTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:TermsAggregateBaseMultiTermsBucket' + - type: object + _common.aggregations:MultiTermsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + collect_mode: + $ref: '#/components/schemas/_common.aggregations:TermsAggregationCollectMode' + order: + $ref: '#/components/schemas/_common.aggregations:AggregateOrder' + min_doc_count: + description: The minimum number of documents in a bucket for it to be returned. + type: number + shard_min_doc_count: + description: The minimum number of documents in a bucket on each shard for it to be returned. + type: number + shard_size: + description: |- + The number of candidate terms produced by each shard. + By default, `shard_size` will be automatically estimated based on the number of shards and the `size` parameter. + type: number + show_term_doc_count_error: + description: Calculates the doc count error on per term basis. + type: boolean + size: + description: The number of term buckets should be returned out of the overall terms list. + type: number + terms: + description: The field from which to generate sets of terms. + type: array + items: + $ref: '#/components/schemas/_common.aggregations:MultiTermLookup' + required: + - terms + _common.aggregations:MultiTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + type: array + items: + $ref: '#/components/schemas/_common:FieldValue' + key_as_string: + type: string + doc_count_error_upper_bound: + type: number + required: + - key + _common.aggregations:MutualInformationHeuristic: + type: object + properties: + background_is_superset: + description: Set to `false` if you defined a custom background filter that represents a different set of documents that you want to compare to. + type: boolean + include_negatives: + description: Set to `false` to filter out the terms that appear less often in the subset than in documents outside the subset. + type: boolean + _common.aggregations:NestedAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:NestedAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + path: + $ref: '#/components/schemas/_common:Field' + _common.aggregations:NormalizeAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + method: + $ref: '#/components/schemas/_common.aggregations:NormalizeMethod' + _common.aggregations:NormalizeMethod: + type: string + enum: + - rescale_0_1 + - rescale_0_100 + - percent_of_sum + - mean + - z-score + - softmax + _common.aggregations:ParentAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:ParentAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + type: + $ref: '#/components/schemas/_common:RelationName' + _common.aggregations:PercentageScoreHeuristic: + type: object + _common.aggregations:PercentileRanksAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + properties: + keyed: + description: |- + By default, the aggregation associates a unique string key with each bucket and returns the ranges as a hash rather than an array. + Set to `false` to disable this behavior. + type: boolean + values: + description: An array of values for which to calculate the percentile ranks. + oneOf: + - type: array + items: + type: number + - nullable: true + type: string + hdr: + $ref: '#/components/schemas/_common.aggregations:HdrMethod' + tdigest: + $ref: '#/components/schemas/_common.aggregations:TDigest' + _common.aggregations:Percentiles: + oneOf: + - $ref: '#/components/schemas/_common.aggregations:KeyedPercentiles' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:ArrayPercentilesItem' + _common.aggregations:PercentilesAggregateBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + values: + $ref: '#/components/schemas/_common.aggregations:Percentiles' + required: + - values + _common.aggregations:PercentilesAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + properties: + keyed: + description: |- + By default, the aggregation associates a unique string key with each bucket and returns the ranges as a hash rather than an array. + Set to `false` to disable this behavior. + type: boolean + percents: + description: The percentiles to calculate. + type: array + items: + type: number + hdr: + $ref: '#/components/schemas/_common.aggregations:HdrMethod' + tdigest: + $ref: '#/components/schemas/_common.aggregations:TDigest' + _common.aggregations:PercentilesBucketAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PercentilesAggregateBase' + - type: object + _common.aggregations:PercentilesBucketAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + percents: + description: The list of percentiles to calculate. + type: array + items: + type: number + _common.aggregations:PipelineAggregationBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketPathAggregation' + - type: object + properties: + format: + description: |- + `DecimalFormat` pattern for the output value. + If specified, the formatted value is returned in the aggregation’s `value_as_string` property. + type: string + gap_policy: + $ref: '#/components/schemas/_common.aggregations:GapPolicy' + _common.aggregations:RangeAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseRangeBucket' + - type: object + _common.aggregations:RangeAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + missing: + description: |- + The value to apply to documents that do not have a value. + By default, documents without a value are ignored. + type: number + ranges: + description: An array of ranges used to bucket documents. + type: array + items: + $ref: '#/components/schemas/_common.aggregations:AggregationRange' + script: + $ref: '#/components/schemas/_common:Script' + keyed: + description: Set to `true` to associate a unique string key with each bucket and return the ranges as a hash rather than an array. + type: boolean + format: + type: string + _common.aggregations:RangeBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + from: + type: number + to: + type: number + from_as_string: + type: string + to_as_string: + type: string + key: + description: The bucket key. Present if the aggregation is _not_ keyed + type: string + _common.aggregations:RareTermsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + exclude: + $ref: '#/components/schemas/_common.aggregations:TermsExclude' + field: + $ref: '#/components/schemas/_common:Field' + include: + $ref: '#/components/schemas/_common.aggregations:TermsInclude' + max_doc_count: + description: The maximum number of documents a term should appear in. + type: number + missing: + $ref: '#/components/schemas/_common.aggregations:Missing' + precision: + description: |- + The precision of the internal CuckooFilters. + Smaller precision leads to better approximation, but higher memory usage. + type: number + value_type: + type: string + _common.aggregations:RateAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + value: + type: number + value_as_string: + type: string + required: + - value + _common.aggregations:RateAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + properties: + unit: + $ref: '#/components/schemas/_common.aggregations:CalendarInterval' + mode: + $ref: '#/components/schemas/_common.aggregations:RateMode' + _common.aggregations:RateMode: + type: string + enum: + - sum + - value_count + _common.aggregations:RegressionInferenceOptions: + type: object + properties: + results_field: + $ref: '#/components/schemas/_common:Field' + num_top_feature_importance_values: + description: Specifies the maximum number of feature importance values per document. + type: number + _common.aggregations:ReverseNestedAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:ReverseNestedAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + path: + $ref: '#/components/schemas/_common:Field' + _common.aggregations:SamplerAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:SamplerAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + shard_size: + description: Limits how many top-scoring documents are collected in the sample processed on each shard. + type: number + _common.aggregations:SamplerAggregationExecutionHint: + type: string + enum: + - map + - global_ordinals + - bytes_hash + _common.aggregations:ScriptedHeuristic: + type: object + properties: + script: + $ref: '#/components/schemas/_common:Script' + required: + - script + _common.aggregations:ScriptedMetricAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + value: + type: object + required: + - value + _common.aggregations:ScriptedMetricAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + combine_script: + $ref: '#/components/schemas/_common:Script' + init_script: + $ref: '#/components/schemas/_common:Script' + map_script: + $ref: '#/components/schemas/_common:Script' + params: + description: |- + A global object with script parameters for `init`, `map` and `combine` scripts. + It is shared between the scripts. + type: object + additionalProperties: + type: object + reduce_script: + $ref: '#/components/schemas/_common:Script' + _common.aggregations:SerialDifferencingAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + properties: + lag: + description: |- + The historical bucket to subtract from the current value. + Must be a positive, non-zero integer. + type: number + _common.aggregations:SignificantLongTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SignificantTermsAggregateBaseSignificantLongTermsBucket' + - type: object + _common.aggregations:SignificantLongTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SignificantTermsBucketBase' + - type: object + properties: + key: + type: number + key_as_string: + type: string + required: + - key + _common.aggregations:SignificantStringTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SignificantTermsAggregateBaseSignificantStringTermsBucket' + - type: object + _common.aggregations:SignificantStringTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SignificantTermsBucketBase' + - type: object + properties: + key: + type: string + required: + - key + _common.aggregations:SignificantTermsAggregateBaseSignificantLongTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseSignificantLongTermsBucket' + - type: object + properties: + bg_count: + type: number + doc_count: + type: number + _common.aggregations:SignificantTermsAggregateBaseSignificantStringTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseSignificantStringTermsBucket' + - type: object + properties: + bg_count: + type: number + doc_count: + type: number + _common.aggregations:SignificantTermsAggregateBaseVoid: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseVoid' + - type: object + properties: + bg_count: + type: number + doc_count: + type: number + _common.aggregations:SignificantTermsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + background_filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + chi_square: + $ref: '#/components/schemas/_common.aggregations:ChiSquareHeuristic' + exclude: + $ref: '#/components/schemas/_common.aggregations:TermsExclude' + execution_hint: + $ref: '#/components/schemas/_common.aggregations:TermsAggregationExecutionHint' + field: + $ref: '#/components/schemas/_common:Field' + gnd: + $ref: '#/components/schemas/_common.aggregations:GoogleNormalizedDistanceHeuristic' + include: + $ref: '#/components/schemas/_common.aggregations:TermsInclude' + jlh: + $ref: '#/components/schemas/_common:EmptyObject' + min_doc_count: + description: Only return terms that are found in more than `min_doc_count` hits. + type: number + mutual_information: + $ref: '#/components/schemas/_common.aggregations:MutualInformationHeuristic' + percentage: + $ref: '#/components/schemas/_common.aggregations:PercentageScoreHeuristic' + script_heuristic: + $ref: '#/components/schemas/_common.aggregations:ScriptedHeuristic' + shard_min_doc_count: + description: |- + Regulates the certainty a shard has if the term should actually be added to the candidate list or not with respect to the `min_doc_count`. + Terms will only be considered if their local shard frequency within the set is higher than the `shard_min_doc_count`. + type: number + shard_size: + description: |- + Can be used to control the volumes of candidate terms produced by each shard. + By default, `shard_size` will be automatically estimated based on the number of shards and the `size` parameter. + type: number + size: + description: The number of buckets returned out of the overall terms list. + type: number + _common.aggregations:SignificantTermsBucketBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + score: + type: number + bg_count: + type: number + required: + - score + - bg_count + _common.aggregations:SignificantTextAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + background_filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + chi_square: + $ref: '#/components/schemas/_common.aggregations:ChiSquareHeuristic' + exclude: + $ref: '#/components/schemas/_common.aggregations:TermsExclude' + execution_hint: + $ref: '#/components/schemas/_common.aggregations:TermsAggregationExecutionHint' + field: + $ref: '#/components/schemas/_common:Field' + filter_duplicate_text: + description: Whether to out duplicate text to deal with noisy data. + type: boolean + gnd: + $ref: '#/components/schemas/_common.aggregations:GoogleNormalizedDistanceHeuristic' + include: + $ref: '#/components/schemas/_common.aggregations:TermsInclude' + jlh: + $ref: '#/components/schemas/_common:EmptyObject' + min_doc_count: + description: Only return values that are found in more than `min_doc_count` hits. + type: number + mutual_information: + $ref: '#/components/schemas/_common.aggregations:MutualInformationHeuristic' + percentage: + $ref: '#/components/schemas/_common.aggregations:PercentageScoreHeuristic' + script_heuristic: + $ref: '#/components/schemas/_common.aggregations:ScriptedHeuristic' + shard_min_doc_count: + description: |- + Regulates the certainty a shard has if the values should actually be added to the candidate list or not with respect to the min_doc_count. + Values will only be considered if their local shard frequency within the set is higher than the `shard_min_doc_count`. + type: number + shard_size: + description: |- + The number of candidate terms produced by each shard. + By default, `shard_size` will be automatically estimated based on the number of shards and the `size` parameter. + type: number + size: + description: The number of buckets returned out of the overall terms list. + type: number + source_fields: + $ref: '#/components/schemas/_common:Fields' + _common.aggregations:SimpleMovingAverageAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MovingAverageAggregationBase' + - type: object + properties: + model: + type: string + enum: + - simple + settings: + $ref: '#/components/schemas/_common:EmptyObject' + required: + - model + - settings + _common.aggregations:SimpleValueAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + _common.aggregations:SingleBucketAggregateBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + doc_count: + type: number + required: + - doc_count + _common.aggregations:SingleMetricAggregateBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + value: + description: |- + The metric value. A missing value generally means that there was no data to aggregate, + unless specified otherwise. + oneOf: + - type: number + - nullable: true + type: string + value_as_string: + type: string + required: + - value + _common.aggregations:StandardDeviationBounds: + type: object + properties: + upper: + oneOf: + - type: number + - nullable: true + type: string + lower: + oneOf: + - type: number + - nullable: true + type: string + upper_population: + oneOf: + - type: number + - nullable: true + type: string + lower_population: + oneOf: + - type: number + - nullable: true + type: string + upper_sampling: + oneOf: + - type: number + - nullable: true + type: string + lower_sampling: + oneOf: + - type: number + - nullable: true + type: string + required: + - upper + - lower + - upper_population + - lower_population + - upper_sampling + - lower_sampling + _common.aggregations:StandardDeviationBoundsAsString: + type: object + properties: + upper: + type: string + lower: + type: string + upper_population: + type: string + lower_population: + type: string + upper_sampling: + type: string + lower_sampling: + type: string + required: + - upper + - lower + - upper_population + - lower_population + - upper_sampling + - lower_sampling + _common.aggregations:StatsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + count: + type: number + min: + oneOf: + - type: number + - nullable: true + type: string + max: + oneOf: + - type: number + - nullable: true + type: string + avg: + oneOf: + - type: number + - nullable: true + type: string + sum: + type: number + min_as_string: + type: string + max_as_string: + type: string + avg_as_string: + type: string + sum_as_string: + type: string + required: + - count + - min + - max + - avg + - sum + _common.aggregations:StatsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + _common.aggregations:StatsBucketAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:StatsAggregate' + - type: object + _common.aggregations:StatsBucketAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + _common.aggregations:StringRareTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseStringRareTermsBucket' + - type: object + _common.aggregations:StringRareTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + key: + type: string + required: + - key + _common.aggregations:StringStatsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + count: + type: number + min_length: + oneOf: + - type: number + - nullable: true + type: string + max_length: + oneOf: + - type: number + - nullable: true + type: string + avg_length: + oneOf: + - type: number + - nullable: true + type: string + entropy: + oneOf: + - type: number + - nullable: true + type: string + distribution: + oneOf: + - type: object + additionalProperties: + type: number + - nullable: true + type: string + min_length_as_string: + type: string + max_length_as_string: + type: string + avg_length_as_string: + type: string + required: + - count + - min_length + - max_length + - avg_length + - entropy + _common.aggregations:StringStatsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + show_distribution: + description: Shows the probability distribution for all characters. + type: boolean + _common.aggregations:StringTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:TermsAggregateBaseStringTermsBucket' + - type: object + _common.aggregations:StringTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:TermsBucketBase' + - type: object + properties: + key: + $ref: '#/components/schemas/_common:FieldValue' + required: + - key + _common.aggregations:SumAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + _common.aggregations:SumAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormatMetricAggregationBase' + - type: object + _common.aggregations:SumBucketAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PipelineAggregationBase' + - type: object + _common.aggregations:TDigest: + type: object + properties: + compression: + description: Limits the maximum number of nodes used by the underlying TDigest algorithm to `20 * compression`, enabling control of memory usage and approximation error. + type: number + _common.aggregations:TDigestPercentileRanksAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PercentilesAggregateBase' + - type: object + _common.aggregations:TDigestPercentilesAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:PercentilesAggregateBase' + - type: object + _common.aggregations:TTestAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + value: + oneOf: + - type: number + - nullable: true + type: string + value_as_string: + type: string + required: + - value + _common.aggregations:TTestAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:Aggregation' + - type: object + properties: + a: + $ref: '#/components/schemas/_common.aggregations:TestPopulation' + b: + $ref: '#/components/schemas/_common.aggregations:TestPopulation' + type: + $ref: '#/components/schemas/_common.aggregations:TTestType' + _common.aggregations:TTestType: + type: string + enum: + - paired + - homoscedastic + - heteroscedastic + _common.aggregations:TermsAggregateBaseDoubleTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseDoubleTermsBucket' + - type: object + properties: + doc_count_error_upper_bound: + type: number + sum_other_doc_count: + type: number + _common.aggregations:TermsAggregateBaseLongTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseLongTermsBucket' + - type: object + properties: + doc_count_error_upper_bound: + type: number + sum_other_doc_count: + type: number + _common.aggregations:TermsAggregateBaseMultiTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseMultiTermsBucket' + - type: object + properties: + doc_count_error_upper_bound: + type: number + sum_other_doc_count: + type: number + _common.aggregations:TermsAggregateBaseStringTermsBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseStringTermsBucket' + - type: object + properties: + doc_count_error_upper_bound: + type: number + sum_other_doc_count: + type: number + _common.aggregations:TermsAggregateBaseVoid: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseVoid' + - type: object + properties: + doc_count_error_upper_bound: + type: number + sum_other_doc_count: + type: number + _common.aggregations:TermsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:BucketAggregationBase' + - type: object + properties: + collect_mode: + $ref: '#/components/schemas/_common.aggregations:TermsAggregationCollectMode' + exclude: + $ref: '#/components/schemas/_common.aggregations:TermsExclude' + execution_hint: + $ref: '#/components/schemas/_common.aggregations:TermsAggregationExecutionHint' + field: + $ref: '#/components/schemas/_common:Field' + include: + $ref: '#/components/schemas/_common.aggregations:TermsInclude' + min_doc_count: + description: Only return values that are found in more than `min_doc_count` hits. + type: number + missing: + $ref: '#/components/schemas/_common.aggregations:Missing' + missing_order: + $ref: '#/components/schemas/_common.aggregations:MissingOrder' + missing_bucket: + type: boolean + value_type: + description: Coerced unmapped fields into the specified type. + type: string + order: + $ref: '#/components/schemas/_common.aggregations:AggregateOrder' + script: + $ref: '#/components/schemas/_common:Script' + shard_size: + description: |- + The number of candidate terms produced by each shard. + By default, `shard_size` will be automatically estimated based on the number of shards and the `size` parameter. + type: number + show_term_doc_count_error: + description: Set to `true` to return the `doc_count_error_upper_bound`, which is an upper bound to the error on the `doc_count` returned by each shard. + type: boolean + size: + description: The number of buckets returned out of the overall terms list. + type: number + format: + type: string + _common.aggregations:TermsAggregationCollectMode: + type: string + enum: + - depth_first + - breadth_first + _common.aggregations:TermsAggregationExecutionHint: + type: string + enum: + - map + - global_ordinals + - global_ordinals_hash + - global_ordinals_low_cardinality + _common.aggregations:TermsBucketBase: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + doc_count_error: + type: number + _common.aggregations:TermsExclude: + oneOf: + - type: string + - type: array + items: + type: string + _common.aggregations:TermsInclude: + oneOf: + - type: string + - type: array + items: + type: string + - $ref: '#/components/schemas/_common.aggregations:TermsPartition' + _common.aggregations:TermsPartition: + type: object + properties: + num_partitions: + description: The number of partitions. + type: number + partition: + description: The partition number for this request. + type: number + required: + - num_partitions + - partition + _common.aggregations:TestPopulation: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + script: + $ref: '#/components/schemas/_common:Script' + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + required: + - field + _common.aggregations:TopHitsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + hits: + $ref: '#/components/schemas/_core.search:HitsMetadata' + required: + - hits + _common.aggregations:TopHitsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + docvalue_fields: + $ref: '#/components/schemas/_common:Fields' + explain: + description: If `true`, returns detailed information about score computation as part of a hit. + type: boolean + from: + description: Starting document offset. + type: number + highlight: + $ref: '#/components/schemas/_core.search:Highlight' + script_fields: + description: Returns the result of one or more script evaluations for each hit. + type: object + additionalProperties: + $ref: '#/components/schemas/_common:ScriptField' + size: + description: The maximum number of top matching hits to return per bucket. + type: number + sort: + $ref: '#/components/schemas/_common:Sort' + _source: + $ref: '#/components/schemas/_core.search:SourceConfig' + stored_fields: + $ref: '#/components/schemas/_common:Fields' + track_scores: + description: If `true`, calculates and returns document scores, even if the scores are not used for sorting. + type: boolean + version: + description: If `true`, returns document version as part of a hit. + type: boolean + seq_no_primary_term: + description: If `true`, returns sequence number and primary term of the last modification of each hit. + type: boolean + _common.aggregations:TopMetrics: + type: object + properties: + sort: + type: array + items: + oneOf: + - $ref: '#/components/schemas/_common:FieldValue' + - nullable: true + type: string + metrics: + type: object + additionalProperties: + oneOf: + - $ref: '#/components/schemas/_common:FieldValue' + - nullable: true + type: string + required: + - sort + - metrics + _common.aggregations:TopMetricsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:AggregateBase' + - type: object + properties: + top: + type: array + items: + $ref: '#/components/schemas/_common.aggregations:TopMetrics' + required: + - top + _common.aggregations:TopMetricsAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MetricAggregationBase' + - type: object + properties: + metrics: + description: The fields of the top document to return. + oneOf: + - $ref: '#/components/schemas/_common.aggregations:TopMetricsValue' + - type: array + items: + $ref: '#/components/schemas/_common.aggregations:TopMetricsValue' + size: + description: The number of top documents from which to return metrics. + type: number + sort: + $ref: '#/components/schemas/_common:Sort' + _common.aggregations:TopMetricsValue: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + required: + - field + _common.aggregations:UnmappedRareTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseVoid' + - type: object + _common.aggregations:UnmappedSamplerAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleBucketAggregateBase' + - type: object + _common.aggregations:UnmappedSignificantTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SignificantTermsAggregateBaseVoid' + - type: object + _common.aggregations:UnmappedTermsAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:TermsAggregateBaseVoid' + - type: object + _common.aggregations:ValueCountAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + _common.aggregations:ValueCountAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:FormattableMetricAggregation' + - type: object + _common.aggregations:ValueType: + type: string + enum: + - string + - long + - double + - number + - date + - date_nanos + - ip + - numeric + - geo_point + - boolean + _common.aggregations:VariableWidthHistogramAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketAggregateBaseVariableWidthHistogramBucket' + - type: object + _common.aggregations:VariableWidthHistogramAggregation: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + buckets: + description: The target number of buckets. + type: number + shard_size: + description: |- + The number of buckets that the coordinating node will request from each shard. + Defaults to `buckets * 50`. + type: number + initial_buffer: + description: |- + Specifies the number of individual documents that will be stored in memory on a shard before the initial bucketing algorithm is run. + Defaults to `min(10 * shard_size, 50000)`. + type: number + _common.aggregations:VariableWidthHistogramBucket: + allOf: + - $ref: '#/components/schemas/_common.aggregations:MultiBucketBase' + - type: object + properties: + min: + type: number + key: + type: number + max: + type: number + min_as_string: + type: string + key_as_string: + type: string + max_as_string: + type: string + required: + - min + - key + - max + _common.aggregations:WeightedAverageAggregation: + allOf: + - $ref: '#/components/schemas/_common.aggregations:Aggregation' + - type: object + properties: + format: + description: A numeric response formatter. + type: string + value: + $ref: '#/components/schemas/_common.aggregations:WeightedAverageValue' + value_type: + $ref: '#/components/schemas/_common.aggregations:ValueType' + weight: + $ref: '#/components/schemas/_common.aggregations:WeightedAverageValue' + _common.aggregations:WeightedAverageValue: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + missing: + description: A value or weight to use if the field is missing. + type: number + script: + $ref: '#/components/schemas/_common:Script' + _common.aggregations:WeightedAvgAggregate: + allOf: + - $ref: '#/components/schemas/_common.aggregations:SingleMetricAggregateBase' + - type: object + _common.analysis:Analyzer: + discriminator: + propertyName: type + oneOf: + - $ref: '#/components/schemas/_common.analysis:CustomAnalyzer' + - $ref: '#/components/schemas/_common.analysis:FingerprintAnalyzer' + - $ref: '#/components/schemas/_common.analysis:KeywordAnalyzer' + - $ref: '#/components/schemas/_common.analysis:LanguageAnalyzer' + - $ref: '#/components/schemas/_common.analysis:NoriAnalyzer' + - $ref: '#/components/schemas/_common.analysis:PatternAnalyzer' + - $ref: '#/components/schemas/_common.analysis:SimpleAnalyzer' + - $ref: '#/components/schemas/_common.analysis:StandardAnalyzer' + - $ref: '#/components/schemas/_common.analysis:StopAnalyzer' + - $ref: '#/components/schemas/_common.analysis:WhitespaceAnalyzer' + - $ref: '#/components/schemas/_common.analysis:IcuAnalyzer' + - $ref: '#/components/schemas/_common.analysis:KuromojiAnalyzer' + - $ref: '#/components/schemas/_common.analysis:SnowballAnalyzer' + - $ref: '#/components/schemas/_common.analysis:DutchAnalyzer' + _common.analysis:AsciiFoldingTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - asciifolding + preserve_original: + $ref: '#/components/schemas/_common:Stringifiedboolean' + required: + - type + _common.analysis:CharFilter: + oneOf: + - type: string + - $ref: '#/components/schemas/_common.analysis:CharFilterDefinition' + _common.analysis:CharFilterBase: + type: object + properties: + version: + $ref: '#/components/schemas/_common:VersionString' + _common.analysis:CharFilterDefinition: + discriminator: + propertyName: type + oneOf: + - $ref: '#/components/schemas/_common.analysis:HtmlStripCharFilter' + - $ref: '#/components/schemas/_common.analysis:MappingCharFilter' + - $ref: '#/components/schemas/_common.analysis:PatternReplaceCharFilter' + - $ref: '#/components/schemas/_common.analysis:IcuNormalizationCharFilter' + - $ref: '#/components/schemas/_common.analysis:KuromojiIterationMarkCharFilter' + _common.analysis:CharGroupTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - char_group + tokenize_on_chars: + type: array + items: + type: string + max_token_length: + type: number + required: + - type + - tokenize_on_chars + _common.analysis:CommonGramsTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - common_grams + common_words: + type: array + items: + type: string + common_words_path: + type: string + ignore_case: + type: boolean + query_mode: + type: boolean + required: + - type + _common.analysis:CompoundWordTokenFilterBase: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + hyphenation_patterns_path: + type: string + max_subword_size: + type: number + min_subword_size: + type: number + min_word_size: + type: number + only_longest_match: + type: boolean + word_list: + type: array + items: + type: string + word_list_path: + type: string + _common.analysis:ConditionTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - condition + filter: + type: array + items: + type: string + script: + $ref: '#/components/schemas/_common:Script' + required: + - type + - filter + - script + _common.analysis:CustomAnalyzer: + type: object + properties: + type: + type: string + enum: + - custom + char_filter: + type: array + items: + type: string + filter: + type: array + items: + type: string + position_increment_gap: + type: number + position_offset_gap: + type: number + tokenizer: + type: string + required: + - type + - tokenizer + _common.analysis:CustomNormalizer: + type: object + properties: + type: + type: string + enum: + - custom + char_filter: + type: array + items: + type: string + filter: + type: array + items: + type: string + required: + - type + _common.analysis:DelimitedPayloadEncoding: + type: string + enum: + - int + - float + - identity + _common.analysis:DelimitedPayloadTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - delimited_payload + delimiter: + type: string + encoding: + $ref: '#/components/schemas/_common.analysis:DelimitedPayloadEncoding' + required: + - type + _common.analysis:DictionaryDecompounderTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:CompoundWordTokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - dictionary_decompounder + required: + - type + _common.analysis:DutchAnalyzer: + type: object + properties: + type: + type: string + enum: + - dutch + stopwords: + $ref: '#/components/schemas/_common.analysis:StopWords' + required: + - type + _common.analysis:EdgeNGramSide: + type: string + enum: + - front + - back + _common.analysis:EdgeNGramTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - edge_ngram + max_gram: + type: number + min_gram: + type: number + side: + $ref: '#/components/schemas/_common.analysis:EdgeNGramSide' + preserve_original: + $ref: '#/components/schemas/_common:Stringifiedboolean' + required: + - type + _common.analysis:EdgeNGramTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - edge_ngram + custom_token_chars: + type: string + max_gram: + type: number + min_gram: + type: number + token_chars: + type: array + items: + $ref: '#/components/schemas/_common.analysis:TokenChar' + required: + - type + - max_gram + - min_gram + - token_chars + _common.analysis:ElisionTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - elision + articles: + type: array + items: + type: string + articles_path: + type: string + articles_case: + $ref: '#/components/schemas/_common:Stringifiedboolean' + required: + - type + _common.analysis:FingerprintAnalyzer: + type: object + properties: + type: + type: string + enum: + - fingerprint + version: + $ref: '#/components/schemas/_common:VersionString' + max_output_size: + type: number + preserve_original: + type: boolean + separator: + type: string + stopwords: + $ref: '#/components/schemas/_common.analysis:StopWords' + stopwords_path: + type: string + required: + - type + - max_output_size + - preserve_original + - separator + _common.analysis:FingerprintTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - fingerprint + max_output_size: + type: number + separator: + type: string + required: + - type + _common.analysis:HtmlStripCharFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:CharFilterBase' + - type: object + properties: + type: + type: string + enum: + - html_strip + required: + - type + _common.analysis:HunspellTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - hunspell + dedup: + type: boolean + dictionary: + type: string + locale: + type: string + longest_only: + type: boolean + required: + - type + - locale + _common.analysis:HyphenationDecompounderTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:CompoundWordTokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - hyphenation_decompounder + required: + - type + _common.analysis:IcuAnalyzer: + type: object + properties: + type: + type: string + enum: + - icu_analyzer + method: + $ref: '#/components/schemas/_common.analysis:IcuNormalizationType' + mode: + $ref: '#/components/schemas/_common.analysis:IcuNormalizationMode' + required: + - type + - method + - mode + _common.analysis:IcuCollationAlternate: + type: string + enum: + - shifted + - non-ignorable + _common.analysis:IcuCollationCaseFirst: + type: string + enum: + - lower + - upper + _common.analysis:IcuCollationDecomposition: + type: string + enum: + - no + - identical + _common.analysis:IcuCollationStrength: + type: string + enum: + - primary + - secondary + - tertiary + - quaternary + - identical + _common.analysis:IcuCollationTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - icu_collation + alternate: + $ref: '#/components/schemas/_common.analysis:IcuCollationAlternate' + caseFirst: + $ref: '#/components/schemas/_common.analysis:IcuCollationCaseFirst' + caseLevel: + type: boolean + country: + type: string + decomposition: + $ref: '#/components/schemas/_common.analysis:IcuCollationDecomposition' + hiraganaQuaternaryMode: + type: boolean + language: + type: string + numeric: + type: boolean + rules: + type: string + strength: + $ref: '#/components/schemas/_common.analysis:IcuCollationStrength' + variableTop: + type: string + variant: + type: string + required: + - type + _common.analysis:IcuFoldingTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - icu_folding + unicode_set_filter: + type: string + required: + - type + - unicode_set_filter + _common.analysis:IcuNormalizationCharFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:CharFilterBase' + - type: object + properties: + type: + type: string + enum: + - icu_normalizer + mode: + $ref: '#/components/schemas/_common.analysis:IcuNormalizationMode' + name: + $ref: '#/components/schemas/_common.analysis:IcuNormalizationType' + required: + - type + _common.analysis:IcuNormalizationMode: + type: string + enum: + - decompose + - compose + _common.analysis:IcuNormalizationTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - icu_normalizer + name: + $ref: '#/components/schemas/_common.analysis:IcuNormalizationType' + required: + - type + - name + _common.analysis:IcuNormalizationType: + type: string + enum: + - nfc + - nfkc + - nfkc_cf + _common.analysis:IcuTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - icu_tokenizer + rule_files: + type: string + required: + - type + - rule_files + _common.analysis:IcuTransformDirection: + type: string + enum: + - forward + - reverse + _common.analysis:IcuTransformTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - icu_transform + dir: + $ref: '#/components/schemas/_common.analysis:IcuTransformDirection' + id: + type: string + required: + - type + - id + _common.analysis:KStemTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - kstem + required: + - type + _common.analysis:KeepTypesMode: + type: string + enum: + - include + - exclude + _common.analysis:KeepTypesTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - keep_types + mode: + $ref: '#/components/schemas/_common.analysis:KeepTypesMode' + types: + type: array + items: + type: string + required: + - type + _common.analysis:KeepWordsTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - keep + keep_words: + type: array + items: + type: string + keep_words_case: + type: boolean + keep_words_path: + type: string + required: + - type + _common.analysis:KeywordAnalyzer: + type: object + properties: + type: + type: string + enum: + - keyword + version: + $ref: '#/components/schemas/_common:VersionString' + required: + - type + _common.analysis:KeywordMarkerTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - keyword_marker + ignore_case: + type: boolean + keywords: + type: array + items: + type: string + keywords_path: + type: string + keywords_pattern: + type: string + required: + - type + _common.analysis:KeywordTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - keyword + buffer_size: + type: number + required: + - type + - buffer_size + _common.analysis:KuromojiAnalyzer: + type: object + properties: + type: + type: string + enum: + - kuromoji + mode: + $ref: '#/components/schemas/_common.analysis:KuromojiTokenizationMode' + user_dictionary: + type: string + required: + - type + - mode + _common.analysis:KuromojiIterationMarkCharFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:CharFilterBase' + - type: object + properties: + type: + type: string + enum: + - kuromoji_iteration_mark + normalize_kana: + type: boolean + normalize_kanji: + type: boolean + required: + - type + - normalize_kana + - normalize_kanji + _common.analysis:KuromojiPartOfSpeechTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - kuromoji_part_of_speech + stoptags: + type: array + items: + type: string + required: + - type + - stoptags + _common.analysis:KuromojiReadingFormTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - kuromoji_readingform + use_romaji: + type: boolean + required: + - type + - use_romaji + _common.analysis:KuromojiStemmerTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - kuromoji_stemmer + minimum_length: + type: number + required: + - type + - minimum_length + _common.analysis:KuromojiTokenizationMode: + type: string + enum: + - normal + - search + - extended + _common.analysis:KuromojiTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - kuromoji_tokenizer + discard_punctuation: + type: boolean + mode: + $ref: '#/components/schemas/_common.analysis:KuromojiTokenizationMode' + nbest_cost: + type: number + nbest_examples: + type: string + user_dictionary: + type: string + user_dictionary_rules: + type: array + items: + type: string + discard_compound_token: + type: boolean + required: + - type + - mode + _common.analysis:Language: + type: string + enum: + - Arabic + - Armenian + - Basque + - Brazilian + - Bulgarian + - Catalan + - Chinese + - Cjk + - Czech + - Danish + - Dutch + - English + - Estonian + - Finnish + - French + - Galician + - German + - Greek + - Hindi + - Hungarian + - Indonesian + - Irish + - Italian + - Latvian + - Norwegian + - Persian + - Portuguese + - Romanian + - Russian + - Sorani + - Spanish + - Swedish + - Turkish + - Thai + _common.analysis:LanguageAnalyzer: + type: object + properties: + type: + type: string + enum: + - language + version: + $ref: '#/components/schemas/_common:VersionString' + language: + $ref: '#/components/schemas/_common.analysis:Language' + stem_exclusion: + type: array + items: + type: string + stopwords: + $ref: '#/components/schemas/_common.analysis:StopWords' + stopwords_path: + type: string + required: + - type + - language + - stem_exclusion + _common.analysis:LengthTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - length + max: + type: number + min: + type: number + required: + - type + _common.analysis:LetterTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - letter + required: + - type + _common.analysis:LimitTokenCountTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - limit + consume_all_tokens: + type: boolean + max_token_count: + $ref: '#/components/schemas/_common:Stringifiedinteger' + required: + - type + _common.analysis:LowercaseNormalizer: + type: object + properties: + type: + type: string + enum: + - lowercase + required: + - type + _common.analysis:LowercaseTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - lowercase + language: + type: string + required: + - type + _common.analysis:LowercaseTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - lowercase + required: + - type + _common.analysis:MappingCharFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:CharFilterBase' + - type: object + properties: + type: + type: string + enum: + - mapping + mappings: + type: array + items: + type: string + mappings_path: + type: string + required: + - type + _common.analysis:MultiplexerTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - multiplexer + filters: + type: array + items: + type: string + preserve_original: + $ref: '#/components/schemas/_common:Stringifiedboolean' + required: + - type + - filters + _common.analysis:NGramTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - ngram + max_gram: + type: number + min_gram: + type: number + preserve_original: + $ref: '#/components/schemas/_common:Stringifiedboolean' + required: + - type + _common.analysis:NGramTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - ngram + custom_token_chars: + type: string + max_gram: + type: number + min_gram: + type: number + token_chars: + type: array + items: + $ref: '#/components/schemas/_common.analysis:TokenChar' + required: + - type + - max_gram + - min_gram + - token_chars + _common.analysis:NoriAnalyzer: + type: object + properties: + type: + type: string + enum: + - nori + version: + $ref: '#/components/schemas/_common:VersionString' + decompound_mode: + $ref: '#/components/schemas/_common.analysis:NoriDecompoundMode' + stoptags: + type: array + items: + type: string + user_dictionary: + type: string + required: + - type + _common.analysis:NoriDecompoundMode: + type: string + enum: + - discard + - none + - mixed + _common.analysis:NoriPartOfSpeechTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - nori_part_of_speech + stoptags: + type: array + items: + type: string + required: + - type + _common.analysis:NoriTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - nori_tokenizer + decompound_mode: + $ref: '#/components/schemas/_common.analysis:NoriDecompoundMode' + discard_punctuation: + type: boolean + user_dictionary: + type: string + user_dictionary_rules: + type: array + items: + type: string + required: + - type + _common.analysis:Normalizer: + discriminator: + propertyName: type + oneOf: + - $ref: '#/components/schemas/_common.analysis:LowercaseNormalizer' + - $ref: '#/components/schemas/_common.analysis:CustomNormalizer' + _common.analysis:PathHierarchyTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - path_hierarchy + buffer_size: + $ref: '#/components/schemas/_common:Stringifiedinteger' + delimiter: + type: string + replacement: + type: string + reverse: + $ref: '#/components/schemas/_common:Stringifiedboolean' + skip: + $ref: '#/components/schemas/_common:Stringifiedinteger' + required: + - type + - buffer_size + - delimiter + - reverse + - skip + _common.analysis:PatternAnalyzer: + type: object + properties: + type: + type: string + enum: + - pattern + version: + $ref: '#/components/schemas/_common:VersionString' + flags: + type: string + lowercase: + type: boolean + pattern: + type: string + stopwords: + $ref: '#/components/schemas/_common.analysis:StopWords' + required: + - type + - pattern + _common.analysis:PatternCaptureTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - pattern_capture + patterns: + type: array + items: + type: string + preserve_original: + $ref: '#/components/schemas/_common:Stringifiedboolean' + required: + - type + - patterns + _common.analysis:PatternReplaceCharFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:CharFilterBase' + - type: object + properties: + type: + type: string + enum: + - pattern_replace + flags: + type: string + pattern: + type: string + replacement: + type: string + required: + - type + - pattern + _common.analysis:PatternReplaceTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - pattern_replace + all: + type: boolean + flags: + type: string + pattern: + type: string + replacement: + type: string + required: + - type + - pattern + _common.analysis:PatternTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - pattern + flags: + type: string + group: + type: number + pattern: + type: string + required: + - type + _common.analysis:PhoneticEncoder: + type: string + enum: + - metaphone + - double_metaphone + - soundex + - refined_soundex + - caverphone1 + - caverphone2 + - cologne + - nysiis + - koelnerphonetik + - haasephonetik + - beider_morse + - daitch_mokotoff + _common.analysis:PhoneticLanguage: + type: string + enum: + - any + - common + - cyrillic + - english + - french + - german + - hebrew + - hungarian + - polish + - romanian + - russian + - spanish + _common.analysis:PhoneticNameType: + type: string + enum: + - generic + - ashkenazi + - sephardic + _common.analysis:PhoneticRuleType: + type: string + enum: + - approx + - exact + _common.analysis:PhoneticTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - phonetic + encoder: + $ref: '#/components/schemas/_common.analysis:PhoneticEncoder' + languageset: + type: array + items: + $ref: '#/components/schemas/_common.analysis:PhoneticLanguage' + max_code_len: + type: number + name_type: + $ref: '#/components/schemas/_common.analysis:PhoneticNameType' + replace: + type: boolean + rule_type: + $ref: '#/components/schemas/_common.analysis:PhoneticRuleType' + required: + - type + - encoder + - languageset + - name_type + - rule_type + _common.analysis:PorterStemTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - porter_stem + required: + - type + _common.analysis:PredicateTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - predicate_token_filter + script: + $ref: '#/components/schemas/_common:Script' + required: + - type + - script + _common.analysis:RemoveDuplicatesTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - remove_duplicates + required: + - type + _common.analysis:ReverseTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - reverse + required: + - type + _common.analysis:ShingleTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - shingle + filler_token: + type: string + max_shingle_size: + oneOf: + - type: number + - type: string + min_shingle_size: + oneOf: + - type: number + - type: string + output_unigrams: + type: boolean + output_unigrams_if_no_shingles: + type: boolean + token_separator: + type: string + required: + - type + _common.analysis:SimpleAnalyzer: + type: object + properties: + type: + type: string + enum: + - simple + version: + $ref: '#/components/schemas/_common:VersionString' + required: + - type + _common.analysis:SnowballAnalyzer: + type: object + properties: + type: + type: string + enum: + - snowball + version: + $ref: '#/components/schemas/_common:VersionString' + language: + $ref: '#/components/schemas/_common.analysis:SnowballLanguage' + stopwords: + $ref: '#/components/schemas/_common.analysis:StopWords' + required: + - type + - language + _common.analysis:SnowballLanguage: + type: string + enum: + - Armenian + - Basque + - Catalan + - Danish + - Dutch + - English + - Finnish + - French + - German + - German2 + - Hungarian + - Italian + - Kp + - Lovins + - Norwegian + - Porter + - Portuguese + - Romanian + - Russian + - Spanish + - Swedish + - Turkish + _common.analysis:SnowballTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - snowball + language: + $ref: '#/components/schemas/_common.analysis:SnowballLanguage' + required: + - type + - language + _common.analysis:StandardAnalyzer: + type: object + properties: + type: + type: string + enum: + - standard + max_token_length: + type: number + stopwords: + $ref: '#/components/schemas/_common.analysis:StopWords' + required: + - type + _common.analysis:StandardTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - standard + max_token_length: + type: number + required: + - type + _common.analysis:StemmerOverrideTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - stemmer_override + rules: + type: array + items: + type: string + rules_path: + type: string + required: + - type + _common.analysis:StemmerTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - stemmer + language: + type: string + required: + - type + _common.analysis:StopAnalyzer: + type: object + properties: + type: + type: string + enum: + - stop + version: + $ref: '#/components/schemas/_common:VersionString' + stopwords: + $ref: '#/components/schemas/_common.analysis:StopWords' + stopwords_path: + type: string + required: + - type + _common.analysis:StopTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - stop + ignore_case: + type: boolean + remove_trailing: + type: boolean + stopwords: + $ref: '#/components/schemas/_common.analysis:StopWords' + stopwords_path: + type: string + required: + - type + _common.analysis:StopWords: + description: |- + Language value, such as _arabic_ or _thai_. Defaults to _english_. + Each language value corresponds to a predefined list of stop words in Lucene. See Stop words by language for supported language values and their stop words. + Also accepts an array of stop words. + oneOf: + - type: string + - type: array + items: + type: string + _common.analysis:SynonymFormat: + type: string + enum: + - solr + - wordnet + _common.analysis:SynonymGraphTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - synonym_graph + expand: + type: boolean + format: + $ref: '#/components/schemas/_common.analysis:SynonymFormat' + lenient: + type: boolean + synonyms: + type: array + items: + type: string + synonyms_path: + type: string + tokenizer: + type: string + updateable: + type: boolean + required: + - type + _common.analysis:SynonymTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - synonym + expand: + type: boolean + format: + $ref: '#/components/schemas/_common.analysis:SynonymFormat' + lenient: + type: boolean + synonyms: + type: array + items: + type: string + synonyms_path: + type: string + tokenizer: + type: string + updateable: + type: boolean + required: + - type + _common.analysis:TokenChar: + type: string + enum: + - letter + - digit + - whitespace + - punctuation + - symbol + - custom + _common.analysis:TokenFilter: + oneOf: + - type: string + - $ref: '#/components/schemas/_common.analysis:TokenFilterDefinition' + _common.analysis:TokenFilterBase: + type: object + properties: + version: + $ref: '#/components/schemas/_common:VersionString' + _common.analysis:TokenFilterDefinition: + discriminator: + propertyName: type + oneOf: + - $ref: '#/components/schemas/_common.analysis:AsciiFoldingTokenFilter' + - $ref: '#/components/schemas/_common.analysis:CommonGramsTokenFilter' + - $ref: '#/components/schemas/_common.analysis:ConditionTokenFilter' + - $ref: '#/components/schemas/_common.analysis:DelimitedPayloadTokenFilter' + - $ref: '#/components/schemas/_common.analysis:EdgeNGramTokenFilter' + - $ref: '#/components/schemas/_common.analysis:ElisionTokenFilter' + - $ref: '#/components/schemas/_common.analysis:FingerprintTokenFilter' + - $ref: '#/components/schemas/_common.analysis:HunspellTokenFilter' + - $ref: '#/components/schemas/_common.analysis:HyphenationDecompounderTokenFilter' + - $ref: '#/components/schemas/_common.analysis:KeepTypesTokenFilter' + - $ref: '#/components/schemas/_common.analysis:KeepWordsTokenFilter' + - $ref: '#/components/schemas/_common.analysis:KeywordMarkerTokenFilter' + - $ref: '#/components/schemas/_common.analysis:KStemTokenFilter' + - $ref: '#/components/schemas/_common.analysis:LengthTokenFilter' + - $ref: '#/components/schemas/_common.analysis:LimitTokenCountTokenFilter' + - $ref: '#/components/schemas/_common.analysis:LowercaseTokenFilter' + - $ref: '#/components/schemas/_common.analysis:MultiplexerTokenFilter' + - $ref: '#/components/schemas/_common.analysis:NGramTokenFilter' + - $ref: '#/components/schemas/_common.analysis:NoriPartOfSpeechTokenFilter' + - $ref: '#/components/schemas/_common.analysis:PatternCaptureTokenFilter' + - $ref: '#/components/schemas/_common.analysis:PatternReplaceTokenFilter' + - $ref: '#/components/schemas/_common.analysis:PorterStemTokenFilter' + - $ref: '#/components/schemas/_common.analysis:PredicateTokenFilter' + - $ref: '#/components/schemas/_common.analysis:RemoveDuplicatesTokenFilter' + - $ref: '#/components/schemas/_common.analysis:ReverseTokenFilter' + - $ref: '#/components/schemas/_common.analysis:ShingleTokenFilter' + - $ref: '#/components/schemas/_common.analysis:SnowballTokenFilter' + - $ref: '#/components/schemas/_common.analysis:StemmerOverrideTokenFilter' + - $ref: '#/components/schemas/_common.analysis:StemmerTokenFilter' + - $ref: '#/components/schemas/_common.analysis:StopTokenFilter' + - $ref: '#/components/schemas/_common.analysis:SynonymGraphTokenFilter' + - $ref: '#/components/schemas/_common.analysis:SynonymTokenFilter' + - $ref: '#/components/schemas/_common.analysis:TrimTokenFilter' + - $ref: '#/components/schemas/_common.analysis:TruncateTokenFilter' + - $ref: '#/components/schemas/_common.analysis:UniqueTokenFilter' + - $ref: '#/components/schemas/_common.analysis:UppercaseTokenFilter' + - $ref: '#/components/schemas/_common.analysis:WordDelimiterGraphTokenFilter' + - $ref: '#/components/schemas/_common.analysis:WordDelimiterTokenFilter' + - $ref: '#/components/schemas/_common.analysis:KuromojiStemmerTokenFilter' + - $ref: '#/components/schemas/_common.analysis:KuromojiReadingFormTokenFilter' + - $ref: '#/components/schemas/_common.analysis:KuromojiPartOfSpeechTokenFilter' + - $ref: '#/components/schemas/_common.analysis:IcuTokenizer' + - $ref: '#/components/schemas/_common.analysis:IcuCollationTokenFilter' + - $ref: '#/components/schemas/_common.analysis:IcuFoldingTokenFilter' + - $ref: '#/components/schemas/_common.analysis:IcuNormalizationTokenFilter' + - $ref: '#/components/schemas/_common.analysis:IcuTransformTokenFilter' + - $ref: '#/components/schemas/_common.analysis:PhoneticTokenFilter' + - $ref: '#/components/schemas/_common.analysis:DictionaryDecompounderTokenFilter' + _common.analysis:Tokenizer: + oneOf: + - type: string + - $ref: '#/components/schemas/_common.analysis:TokenizerDefinition' + _common.analysis:TokenizerBase: + type: object + properties: + version: + $ref: '#/components/schemas/_common:VersionString' + _common.analysis:TokenizerDefinition: + discriminator: + propertyName: type + oneOf: + - $ref: '#/components/schemas/_common.analysis:CharGroupTokenizer' + - $ref: '#/components/schemas/_common.analysis:EdgeNGramTokenizer' + - $ref: '#/components/schemas/_common.analysis:KeywordTokenizer' + - $ref: '#/components/schemas/_common.analysis:LetterTokenizer' + - $ref: '#/components/schemas/_common.analysis:LowercaseTokenizer' + - $ref: '#/components/schemas/_common.analysis:NGramTokenizer' + - $ref: '#/components/schemas/_common.analysis:NoriTokenizer' + - $ref: '#/components/schemas/_common.analysis:PathHierarchyTokenizer' + - $ref: '#/components/schemas/_common.analysis:StandardTokenizer' + - $ref: '#/components/schemas/_common.analysis:UaxEmailUrlTokenizer' + - $ref: '#/components/schemas/_common.analysis:WhitespaceTokenizer' + - $ref: '#/components/schemas/_common.analysis:KuromojiTokenizer' + - $ref: '#/components/schemas/_common.analysis:PatternTokenizer' + - $ref: '#/components/schemas/_common.analysis:IcuTokenizer' + _common.analysis:TrimTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - trim + required: + - type + _common.analysis:TruncateTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - truncate + length: + type: number + required: + - type + _common.analysis:UaxEmailUrlTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - uax_url_email + max_token_length: + type: number + required: + - type + _common.analysis:UniqueTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - unique + only_on_same_position: + type: boolean + required: + - type + _common.analysis:UppercaseTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - uppercase + required: + - type + _common.analysis:WhitespaceAnalyzer: + type: object + properties: + type: + type: string + enum: + - whitespace + version: + $ref: '#/components/schemas/_common:VersionString' + required: + - type + _common.analysis:WhitespaceTokenizer: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenizerBase' + - type: object + properties: + type: + type: string + enum: + - whitespace + max_token_length: + type: number + required: + - type + _common.analysis:WordDelimiterGraphTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - word_delimiter_graph + adjust_offsets: + type: boolean + catenate_all: + type: boolean + catenate_numbers: + type: boolean + catenate_words: + type: boolean + generate_number_parts: + type: boolean + generate_word_parts: + type: boolean + ignore_keywords: + type: boolean + preserve_original: + $ref: '#/components/schemas/_common:Stringifiedboolean' + protected_words: + type: array + items: + type: string + protected_words_path: + type: string + split_on_case_change: + type: boolean + split_on_numerics: + type: boolean + stem_english_possessive: + type: boolean + type_table: + type: array + items: + type: string + type_table_path: + type: string + required: + - type + _common.analysis:WordDelimiterTokenFilter: + allOf: + - $ref: '#/components/schemas/_common.analysis:TokenFilterBase' + - type: object + properties: + type: + type: string + enum: + - word_delimiter + catenate_all: + type: boolean + catenate_numbers: + type: boolean + catenate_words: + type: boolean + generate_number_parts: + type: boolean + generate_word_parts: + type: boolean + preserve_original: + $ref: '#/components/schemas/_common:Stringifiedboolean' + protected_words: + type: array + items: + type: string + protected_words_path: + type: string + split_on_case_change: + type: boolean + split_on_numerics: + type: boolean + stem_english_possessive: + type: boolean + type_table: + type: array + items: + type: string + type_table_path: + type: string + required: + - type + _common.mapping:AggregateMetricDoubleProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + type: + type: string + enum: + - aggregate_metric_double + default_metric: + type: string + metrics: + type: array + items: + type: string + time_series_metric: + $ref: '#/components/schemas/_common.mapping:TimeSeriesMetricType' + required: + - type + - default_metric + - metrics + _common.mapping:AllField: + type: object + properties: + analyzer: + type: string + enabled: + type: boolean + omit_norms: + type: boolean + search_analyzer: + type: string + similarity: + type: string + store: + type: boolean + store_term_vector_offsets: + type: boolean + store_term_vector_payloads: + type: boolean + store_term_vector_positions: + type: boolean + store_term_vectors: + type: boolean + required: + - analyzer + - enabled + - omit_norms + - search_analyzer + - similarity + - store + - store_term_vector_offsets + - store_term_vector_payloads + - store_term_vector_positions + - store_term_vectors + _common.mapping:BinaryProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + type: + type: string + enum: + - binary + required: + - type + _common.mapping:BooleanProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + boost: + type: number + fielddata: + $ref: '#/components/schemas/indices._common:NumericFielddata' + index: + type: boolean + null_value: + type: boolean + type: + type: string + enum: + - boolean + required: + - type + _common.mapping:ByteNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - byte + null_value: + $ref: '#/components/schemas/_common:byte' + required: + - type + _common.mapping:CompletionProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + analyzer: + type: string + contexts: + type: array + items: + $ref: '#/components/schemas/_common.mapping:SuggestContext' + max_input_length: + type: number + preserve_position_increments: + type: boolean + preserve_separators: + type: boolean + search_analyzer: + type: string + type: + type: string + enum: + - completion + required: + - type + _common.mapping:ConstantKeywordProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + value: + type: object + type: + type: string + enum: + - constant_keyword + required: + - type + _common.mapping:CorePropertyBase: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + copy_to: + $ref: '#/components/schemas/_common:Fields' + similarity: + type: string + store: + type: boolean + _common.mapping:DataStreamTimestamp: + type: object + properties: + enabled: + type: boolean + required: + - enabled + _common.mapping:DateNanosProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + boost: + type: number + format: + type: string + ignore_malformed: + type: boolean + index: + type: boolean + null_value: + $ref: '#/components/schemas/_common:DateTime' + precision_step: + type: number + type: + type: string + enum: + - date_nanos + required: + - type + _common.mapping:DateProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + boost: + type: number + fielddata: + $ref: '#/components/schemas/indices._common:NumericFielddata' + format: + type: string + ignore_malformed: + type: boolean + index: + type: boolean + null_value: + $ref: '#/components/schemas/_common:DateTime' + precision_step: + type: number + locale: + type: string + type: + type: string + enum: + - date + required: + - type + _common.mapping:DateRangeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:RangePropertyBase' + - type: object + properties: + format: + type: string + type: + type: string + enum: + - date_range + required: + - type + _common.mapping:DenseVectorIndexOptions: + type: object + properties: + type: + type: string + m: + type: number + ef_construction: + type: number + required: + - type + - m + - ef_construction + _common.mapping:DenseVectorProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + type: + type: string + enum: + - dense_vector + dims: + type: number + similarity: + type: string + index: + type: boolean + index_options: + $ref: '#/components/schemas/_common.mapping:DenseVectorIndexOptions' + required: + - type + - dims + _common.mapping:DocValuesPropertyBase: + allOf: + - $ref: '#/components/schemas/_common.mapping:CorePropertyBase' + - type: object + properties: + doc_values: + type: boolean + _common.mapping:DoubleNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - double + null_value: + type: number + required: + - type + _common.mapping:DoubleRangeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:RangePropertyBase' + - type: object + properties: + type: + type: string + enum: + - double_range + required: + - type + _common.mapping:DynamicMapping: + type: string + enum: + - strict + - runtime + - 'true' + - 'false' + _common.mapping:DynamicProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + type: + type: string + enum: + - '{dynamic_property}' + enabled: + type: boolean + null_value: + $ref: '#/components/schemas/_common:FieldValue' + boost: + type: number + coerce: + type: boolean + script: + $ref: '#/components/schemas/_common:Script' + on_script_error: + $ref: '#/components/schemas/_common.mapping:OnScriptError' + ignore_malformed: + type: boolean + time_series_metric: + $ref: '#/components/schemas/_common.mapping:TimeSeriesMetricType' + analyzer: + type: string + eager_global_ordinals: + type: boolean + index: + type: boolean + index_options: + $ref: '#/components/schemas/_common.mapping:IndexOptions' + index_phrases: + type: boolean + index_prefixes: + $ref: '#/components/schemas/_common.mapping:TextIndexPrefixes' + norms: + type: boolean + position_increment_gap: + type: number + search_analyzer: + type: string + search_quote_analyzer: + type: string + term_vector: + $ref: '#/components/schemas/_common.mapping:TermVectorOption' + format: + type: string + precision_step: + type: number + locale: + type: string + required: + - type + _common.mapping:DynamicTemplate: + type: object + properties: + mapping: + $ref: '#/components/schemas/_common.mapping:Property' + match: + type: string + match_mapping_type: + type: string + match_pattern: + $ref: '#/components/schemas/_common.mapping:MatchType' + path_match: + type: string + path_unmatch: + type: string + unmatch: + type: string + _common.mapping:FieldAliasProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + path: + $ref: '#/components/schemas/_common:Field' + type: + type: string + enum: + - alias + required: + - type + _common.mapping:FieldMapping: + type: object + properties: + full_name: + type: string + mapping: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:Property' + minProperties: 1 + maxProperties: 1 + required: + - full_name + - mapping + _common.mapping:FieldNamesField: + type: object + properties: + enabled: + type: boolean + required: + - enabled + _common.mapping:FlattenedProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + boost: + type: number + depth_limit: + type: number + doc_values: + type: boolean + eager_global_ordinals: + type: boolean + index: + type: boolean + index_options: + $ref: '#/components/schemas/_common.mapping:IndexOptions' + null_value: + type: string + similarity: + type: string + split_queries_on_whitespace: + type: boolean + type: + type: string + enum: + - flattened + required: + - type + _common.mapping:FloatNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - float + null_value: + type: number + required: + - type + _common.mapping:FloatRangeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:RangePropertyBase' + - type: object + properties: + type: + type: string + enum: + - float_range + required: + - type + _common.mapping:GeoOrientation: + type: string + enum: + - right + - left + _common.mapping:GeoPointProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + ignore_malformed: + type: boolean + ignore_z_value: + type: boolean + null_value: + $ref: '#/components/schemas/_common:GeoLocation' + type: + type: string + enum: + - geo_point + required: + - type + _common.mapping:GeoShapeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + coerce: + type: boolean + ignore_malformed: + type: boolean + ignore_z_value: + type: boolean + orientation: + $ref: '#/components/schemas/_common.mapping:GeoOrientation' + strategy: + $ref: '#/components/schemas/_common.mapping:GeoStrategy' + type: + type: string + enum: + - geo_shape + required: + - type + _common.mapping:GeoStrategy: + type: string + enum: + - recursive + - term + _common.mapping:HalfFloatNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - half_float + null_value: + type: number + required: + - type + _common.mapping:HistogramProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + ignore_malformed: + type: boolean + type: + type: string + enum: + - histogram + required: + - type + _common.mapping:IndexField: + type: object + properties: + enabled: + type: boolean + required: + - enabled + _common.mapping:IndexOptions: + type: string + enum: + - docs + - freqs + - positions + - offsets + _common.mapping:IntegerNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - integer + null_value: + type: number + required: + - type + _common.mapping:IntegerRangeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:RangePropertyBase' + - type: object + properties: + type: + type: string + enum: + - integer_range + required: + - type + _common.mapping:IpProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + boost: + type: number + index: + type: boolean + ignore_malformed: + type: boolean + null_value: + type: string + on_script_error: + $ref: '#/components/schemas/_common.mapping:OnScriptError' + script: + $ref: '#/components/schemas/_common:Script' + time_series_dimension: + description: For internal use by Opensearch only. Marks the field as a time series dimension. Defaults to false. + type: boolean + type: + type: string + enum: + - ip + required: + - type + _common.mapping:IpRangeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:RangePropertyBase' + - type: object + properties: + type: + type: string + enum: + - ip_range + required: + - type + _common.mapping:JoinProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + relations: + type: object + additionalProperties: + oneOf: + - $ref: '#/components/schemas/_common:RelationName' + - type: array + items: + $ref: '#/components/schemas/_common:RelationName' + eager_global_ordinals: + type: boolean + type: + type: string + enum: + - join + required: + - type + _common.mapping:KeywordProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + boost: + type: number + eager_global_ordinals: + type: boolean + index: + type: boolean + index_options: + $ref: '#/components/schemas/_common.mapping:IndexOptions' + normalizer: + type: string + norms: + type: boolean + null_value: + type: string + split_queries_on_whitespace: + type: boolean + time_series_dimension: + description: For internal use by Opensearch only. Marks the field as a time series dimension. Defaults to false. + type: boolean + type: + type: string + enum: + - keyword + required: + - type + _common.mapping:LongNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - long + null_value: + type: number + required: + - type + _common.mapping:LongRangeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:RangePropertyBase' + - type: object + properties: + type: + type: string + enum: + - long_range + required: + - type + _common.mapping:MatchOnlyTextProperty: + type: object + properties: + type: + type: string + enum: + - match_only_text + fields: + description: |- + Multi-fields allow the same string value to be indexed in multiple ways for different purposes, such as one + field for search and a multi-field for sorting and aggregations, or the same string value analyzed by different analyzers. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:Property' + meta: + description: Metadata about the field. + type: object + additionalProperties: + type: string + copy_to: + $ref: '#/components/schemas/_common:Fields' + required: + - type + _common.mapping:MatchType: + type: string + enum: + - simple + - regex + _common.mapping:Murmur3HashProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + type: + type: string + enum: + - murmur3 + required: + - type + _common.mapping:NestedProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:CorePropertyBase' + - type: object + properties: + enabled: + type: boolean + include_in_parent: + type: boolean + include_in_root: + type: boolean + type: + type: string + enum: + - nested + required: + - type + _common.mapping:NumberPropertyBase: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + boost: + type: number + coerce: + type: boolean + ignore_malformed: + type: boolean + index: + type: boolean + on_script_error: + $ref: '#/components/schemas/_common.mapping:OnScriptError' + script: + $ref: '#/components/schemas/_common:Script' + time_series_metric: + $ref: '#/components/schemas/_common.mapping:TimeSeriesMetricType' + time_series_dimension: + description: For internal use by Opensearch only. Marks the field as a time series dimension. Defaults to false. + type: boolean + _common.mapping:ObjectProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:CorePropertyBase' + - type: object + properties: + enabled: + type: boolean + type: + type: string + enum: + - object + _common.mapping:OnScriptError: + type: string + enum: + - fail + - continue + _common.mapping:PercolatorProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + type: + type: string + enum: + - percolator + required: + - type + _common.mapping:PointProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + ignore_malformed: + type: boolean + ignore_z_value: + type: boolean + null_value: + type: string + type: + type: string + enum: + - point + required: + - type + _common.mapping:Property: + discriminator: + propertyName: type + oneOf: + - $ref: '#/components/schemas/_common.mapping:BinaryProperty' + - $ref: '#/components/schemas/_common.mapping:BooleanProperty' + - $ref: '#/components/schemas/_common.mapping:DynamicProperty' + - $ref: '#/components/schemas/_common.mapping:JoinProperty' + - $ref: '#/components/schemas/_common.mapping:KeywordProperty' + - $ref: '#/components/schemas/_common.mapping:MatchOnlyTextProperty' + - $ref: '#/components/schemas/_common.mapping:PercolatorProperty' + - $ref: '#/components/schemas/_common.mapping:RankFeatureProperty' + - $ref: '#/components/schemas/_common.mapping:RankFeaturesProperty' + - $ref: '#/components/schemas/_common.mapping:SearchAsYouTypeProperty' + - $ref: '#/components/schemas/_common.mapping:TextProperty' + - $ref: '#/components/schemas/_common.mapping:VersionProperty' + - $ref: '#/components/schemas/_common.mapping:WildcardProperty' + - $ref: '#/components/schemas/_common.mapping:DateNanosProperty' + - $ref: '#/components/schemas/_common.mapping:DateProperty' + - $ref: '#/components/schemas/_common.mapping:AggregateMetricDoubleProperty' + - $ref: '#/components/schemas/_common.mapping:DenseVectorProperty' + - $ref: '#/components/schemas/_common.mapping:SparseVectorProperty' + - $ref: '#/components/schemas/_common.mapping:FlattenedProperty' + - $ref: '#/components/schemas/_common.mapping:NestedProperty' + - $ref: '#/components/schemas/_common.mapping:ObjectProperty' + - $ref: '#/components/schemas/_common.mapping:CompletionProperty' + - $ref: '#/components/schemas/_common.mapping:ConstantKeywordProperty' + - $ref: '#/components/schemas/_common.mapping:FieldAliasProperty' + - $ref: '#/components/schemas/_common.mapping:HistogramProperty' + - $ref: '#/components/schemas/_common.mapping:IpProperty' + - $ref: '#/components/schemas/_common.mapping:Murmur3HashProperty' + - $ref: '#/components/schemas/_common.mapping:TokenCountProperty' + - $ref: '#/components/schemas/_common.mapping:GeoPointProperty' + - $ref: '#/components/schemas/_common.mapping:GeoShapeProperty' + - $ref: '#/components/schemas/_common.mapping:PointProperty' + - $ref: '#/components/schemas/_common.mapping:ShapeProperty' + - $ref: '#/components/schemas/_common.mapping:ByteNumberProperty' + - $ref: '#/components/schemas/_common.mapping:DoubleNumberProperty' + - $ref: '#/components/schemas/_common.mapping:FloatNumberProperty' + - $ref: '#/components/schemas/_common.mapping:HalfFloatNumberProperty' + - $ref: '#/components/schemas/_common.mapping:IntegerNumberProperty' + - $ref: '#/components/schemas/_common.mapping:LongNumberProperty' + - $ref: '#/components/schemas/_common.mapping:ScaledFloatNumberProperty' + - $ref: '#/components/schemas/_common.mapping:ShortNumberProperty' + - $ref: '#/components/schemas/_common.mapping:UnsignedLongNumberProperty' + - $ref: '#/components/schemas/_common.mapping:DateRangeProperty' + - $ref: '#/components/schemas/_common.mapping:DoubleRangeProperty' + - $ref: '#/components/schemas/_common.mapping:FloatRangeProperty' + - $ref: '#/components/schemas/_common.mapping:IntegerRangeProperty' + - $ref: '#/components/schemas/_common.mapping:IpRangeProperty' + - $ref: '#/components/schemas/_common.mapping:LongRangeProperty' + _common.mapping:PropertyBase: + type: object + properties: + meta: + description: Metadata about the field. + type: object + additionalProperties: + type: string + properties: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:Property' + ignore_above: + type: number + dynamic: + $ref: '#/components/schemas/_common.mapping:DynamicMapping' + fields: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:Property' + _common.mapping:RangePropertyBase: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + boost: + type: number + coerce: + type: boolean + index: + type: boolean + _common.mapping:RankFeatureProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + positive_score_impact: + type: boolean + type: + type: string + enum: + - rank_feature + required: + - type + _common.mapping:RankFeaturesProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + type: + type: string + enum: + - rank_features + required: + - type + _common.mapping:RoutingField: + type: object + properties: + required: + type: boolean + required: + - required + _common.mapping:RuntimeField: + type: object + properties: + fetch_fields: + description: For type `lookup` + type: array + items: + $ref: '#/components/schemas/_common.mapping:RuntimeFieldFetchFields' + format: + description: A custom format for `date` type runtime fields. + type: string + input_field: + $ref: '#/components/schemas/_common:Field' + target_field: + $ref: '#/components/schemas/_common:Field' + target_index: + $ref: '#/components/schemas/_common:IndexName' + script: + $ref: '#/components/schemas/_common:Script' + type: + $ref: '#/components/schemas/_common.mapping:RuntimeFieldType' + required: + - type + _common.mapping:RuntimeFieldFetchFields: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + format: + type: string + required: + - field + _common.mapping:RuntimeFieldType: + type: string + enum: + - boolean + - date + - double + - geo_point + - ip + - keyword + - long + - lookup + _common.mapping:RuntimeFields: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:RuntimeField' + _common.mapping:ScaledFloatNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - scaled_float + null_value: + type: number + scaling_factor: + type: number + required: + - type + _common.mapping:SearchAsYouTypeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:CorePropertyBase' + - type: object + properties: + analyzer: + type: string + index: + type: boolean + index_options: + $ref: '#/components/schemas/_common.mapping:IndexOptions' + max_shingle_size: + type: number + norms: + type: boolean + search_analyzer: + type: string + search_quote_analyzer: + type: string + term_vector: + $ref: '#/components/schemas/_common.mapping:TermVectorOption' + type: + type: string + enum: + - search_as_you_type + required: + - type + _common.mapping:ShapeProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + coerce: + type: boolean + ignore_malformed: + type: boolean + ignore_z_value: + type: boolean + orientation: + $ref: '#/components/schemas/_common.mapping:GeoOrientation' + type: + type: string + enum: + - shape + required: + - type + _common.mapping:ShortNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - short + null_value: + $ref: '#/components/schemas/_common:short' + required: + - type + _common.mapping:SizeField: + type: object + properties: + enabled: + type: boolean + required: + - enabled + _common.mapping:SourceField: + type: object + properties: + compress: + type: boolean + compress_threshold: + type: string + enabled: + type: boolean + excludes: + type: array + items: + type: string + includes: + type: array + items: + type: string + mode: + $ref: '#/components/schemas/_common.mapping:SourceFieldMode' + _common.mapping:SourceFieldMode: + type: string + enum: + - disabled + - stored + - synthetic + _common.mapping:SparseVectorProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:PropertyBase' + - type: object + properties: + type: + type: string + enum: + - sparse_vector + required: + - type + _common.mapping:SuggestContext: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + path: + $ref: '#/components/schemas/_common:Field' + type: + type: string + precision: + oneOf: + - type: number + - type: string + required: + - name + - type + _common.mapping:TermVectorOption: + type: string + enum: + - no + - yes + - with_offsets + - with_positions + - with_positions_offsets + - with_positions_offsets_payloads + - with_positions_payloads + _common.mapping:TextIndexPrefixes: + type: object + properties: + max_chars: + type: number + min_chars: + type: number + required: + - max_chars + - min_chars + _common.mapping:TextProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:CorePropertyBase' + - type: object + properties: + analyzer: + type: string + boost: + type: number + eager_global_ordinals: + type: boolean + fielddata: + type: boolean + fielddata_frequency_filter: + $ref: '#/components/schemas/indices._common:FielddataFrequencyFilter' + index: + type: boolean + index_options: + $ref: '#/components/schemas/_common.mapping:IndexOptions' + index_phrases: + type: boolean + index_prefixes: + $ref: '#/components/schemas/_common.mapping:TextIndexPrefixes' + norms: + type: boolean + position_increment_gap: + type: number + search_analyzer: + type: string + search_quote_analyzer: + type: string + term_vector: + $ref: '#/components/schemas/_common.mapping:TermVectorOption' + type: + type: string + enum: + - text + required: + - type + _common.mapping:TimeSeriesMetricType: + type: string + enum: + - gauge + - counter + - summary + - histogram + - position + _common.mapping:TokenCountProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + analyzer: + type: string + boost: + type: number + index: + type: boolean + null_value: + type: number + enable_position_increments: + type: boolean + type: + type: string + enum: + - token_count + required: + - type + _common.mapping:TypeMapping: + type: object + properties: + all_field: + $ref: '#/components/schemas/_common.mapping:AllField' + date_detection: + type: boolean + dynamic: + $ref: '#/components/schemas/_common.mapping:DynamicMapping' + dynamic_date_formats: + type: array + items: + type: string + dynamic_templates: + type: array + items: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:DynamicTemplate' + _field_names: + $ref: '#/components/schemas/_common.mapping:FieldNamesField' + index_field: + $ref: '#/components/schemas/_common.mapping:IndexField' + _meta: + $ref: '#/components/schemas/_common:Metadata' + numeric_detection: + type: boolean + properties: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:Property' + _routing: + $ref: '#/components/schemas/_common.mapping:RoutingField' + _size: + $ref: '#/components/schemas/_common.mapping:SizeField' + _source: + $ref: '#/components/schemas/_common.mapping:SourceField' + runtime: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:RuntimeField' + enabled: + type: boolean + _data_stream_timestamp: + $ref: '#/components/schemas/_common.mapping:DataStreamTimestamp' + _common.mapping:UnsignedLongNumberProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:NumberPropertyBase' + - type: object + properties: + type: + type: string + enum: + - unsigned_long + null_value: + $ref: '#/components/schemas/_common:ulong' + required: + - type + _common.mapping:VersionProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + type: + type: string + enum: + - version + required: + - type + _common.mapping:WildcardProperty: + allOf: + - $ref: '#/components/schemas/_common.mapping:DocValuesPropertyBase' + - type: object + properties: + type: + type: string + enum: + - wildcard + null_value: + type: string + required: + - type + _common.query_dsl:BoolQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + filter: + description: |- + The clause (query) must appear in matching documents. + However, unlike `must`, the score of the query will be ignored. + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + must: + description: The clause (query) must appear in matching documents and will contribute to the score. + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + must_not: + description: |- + The clause (query) must not appear in the matching documents. + Because scoring is ignored, a score of `0` is returned for all documents. + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + should: + description: The clause (query) should appear in the matching document. + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + _common.query_dsl:BoostingQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + negative_boost: + description: Floating point number between 0 and 1.0 used to decrease the relevance scores of documents matching the `negative` query. + type: number + negative: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + positive: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + required: + - negative_boost + - negative + - positive + _common.query_dsl:ChildScoreMode: + type: string + enum: + - none + - avg + - sum + - max + - min + _common.query_dsl:CombinedFieldsOperator: + type: string + enum: + - or + - and + _common.query_dsl:CombinedFieldsQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + fields: + description: List of fields to search. Field wildcard patterns are allowed. Only `text` fields are supported, and they must all have the same search `analyzer`. + type: array + items: + $ref: '#/components/schemas/_common:Field' + query: + description: |- + Text to search for in the provided `fields`. + The `combined_fields` query analyzes the provided text before performing a search. + type: string + auto_generate_synonyms_phrase_query: + description: If true, match phrase queries are automatically created for multi-term synonyms. + type: boolean + operator: + $ref: '#/components/schemas/_common.query_dsl:CombinedFieldsOperator' + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + zero_terms_query: + $ref: '#/components/schemas/_common.query_dsl:CombinedFieldsZeroTerms' + required: + - fields + - query + _common.query_dsl:CombinedFieldsZeroTerms: + type: string + enum: + - none + - all + _common.query_dsl:CommonTermsQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + analyzer: + type: string + cutoff_frequency: + type: number + high_freq_operator: + $ref: '#/components/schemas/_common.query_dsl:Operator' + low_freq_operator: + $ref: '#/components/schemas/_common.query_dsl:Operator' + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + query: + type: string + required: + - query + _common.query_dsl:ConstantScoreQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + required: + - filter + _common.query_dsl:DateDecayFunction: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:DecayFunctionBase' + - type: object + _common.query_dsl:DateDistanceFeatureQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:DistanceFeatureQueryBaseDateMathDuration' + - type: object + _common.query_dsl:DateRangeQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:RangeQueryBase' + - type: object + properties: + gt: + $ref: '#/components/schemas/_common:DateMath' + gte: + $ref: '#/components/schemas/_common:DateMath' + lt: + $ref: '#/components/schemas/_common:DateMath' + lte: + $ref: '#/components/schemas/_common:DateMath' + from: + oneOf: + - $ref: '#/components/schemas/_common:DateMath' + - nullable: true + type: string + to: + oneOf: + - $ref: '#/components/schemas/_common:DateMath' + - nullable: true + type: string + format: + $ref: '#/components/schemas/_common:DateFormat' + time_zone: + $ref: '#/components/schemas/_common:TimeZone' + _common.query_dsl:DecayFunction: + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:DateDecayFunction' + - $ref: '#/components/schemas/_common.query_dsl:NumericDecayFunction' + - $ref: '#/components/schemas/_common.query_dsl:GeoDecayFunction' + _common.query_dsl:DecayFunctionBase: + type: object + properties: + multi_value_mode: + $ref: '#/components/schemas/_common.query_dsl:MultiValueMode' + _common.query_dsl:DisMaxQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + queries: + description: |- + One or more query clauses. + Returned documents must match one or more of these queries. + If a document matches multiple queries, Opensearch uses the highest relevance score. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + tie_breaker: + description: Floating point number between 0 and 1.0 used to increase the relevance scores of documents matching multiple query clauses. + type: number + required: + - queries + _common.query_dsl:DistanceFeatureQuery: + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:GeoDistanceFeatureQuery' + - $ref: '#/components/schemas/_common.query_dsl:DateDistanceFeatureQuery' + _common.query_dsl:DistanceFeatureQueryBaseDateMathDuration: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + origin: + $ref: '#/components/schemas/_common:DateMath' + pivot: + $ref: '#/components/schemas/_common:Duration' + field: + $ref: '#/components/schemas/_common:Field' + required: + - origin + - pivot + - field + _common.query_dsl:DistanceFeatureQueryBaseGeoLocationDistance: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + origin: + $ref: '#/components/schemas/_common:GeoLocation' + pivot: + $ref: '#/components/schemas/_common:Distance' + field: + $ref: '#/components/schemas/_common:Field' + required: + - origin + - pivot + - field + _common.query_dsl:ExistsQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + required: + - field + _common.query_dsl:FieldAndFormat: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + format: + description: Format in which the values are returned. + type: string + include_unmapped: + type: boolean + required: + - field + _common.query_dsl:FieldValueFactorModifier: + type: string + enum: + - none + - log + - log1p + - log2p + - ln + - ln1p + - ln2p + - square + - sqrt + - reciprocal + _common.query_dsl:FieldValueFactorScoreFunction: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + factor: + description: Optional factor to multiply the field value with. + type: number + missing: + description: |- + Value used if the document doesn’t have that field. + The modifier and factor are still applied to it as though it were read from the document. + type: number + modifier: + $ref: '#/components/schemas/_common.query_dsl:FieldValueFactorModifier' + required: + - field + _common.query_dsl:FunctionBoostMode: + type: string + enum: + - multiply + - replace + - sum + - avg + - max + - min + _common.query_dsl:FunctionScoreContainer: + allOf: + - type: object + properties: + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + weight: + type: number + - type: object + properties: + exp: + $ref: '#/components/schemas/_common.query_dsl:DecayFunction' + gauss: + $ref: '#/components/schemas/_common.query_dsl:DecayFunction' + linear: + $ref: '#/components/schemas/_common.query_dsl:DecayFunction' + field_value_factor: + $ref: '#/components/schemas/_common.query_dsl:FieldValueFactorScoreFunction' + random_score: + $ref: '#/components/schemas/_common.query_dsl:RandomScoreFunction' + script_score: + $ref: '#/components/schemas/_common.query_dsl:ScriptScoreFunction' + minProperties: 1 + maxProperties: 1 + _common.query_dsl:FunctionScoreMode: + type: string + enum: + - multiply + - sum + - avg + - first + - max + - min + _common.query_dsl:FunctionScoreQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + boost_mode: + $ref: '#/components/schemas/_common.query_dsl:FunctionBoostMode' + functions: + description: One or more functions that compute a new score for each document returned by the query. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:FunctionScoreContainer' + max_boost: + description: Restricts the new score to not exceed the provided limit. + type: number + min_score: + description: Excludes documents that do not meet the provided score threshold. + type: number + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + score_mode: + $ref: '#/components/schemas/_common.query_dsl:FunctionScoreMode' + _common.query_dsl:FuzzyQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + max_expansions: + description: Maximum number of variations created. + type: number + prefix_length: + description: Number of beginning characters left unchanged when creating expansions. + type: number + rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + transpositions: + description: Indicates whether edits include transpositions of two adjacent characters (for example `ab` to `ba`). + type: boolean + fuzziness: + $ref: '#/components/schemas/_common:Fuzziness' + value: + description: Term you wish to find in the provided field. + oneOf: + - type: string + - type: number + - type: boolean + required: + - value + _common.query_dsl:GeoBoundingBoxQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + type: + $ref: '#/components/schemas/_common.query_dsl:GeoExecution' + validation_method: + $ref: '#/components/schemas/_common.query_dsl:GeoValidationMethod' + ignore_unmapped: + description: |- + Set to `true` to ignore an unmapped field and not match any documents for this query. + Set to `false` to throw an exception if the field is not mapped. + type: boolean + _common.query_dsl:GeoDecayFunction: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:DecayFunctionBase' + - type: object + _common.query_dsl:GeoDistanceFeatureQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:DistanceFeatureQueryBaseGeoLocationDistance' + - type: object + _common.query_dsl:GeoDistanceQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + distance: + $ref: '#/components/schemas/_common:Distance' + distance_type: + $ref: '#/components/schemas/_common:GeoDistanceType' + validation_method: + $ref: '#/components/schemas/_common.query_dsl:GeoValidationMethod' + required: + - distance + _common.query_dsl:GeoExecution: + type: string + enum: + - memory + - indexed + _common.query_dsl:GeoPolygonQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + validation_method: + $ref: '#/components/schemas/_common.query_dsl:GeoValidationMethod' + ignore_unmapped: + type: boolean + _common.query_dsl:GeoShapeQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + ignore_unmapped: + description: |- + Set to `true` to ignore an unmapped field and not match any documents for this query. + Set to `false` to throw an exception if the field is not mapped. + type: boolean + _common.query_dsl:GeoValidationMethod: + type: string + enum: + - coerce + - ignore_malformed + - strict + _common.query_dsl:HasChildQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + ignore_unmapped: + description: Indicates whether to ignore an unmapped `type` and not return any documents instead of an error. + type: boolean + inner_hits: + $ref: '#/components/schemas/_core.search:InnerHits' + max_children: + description: |- + Maximum number of child documents that match the query allowed for a returned parent document. + If the parent document exceeds this limit, it is excluded from the search results. + type: number + min_children: + description: |- + Minimum number of child documents that match the query required to match the query for a returned parent document. + If the parent document does not meet this limit, it is excluded from the search results. + type: number + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + score_mode: + $ref: '#/components/schemas/_common.query_dsl:ChildScoreMode' + type: + $ref: '#/components/schemas/_common:RelationName' + required: + - query + - type + _common.query_dsl:HasParentQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + ignore_unmapped: + description: |- + Indicates whether to ignore an unmapped `parent_type` and not return any documents instead of an error. + You can use this parameter to query multiple indices that may not contain the `parent_type`. + type: boolean + inner_hits: + $ref: '#/components/schemas/_core.search:InnerHits' + parent_type: + $ref: '#/components/schemas/_common:RelationName' + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + score: + description: Indicates whether the relevance score of a matching parent document is aggregated into its child documents. + type: boolean + required: + - parent_type + - query + _common.query_dsl:IdsQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + values: + $ref: '#/components/schemas/_common:Ids' + _common.query_dsl:IntervalsAllOf: + type: object + properties: + intervals: + description: An array of rules to combine. All rules must produce a match in a document for the overall source to match. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + max_gaps: + description: |- + Maximum number of positions between the matching terms. + Intervals produced by the rules further apart than this are not considered matches. + type: number + ordered: + description: If `true`, intervals produced by the rules should appear in the order in which they are specified. + type: boolean + filter: + $ref: '#/components/schemas/_common.query_dsl:IntervalsFilter' + required: + - intervals + _common.query_dsl:IntervalsAnyOf: + type: object + properties: + intervals: + description: An array of rules to match. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + filter: + $ref: '#/components/schemas/_common.query_dsl:IntervalsFilter' + required: + - intervals + _common.query_dsl:IntervalsContainer: + type: object + properties: + all_of: + $ref: '#/components/schemas/_common.query_dsl:IntervalsAllOf' + any_of: + $ref: '#/components/schemas/_common.query_dsl:IntervalsAnyOf' + fuzzy: + $ref: '#/components/schemas/_common.query_dsl:IntervalsFuzzy' + match: + $ref: '#/components/schemas/_common.query_dsl:IntervalsMatch' + prefix: + $ref: '#/components/schemas/_common.query_dsl:IntervalsPrefix' + wildcard: + $ref: '#/components/schemas/_common.query_dsl:IntervalsWildcard' + minProperties: 1 + maxProperties: 1 + _common.query_dsl:IntervalsFilter: + type: object + properties: + after: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + before: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + contained_by: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + containing: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + not_contained_by: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + not_containing: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + not_overlapping: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + overlapping: + $ref: '#/components/schemas/_common.query_dsl:IntervalsContainer' + script: + $ref: '#/components/schemas/_common:Script' + minProperties: 1 + maxProperties: 1 + _common.query_dsl:IntervalsFuzzy: + type: object + properties: + analyzer: + description: Analyzer used to normalize the term. + type: string + fuzziness: + $ref: '#/components/schemas/_common:Fuzziness' + prefix_length: + description: Number of beginning characters left unchanged when creating expansions. + type: number + term: + description: The term to match. + type: string + transpositions: + description: Indicates whether edits include transpositions of two adjacent characters (for example, `ab` to `ba`). + type: boolean + use_field: + $ref: '#/components/schemas/_common:Field' + required: + - term + _common.query_dsl:IntervalsMatch: + type: object + properties: + analyzer: + description: Analyzer used to analyze terms in the query. + type: string + max_gaps: + description: |- + Maximum number of positions between the matching terms. + Terms further apart than this are not considered matches. + type: number + ordered: + description: If `true`, matching terms must appear in their specified order. + type: boolean + query: + description: Text you wish to find in the provided field. + type: string + use_field: + $ref: '#/components/schemas/_common:Field' + filter: + $ref: '#/components/schemas/_common.query_dsl:IntervalsFilter' + required: + - query + _common.query_dsl:IntervalsPrefix: + type: object + properties: + analyzer: + description: Analyzer used to analyze the `prefix`. + type: string + prefix: + description: Beginning characters of terms you wish to find in the top-level field. + type: string + use_field: + $ref: '#/components/schemas/_common:Field' + required: + - prefix + _common.query_dsl:IntervalsQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + all_of: + $ref: '#/components/schemas/_common.query_dsl:IntervalsAllOf' + any_of: + $ref: '#/components/schemas/_common.query_dsl:IntervalsAnyOf' + fuzzy: + $ref: '#/components/schemas/_common.query_dsl:IntervalsFuzzy' + match: + $ref: '#/components/schemas/_common.query_dsl:IntervalsMatch' + prefix: + $ref: '#/components/schemas/_common.query_dsl:IntervalsPrefix' + wildcard: + $ref: '#/components/schemas/_common.query_dsl:IntervalsWildcard' + minProperties: 1 + maxProperties: 1 + _common.query_dsl:IntervalsWildcard: + type: object + properties: + analyzer: + description: |- + Analyzer used to analyze the `pattern`. + Defaults to the top-level field's analyzer. + type: string + pattern: + description: Wildcard pattern used to find matching terms. + type: string + use_field: + $ref: '#/components/schemas/_common:Field' + required: + - pattern + _common.query_dsl:Like: + description: Text that we want similar documents for or a lookup to a document's field for the text. + oneOf: + - type: string + - $ref: '#/components/schemas/_common.query_dsl:LikeDocument' + _common.query_dsl:LikeDocument: + type: object + properties: + doc: + description: A document not present in the index. + type: object + fields: + type: array + items: + $ref: '#/components/schemas/_common:Field' + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + per_field_analyzer: + type: object + additionalProperties: + type: string + routing: + $ref: '#/components/schemas/_common:Routing' + version: + $ref: '#/components/schemas/_common:VersionNumber' + version_type: + $ref: '#/components/schemas/_common:VersionType' + _common.query_dsl:MatchAllQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + _common.query_dsl:MatchBoolPrefixQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert the text in the query value into tokens. + type: string + fuzziness: + $ref: '#/components/schemas/_common:Fuzziness' + fuzzy_rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + fuzzy_transpositions: + description: |- + If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). + Can be applied to the term subqueries constructed for all terms but the final term. + type: boolean + max_expansions: + description: |- + Maximum number of terms to which the query will expand. + Can be applied to the term subqueries constructed for all terms but the final term. + type: number + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + operator: + $ref: '#/components/schemas/_common.query_dsl:Operator' + prefix_length: + description: |- + Number of beginning characters left unchanged for fuzzy matching. + Can be applied to the term subqueries constructed for all terms but the final term. + type: number + query: + description: |- + Terms you wish to find in the provided field. + The last term is used in a prefix query. + type: string + required: + - query + _common.query_dsl:MatchNoneQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + _common.query_dsl:MatchPhrasePrefixQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert text in the query value into tokens. + type: string + max_expansions: + description: Maximum number of terms to which the last provided term of the query value will expand. + type: number + query: + description: Text you wish to find in the provided field. + type: string + slop: + description: Maximum number of positions allowed between matching tokens. + type: number + zero_terms_query: + $ref: '#/components/schemas/_common.query_dsl:ZeroTermsQuery' + required: + - query + _common.query_dsl:MatchPhraseQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert the text in the query value into tokens. + type: string + query: + description: Query terms that are analyzed and turned into a phrase query. + type: string + slop: + description: Maximum number of positions allowed between matching tokens. + type: number + zero_terms_query: + $ref: '#/components/schemas/_common.query_dsl:ZeroTermsQuery' + required: + - query + _common.query_dsl:MatchQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert the text in the query value into tokens. + type: string + auto_generate_synonyms_phrase_query: + description: If `true`, match phrase queries are automatically created for multi-term synonyms. + type: boolean + cutoff_frequency: + deprecated: true + type: number + fuzziness: + $ref: '#/components/schemas/_common:Fuzziness' + fuzzy_rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + fuzzy_transpositions: + description: If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). + type: boolean + lenient: + description: If `true`, format-based errors, such as providing a text query value for a numeric field, are ignored. + type: boolean + max_expansions: + description: Maximum number of terms to which the query will expand. + type: number + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + operator: + $ref: '#/components/schemas/_common.query_dsl:Operator' + prefix_length: + description: Number of beginning characters left unchanged for fuzzy matching. + type: number + query: + description: Text, number, boolean value or date you wish to find in the provided field. + oneOf: + - type: string + - type: number + - type: boolean + zero_terms_query: + $ref: '#/components/schemas/_common.query_dsl:ZeroTermsQuery' + required: + - query + _common.query_dsl:MoreLikeThisQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + analyzer: + description: |- + The analyzer that is used to analyze the free form text. + Defaults to the analyzer associated with the first field in fields. + type: string + boost_terms: + description: |- + Each term in the formed query could be further boosted by their tf-idf score. + This sets the boost factor to use when using this feature. + Defaults to deactivated (0). + type: number + fail_on_unsupported_field: + description: Controls whether the query should fail (throw an exception) if any of the specified fields are not of the supported types (`text` or `keyword`). + type: boolean + fields: + description: |- + A list of fields to fetch and analyze the text from. + Defaults to the `index.query.default_field` index setting, which has a default value of `*`. + type: array + items: + $ref: '#/components/schemas/_common:Field' + include: + description: Specifies whether the input documents should also be included in the search results returned. + type: boolean + like: + description: Specifies free form text and/or a single or multiple documents for which you want to find similar documents. + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:Like' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl:Like' + max_doc_freq: + description: The maximum document frequency above which the terms are ignored from the input document. + type: number + max_query_terms: + description: The maximum number of query terms that can be selected. + type: number + max_word_length: + description: |- + The maximum word length above which the terms are ignored. + Defaults to unbounded (`0`). + type: number + min_doc_freq: + description: The minimum document frequency below which the terms are ignored from the input document. + type: number + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + min_term_freq: + description: The minimum term frequency below which the terms are ignored from the input document. + type: number + min_word_length: + description: The minimum word length below which the terms are ignored. + type: number + per_field_analyzer: + description: Overrides the default analyzer. + type: object + additionalProperties: + type: string + routing: + $ref: '#/components/schemas/_common:Routing' + stop_words: + $ref: '#/components/schemas/_common.analysis:StopWords' + unlike: + description: Used in combination with `like` to exclude documents that match a set of terms. + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:Like' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl:Like' + version: + $ref: '#/components/schemas/_common:VersionNumber' + version_type: + $ref: '#/components/schemas/_common:VersionType' + required: + - like + _common.query_dsl:MultiMatchQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert the text in the query value into tokens. + type: string + auto_generate_synonyms_phrase_query: + description: If `true`, match phrase queries are automatically created for multi-term synonyms. + type: boolean + cutoff_frequency: + deprecated: true + type: number + fields: + $ref: '#/components/schemas/_common:Fields' + fuzziness: + $ref: '#/components/schemas/_common:Fuzziness' + fuzzy_rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + fuzzy_transpositions: + description: |- + If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). + Can be applied to the term subqueries constructed for all terms but the final term. + type: boolean + lenient: + description: If `true`, format-based errors, such as providing a text query value for a numeric field, are ignored. + type: boolean + max_expansions: + description: Maximum number of terms to which the query will expand. + type: number + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + operator: + $ref: '#/components/schemas/_common.query_dsl:Operator' + prefix_length: + description: Number of beginning characters left unchanged for fuzzy matching. + type: number + query: + description: Text, number, boolean value or date you wish to find in the provided field. + type: string + slop: + description: Maximum number of positions allowed between matching tokens. + type: number + tie_breaker: + description: Determines how scores for each per-term blended query and scores across groups are combined. + type: number + type: + $ref: '#/components/schemas/_common.query_dsl:TextQueryType' + zero_terms_query: + $ref: '#/components/schemas/_common.query_dsl:ZeroTermsQuery' + required: + - query + _common.query_dsl:MultiValueMode: + type: string + enum: + - min + - max + - avg + - sum + _common.query_dsl:NestedQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + ignore_unmapped: + description: Indicates whether to ignore an unmapped path and not return any documents instead of an error. + type: boolean + inner_hits: + $ref: '#/components/schemas/_core.search:InnerHits' + path: + $ref: '#/components/schemas/_common:Field' + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + score_mode: + $ref: '#/components/schemas/_common.query_dsl:ChildScoreMode' + required: + - path + - query + _common.query_dsl:NumberRangeQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:RangeQueryBase' + - type: object + properties: + gt: + description: Greater than. + type: number + gte: + description: Greater than or equal to. + type: number + lt: + description: Less than. + type: number + lte: + description: Less than or equal to. + type: number + from: + oneOf: + - type: number + - nullable: true + type: string + to: + oneOf: + - type: number + - nullable: true + type: string + _common.query_dsl:NumericDecayFunction: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:DecayFunctionBase' + - type: object + _common.query_dsl:Operator: + type: string + enum: + - and + - or + _common.query_dsl:ParentIdQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + id: + $ref: '#/components/schemas/_common:Id' + ignore_unmapped: + description: Indicates whether to ignore an unmapped `type` and not return any documents instead of an error. + type: boolean + type: + $ref: '#/components/schemas/_common:RelationName' + _common.query_dsl:PercolateQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + document: + description: The source of the document being percolated. + type: object + documents: + description: An array of sources of the documents being percolated. + type: array + items: + type: object + field: + $ref: '#/components/schemas/_common:Field' + id: + $ref: '#/components/schemas/_common:Id' + index: + $ref: '#/components/schemas/_common:IndexName' + name: + description: The suffix used for the `_percolator_document_slot` field when multiple `percolate` queries are specified. + type: string + preference: + description: Preference used to fetch document to percolate. + type: string + routing: + $ref: '#/components/schemas/_common:Routing' + version: + $ref: '#/components/schemas/_common:VersionNumber' + required: + - field + _common.query_dsl:PinnedDoc: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + required: + - _id + - _index + _common.query_dsl:PinnedQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - allOf: + - type: object + properties: + organic: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + required: + - organic + - type: object + properties: + ids: + description: |- + Document IDs listed in the order they are to appear in results. + Required if `docs` is not specified. + type: array + items: + $ref: '#/components/schemas/_common:Id' + docs: + description: |- + Documents listed in the order they are to appear in results. + Required if `ids` is not specified. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:PinnedDoc' + minProperties: 1 + maxProperties: 1 + _common.query_dsl:PrefixQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + value: + description: Beginning characters of terms you wish to find in the provided field. + type: string + case_insensitive: + description: |- + Allows ASCII case insensitive matching of the value with the indexed field values when set to `true`. + Default is `false` which means the case sensitivity of matching depends on the underlying field’s mapping. + type: boolean + required: + - value + _common.query_dsl:QueryBase: + type: object + properties: + boost: + description: |- + Floating point number used to decrease or increase the relevance scores of the query. + Boost values are relative to the default value of 1.0. + A boost value between 0 and 1.0 decreases the relevance score. + A value greater than 1.0 increases the relevance score. + type: number + _name: + type: string + _common.query_dsl:QueryContainer: + type: object + properties: + bool: + $ref: '#/components/schemas/_common.query_dsl:BoolQuery' + boosting: + $ref: '#/components/schemas/_common.query_dsl:BoostingQuery' + common: + deprecated: true + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:CommonTermsQuery' + minProperties: 1 + maxProperties: 1 + combined_fields: + $ref: '#/components/schemas/_common.query_dsl:CombinedFieldsQuery' + constant_score: + $ref: '#/components/schemas/_common.query_dsl:ConstantScoreQuery' + dis_max: + $ref: '#/components/schemas/_common.query_dsl:DisMaxQuery' + distance_feature: + $ref: '#/components/schemas/_common.query_dsl:DistanceFeatureQuery' + exists: + $ref: '#/components/schemas/_common.query_dsl:ExistsQuery' + function_score: + $ref: '#/components/schemas/_common.query_dsl:FunctionScoreQuery' + fuzzy: + description: Returns documents that contain terms similar to the search term, as measured by a Levenshtein edit distance. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:FuzzyQuery' + minProperties: 1 + maxProperties: 1 + geo_bounding_box: + $ref: '#/components/schemas/_common.query_dsl:GeoBoundingBoxQuery' + geo_distance: + $ref: '#/components/schemas/_common.query_dsl:GeoDistanceQuery' + geo_polygon: + $ref: '#/components/schemas/_common.query_dsl:GeoPolygonQuery' + geo_shape: + $ref: '#/components/schemas/_common.query_dsl:GeoShapeQuery' + has_child: + $ref: '#/components/schemas/_common.query_dsl:HasChildQuery' + has_parent: + $ref: '#/components/schemas/_common.query_dsl:HasParentQuery' + ids: + $ref: '#/components/schemas/_common.query_dsl:IdsQuery' + intervals: + description: Returns documents based on the order and proximity of matching terms. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:IntervalsQuery' + minProperties: 1 + maxProperties: 1 + match: + description: |- + Returns documents that match a provided text, number, date or boolean value. + The provided text is analyzed before matching. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:MatchQuery' + minProperties: 1 + maxProperties: 1 + match_all: + $ref: '#/components/schemas/_common.query_dsl:MatchAllQuery' + match_bool_prefix: + description: |- + Analyzes its input and constructs a `bool` query from the terms. + Each term except the last is used in a `term` query. + The last term is used in a prefix query. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:MatchBoolPrefixQuery' + minProperties: 1 + maxProperties: 1 + match_none: + $ref: '#/components/schemas/_common.query_dsl:MatchNoneQuery' + match_phrase: + description: Analyzes the text and creates a phrase query out of the analyzed text. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:MatchPhraseQuery' + minProperties: 1 + maxProperties: 1 + match_phrase_prefix: + description: |- + Returns documents that contain the words of a provided text, in the same order as provided. + The last term of the provided text is treated as a prefix, matching any words that begin with that term. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:MatchPhrasePrefixQuery' + minProperties: 1 + maxProperties: 1 + more_like_this: + $ref: '#/components/schemas/_common.query_dsl:MoreLikeThisQuery' + multi_match: + $ref: '#/components/schemas/_common.query_dsl:MultiMatchQuery' + nested: + $ref: '#/components/schemas/_common.query_dsl:NestedQuery' + parent_id: + $ref: '#/components/schemas/_common.query_dsl:ParentIdQuery' + percolate: + $ref: '#/components/schemas/_common.query_dsl:PercolateQuery' + pinned: + $ref: '#/components/schemas/_common.query_dsl:PinnedQuery' + prefix: + description: Returns documents that contain a specific prefix in a provided field. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:PrefixQuery' + minProperties: 1 + maxProperties: 1 + query_string: + $ref: '#/components/schemas/_common.query_dsl:QueryStringQuery' + range: + description: Returns documents that contain terms within a provided range. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:RangeQuery' + minProperties: 1 + maxProperties: 1 + rank_feature: + $ref: '#/components/schemas/_common.query_dsl:RankFeatureQuery' + regexp: + description: Returns documents that contain terms matching a regular expression. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:RegexpQuery' + minProperties: 1 + maxProperties: 1 + rule_query: + $ref: '#/components/schemas/_common.query_dsl:RuleQuery' + script: + $ref: '#/components/schemas/_common.query_dsl:ScriptQuery' + script_score: + $ref: '#/components/schemas/_common.query_dsl:ScriptScoreQuery' + shape: + $ref: '#/components/schemas/_common.query_dsl:ShapeQuery' + simple_query_string: + $ref: '#/components/schemas/_common.query_dsl:SimpleQueryStringQuery' + span_containing: + $ref: '#/components/schemas/_common.query_dsl:SpanContainingQuery' + field_masking_span: + $ref: '#/components/schemas/_common.query_dsl:SpanFieldMaskingQuery' + span_first: + $ref: '#/components/schemas/_common.query_dsl:SpanFirstQuery' + span_multi: + $ref: '#/components/schemas/_common.query_dsl:SpanMultiTermQuery' + span_near: + $ref: '#/components/schemas/_common.query_dsl:SpanNearQuery' + span_not: + $ref: '#/components/schemas/_common.query_dsl:SpanNotQuery' + span_or: + $ref: '#/components/schemas/_common.query_dsl:SpanOrQuery' + span_term: + description: Matches spans containing a term. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:SpanTermQuery' + minProperties: 1 + maxProperties: 1 + span_within: + $ref: '#/components/schemas/_common.query_dsl:SpanWithinQuery' + term: + description: |- + Returns documents that contain an exact term in a provided field. + To return a document, the query term must exactly match the queried field's value, including whitespace and capitalization. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:TermQuery' + minProperties: 1 + maxProperties: 1 + terms: + $ref: '#/components/schemas/_common.query_dsl:TermsQuery' + terms_set: + description: |- + Returns documents that contain a minimum number of exact terms in a provided field. + To return a document, a required number of terms must exactly match the field values, including whitespace and capitalization. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:TermsSetQuery' + minProperties: 1 + maxProperties: 1 + text_expansion: + description: Uses a natural language processing model to convert the query text into a list of token-weight pairs which are then used in a query against a sparse vector or rank features field. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:TextExpansionQuery' + minProperties: 1 + maxProperties: 1 + weighted_tokens: + description: Supports returning text_expansion query results by sending in precomputed tokens with the query. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:WeightedTokensQuery' + minProperties: 1 + maxProperties: 1 + wildcard: + description: Returns documents that contain terms matching a wildcard pattern. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:WildcardQuery' + minProperties: 1 + maxProperties: 1 + wrapper: + $ref: '#/components/schemas/_common.query_dsl:WrapperQuery' + type: + $ref: '#/components/schemas/_common.query_dsl:TypeQuery' + minProperties: 1 + maxProperties: 1 + _common.query_dsl:QueryStringQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + allow_leading_wildcard: + description: If `true`, the wildcard characters `*` and `?` are allowed as the first character of the query string. + type: boolean + analyzer: + description: Analyzer used to convert text in the query string into tokens. + type: string + analyze_wildcard: + description: If `true`, the query attempts to analyze wildcard terms in the query string. + type: boolean + auto_generate_synonyms_phrase_query: + description: If `true`, match phrase queries are automatically created for multi-term synonyms. + type: boolean + default_field: + $ref: '#/components/schemas/_common:Field' + default_operator: + $ref: '#/components/schemas/_common.query_dsl:Operator' + enable_position_increments: + description: If `true`, enable position increments in queries constructed from a `query_string` search. + type: boolean + escape: + type: boolean + fields: + description: Array of fields to search. Supports wildcards (`*`). + type: array + items: + $ref: '#/components/schemas/_common:Field' + fuzziness: + $ref: '#/components/schemas/_common:Fuzziness' + fuzzy_max_expansions: + description: Maximum number of terms to which the query expands for fuzzy matching. + type: number + fuzzy_prefix_length: + description: Number of beginning characters left unchanged for fuzzy matching. + type: number + fuzzy_rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + fuzzy_transpositions: + description: If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). + type: boolean + lenient: + description: If `true`, format-based errors, such as providing a text value for a numeric field, are ignored. + type: boolean + max_determinized_states: + description: Maximum number of automaton states required for the query. + type: number + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + phrase_slop: + description: Maximum number of positions allowed between matching tokens for phrases. + type: number + query: + description: Query string you wish to parse and use for search. + type: string + quote_analyzer: + description: |- + Analyzer used to convert quoted text in the query string into tokens. + For quoted text, this parameter overrides the analyzer specified in the `analyzer` parameter. + type: string + quote_field_suffix: + description: |- + Suffix appended to quoted text in the query string. + You can use this suffix to use a different analysis method for exact matches. + type: string + rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + tie_breaker: + description: How to combine the queries generated from the individual search terms in the resulting `dis_max` query. + type: number + time_zone: + $ref: '#/components/schemas/_common:TimeZone' + type: + $ref: '#/components/schemas/_common.query_dsl:TextQueryType' + required: + - query + _common.query_dsl:RandomScoreFunction: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + seed: + oneOf: + - type: number + - type: string + _common.query_dsl:RangeQuery: + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:DateRangeQuery' + - $ref: '#/components/schemas/_common.query_dsl:NumberRangeQuery' + _common.query_dsl:RangeQueryBase: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + relation: + $ref: '#/components/schemas/_common.query_dsl:RangeRelation' + _common.query_dsl:RangeRelation: + type: string + enum: + - within + - contains + - intersects + _common.query_dsl:RankFeatureFunction: + type: object + _common.query_dsl:RankFeatureFunctionLinear: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:RankFeatureFunction' + - type: object + _common.query_dsl:RankFeatureFunctionLogarithm: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:RankFeatureFunction' + - type: object + properties: + scaling_factor: + description: Configurable scaling factor. + type: number + required: + - scaling_factor + _common.query_dsl:RankFeatureFunctionSaturation: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:RankFeatureFunction' + - type: object + properties: + pivot: + description: Configurable pivot value so that the result will be less than 0.5. + type: number + _common.query_dsl:RankFeatureFunctionSigmoid: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:RankFeatureFunction' + - type: object + properties: + pivot: + description: Configurable pivot value so that the result will be less than 0.5. + type: number + exponent: + description: Configurable Exponent. + type: number + required: + - pivot + - exponent + _common.query_dsl:RankFeatureQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + saturation: + $ref: '#/components/schemas/_common.query_dsl:RankFeatureFunctionSaturation' + log: + $ref: '#/components/schemas/_common.query_dsl:RankFeatureFunctionLogarithm' + linear: + $ref: '#/components/schemas/_common.query_dsl:RankFeatureFunctionLinear' + sigmoid: + $ref: '#/components/schemas/_common.query_dsl:RankFeatureFunctionSigmoid' + required: + - field + _common.query_dsl:RegexpQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + case_insensitive: + description: |- + Allows case insensitive matching of the regular expression value with the indexed field values when set to `true`. + When `false`, case sensitivity of matching depends on the underlying field’s mapping. + type: boolean + flags: + description: Enables optional operators for the regular expression. + type: string + max_determinized_states: + description: Maximum number of automaton states required for the query. + type: number + rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + value: + description: Regular expression for terms you wish to find in the provided field. + type: string + required: + - value + _common.query_dsl:RuleQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + organic: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + ruleset_id: + $ref: '#/components/schemas/_common:Id' + match_criteria: + type: object + required: + - organic + - ruleset_id + - match_criteria + _common.query_dsl:ScriptQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + script: + $ref: '#/components/schemas/_common:Script' + required: + - script + _common.query_dsl:ScriptScoreFunction: + type: object + properties: + script: + $ref: '#/components/schemas/_common:Script' + required: + - script + _common.query_dsl:ScriptScoreQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + min_score: + description: Documents with a score lower than this floating point number are excluded from the search results. + type: number + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + script: + $ref: '#/components/schemas/_common:Script' + required: + - query + - script + _common.query_dsl:ShapeQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + ignore_unmapped: + description: When set to `true` the query ignores an unmapped field and will not match any documents. + type: boolean + _common.query_dsl:SimpleQueryStringFlag: + type: string + enum: + - NONE + - AND + - NOT + - OR + - PREFIX + - PHRASE + - PRECEDENCE + - ESCAPE + - WHITESPACE + - FUZZY + - NEAR + - SLOP + - ALL + _common.query_dsl:SimpleQueryStringFlags: + description: Query flags can be either a single flag or a combination of flags, e.g. `OR|AND|PREFIX` + allOf: + - $ref: '#/components/schemas/_common:PipeSeparatedFlagsSimpleQueryStringFlag' + _common.query_dsl:SimpleQueryStringQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert text in the query string into tokens. + type: string + analyze_wildcard: + description: If `true`, the query attempts to analyze wildcard terms in the query string. + type: boolean + auto_generate_synonyms_phrase_query: + description: If `true`, the parser creates a match_phrase query for each multi-position token. + type: boolean + default_operator: + $ref: '#/components/schemas/_common.query_dsl:Operator' + fields: + description: |- + Array of fields you wish to search. + Accepts wildcard expressions. + You also can boost relevance scores for matches to particular fields using a caret (`^`) notation. + Defaults to the `index.query.default_field index` setting, which has a default value of `*`. + type: array + items: + $ref: '#/components/schemas/_common:Field' + flags: + $ref: '#/components/schemas/_common.query_dsl:SimpleQueryStringFlags' + fuzzy_max_expansions: + description: Maximum number of terms to which the query expands for fuzzy matching. + type: number + fuzzy_prefix_length: + description: Number of beginning characters left unchanged for fuzzy matching. + type: number + fuzzy_transpositions: + description: If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). + type: boolean + lenient: + description: If `true`, format-based errors, such as providing a text value for a numeric field, are ignored. + type: boolean + minimum_should_match: + $ref: '#/components/schemas/_common:MinimumShouldMatch' + query: + description: Query string in the simple query string syntax you wish to parse and use for search. + type: string + quote_field_suffix: + description: Suffix appended to quoted text in the query string. + type: string + required: + - query + _common.query_dsl:SpanContainingQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + big: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + little: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + required: + - big + - little + _common.query_dsl:SpanFieldMaskingQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + query: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + required: + - field + - query + _common.query_dsl:SpanFirstQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + end: + description: Controls the maximum end position permitted in a match. + type: number + match: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + required: + - end + - match + _common.query_dsl:SpanGapQuery: + description: Can only be used as a clause in a span_near query. + type: object + additionalProperties: + type: number + minProperties: 1 + maxProperties: 1 + _common.query_dsl:SpanMultiTermQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + match: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + required: + - match + _common.query_dsl:SpanNearQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + clauses: + description: Array of one or more other span type queries. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + in_order: + description: Controls whether matches are required to be in-order. + type: boolean + slop: + description: Controls the maximum number of intervening unmatched positions permitted. + type: number + required: + - clauses + _common.query_dsl:SpanNotQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + dist: + description: |- + The number of tokens from within the include span that can’t have overlap with the exclude span. + Equivalent to setting both `pre` and `post`. + type: number + exclude: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + include: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + post: + description: The number of tokens after the include span that can’t have overlap with the exclude span. + type: number + pre: + description: The number of tokens before the include span that can’t have overlap with the exclude span. + type: number + required: + - exclude + - include + _common.query_dsl:SpanOrQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + clauses: + description: Array of one or more other span type queries. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + required: + - clauses + _common.query_dsl:SpanQuery: + type: object + properties: + span_containing: + $ref: '#/components/schemas/_common.query_dsl:SpanContainingQuery' + field_masking_span: + $ref: '#/components/schemas/_common.query_dsl:SpanFieldMaskingQuery' + span_first: + $ref: '#/components/schemas/_common.query_dsl:SpanFirstQuery' + span_gap: + $ref: '#/components/schemas/_common.query_dsl:SpanGapQuery' + span_multi: + $ref: '#/components/schemas/_common.query_dsl:SpanMultiTermQuery' + span_near: + $ref: '#/components/schemas/_common.query_dsl:SpanNearQuery' + span_not: + $ref: '#/components/schemas/_common.query_dsl:SpanNotQuery' + span_or: + $ref: '#/components/schemas/_common.query_dsl:SpanOrQuery' + span_term: + description: The equivalent of the `term` query but for use with other span queries. + type: object + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl:SpanTermQuery' + minProperties: 1 + maxProperties: 1 + span_within: + $ref: '#/components/schemas/_common.query_dsl:SpanWithinQuery' + minProperties: 1 + maxProperties: 1 + _common.query_dsl:SpanTermQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + value: + type: string + required: + - value + _common.query_dsl:SpanWithinQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + big: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + little: + $ref: '#/components/schemas/_common.query_dsl:SpanQuery' + required: + - big + - little + _common.query_dsl:TermQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + value: + $ref: '#/components/schemas/_common:FieldValue' + case_insensitive: + description: |- + Allows ASCII case insensitive matching of the value with the indexed field values when set to `true`. + When `false`, the case sensitivity of matching depends on the underlying field’s mapping. + type: boolean + required: + - value + _common.query_dsl:TermsQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + _common.query_dsl:TermsSetQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + minimum_should_match_field: + $ref: '#/components/schemas/_common:Field' + minimum_should_match_script: + $ref: '#/components/schemas/_common:Script' + terms: + description: Array of terms you wish to find in the provided field. + type: array + items: + type: string + required: + - terms + _common.query_dsl:TextExpansionQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + model_id: + description: The text expansion NLP model to use + type: string + model_text: + description: The query text + type: string + pruning_config: + $ref: '#/components/schemas/_common.query_dsl:TokenPruningConfig' + required: + - model_id + - model_text + _common.query_dsl:TextQueryType: + type: string + enum: + - best_fields + - most_fields + - cross_fields + - phrase + - phrase_prefix + - bool_prefix + _common.query_dsl:TokenPruningConfig: + type: object + properties: + tokens_freq_ratio_threshold: + description: Tokens whose frequency is more than this threshold times the average frequency of all tokens in the specified field are considered outliers and pruned. + type: number + tokens_weight_threshold: + description: Tokens whose weight is less than this threshold are considered nonsignificant and pruned. + type: number + only_score_pruned_tokens: + description: Whether to only score pruned tokens, vs only scoring kept tokens. + type: boolean + _common.query_dsl:TypeQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + value: + type: string + required: + - value + _common.query_dsl:WeightedTokensQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + tokens: + description: The tokens representing this query + type: object + additionalProperties: + type: number + pruning_config: + $ref: '#/components/schemas/_common.query_dsl:TokenPruningConfig' + required: + - tokens + _common.query_dsl:WildcardQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + case_insensitive: + description: Allows case insensitive matching of the pattern with the indexed field values when set to true. Default is false which means the case sensitivity of matching depends on the underlying field’s mapping. + type: boolean + rewrite: + $ref: '#/components/schemas/_common:MultiTermQueryRewrite' + value: + description: Wildcard pattern for terms you wish to find in the provided field. Required, when wildcard is not set. + type: string + wildcard: + description: Wildcard pattern for terms you wish to find in the provided field. Required, when value is not set. + type: string + _common.query_dsl:WrapperQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryBase' + - type: object + properties: + query: + description: |- + A base64 encoded query. + The binary data format can be any of JSON, YAML, CBOR or SMILE encodings + type: string + required: + - query + _common.query_dsl:ZeroTermsQuery: + type: string + enum: + - all + - none + _common:AcknowledgedResponseBase: + type: object + properties: + acknowledged: + description: For a successful response, this value is always true. On failure, an exception is returned instead. + type: boolean + required: + - acknowledged + _common:ActionStatusOptions: + type: string + enum: + - success + - failure + - simulated + - throttled + _common:BaseNode: + type: object + properties: + attributes: + type: object + additionalProperties: + type: string + host: + $ref: '#/components/schemas/_common:Host' + ip: + $ref: '#/components/schemas/_common:Ip' + name: + $ref: '#/components/schemas/_common:Name' + roles: + $ref: '#/components/schemas/_common:NodeRoles' + transport_address: + $ref: '#/components/schemas/_common:TransportAddress' + required: + - attributes + - host + - ip + - name + - transport_address + _common:BulkIndexByScrollFailure: + type: object + properties: + cause: + $ref: '#/components/schemas/_common:ErrorCause' + id: + $ref: '#/components/schemas/_common:Id' + index: + $ref: '#/components/schemas/_common:IndexName' + status: + type: number + type: + type: string + required: + - cause + - id + - index + - status + - type + _common:BulkStats: + type: object + properties: + total_operations: + type: number + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total_size: + $ref: '#/components/schemas/_common:ByteSize' + total_size_in_bytes: + type: number + avg_time: + $ref: '#/components/schemas/_common:Duration' + avg_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + avg_size: + $ref: '#/components/schemas/_common:ByteSize' + avg_size_in_bytes: + type: number + required: + - total_operations + - total_time_in_millis + - total_size_in_bytes + - avg_time_in_millis + - avg_size_in_bytes + _common:ByteSize: + oneOf: + - type: number + - type: string + _common:Bytes: + type: string + enum: + - b + - k + - kb + - m + - mb + - g + - gb + - t + - tb + - p + - pb + _common:ClusterDetails: + type: object + properties: + status: + $ref: '#/components/schemas/_common:ClusterSearchStatus' + indices: + type: string + took: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + timed_out: + type: boolean + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + failures: + type: array + items: + $ref: '#/components/schemas/_common:ShardFailure' + required: + - status + - indices + - timed_out + _common:ClusterSearchStatus: + type: string + enum: + - running + - successful + - partial + - skipped + - failed + _common:ClusterStatistics: + type: object + properties: + skipped: + type: number + successful: + type: number + total: + type: number + running: + type: number + partial: + type: number + failed: + type: number + details: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:ClusterDetails' + required: + - skipped + - successful + - total + - running + - partial + - failed + _common:CompletionStats: + type: object + properties: + size_in_bytes: + description: Total amount, in bytes, of memory used for completion across all shards assigned to selected nodes. + type: number + size: + $ref: '#/components/schemas/_common:ByteSize' + fields: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:FieldSizeUsage' + required: + - size_in_bytes + _common:Conflicts: + type: string + enum: + - abort + - proceed + _common:CoordsGeoBounds: + type: object + properties: + top: + type: number + bottom: + type: number + left: + type: number + right: + type: number + required: + - top + - bottom + - left + - right + _common:DFIIndependenceMeasure: + type: string + enum: + - standardized + - saturated + - chisquared + _common:DFRAfterEffect: + type: string + enum: + - no + - b + - l + _common:DFRBasicModel: + type: string + enum: + - be + - d + - g + - if + - in + - ine + - p + _common:DataStreamName: + type: string + _common:DataStreamNames: + oneOf: + - $ref: '#/components/schemas/_common:DataStreamName' + - type: array + items: + $ref: '#/components/schemas/_common:DataStreamName' + _common:DateFormat: + type: string + _common:DateMath: + type: string + _common:DateTime: + description: |- + A date and time, either as a string whose format can depend on the context (defaulting to ISO 8601), or a + number of milliseconds since the Epoch. Opensearch accepts both as input, but will generally output a string + representation. + oneOf: + - type: string + - $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + _common:Distance: + type: string + _common:DistanceUnit: + type: string + enum: + - in + - ft + - yd + - mi + - nmi + - km + - m + - cm + - mm + _common:DocStats: + type: object + properties: + count: + description: |- + Total number of non-deleted documents across all primary shards assigned to selected nodes. + This number is based on documents in Lucene segments and may include documents from nested fields. + type: number + deleted: + description: |- + Total number of deleted documents across all primary shards assigned to selected nodes. + This number is based on documents in Lucene segments. + Opensearch reclaims the disk space of deleted Lucene documents when a segment is merged. + type: number + required: + - count + _common:Duration: + description: |- + A duration. Units can be `nanos`, `micros`, `ms` (milliseconds), `s` (seconds), `m` (minutes), `h` (hours) and + `d` (days). Also accepts "0" without a unit and "-1" to indicate an unspecified value. + x-data-type: time + pattern: ^([0-9]+)(?:d|h|m|s|ms|micros|nanos)$ + type: string + _common:DurationLarge: + description: |- + A date histogram interval. Similar to `Duration` with additional units: `w` (week), `M` (month), `q` (quarter) and + `y` (year) + type: string + _common:DurationValueUnitMillis: + allOf: + - $ref: '#/components/schemas/_common:UnitMillis' + _common:DurationValueUnitNanos: + allOf: + - $ref: '#/components/schemas/_common:UnitNanos' + _common:EmptyObject: + type: object + _common:EpochTimeUnitMillis: + allOf: + - $ref: '#/components/schemas/_common:UnitMillis' + _common:EpochTimeUnitSeconds: + allOf: + - $ref: '#/components/schemas/_common:UnitSeconds' + _common:ErrorCause: + type: object + properties: + type: + description: The type of error + type: string + reason: + description: A human-readable explanation of the error, in english + type: string + stack_trace: + description: The server stack trace. Present only if the `error_trace=true` parameter was sent with the request. + type: string + caused_by: + $ref: '#/components/schemas/_common:ErrorCause' + root_cause: + type: array + items: + $ref: '#/components/schemas/_common:ErrorCause' + suppressed: + type: array + items: + $ref: '#/components/schemas/_common:ErrorCause' + required: + - type + _common:ErrorResponseBase: + type: object + properties: + error: + $ref: '#/components/schemas/_common:ErrorCause' + status: + type: number + required: + - error + - status + _common:ExpandWildcard: + type: string + enum: + - all + - open + - closed + - hidden + - none + _common:ExpandWildcards: + oneOf: + - $ref: '#/components/schemas/_common:ExpandWildcard' + - type: array + items: + $ref: '#/components/schemas/_common:ExpandWildcard' + _common:Field: + description: Path to field or array of paths. Some API's support wildcards in the path to select multiple fields. + type: string + _common:FieldMemoryUsage: + type: object + properties: + memory_size: + $ref: '#/components/schemas/_common:ByteSize' + memory_size_in_bytes: + type: number + required: + - memory_size_in_bytes + _common:FieldSizeUsage: + type: object + properties: + size: + $ref: '#/components/schemas/_common:ByteSize' + size_in_bytes: + type: number + required: + - size_in_bytes + _common:FieldValue: + description: A field value. + oneOf: + - type: number + - type: number + - type: string + - type: boolean + - nullable: true + type: string + - type: object + _common:FielddataStats: + type: object + properties: + evictions: + type: number + memory_size: + $ref: '#/components/schemas/_common:ByteSize' + memory_size_in_bytes: + type: number + fields: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:FieldMemoryUsage' + required: + - memory_size_in_bytes + _common:Fields: + oneOf: + - $ref: '#/components/schemas/_common:Field' + - type: array + items: + $ref: '#/components/schemas/_common:Field' + _common:FlushStats: + type: object + properties: + periodic: + type: number + total: + type: number + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - periodic + - total + - total_time_in_millis + _common:Fuzziness: + oneOf: + - type: string + - type: number + _common:GeoBounds: + description: |- + A geo bounding box. It can be represented in various ways: + - as 4 top/bottom/left/right coordinates + - as 2 top_left / bottom_right points + - as 2 top_right / bottom_left points + - as a WKT bounding box + oneOf: + - $ref: '#/components/schemas/_common:CoordsGeoBounds' + - $ref: '#/components/schemas/_common:TopLeftBottomRightGeoBounds' + - $ref: '#/components/schemas/_common:TopRightBottomLeftGeoBounds' + - $ref: '#/components/schemas/_common:WktGeoBounds' + _common:GeoDistanceSort: + type: object + properties: + mode: + $ref: '#/components/schemas/_common:SortMode' + distance_type: + $ref: '#/components/schemas/_common:GeoDistanceType' + ignore_unmapped: + type: boolean + order: + $ref: '#/components/schemas/_common:SortOrder' + unit: + $ref: '#/components/schemas/_common:DistanceUnit' + _common:GeoDistanceType: + type: string + enum: + - arc + - plane + _common:GeoHash: + type: string + _common:GeoHashLocation: + type: object + properties: + geohash: + $ref: '#/components/schemas/_common:GeoHash' + required: + - geohash + _common:GeoHashPrecision: + description: A precision that can be expressed as a geohash length between 1 and 12, or a distance measure like "1km", "10m". + oneOf: + - type: number + - type: string + _common:GeoHexCell: + description: A map hex cell (H3) reference + type: string + _common:GeoLine: + type: object + properties: + type: + description: Always `"LineString"` + type: string + coordinates: + description: Array of `[lon, lat]` coordinates + type: array + items: + type: array + items: + type: number + required: + - type + - coordinates + _common:GeoLocation: + description: |- + A latitude/longitude as a 2 dimensional point. It can be represented in various ways: + - as a `{lat, long}` object + - as a geo hash value + - as a `[lon, lat]` array + - as a string in `", "` or WKT point formats + oneOf: + - $ref: '#/components/schemas/_common:LatLonGeoLocation' + - $ref: '#/components/schemas/_common:GeoHashLocation' + - type: array + items: + type: number + - type: string + _common:GeoShapeRelation: + type: string + enum: + - intersects + - disjoint + - within + - contains + _common:GeoTile: + description: A map tile reference, represented as `{zoom}/{x}/{y}` + type: string + _common:GeoTilePrecision: + type: number + _common:GetStats: + type: object + properties: + current: + type: number + exists_time: + $ref: '#/components/schemas/_common:Duration' + exists_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + exists_total: + type: number + missing_time: + $ref: '#/components/schemas/_common:Duration' + missing_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + missing_total: + type: number + time: + $ref: '#/components/schemas/_common:Duration' + time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total: + type: number + required: + - current + - exists_time_in_millis + - exists_total + - missing_time_in_millis + - missing_total + - time_in_millis + - total + _common:HealthStatus: + type: string + enum: + - green + - yellow + - red + _common:Host: + type: string + _common:HourAndMinute: + type: object + properties: + hour: + type: array + items: + type: number + minute: + type: array + items: + type: number + required: + - hour + - minute + _common:HttpHeaders: + type: object + additionalProperties: + oneOf: + - type: string + - type: array + items: + type: string + _common:IBDistribution: + type: string + enum: + - ll + - spl + _common:IBLambda: + type: string + enum: + - df + - ttf + _common:Id: + type: string + _common:Ids: + oneOf: + - $ref: '#/components/schemas/_common:Id' + - type: array + items: + $ref: '#/components/schemas/_common:Id' + _common:IndexAlias: + type: string + _common:IndexName: + type: string + _common:IndexingStats: + type: object + properties: + index_current: + type: number + delete_current: + type: number + delete_time: + $ref: '#/components/schemas/_common:Duration' + delete_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + delete_total: + type: number + is_throttled: + type: boolean + noop_update_total: + type: number + throttle_time: + $ref: '#/components/schemas/_common:Duration' + throttle_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + index_time: + $ref: '#/components/schemas/_common:Duration' + index_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + index_total: + type: number + index_failed: + type: number + types: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:IndexingStats' + write_load: + type: number + required: + - index_current + - delete_current + - delete_time_in_millis + - delete_total + - is_throttled + - noop_update_total + - throttle_time_in_millis + - index_time_in_millis + - index_total + - index_failed + _common:Indices: + oneOf: + - $ref: '#/components/schemas/_common:IndexName' + - type: array + items: + $ref: '#/components/schemas/_common:IndexName' + _common:IndicesResponseBase: + allOf: + - $ref: '#/components/schemas/_common:AcknowledgedResponseBase' + - type: object + properties: + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + _common:InlineGet: + type: object + properties: + fields: + type: object + additionalProperties: + type: object + found: + type: boolean + _seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + _primary_term: + type: number + _routing: + $ref: '#/components/schemas/_common:Routing' + _source: + type: object + required: + - found + - _source + _common:InlineGetDictUserDefined: + type: object + properties: + fields: + type: object + additionalProperties: + type: object + found: + type: boolean + _seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + _primary_term: + type: number + _routing: + $ref: '#/components/schemas/_common:Routing' + _source: + type: object + additionalProperties: + type: object + required: + - found + - _source + _common:InlineScript: + allOf: + - $ref: '#/components/schemas/_common:ScriptBase' + - type: object + properties: + lang: + $ref: '#/components/schemas/_common:ScriptLanguage' + options: + type: object + additionalProperties: + type: string + source: + description: The script source. + type: string + required: + - source + _common:Ip: + type: string + _common:KnnQuery: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + query_vector: + $ref: '#/components/schemas/_common:QueryVector' + query_vector_builder: + $ref: '#/components/schemas/_common:QueryVectorBuilder' + k: + description: The final number of nearest neighbors to return as top hits + type: number + num_candidates: + description: The number of nearest neighbor candidates to consider per shard + type: number + boost: + description: Boost value to apply to kNN scores + type: number + filter: + description: Filters for the kNN search query + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + similarity: + description: The minimum similarity for a vector to be considered a match + type: number + required: + - field + - k + - num_candidates + _common:LatLonGeoLocation: + type: object + properties: + lat: + description: Latitude + type: number + lon: + description: Longitude + type: number + required: + - lat + - lon + _common:Level: + type: string + enum: + - cluster + - indices + - shards + _common:MergesStats: + type: object + properties: + current: + type: number + current_docs: + type: number + current_size: + type: string + current_size_in_bytes: + type: number + total: + type: number + total_auto_throttle: + type: string + total_auto_throttle_in_bytes: + type: number + total_docs: + type: number + total_size: + type: string + total_size_in_bytes: + type: number + total_stopped_time: + $ref: '#/components/schemas/_common:Duration' + total_stopped_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total_throttled_time: + $ref: '#/components/schemas/_common:Duration' + total_throttled_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - current + - current_docs + - current_size_in_bytes + - total + - total_auto_throttle_in_bytes + - total_docs + - total_size_in_bytes + - total_stopped_time_in_millis + - total_throttled_time_in_millis + - total_time_in_millis + _common:Metadata: + type: object + additionalProperties: + type: object + _common:Metrics: + oneOf: + - type: string + - type: array + items: + type: string + _common:MinimumShouldMatch: + description: The minimum number of terms that should match as integer, percentage or range + oneOf: + - type: number + - type: string + _common:MultiTermQueryRewrite: + type: string + _common:Name: + type: string + _common:Names: + oneOf: + - $ref: '#/components/schemas/_common:Name' + - type: array + items: + $ref: '#/components/schemas/_common:Name' + _common:NestedSortValue: + type: object + properties: + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + max_children: + type: number + nested: + $ref: '#/components/schemas/_common:NestedSortValue' + path: + $ref: '#/components/schemas/_common:Field' + required: + - path + _common:NodeAttributes: + type: object + properties: + attributes: + description: Lists node attributes. + type: object + additionalProperties: + type: string + ephemeral_id: + $ref: '#/components/schemas/_common:Id' + id: + $ref: '#/components/schemas/_common:NodeId' + name: + $ref: '#/components/schemas/_common:NodeName' + transport_address: + $ref: '#/components/schemas/_common:TransportAddress' + roles: + $ref: '#/components/schemas/_common:NodeRoles' + external_id: + type: string + required: + - attributes + - ephemeral_id + - name + - transport_address + _common:NodeId: + type: string + _common:NodeIds: + oneOf: + - $ref: '#/components/schemas/_common:NodeId' + - type: array + items: + $ref: '#/components/schemas/_common:NodeId' + _common:NodeName: + type: string + _common:NodeRole: + type: string + enum: + - master + - data + - data_cold + - data_content + - data_frozen + - data_hot + - data_warm + - client + - ingest + - ml + - voting_only + - transform + - remote_cluster_client + - coordinating_only + _common:NodeRoles: + description: '* @doc_id node-roles' + type: array + items: + $ref: '#/components/schemas/_common:NodeRole' + _common:NodeShard: + type: object + properties: + state: + $ref: '#/components/schemas/indices.stats:ShardRoutingState' + primary: + type: boolean + node: + $ref: '#/components/schemas/_common:NodeName' + shard: + type: number + index: + $ref: '#/components/schemas/_common:IndexName' + allocation_id: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:Id' + recovery_source: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:Id' + unassigned_info: + $ref: '#/components/schemas/cluster.allocation_explain:UnassignedInformation' + relocating_node: + oneOf: + - $ref: '#/components/schemas/_common:NodeId' + - nullable: true + type: string + relocation_failure_info: + $ref: '#/components/schemas/_common:RelocationFailureInfo' + required: + - state + - primary + - shard + - index + _common:NodeStatistics: + type: object + properties: + failures: + type: array + items: + $ref: '#/components/schemas/_common:ErrorCause' + total: + description: Total number of nodes selected by the request. + type: number + successful: + description: Number of nodes that responded successfully to the request. + type: number + failed: + description: Number of nodes that rejected the request or failed to respond. If this value is not 0, a reason for the rejection or failure is included in the response. + type: number + required: + - total + - successful + - failed + _common:Normalization: + type: string + enum: + - no + - h1 + - h2 + - h3 + - z + _common:OpType: + type: string + enum: + - index + - create + _common:OpensearchVersionInfo: + type: object + properties: + build_date: + $ref: '#/components/schemas/_common:DateTime' + build_flavor: + type: string + build_hash: + type: string + build_snapshot: + type: boolean + build_type: + type: string + lucene_version: + $ref: '#/components/schemas/_common:VersionString' + minimum_index_compatibility_version: + $ref: '#/components/schemas/_common:VersionString' + minimum_wire_compatibility_version: + $ref: '#/components/schemas/_common:VersionString' + number: + type: string + required: + - build_date + - build_flavor + - build_hash + - build_snapshot + - build_type + - lucene_version + - minimum_index_compatibility_version + - minimum_wire_compatibility_version + - number + _common:Password: + type: string + _common:Percentage: + oneOf: + - type: string + - type: number + _common:PipeSeparatedFlagsSimpleQueryStringFlag: + description: |- + A set of flags that can be represented as a single enum value or a set of values that are encoded + as a pipe-separated string + + Depending on the target language, code generators can use this hint to generate language specific + flags enum constructs and the corresponding (de-)serialization code. + oneOf: + - $ref: '#/components/schemas/_common.query_dsl:SimpleQueryStringFlag' + - type: string + _common:PipelineName: + type: string + _common:PluginStats: + type: object + properties: + classname: + type: string + description: + type: string + extended_plugins: + type: array + items: + type: string + has_native_controller: + type: boolean + java_version: + $ref: '#/components/schemas/_common:VersionString' + name: + $ref: '#/components/schemas/_common:Name' + version: + $ref: '#/components/schemas/_common:VersionString' + licensed: + type: boolean + opensearch_version: + $ref: '#/components/schemas/_common:VersionString' + required: + - classname + - description + - opensearch_version + - extended_plugins + - has_native_controller + - java_version + - name + - version + - licensed + _common:QueryCacheStats: + type: object + properties: + cache_count: + description: |- + Total number of entries added to the query cache across all shards assigned to selected nodes. + This number includes current and evicted entries. + type: number + cache_size: + description: Total number of entries currently in the query cache across all shards assigned to selected nodes. + type: number + evictions: + description: Total number of query cache evictions across all shards assigned to selected nodes. + type: number + hit_count: + description: Total count of query cache hits across all shards assigned to selected nodes. + type: number + memory_size: + $ref: '#/components/schemas/_common:ByteSize' + memory_size_in_bytes: + description: Total amount, in bytes, of memory used for the query cache across all shards assigned to selected nodes. + type: number + miss_count: + description: Total count of query cache misses across all shards assigned to selected nodes. + type: number + total_count: + description: Total count of hits and misses in the query cache across all shards assigned to selected nodes. + type: number + required: + - cache_count + - cache_size + - evictions + - hit_count + - memory_size_in_bytes + - miss_count + - total_count + _common:QueryVector: + type: array + items: + type: number + _common:QueryVectorBuilder: + type: object + properties: + text_embedding: + $ref: '#/components/schemas/_common:TextEmbedding' + minProperties: 1 + maxProperties: 1 + _common:RankBase: + type: object + _common:RankContainer: + type: object + properties: + rrf: + $ref: '#/components/schemas/_common:RrfRank' + minProperties: 1 + maxProperties: 1 + _common:RecoveryStats: + type: object + properties: + current_as_source: + type: number + current_as_target: + type: number + throttle_time: + $ref: '#/components/schemas/_common:Duration' + throttle_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - current_as_source + - current_as_target + - throttle_time_in_millis + _common:Refresh: + type: string + enum: + - 'true' + - 'false' + - wait_for + _common:RefreshStats: + type: object + properties: + external_total: + type: number + external_total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + listeners: + type: number + total: + type: number + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - external_total + - external_total_time_in_millis + - listeners + - total + - total_time_in_millis + _common:RelationName: + type: string + _common:RelocationFailureInfo: + type: object + properties: + failed_attempts: + type: number + required: + - failed_attempts + _common:RequestCacheStats: + type: object + properties: + evictions: + type: number + hit_count: + type: number + memory_size: + type: string + memory_size_in_bytes: + type: number + miss_count: + type: number + required: + - evictions + - hit_count + - memory_size_in_bytes + - miss_count + _common:Result: + type: string + enum: + - created + - updated + - deleted + - not_found + - noop + _common:Retries: + type: object + properties: + bulk: + type: number + search: + type: number + required: + - bulk + - search + _common:Routing: + type: string + _common:RrfRank: + allOf: + - $ref: '#/components/schemas/_common:RankBase' + - type: object + properties: + rank_constant: + description: How much influence documents in individual result sets per query have over the final ranked result set + type: number + window_size: + description: Size of the individual result sets per query + type: number + _common:ScheduleTimeOfDay: + description: A time of day, expressed either as `hh:mm`, `noon`, `midnight`, or an hour/minutes structure. + oneOf: + - type: string + - $ref: '#/components/schemas/_common:HourAndMinute' + _common:ScoreSort: + type: object + properties: + order: + $ref: '#/components/schemas/_common:SortOrder' + _common:Script: + oneOf: + - $ref: '#/components/schemas/_common:InlineScript' + - $ref: '#/components/schemas/_common:StoredScriptId' + _common:ScriptBase: + type: object + properties: + params: + description: |- + Specifies any named parameters that are passed into the script as variables. + Use parameters instead of hard-coded values to decrease compile time. + type: object + additionalProperties: + type: object + _common:ScriptField: + type: object + properties: + script: + $ref: '#/components/schemas/_common:Script' + ignore_failure: + type: boolean + required: + - script + _common:ScriptLanguage: + type: string + enum: + - painless + - expression + - mustache + - java + _common:ScriptSort: + type: object + properties: + order: + $ref: '#/components/schemas/_common:SortOrder' + script: + $ref: '#/components/schemas/_common:Script' + type: + $ref: '#/components/schemas/_common:ScriptSortType' + mode: + $ref: '#/components/schemas/_common:SortMode' + nested: + $ref: '#/components/schemas/_common:NestedSortValue' + required: + - script + _common:ScriptSortType: + type: string + enum: + - string + - number + - version + _common:ScrollId: + type: string + _common:ScrollIds: + oneOf: + - $ref: '#/components/schemas/_common:ScrollId' + - type: array + items: + $ref: '#/components/schemas/_common:ScrollId' + _common:SearchStats: + type: object + properties: + fetch_current: + type: number + fetch_time: + $ref: '#/components/schemas/_common:Duration' + fetch_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + fetch_total: + type: number + open_contexts: + type: number + query_current: + type: number + query_time: + $ref: '#/components/schemas/_common:Duration' + query_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + query_total: + type: number + scroll_current: + type: number + scroll_time: + $ref: '#/components/schemas/_common:Duration' + scroll_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + scroll_total: + type: number + suggest_current: + type: number + suggest_time: + $ref: '#/components/schemas/_common:Duration' + suggest_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + suggest_total: + type: number + groups: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:SearchStats' + required: + - fetch_current + - fetch_time_in_millis + - fetch_total + - query_current + - query_time_in_millis + - query_total + - scroll_current + - scroll_time_in_millis + - scroll_total + - suggest_current + - suggest_time_in_millis + - suggest_total + _common:SearchType: + type: string + enum: + - query_then_fetch + - dfs_query_then_fetch + _common:SegmentsStats: + type: object + properties: + count: + description: Total number of segments across all shards assigned to selected nodes. + type: number + doc_values_memory: + $ref: '#/components/schemas/_common:ByteSize' + doc_values_memory_in_bytes: + description: Total amount, in bytes, of memory used for doc values across all shards assigned to selected nodes. + type: number + file_sizes: + description: |- + This object is not populated by the cluster stats API. + To get information on segment files, use the node stats API. + type: object + additionalProperties: + $ref: '#/components/schemas/indices.stats:ShardFileSizeInfo' + fixed_bit_set: + $ref: '#/components/schemas/_common:ByteSize' + fixed_bit_set_memory_in_bytes: + description: Total amount of memory, in bytes, used by fixed bit sets across all shards assigned to selected nodes. + type: number + index_writer_memory: + $ref: '#/components/schemas/_common:ByteSize' + index_writer_max_memory_in_bytes: + type: number + index_writer_memory_in_bytes: + description: Total amount, in bytes, of memory used by all index writers across all shards assigned to selected nodes. + type: number + max_unsafe_auto_id_timestamp: + description: Unix timestamp, in milliseconds, of the most recently retried indexing request. + type: number + memory: + $ref: '#/components/schemas/_common:ByteSize' + memory_in_bytes: + description: Total amount, in bytes, of memory used for segments across all shards assigned to selected nodes. + type: number + norms_memory: + $ref: '#/components/schemas/_common:ByteSize' + norms_memory_in_bytes: + description: Total amount, in bytes, of memory used for normalization factors across all shards assigned to selected nodes. + type: number + points_memory: + $ref: '#/components/schemas/_common:ByteSize' + points_memory_in_bytes: + description: Total amount, in bytes, of memory used for points across all shards assigned to selected nodes. + type: number + stored_memory: + $ref: '#/components/schemas/_common:ByteSize' + stored_fields_memory_in_bytes: + description: Total amount, in bytes, of memory used for stored fields across all shards assigned to selected nodes. + type: number + terms_memory_in_bytes: + description: Total amount, in bytes, of memory used for terms across all shards assigned to selected nodes. + type: number + terms_memory: + $ref: '#/components/schemas/_common:ByteSize' + term_vectory_memory: + $ref: '#/components/schemas/_common:ByteSize' + term_vectors_memory_in_bytes: + description: Total amount, in bytes, of memory used for term vectors across all shards assigned to selected nodes. + type: number + version_map_memory: + $ref: '#/components/schemas/_common:ByteSize' + version_map_memory_in_bytes: + description: Total amount, in bytes, of memory used by all version maps across all shards assigned to selected nodes. + type: number + required: + - count + - doc_values_memory_in_bytes + - file_sizes + - fixed_bit_set_memory_in_bytes + - index_writer_memory_in_bytes + - max_unsafe_auto_id_timestamp + - memory_in_bytes + - norms_memory_in_bytes + - points_memory_in_bytes + - stored_fields_memory_in_bytes + - terms_memory_in_bytes + - term_vectors_memory_in_bytes + - version_map_memory_in_bytes + _common:SequenceNumber: + type: number + _common:ShardFailure: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + node: + type: string + reason: + $ref: '#/components/schemas/_common:ErrorCause' + shard: + type: number + status: + type: string + required: + - reason + - shard + _common:ShardStatistics: + type: object + properties: + failed: + $ref: '#/components/schemas/_common:uint' + successful: + $ref: '#/components/schemas/_common:uint' + total: + $ref: '#/components/schemas/_common:uint' + failures: + type: array + items: + $ref: '#/components/schemas/_common:ShardFailure' + skipped: + $ref: '#/components/schemas/_common:uint' + required: + - failed + - successful + - total + _common:ShardsOperationResponseBase: + type: object + properties: + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + required: + - _shards + _common:SlicedScroll: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + id: + $ref: '#/components/schemas/_common:Id' + max: + type: number + required: + - id + - max + _common:Slices: + description: Slices configuration used to parallelize a process. + oneOf: + - type: number + - $ref: '#/components/schemas/_common:SlicesCalculation' + _common:SlicesCalculation: + type: string + enum: + - auto + _common:Sort: + oneOf: + - $ref: '#/components/schemas/_common:SortCombinations' + - type: array + items: + $ref: '#/components/schemas/_common:SortCombinations' + _common:SortCombinations: + oneOf: + - $ref: '#/components/schemas/_common:Field' + - $ref: '#/components/schemas/_common:SortOptions' + _common:SortMode: + type: string + enum: + - min + - max + - sum + - avg + - median + _common:SortOptions: + type: object + properties: + _score: + $ref: '#/components/schemas/_common:ScoreSort' + _doc: + $ref: '#/components/schemas/_common:ScoreSort' + _geo_distance: + $ref: '#/components/schemas/_common:GeoDistanceSort' + _script: + $ref: '#/components/schemas/_common:ScriptSort' + minProperties: 1 + maxProperties: 1 + _common:SortOrder: + type: string + enum: + - asc + - desc + _common:SortResults: + type: array + items: + $ref: '#/components/schemas/_common:FieldValue' + _common:StoreStats: + type: object + properties: + size: + $ref: '#/components/schemas/_common:ByteSize' + size_in_bytes: + description: Total size, in bytes, of all shards assigned to selected nodes. + type: number + reserved: + $ref: '#/components/schemas/_common:ByteSize' + reserved_in_bytes: + description: A prediction, in bytes, of how much larger the shard stores will eventually grow due to ongoing peer recoveries, restoring snapshots, and similar activities. + type: number + total_data_set_size: + $ref: '#/components/schemas/_common:ByteSize' + total_data_set_size_in_bytes: + description: |- + Total data set size, in bytes, of all shards assigned to selected nodes. + This includes the size of shards not stored fully on the nodes, such as the cache for partially mounted indices. + type: number + required: + - size_in_bytes + - reserved_in_bytes + _common:StoredScript: + type: object + properties: + lang: + $ref: '#/components/schemas/_common:ScriptLanguage' + options: + type: object + additionalProperties: + type: string + source: + description: The script source. + type: string + required: + - lang + - source + _common:StoredScriptId: + allOf: + - $ref: '#/components/schemas/_common:ScriptBase' + - type: object + properties: + id: + $ref: '#/components/schemas/_common:Id' + required: + - id + _common:StringifiedEpochTimeUnitMillis: + description: |- + Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior + is used to capture this behavior while keeping the semantics of the field type. + + Depending on the target language, code generators can keep the union or remove it and leniently parse + strings to the target type. + oneOf: + - $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + - type: string + _common:StringifiedEpochTimeUnitSeconds: + description: |- + Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior + is used to capture this behavior while keeping the semantics of the field type. + + Depending on the target language, code generators can keep the union or remove it and leniently parse + strings to the target type. + oneOf: + - $ref: '#/components/schemas/_common:EpochTimeUnitSeconds' + - type: string + _common:StringifiedVersionNumber: + description: |- + Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior + is used to capture this behavior while keeping the semantics of the field type. + + Depending on the target language, code generators can keep the union or remove it and leniently parse + strings to the target type. + oneOf: + - $ref: '#/components/schemas/_common:VersionNumber' + - type: string + _common:Stringifiedboolean: + description: |- + Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior + is used to capture this behavior while keeping the semantics of the field type. + + Depending on the target language, code generators can keep the union or remove it and leniently parse + strings to the target type. + oneOf: + - type: boolean + - type: string + _common:Stringifiedinteger: + description: |- + Some APIs will return values such as numbers also as a string (notably epoch timestamps). This behavior + is used to capture this behavior while keeping the semantics of the field type. + + Depending on the target language, code generators can keep the union or remove it and leniently parse + strings to the target type. + oneOf: + - type: number + - type: string + _common:SuggestMode: + type: string + enum: + - missing + - popular + - always + _common:TaskFailure: + type: object + properties: + task_id: + type: number + node_id: + $ref: '#/components/schemas/_common:NodeId' + status: + type: string + reason: + $ref: '#/components/schemas/_common:ErrorCause' + required: + - task_id + - node_id + - status + - reason + _common:TaskId: + oneOf: + - type: string + - type: number + _common:TextEmbedding: + type: object + properties: + model_id: + type: string + model_text: + type: string + required: + - model_id + - model_text + _common:TimeOfDay: + description: Time of day, expressed as HH:MM:SS + type: string + _common:TimeUnit: + type: string + enum: + - nanos + - micros + - ms + - s + - m + - h + - d + _common:TimeZone: + type: string + _common:TopLeftBottomRightGeoBounds: + type: object + properties: + top_left: + $ref: '#/components/schemas/_common:GeoLocation' + bottom_right: + $ref: '#/components/schemas/_common:GeoLocation' + required: + - top_left + - bottom_right + _common:TopRightBottomLeftGeoBounds: + type: object + properties: + top_right: + $ref: '#/components/schemas/_common:GeoLocation' + bottom_left: + $ref: '#/components/schemas/_common:GeoLocation' + required: + - top_right + - bottom_left + _common:TranslogStats: + type: object + properties: + earliest_last_modified_age: + type: number + operations: + type: number + size: + type: string + size_in_bytes: + type: number + uncommitted_operations: + type: number + uncommitted_size: + type: string + uncommitted_size_in_bytes: + type: number + required: + - earliest_last_modified_age + - operations + - size_in_bytes + - uncommitted_operations + - uncommitted_size_in_bytes + _common:TransportAddress: + type: string + _common:UnitMillis: + description: Time unit for milliseconds + type: number + _common:UnitNanos: + description: Time unit for nanoseconds + type: number + _common:UnitSeconds: + description: Time unit for seconds + type: number + _common:Username: + type: string + _common:Uuid: + type: string + _common:VersionNumber: + type: number + _common:VersionString: + type: string + _common:VersionType: + type: string + enum: + - internal + - external + - external_gte + - force + _common:Void: + description: |- + The absence of any type. This is commonly used in APIs that don't return a body. + + Although "void" is generally used for the unit type that has only one value, this is to be interpreted as + the bottom type that has no value at all. Most languages have a unit type, but few have a bottom type. + + See https://en.m.wikipedia.org/wiki/Unit_type and https://en.m.wikipedia.org/wiki/Bottom_type + type: object + _common:WaitForActiveShardOptions: + type: string + enum: + - all + - index-setting + _common:WaitForActiveShards: + oneOf: + - type: number + - $ref: '#/components/schemas/_common:WaitForActiveShardOptions' + _common:WaitForEvents: + type: string + enum: + - immediate + - urgent + - high + - normal + - low + - languid + _common:WarmerStats: + type: object + properties: + current: + type: number + total: + type: number + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - current + - total + - total_time_in_millis + _common:WktGeoBounds: + type: object + properties: + wkt: + type: string + required: + - wkt + _common:WriteResponseBase: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + _primary_term: + type: number + result: + $ref: '#/components/schemas/_common:Result' + _seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + _version: + $ref: '#/components/schemas/_common:VersionNumber' + forced_refresh: + type: boolean + required: + - _id + - _index + - _primary_term + - result + - _seq_no + - _shards + - _version + _common:byte: + type: number + _common:short: + type: number + _common:uint: + type: number + _common:ulong: + type: number + _core._common:DeletedPit: + type: object + properties: + successful: + type: boolean + pit_id: + type: string + _core._common:PitDetail: + type: object + properties: + pit_id: + type: string + creation_time: + type: integer + format: int64 + keep_alive: + type: integer + format: int64 + _core._common:PitsDetailsDeleteAll: + type: object + properties: + successful: + type: boolean + pit_id: + type: string + _core._common:ShardStatistics: + type: object + properties: + total: + type: integer + format: int32 + successful: + type: integer + format: int32 + skipped: + type: integer + format: int32 + failed: + type: integer + format: int32 + _core.bulk:CreateOperation: + allOf: + - $ref: '#/components/schemas/_core.bulk:WriteOperation' + - type: object + _core.bulk:DeleteOperation: + allOf: + - $ref: '#/components/schemas/_core.bulk:OperationBase' + - type: object + _core.bulk:IndexOperation: + allOf: + - $ref: '#/components/schemas/_core.bulk:WriteOperation' + - type: object + _core.bulk:OperationBase: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + routing: + $ref: '#/components/schemas/_common:Routing' + if_primary_term: + type: number + if_seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + version: + $ref: '#/components/schemas/_common:VersionNumber' + version_type: + $ref: '#/components/schemas/_common:VersionType' + _core.bulk:OperationContainer: + type: object + properties: + index: + $ref: '#/components/schemas/_core.bulk:IndexOperation' + create: + $ref: '#/components/schemas/_core.bulk:CreateOperation' + update: + $ref: '#/components/schemas/_core.bulk:UpdateOperation' + delete: + $ref: '#/components/schemas/_core.bulk:DeleteOperation' + minProperties: 1 + maxProperties: 1 + _core.bulk:ResponseItem: + type: object + properties: + _id: + description: The document ID associated with the operation. + oneOf: + - type: string + - nullable: true + type: string + _index: + description: |- + Name of the index associated with the operation. + If the operation targeted a data stream, this is the backing index into which the document was written. + type: string + status: + description: HTTP status code returned for the operation. + type: number + error: + $ref: '#/components/schemas/_common:ErrorCause' + _primary_term: + description: The primary term assigned to the document for the operation. + type: number + result: + description: |- + Result of the operation. + Successful values are `created`, `deleted`, and `updated`. + type: string + _seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + _version: + $ref: '#/components/schemas/_common:VersionNumber' + forced_refresh: + type: boolean + get: + $ref: '#/components/schemas/_common:InlineGetDictUserDefined' + required: + - _index + - status + _core.bulk:UpdateAction: + type: object + properties: + detect_noop: + description: |- + Set to false to disable setting 'result' in the response + to 'noop' if no change to the document occurred. + type: boolean + doc: + description: A partial update to an existing document. + type: object + doc_as_upsert: + description: Set to true to use the contents of 'doc' as the value of 'upsert' + type: boolean + script: + $ref: '#/components/schemas/_common:Script' + scripted_upsert: + description: Set to true to execute the script whether or not the document exists. + type: boolean + _source: + $ref: '#/components/schemas/_core.search:SourceConfig' + upsert: + description: |- + If the document does not already exist, the contents of 'upsert' are inserted as a + new document. If the document exists, the 'script' is executed. + type: object + _core.bulk:UpdateOperation: + allOf: + - $ref: '#/components/schemas/_core.bulk:OperationBase' + - type: object + properties: + require_alias: + description: If `true`, the request’s actions must target an index alias. + type: boolean + retry_on_conflict: + type: number + _core.bulk:WriteOperation: + allOf: + - $ref: '#/components/schemas/_core.bulk:OperationBase' + - type: object + properties: + dynamic_templates: + description: |- + A map from the full name of fields to the name of dynamic templates. + Defaults to an empty map. + If a name matches a dynamic template, then that template will be applied regardless of other match predicates defined in the template. + If a field is already defined in the mapping, then this parameter won’t be used. + type: object + additionalProperties: + type: string + pipeline: + description: |- + ID of the pipeline to use to preprocess incoming documents. + If the index has a default ingest pipeline specified, then setting the value to `_none` disables the default ingest pipeline for this request. + If a final pipeline is configured it will always run, regardless of the value of this parameter. + type: string + require_alias: + description: If `true`, the request’s actions must target an index alias. + type: boolean + _core.explain:Explanation: + type: object + properties: + description: + type: string + details: + type: array + items: + $ref: '#/components/schemas/_core.explain:ExplanationDetail' + value: + type: number + required: + - description + - details + - value + _core.explain:ExplanationDetail: + type: object + properties: + description: + type: string + details: + type: array + items: + $ref: '#/components/schemas/_core.explain:ExplanationDetail' + value: + type: number + required: + - description + - value + _core.field_caps:FieldCapability: + type: object + properties: + aggregatable: + description: Whether this field can be aggregated on all indices. + type: boolean + indices: + $ref: '#/components/schemas/_common:Indices' + meta: + $ref: '#/components/schemas/_common:Metadata' + non_aggregatable_indices: + $ref: '#/components/schemas/_common:Indices' + non_searchable_indices: + $ref: '#/components/schemas/_common:Indices' + searchable: + description: Whether this field is indexed for search on all indices. + type: boolean + type: + type: string + metadata_field: + description: Whether this field is registered as a metadata field. + type: boolean + time_series_dimension: + description: Whether this field is used as a time series dimension. + type: boolean + time_series_metric: + $ref: '#/components/schemas/_common.mapping:TimeSeriesMetricType' + non_dimension_indices: + description: |- + If this list is present in response then some indices have the + field marked as a dimension and other indices, the ones in this list, do not. + type: array + items: + $ref: '#/components/schemas/_common:IndexName' + metric_conflicts_indices: + description: |- + The list of indices where this field is present if these indices + don’t have the same `time_series_metric` value for this field. + type: array + items: + $ref: '#/components/schemas/_common:IndexName' + required: + - aggregatable + - searchable + - type + _core.get:GetResult: + type: object + properties: + _index: + $ref: '#/components/schemas/_common:IndexName' + fields: + type: object + additionalProperties: + type: object + found: + type: boolean + _id: + $ref: '#/components/schemas/_common:Id' + _primary_term: + type: number + _routing: + type: string + _seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + _source: + type: object + _version: + $ref: '#/components/schemas/_common:VersionNumber' + required: + - _index + - found + - _id + _core.get_script_context:Context: + type: object + properties: + methods: + type: array + items: + $ref: '#/components/schemas/_core.get_script_context:ContextMethod' + name: + $ref: '#/components/schemas/_common:Name' + required: + - methods + - name + _core.get_script_context:ContextMethod: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + return_type: + type: string + params: + type: array + items: + $ref: '#/components/schemas/_core.get_script_context:ContextMethodParam' + required: + - name + - return_type + - params + _core.get_script_context:ContextMethodParam: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + type: + type: string + required: + - name + - type + _core.get_script_languages:LanguageContext: + type: object + properties: + contexts: + type: array + items: + type: string + language: + $ref: '#/components/schemas/_common:ScriptLanguage' + required: + - contexts + - language + _core.mget:MultiGetError: + type: object + properties: + error: + $ref: '#/components/schemas/_common:ErrorCause' + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + required: + - error + - _id + - _index + _core.mget:Operation: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + routing: + $ref: '#/components/schemas/_common:Routing' + _source: + $ref: '#/components/schemas/_core.search:SourceConfig' + stored_fields: + $ref: '#/components/schemas/_common:Fields' + version: + $ref: '#/components/schemas/_common:VersionNumber' + version_type: + $ref: '#/components/schemas/_common:VersionType' + required: + - _id + _core.mget:ResponseItem: + oneOf: + - $ref: '#/components/schemas/_core.get:GetResult' + - $ref: '#/components/schemas/_core.mget:MultiGetError' + _core.msearch:MultiSearchItem: + allOf: + - $ref: '#/components/schemas/_core.search:ResponseBody' + - type: object + properties: + status: + type: number + _core.msearch:MultiSearchResult: + type: object + properties: + took: + type: number + responses: + type: array + items: + $ref: '#/components/schemas/_core.msearch:ResponseItem' + required: + - took + - responses + _core.msearch:MultisearchBody: + type: object + properties: + aggregations: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:AggregationContainer' + collapse: + $ref: '#/components/schemas/_core.search:FieldCollapse' + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + explain: + description: If true, returns detailed information about score computation as part of a hit. + type: boolean + ext: + description: Configuration of search extensions defined by Opensearch plugins. + type: object + additionalProperties: + type: object + stored_fields: + $ref: '#/components/schemas/_common:Fields' + docvalue_fields: + description: |- + Array of wildcard (*) patterns. The request returns doc values for field + names matching these patterns in the hits.fields property of the response. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:FieldAndFormat' + knn: + description: Defines the approximate kNN search to run. + oneOf: + - $ref: '#/components/schemas/_common:KnnQuery' + - type: array + items: + $ref: '#/components/schemas/_common:KnnQuery' + from: + description: |- + Starting document offset. By default, you cannot page through more than 10,000 + hits using the from and size parameters. To page through more hits, use the + search_after parameter. + type: number + highlight: + $ref: '#/components/schemas/_core.search:Highlight' + indices_boost: + description: Boosts the _score of documents from specified indices. + type: array + items: + type: object + additionalProperties: + type: number + min_score: + description: |- + Minimum _score for matching documents. Documents with a lower _score are + not included in the search results. + type: number + post_filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + profile: + type: boolean + rescore: + oneOf: + - $ref: '#/components/schemas/_core.search:Rescore' + - type: array + items: + $ref: '#/components/schemas/_core.search:Rescore' + script_fields: + description: Retrieve a script evaluation (based on different fields) for each hit. + type: object + additionalProperties: + $ref: '#/components/schemas/_common:ScriptField' + search_after: + $ref: '#/components/schemas/_common:SortResults' + size: + description: |- + The number of hits to return. By default, you cannot page through more + than 10,000 hits using the from and size parameters. To page through more + hits, use the search_after parameter. + type: number + sort: + $ref: '#/components/schemas/_common:Sort' + _source: + $ref: '#/components/schemas/_core.search:SourceConfig' + fields: + description: |- + Array of wildcard (*) patterns. The request returns values for field names + matching these patterns in the hits.fields property of the response. + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:FieldAndFormat' + terminate_after: + description: |- + Maximum number of documents to collect for each shard. If a query reaches this + limit, Opensearch terminates the query early. Opensearch collects documents + before sorting. Defaults to 0, which does not terminate query execution early. + type: number + stats: + description: |- + Stats groups to associate with the search. Each group maintains a statistics + aggregation for its associated searches. You can retrieve these stats using + the indices stats API. + type: array + items: + type: string + timeout: + description: |- + Specifies the period of time to wait for a response from each shard. If no response + is received before the timeout expires, the request fails and returns an error. + Defaults to no timeout. + type: string + track_scores: + description: If true, calculate and return document scores, even if the scores are not used for sorting. + type: boolean + track_total_hits: + $ref: '#/components/schemas/_core.search:TrackHits' + version: + description: If true, returns document version as part of a hit. + type: boolean + runtime_mappings: + $ref: '#/components/schemas/_common.mapping:RuntimeFields' + seq_no_primary_term: + description: |- + If true, returns sequence number and primary term of the last modification + of each hit. See Optimistic concurrency control. + type: boolean + pit: + $ref: '#/components/schemas/_core.search:PointInTimeReference' + suggest: + $ref: '#/components/schemas/_core.search:Suggester' + _core.msearch:MultisearchHeader: + type: object + properties: + allow_no_indices: + type: boolean + expand_wildcards: + $ref: '#/components/schemas/_common:ExpandWildcards' + ignore_unavailable: + type: boolean + index: + $ref: '#/components/schemas/_common:Indices' + preference: + type: string + request_cache: + type: boolean + routing: + $ref: '#/components/schemas/_common:Routing' + search_type: + $ref: '#/components/schemas/_common:SearchType' + ccs_minimize_roundtrips: + type: boolean + allow_partial_search_results: + type: boolean + ignore_throttled: + type: boolean + _core.msearch:RequestItem: + oneOf: + - $ref: '#/components/schemas/_core.msearch:MultisearchHeader' + - $ref: '#/components/schemas/_core.msearch:MultisearchBody' + _core.msearch:ResponseItem: + oneOf: + - $ref: '#/components/schemas/_core.msearch:MultiSearchItem' + - $ref: '#/components/schemas/_common:ErrorResponseBase' + _core.msearch_template:RequestItem: + oneOf: + - $ref: '#/components/schemas/_core.msearch:MultisearchHeader' + - $ref: '#/components/schemas/_core.msearch_template:TemplateConfig' + _core.msearch_template:TemplateConfig: + type: object + properties: + explain: + description: If `true`, returns detailed information about score calculation as part of each hit. + type: boolean + id: + $ref: '#/components/schemas/_common:Id' + params: + description: |- + Key-value pairs used to replace Mustache variables in the template. + The key is the variable name. + The value is the variable value. + type: object + additionalProperties: + type: object + profile: + description: If `true`, the query execution is profiled. + type: boolean + source: + description: |- + An inline search template. Supports the same parameters as the search API's + request body. Also supports Mustache variables. If no id is specified, this + parameter is required. + type: string + _core.mtermvectors:Operation: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + doc: + description: An artificial document (a document not present in the index) for which you want to retrieve term vectors. + type: object + fields: + $ref: '#/components/schemas/_common:Fields' + field_statistics: + description: If `true`, the response includes the document count, sum of document frequencies, and sum of total term frequencies. + type: boolean + filter: + $ref: '#/components/schemas/_core.termvectors:Filter' + offsets: + description: If `true`, the response includes term offsets. + type: boolean + payloads: + description: If `true`, the response includes term payloads. + type: boolean + positions: + description: If `true`, the response includes term positions. + type: boolean + routing: + $ref: '#/components/schemas/_common:Routing' + term_statistics: + description: If true, the response includes term frequency and document frequency. + type: boolean + version: + $ref: '#/components/schemas/_common:VersionNumber' + version_type: + $ref: '#/components/schemas/_common:VersionType' + required: + - _id + _core.mtermvectors:TermVectorsResult: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + _version: + $ref: '#/components/schemas/_common:VersionNumber' + took: + type: number + found: + type: boolean + term_vectors: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.termvectors:TermVector' + error: + $ref: '#/components/schemas/_common:ErrorCause' + required: + - _id + - _index + _core.rank_eval:DocumentRating: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + rating: + description: The document’s relevance with regard to this search request. + type: number + required: + - _id + - _index + - rating + _core.rank_eval:RankEvalHit: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + _score: + type: number + required: + - _id + - _index + - _score + _core.rank_eval:RankEvalHitItem: + type: object + properties: + hit: + $ref: '#/components/schemas/_core.rank_eval:RankEvalHit' + rating: + oneOf: + - type: number + - nullable: true + type: string + required: + - hit + _core.rank_eval:RankEvalMetric: + type: object + properties: + precision: + $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricPrecision' + recall: + $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricRecall' + mean_reciprocal_rank: + $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricMeanReciprocalRank' + dcg: + $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricDiscountedCumulativeGain' + expected_reciprocal_rank: + $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricExpectedReciprocalRank' + _core.rank_eval:RankEvalMetricBase: + type: object + properties: + k: + description: Sets the maximum number of documents retrieved per query. This value will act in place of the usual size parameter in the query. + type: number + _core.rank_eval:RankEvalMetricDetail: + type: object + properties: + metric_score: + description: The metric_score in the details section shows the contribution of this query to the global quality metric score + type: number + unrated_docs: + description: The unrated_docs section contains an _index and _id entry for each document in the search result for this query that didn’t have a ratings value. This can be used to ask the user to supply ratings for these documents + type: array + items: + $ref: '#/components/schemas/_core.rank_eval:UnratedDocument' + hits: + description: The hits section shows a grouping of the search results with their supplied ratings + type: array + items: + $ref: '#/components/schemas/_core.rank_eval:RankEvalHitItem' + metric_details: + description: The metric_details give additional information about the calculated quality metric (e.g. how many of the retrieved documents were relevant). The content varies for each metric but allows for better interpretation of the results + type: object + additionalProperties: + type: object + additionalProperties: + type: object + required: + - metric_score + - unrated_docs + - hits + - metric_details + _core.rank_eval:RankEvalMetricDiscountedCumulativeGain: + allOf: + - $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricBase' + - type: object + properties: + normalize: + externalDocs: + url: https://en.wikipedia.org/wiki/Discounted_cumulative_gain#Normalized_DCG + description: If set to true, this metric will calculate the Normalized DCG. + type: boolean + _core.rank_eval:RankEvalMetricExpectedReciprocalRank: + allOf: + - $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricBase' + - type: object + properties: + maximum_relevance: + description: The highest relevance grade used in the user-supplied relevance judgments. + type: number + required: + - maximum_relevance + _core.rank_eval:RankEvalMetricMeanReciprocalRank: + allOf: + - $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricRatingTreshold' + - type: object + _core.rank_eval:RankEvalMetricPrecision: + allOf: + - $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricRatingTreshold' + - type: object + properties: + ignore_unlabeled: + description: Controls how unlabeled documents in the search results are counted. If set to true, unlabeled documents are ignored and neither count as relevant or irrelevant. Set to false (the default), they are treated as irrelevant. + type: boolean + _core.rank_eval:RankEvalMetricRatingTreshold: + allOf: + - $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricBase' + - type: object + properties: + relevant_rating_threshold: + description: Sets the rating threshold above which documents are considered to be "relevant". + type: number + _core.rank_eval:RankEvalMetricRecall: + allOf: + - $ref: '#/components/schemas/_core.rank_eval:RankEvalMetricRatingTreshold' + - type: object + _core.rank_eval:RankEvalQuery: + type: object + properties: + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + size: + type: number + required: + - query + _core.rank_eval:RankEvalRequestItem: + type: object + properties: + id: + $ref: '#/components/schemas/_common:Id' + request: + $ref: '#/components/schemas/_core.rank_eval:RankEvalQuery' + ratings: + description: List of document ratings + type: array + items: + $ref: '#/components/schemas/_core.rank_eval:DocumentRating' + template_id: + $ref: '#/components/schemas/_common:Id' + params: + description: The search template parameters. + type: object + additionalProperties: + type: object + required: + - id + - ratings + _core.rank_eval:UnratedDocument: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + required: + - _id + - _index + _core.reindex:Destination: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + op_type: + $ref: '#/components/schemas/_common:OpType' + pipeline: + description: The name of the pipeline to use. + type: string + routing: + $ref: '#/components/schemas/_common:Routing' + version_type: + $ref: '#/components/schemas/_common:VersionType' + required: + - index + _core.reindex:RemoteSource: + type: object + properties: + connect_timeout: + $ref: '#/components/schemas/_common:Duration' + headers: + description: An object containing the headers of the request. + type: object + additionalProperties: + type: string + host: + $ref: '#/components/schemas/_common:Host' + username: + $ref: '#/components/schemas/_common:Username' + password: + $ref: '#/components/schemas/_common:Password' + socket_timeout: + $ref: '#/components/schemas/_common:Duration' + required: + - host + _core.reindex:Source: + type: object + properties: + index: + $ref: '#/components/schemas/_common:Indices' + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + remote: + $ref: '#/components/schemas/_core.reindex:RemoteSource' + size: + description: |- + The number of documents to index per batch. + Use when indexing from remote to ensure that the batches fit within the on-heap buffer, which defaults to a maximum size of 100 MB. + type: number + slice: + $ref: '#/components/schemas/_common:SlicedScroll' + sort: + $ref: '#/components/schemas/_common:Sort' + _source: + $ref: '#/components/schemas/_common:Fields' + runtime_mappings: + $ref: '#/components/schemas/_common.mapping:RuntimeFields' + required: + - index + _core.reindex_rethrottle:ReindexNode: + allOf: + - $ref: '#/components/schemas/_common:BaseNode' + - type: object + properties: + tasks: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.reindex_rethrottle:ReindexTask' + required: + - tasks + _core.reindex_rethrottle:ReindexStatus: + type: object + properties: + batches: + description: The number of scroll responses pulled back by the reindex. + type: number + created: + description: The number of documents that were successfully created. + type: number + deleted: + description: The number of documents that were successfully deleted. + type: number + noops: + description: The number of documents that were ignored because the script used for the reindex returned a `noop` value for `ctx.op`. + type: number + requests_per_second: + description: The number of requests per second effectively executed during the reindex. + type: number + retries: + $ref: '#/components/schemas/_common:Retries' + throttled: + $ref: '#/components/schemas/_common:Duration' + throttled_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + throttled_until: + $ref: '#/components/schemas/_common:Duration' + throttled_until_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total: + description: The number of documents that were successfully processed. + type: number + updated: + description: The number of documents that were successfully updated, for example, a document with same ID already existed prior to reindex updating it. + type: number + version_conflicts: + description: The number of version conflicts that reindex hits. + type: number + required: + - batches + - created + - deleted + - noops + - requests_per_second + - retries + - throttled_millis + - throttled_until_millis + - total + - updated + - version_conflicts + _core.reindex_rethrottle:ReindexTask: + type: object + properties: + action: + type: string + cancellable: + type: boolean + description: + type: string + id: + type: number + node: + $ref: '#/components/schemas/_common:Name' + running_time_in_nanos: + $ref: '#/components/schemas/_common:DurationValueUnitNanos' + start_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + status: + $ref: '#/components/schemas/_core.reindex_rethrottle:ReindexStatus' + type: + type: string + headers: + $ref: '#/components/schemas/_common:HttpHeaders' + required: + - action + - cancellable + - description + - id + - node + - running_time_in_nanos + - start_time_in_millis + - status + - type + - headers + _core.scripts_painless_execute:PainlessContextSetup: + type: object + properties: + document: + description: Document that’s temporarily indexed in-memory and accessible from the script. + type: object + index: + $ref: '#/components/schemas/_common:IndexName' + query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + required: + - document + - index + - query + _core.search:AggregationBreakdown: + type: object + properties: + build_aggregation: + type: number + build_aggregation_count: + type: number + build_leaf_collector: + type: number + build_leaf_collector_count: + type: number + collect: + type: number + collect_count: + type: number + initialize: + type: number + initialize_count: + type: number + post_collection: + type: number + post_collection_count: + type: number + reduce: + type: number + reduce_count: + type: number + required: + - build_aggregation + - build_aggregation_count + - build_leaf_collector + - build_leaf_collector_count + - collect + - collect_count + - initialize + - initialize_count + - reduce + - reduce_count + _core.search:AggregationProfile: + type: object + properties: + breakdown: + $ref: '#/components/schemas/_core.search:AggregationBreakdown' + description: + type: string + time_in_nanos: + $ref: '#/components/schemas/_common:DurationValueUnitNanos' + type: + type: string + debug: + $ref: '#/components/schemas/_core.search:AggregationProfileDebug' + children: + type: array + items: + $ref: '#/components/schemas/_core.search:AggregationProfile' + required: + - breakdown + - description + - time_in_nanos + - type + _core.search:AggregationProfileDebug: + type: object + properties: + segments_with_multi_valued_ords: + type: number + collection_strategy: + type: string + segments_with_single_valued_ords: + type: number + total_buckets: + type: number + built_buckets: + type: number + result_strategy: + type: string + has_filter: + type: boolean + delegate: + type: string + delegate_debug: + $ref: '#/components/schemas/_core.search:AggregationProfileDebug' + chars_fetched: + type: number + extract_count: + type: number + extract_ns: + type: number + values_fetched: + type: number + collect_analyzed_ns: + type: number + collect_analyzed_count: + type: number + surviving_buckets: + type: number + ordinals_collectors_used: + type: number + ordinals_collectors_overhead_too_high: + type: number + string_hashing_collectors_used: + type: number + numeric_collectors_used: + type: number + empty_collectors_used: + type: number + deferred_aggregators: + type: array + items: + type: string + segments_with_doc_count_field: + type: number + segments_with_deleted_docs: + type: number + filters: + type: array + items: + $ref: '#/components/schemas/_core.search:AggregationProfileDelegateDebugFilter' + segments_counted: + type: number + segments_collected: + type: number + map_reducer: + type: string + _core.search:AggregationProfileDelegateDebugFilter: + type: object + properties: + results_from_metadata: + type: number + query: + type: string + specialized_for: + type: string + segments_counted_in_constant_time: + type: number + _core.search:BoundaryScanner: + type: string + enum: + - chars + - sentence + - word + _core.search:Collector: + type: object + properties: + name: + type: string + reason: + type: string + time_in_nanos: + $ref: '#/components/schemas/_common:DurationValueUnitNanos' + children: + type: array + items: + $ref: '#/components/schemas/_core.search:Collector' + required: + - name + - reason + - time_in_nanos + _core.search:CompletionSuggest: + allOf: + - $ref: '#/components/schemas/_core.search:SuggestBase' + - type: object + properties: + options: + oneOf: + - $ref: '#/components/schemas/_core.search:CompletionSuggestOption' + - type: array + items: + $ref: '#/components/schemas/_core.search:CompletionSuggestOption' + required: + - options + _core.search:CompletionSuggestOption: + type: object + properties: + collate_match: + type: boolean + contexts: + type: object + additionalProperties: + type: array + items: + $ref: '#/components/schemas/_core.search:Context' + fields: + type: object + additionalProperties: + type: object + _id: + type: string + _index: + $ref: '#/components/schemas/_common:IndexName' + _routing: + $ref: '#/components/schemas/_common:Routing' + _score: + type: number + _source: + type: object + text: + type: string + score: + type: number + required: + - text + _core.search:Context: + description: Text or location that we want similar documents for or a lookup to a document's field for the text. + oneOf: + - type: string + - $ref: '#/components/schemas/_common:GeoLocation' + _core.search:FetchProfile: + type: object + properties: + type: + type: string + description: + type: string + time_in_nanos: + $ref: '#/components/schemas/_common:DurationValueUnitNanos' + breakdown: + $ref: '#/components/schemas/_core.search:FetchProfileBreakdown' + debug: + $ref: '#/components/schemas/_core.search:FetchProfileDebug' + children: + type: array + items: + $ref: '#/components/schemas/_core.search:FetchProfile' + required: + - type + - description + - time_in_nanos + - breakdown + _core.search:FetchProfileBreakdown: + type: object + properties: + load_source: + type: number + load_source_count: + type: number + load_stored_fields: + type: number + load_stored_fields_count: + type: number + next_reader: + type: number + next_reader_count: + type: number + process_count: + type: number + process: + type: number + _core.search:FetchProfileDebug: + type: object + properties: + stored_fields: + type: array + items: + type: string + fast_path: + type: number + _core.search:FieldCollapse: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + inner_hits: + description: The number of inner hits and their sort order + oneOf: + - $ref: '#/components/schemas/_core.search:InnerHits' + - type: array + items: + $ref: '#/components/schemas/_core.search:InnerHits' + max_concurrent_group_searches: + description: The number of concurrent requests allowed to retrieve the inner_hits per group + type: number + collapse: + $ref: '#/components/schemas/_core.search:FieldCollapse' + required: + - field + _core.search:Highlight: + allOf: + - $ref: '#/components/schemas/_core.search:HighlightBase' + - type: object + properties: + encoder: + $ref: '#/components/schemas/_core.search:HighlighterEncoder' + fields: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.search:HighlightField' + required: + - fields + _core.search:HighlightBase: + type: object + properties: + type: + $ref: '#/components/schemas/_core.search:HighlighterType' + boundary_chars: + description: A string that contains each boundary character. + type: string + boundary_max_scan: + description: How far to scan for boundary characters. + type: number + boundary_scanner: + $ref: '#/components/schemas/_core.search:BoundaryScanner' + boundary_scanner_locale: + description: |- + Controls which locale is used to search for sentence and word boundaries. + This parameter takes a form of a language tag, for example: `"en-US"`, `"fr-FR"`, `"ja-JP"`. + type: string + force_source: + deprecated: true + type: boolean + fragmenter: + $ref: '#/components/schemas/_core.search:HighlighterFragmenter' + fragment_size: + description: The size of the highlighted fragment in characters. + type: number + highlight_filter: + type: boolean + highlight_query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + max_fragment_length: + type: number + max_analyzed_offset: + description: |- + If set to a non-negative value, highlighting stops at this defined maximum limit. + The rest of the text is not processed, thus not highlighted and no error is returned + The `max_analyzed_offset` query setting does not override the `index.highlight.max_analyzed_offset` setting, which prevails when it’s set to lower value than the query setting. + type: number + no_match_size: + description: The amount of text you want to return from the beginning of the field if there are no matching fragments to highlight. + type: number + number_of_fragments: + description: |- + The maximum number of fragments to return. + If the number of fragments is set to `0`, no fragments are returned. + Instead, the entire field contents are highlighted and returned. + This can be handy when you need to highlight short texts such as a title or address, but fragmentation is not required. + If `number_of_fragments` is `0`, `fragment_size` is ignored. + type: number + options: + type: object + additionalProperties: + type: object + order: + $ref: '#/components/schemas/_core.search:HighlighterOrder' + phrase_limit: + description: |- + Controls the number of matching phrases in a document that are considered. + Prevents the `fvh` highlighter from analyzing too many phrases and consuming too much memory. + When using `matched_fields`, `phrase_limit` phrases per matched field are considered. Raising the limit increases query time and consumes more memory. + Only supported by the `fvh` highlighter. + type: number + post_tags: + description: |- + Use in conjunction with `pre_tags` to define the HTML tags to use for the highlighted text. + By default, highlighted text is wrapped in `` and `` tags. + type: array + items: + type: string + pre_tags: + description: |- + Use in conjunction with `post_tags` to define the HTML tags to use for the highlighted text. + By default, highlighted text is wrapped in `` and `` tags. + type: array + items: + type: string + require_field_match: + description: |- + By default, only fields that contains a query match are highlighted. + Set to `false` to highlight all fields. + type: boolean + tags_schema: + $ref: '#/components/schemas/_core.search:HighlighterTagsSchema' + _core.search:HighlightField: + allOf: + - $ref: '#/components/schemas/_core.search:HighlightBase' + - type: object + properties: + fragment_offset: + type: number + matched_fields: + $ref: '#/components/schemas/_common:Fields' + analyzer: + $ref: '#/components/schemas/_common.analysis:Analyzer' + _core.search:HighlighterEncoder: + type: string + enum: + - default + - html + _core.search:HighlighterFragmenter: + type: string + enum: + - simple + - span + _core.search:HighlighterOrder: + type: string + enum: + - score + _core.search:HighlighterTagsSchema: + type: string + enum: + - styled + _core.search:HighlighterType: + type: string + enum: + - plain + - fvh + - unified + _core.search:Hit: + type: object + properties: + _index: + $ref: '#/components/schemas/_common:IndexName' + _id: + $ref: '#/components/schemas/_common:Id' + _score: + oneOf: + - type: number + - nullable: true + type: string + _explanation: + $ref: '#/components/schemas/_core.explain:Explanation' + fields: + type: object + additionalProperties: + type: object + highlight: + type: object + additionalProperties: + type: array + items: + type: string + inner_hits: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.search:InnerHitsResult' + matched_queries: + type: array + items: + type: string + _nested: + $ref: '#/components/schemas/_core.search:NestedIdentity' + _ignored: + type: array + items: + type: string + ignored_field_values: + type: object + additionalProperties: + type: array + items: + type: string + _shard: + type: string + _node: + type: string + _routing: + type: string + _source: + type: object + _seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + _primary_term: + type: number + _version: + $ref: '#/components/schemas/_common:VersionNumber' + sort: + $ref: '#/components/schemas/_common:SortResults' + required: + - _index + - _id + _core.search:HitsMetadata: + type: object + properties: + total: + description: Total hit count information, present only if `track_total_hits` wasn't `false` in the search request. + oneOf: + - $ref: '#/components/schemas/_core.search:TotalHits' + - type: number + hits: + type: array + items: + $ref: '#/components/schemas/_core.search:Hit' + max_score: + oneOf: + - type: number + - nullable: true + type: string + required: + - hits + _core.search:InnerHits: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + size: + description: The maximum number of hits to return per `inner_hits`. + type: number + from: + description: Inner hit starting document offset. + type: number + collapse: + $ref: '#/components/schemas/_core.search:FieldCollapse' + docvalue_fields: + type: array + items: + $ref: '#/components/schemas/_common.query_dsl:FieldAndFormat' + explain: + type: boolean + highlight: + $ref: '#/components/schemas/_core.search:Highlight' + ignore_unmapped: + type: boolean + script_fields: + type: object + additionalProperties: + $ref: '#/components/schemas/_common:ScriptField' + seq_no_primary_term: + type: boolean + fields: + $ref: '#/components/schemas/_common:Fields' + sort: + $ref: '#/components/schemas/_common:Sort' + _source: + $ref: '#/components/schemas/_core.search:SourceConfig' + stored_field: + $ref: '#/components/schemas/_common:Fields' + track_scores: + type: boolean + version: + type: boolean + _core.search:InnerHitsResult: + type: object + properties: + hits: + $ref: '#/components/schemas/_core.search:HitsMetadata' + required: + - hits + _core.search:NestedIdentity: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + offset: + type: number + _nested: + $ref: '#/components/schemas/_core.search:NestedIdentity' + required: + - field + - offset + _core.search:PhraseSuggest: + allOf: + - $ref: '#/components/schemas/_core.search:SuggestBase' + - type: object + properties: + options: + oneOf: + - $ref: '#/components/schemas/_core.search:PhraseSuggestOption' + - type: array + items: + $ref: '#/components/schemas/_core.search:PhraseSuggestOption' + required: + - options + _core.search:PhraseSuggestOption: + type: object + properties: + text: + type: string + score: + type: number + highlighted: + type: string + collate_match: + type: boolean + required: + - text + - score + _core.search:PointInTimeReference: + type: object + properties: + id: + $ref: '#/components/schemas/_common:Id' + keep_alive: + $ref: '#/components/schemas/_common:Duration' + required: + - id + _core.search:Profile: + type: object + properties: + shards: + type: array + items: + $ref: '#/components/schemas/_core.search:ShardProfile' + required: + - shards + _core.search:QueryBreakdown: + type: object + properties: + advance: + type: number + advance_count: + type: number + build_scorer: + type: number + build_scorer_count: + type: number + create_weight: + type: number + create_weight_count: + type: number + match: + type: number + match_count: + type: number + shallow_advance: + type: number + shallow_advance_count: + type: number + next_doc: + type: number + next_doc_count: + type: number + score: + type: number + score_count: + type: number + compute_max_score: + type: number + compute_max_score_count: + type: number + set_min_competitive_score: + type: number + set_min_competitive_score_count: + type: number + required: + - advance + - advance_count + - build_scorer + - build_scorer_count + - create_weight + - create_weight_count + - match + - match_count + - shallow_advance + - shallow_advance_count + - next_doc + - next_doc_count + - score + - score_count + - compute_max_score + - compute_max_score_count + - set_min_competitive_score + - set_min_competitive_score_count + _core.search:QueryProfile: + type: object + properties: + breakdown: + $ref: '#/components/schemas/_core.search:QueryBreakdown' + description: + type: string + time_in_nanos: + $ref: '#/components/schemas/_common:DurationValueUnitNanos' + type: + type: string + children: + type: array + items: + $ref: '#/components/schemas/_core.search:QueryProfile' + required: + - breakdown + - description + - time_in_nanos + - type + _core.search:Rescore: + type: object + properties: + query: + $ref: '#/components/schemas/_core.search:RescoreQuery' + window_size: + type: number + required: + - query + _core.search:RescoreQuery: + type: object + properties: + rescore_query: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + query_weight: + description: Relative importance of the original query versus the rescore query. + type: number + rescore_query_weight: + description: Relative importance of the rescore query versus the original query. + type: number + score_mode: + $ref: '#/components/schemas/_core.search:ScoreMode' + required: + - rescore_query + _core.search:ResponseBody: + type: object + properties: + took: + type: number + timed_out: + type: boolean + _shards: + $ref: '#/components/schemas/_common:ShardStatistics' + hits: + $ref: '#/components/schemas/_core.search:HitsMetadata' + aggregations: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.aggregations:Aggregate' + _clusters: + $ref: '#/components/schemas/_common:ClusterStatistics' + fields: + type: object + additionalProperties: + type: object + max_score: + type: number + num_reduce_phases: + type: number + profile: + $ref: '#/components/schemas/_core.search:Profile' + pit_id: + $ref: '#/components/schemas/_common:Id' + _scroll_id: + $ref: '#/components/schemas/_common:ScrollId' + suggest: + type: object + additionalProperties: + type: array + items: + $ref: '#/components/schemas/_core.search:Suggest' + terminated_early: + type: boolean + required: + - took + - timed_out + - _shards + - hits + _core.search:ScoreMode: + type: string + enum: + - avg + - max + - min + - multiply + - total + _core.search:SearchProfile: + type: object + properties: + collector: + type: array + items: + $ref: '#/components/schemas/_core.search:Collector' + query: + type: array + items: + $ref: '#/components/schemas/_core.search:QueryProfile' + rewrite_time: + type: number + required: + - collector + - query + - rewrite_time + _core.search:ShardProfile: + type: object + properties: + aggregations: + type: array + items: + $ref: '#/components/schemas/_core.search:AggregationProfile' + id: + type: string + searches: + type: array + items: + $ref: '#/components/schemas/_core.search:SearchProfile' + fetch: + $ref: '#/components/schemas/_core.search:FetchProfile' + required: + - aggregations + - id + - searches + _core.search:SourceConfig: + description: Defines how to fetch a source. Fetching can be disabled entirely, or the source can be filtered. + oneOf: + - type: boolean + - $ref: '#/components/schemas/_core.search:SourceFilter' + _core.search:SourceConfigParam: + description: |- + Defines how to fetch a source. Fetching can be disabled entirely, or the source can be filtered. + Used as a query parameter along with the `_source_includes` and `_source_excludes` parameters. + oneOf: + - type: boolean + - $ref: '#/components/schemas/_common:Fields' + _core.search:SourceFilter: + type: object + properties: + excludes: + $ref: '#/components/schemas/_common:Fields' + includes: + $ref: '#/components/schemas/_common:Fields' + _core.search:Suggest: + oneOf: + - $ref: '#/components/schemas/_core.search:CompletionSuggest' + - $ref: '#/components/schemas/_core.search:PhraseSuggest' + - $ref: '#/components/schemas/_core.search:TermSuggest' + _core.search:SuggestBase: + type: object + properties: + length: + type: number + offset: + type: number + text: + type: string + required: + - length + - offset + - text + _core.search:Suggester: + type: object + properties: + text: + description: Global suggest text, to avoid repetition when the same text is used in several suggesters + type: string + _core.search:TermSuggest: + allOf: + - $ref: '#/components/schemas/_core.search:SuggestBase' + - type: object + properties: + options: + oneOf: + - $ref: '#/components/schemas/_core.search:TermSuggestOption' + - type: array + items: + $ref: '#/components/schemas/_core.search:TermSuggestOption' + required: + - options + _core.search:TermSuggestOption: + type: object + properties: + text: + type: string + score: + type: number + freq: + type: number + highlighted: + type: string + collate_match: + type: boolean + required: + - text + - score + - freq + _core.search:TotalHits: + type: object + properties: + relation: + $ref: '#/components/schemas/_core.search:TotalHitsRelation' + value: + type: number + required: + - relation + - value + _core.search:TotalHitsRelation: + type: string + enum: + - eq + - gte + _core.search:TrackHits: + description: |- + Number of hits matching the query to count accurately. If true, the exact + number of hits is returned at the cost of some performance. If false, the + response does not include the total number of hits matching the query. + Defaults to 10,000 hits. + oneOf: + - type: boolean + - type: number + _core.search_shards:ShardStoreIndex: + type: object + properties: + aliases: + type: array + items: + $ref: '#/components/schemas/_common:Name' + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + _core.termvectors:FieldStatistics: + type: object + properties: + doc_count: + type: number + sum_doc_freq: + type: number + sum_ttf: + type: number + required: + - doc_count + - sum_doc_freq + - sum_ttf + _core.termvectors:Filter: + type: object + properties: + max_doc_freq: + description: |- + Ignore words which occur in more than this many docs. + Defaults to unbounded. + type: number + max_num_terms: + description: Maximum number of terms that must be returned per field. + type: number + max_term_freq: + description: |- + Ignore words with more than this frequency in the source doc. + Defaults to unbounded. + type: number + max_word_length: + description: |- + The maximum word length above which words will be ignored. + Defaults to unbounded. + type: number + min_doc_freq: + description: Ignore terms which do not occur in at least this many docs. + type: number + min_term_freq: + description: Ignore words with less than this frequency in the source doc. + type: number + min_word_length: + description: The minimum word length below which words will be ignored. + type: number + _core.termvectors:Term: + type: object + properties: + doc_freq: + type: number + score: + type: number + term_freq: + type: number + tokens: + type: array + items: + $ref: '#/components/schemas/_core.termvectors:Token' + ttf: + type: number + required: + - term_freq + _core.termvectors:TermVector: + type: object + properties: + field_statistics: + $ref: '#/components/schemas/_core.termvectors:FieldStatistics' + terms: + type: object + additionalProperties: + $ref: '#/components/schemas/_core.termvectors:Term' + required: + - field_statistics + - terms + _core.termvectors:Token: + type: object + properties: + end_offset: + type: number + payload: + type: string + position: + type: number + start_offset: + type: number + required: + - position + _core.update:UpdateWriteResponseBase: + allOf: + - $ref: '#/components/schemas/_common:WriteResponseBase' + - type: object + properties: + get: + $ref: '#/components/schemas/_common:InlineGet' + _core.update_by_query_rethrottle:UpdateByQueryRethrottleNode: + allOf: + - $ref: '#/components/schemas/_common:BaseNode' + - type: object + properties: + tasks: + type: object + additionalProperties: + $ref: '#/components/schemas/tasks._common:TaskInfo' + required: + - tasks + cat._common:CatPitSegmentsRecord: + type: object + properties: + index: + type: string + shard: + type: string + prirep: + type: string + ip: + type: string + segment: + type: string + generation: + type: string + docs.count: + type: string + docs.deleted: + type: string + size: + type: string + size.memory: + type: string + committed: + type: string + searchable: + type: string + version: + type: string + compound: + type: string + cat._common:CatSegmentReplicationRecord: + type: object + properties: + shardId: + type: string + target_node: + type: string + target_host: + type: string + checkpoints_behind: + type: string + bytes_behind: + type: string + current_lag: + type: string + last_completed_lag: + type: string + rejected_requests: + type: string + stage: + type: string + time: + type: string + files_fetched: + type: string + files_percent: + type: string + bytes_fetched: + type: string + bytes_percent: + type: string + start_time: + type: string + stop_time: + type: string + files: + type: string + files_total: + type: string + bytes: + type: string + bytes_total: + type: string + replicating_stage_time_taken: + type: string + get_checkpoint_info_stage_time_taken: + type: string + file_diff_stage_time_taken: + type: string + get_files_stage_time_taken: + type: string + finalize_replication_stage_time_taken: + type: string + cat.aliases:AliasesRecord: + type: object + properties: + alias: + description: alias name + type: string + index: + $ref: '#/components/schemas/_common:IndexName' + filter: + description: filter + type: string + routing.index: + description: index routing + type: string + routing.search: + description: search routing + type: string + is_write_index: + description: write index + type: string + cat.allocation:AllocationRecord: + type: object + properties: + shards: + description: Number of primary and replica shards assigned to the node. + type: string + disk.indices: + description: |- + Disk space used by the node’s shards. Does not include disk space for the translog or unassigned shards. + IMPORTANT: This metric double-counts disk space for hard-linked files, such as those created when shrinking, splitting, or cloning an index. + oneOf: + - $ref: '#/components/schemas/_common:ByteSize' + - nullable: true + type: string + disk.used: + description: |- + Total disk space in use. + Opensearch retrieves this metric from the node’s operating system (OS). + The metric includes disk space for: Opensearch, including the translog and unassigned shards; the node’s operating system; any other applications or files on the node. + Unlike `disk.indices`, this metric does not double-count disk space for hard-linked files. + oneOf: + - $ref: '#/components/schemas/_common:ByteSize' + - nullable: true + type: string + disk.avail: + description: |- + Free disk space available to Opensearch. + Opensearch retrieves this metric from the node’s operating system. + Disk-based shard allocation uses this metric to assign shards to nodes based on available disk space. + oneOf: + - $ref: '#/components/schemas/_common:ByteSize' + - nullable: true + type: string + disk.total: + description: Total disk space for the node, including in-use and available space. + oneOf: + - $ref: '#/components/schemas/_common:ByteSize' + - nullable: true + type: string + disk.percent: + description: Total percentage of disk space in use. Calculated as `disk.used / disk.total`. + oneOf: + - $ref: '#/components/schemas/_common:Percentage' + - nullable: true + type: string + host: + description: Network host for the node. Set using the `network.host` setting. + oneOf: + - $ref: '#/components/schemas/_common:Host' + - nullable: true + type: string + ip: + description: IP address and port for the node. + oneOf: + - $ref: '#/components/schemas/_common:Ip' + - nullable: true + type: string + node: + description: Name for the node. Set using the `node.name` setting. + type: string + cat.count:CountRecord: + type: object + properties: + epoch: + $ref: '#/components/schemas/_common:StringifiedEpochTimeUnitSeconds' + timestamp: + $ref: '#/components/schemas/_common:TimeOfDay' + count: + description: the document count + type: string + cat.fielddata:FielddataRecord: + type: object + properties: + id: + description: node id + type: string + host: + description: host name + type: string + ip: + description: ip address + type: string + node: + description: node name + type: string + field: + description: field name + type: string + size: + description: field data usage + type: string + cat.health:HealthRecord: + type: object + properties: + epoch: + $ref: '#/components/schemas/_common:StringifiedEpochTimeUnitSeconds' + timestamp: + $ref: '#/components/schemas/_common:TimeOfDay' + cluster: + description: cluster name + type: string + status: + description: health status + type: string + node.total: + description: total number of nodes + type: string + node.data: + description: number of nodes that can store data + type: string + shards: + description: total number of shards + type: string + pri: + description: number of primary shards + type: string + relo: + description: number of relocating nodes + type: string + init: + description: number of initializing nodes + type: string + unassign: + description: number of unassigned shards + type: string + pending_tasks: + description: number of pending tasks + type: string + max_task_wait_time: + description: wait time of longest task pending + type: string + active_shards_percent: + description: active number of shards in percent + type: string + cat.help:HelpRecord: + type: object + properties: + endpoint: + type: string + required: + - endpoint + cat.indices:IndicesRecord: + type: object + properties: + health: + description: current health status + type: string + status: + description: open/close status + type: string + index: + description: index name + type: string + uuid: + description: index uuid + type: string + pri: + description: number of primary shards + type: string + rep: + description: number of replica shards + type: string + docs.count: + description: available docs + oneOf: + - type: string + - nullable: true + type: string + docs.deleted: + description: deleted docs + oneOf: + - type: string + - nullable: true + type: string + creation.date: + description: index creation date (millisecond value) + type: string + creation.date.string: + description: index creation date (as string) + type: string + store.size: + description: store size of primaries & replicas + oneOf: + - type: string + - nullable: true + type: string + pri.store.size: + description: store size of primaries + oneOf: + - type: string + - nullable: true + type: string + completion.size: + description: size of completion + type: string + pri.completion.size: + description: size of completion + type: string + fielddata.memory_size: + description: used fielddata cache + type: string + pri.fielddata.memory_size: + description: used fielddata cache + type: string + fielddata.evictions: + description: fielddata evictions + type: string + pri.fielddata.evictions: + description: fielddata evictions + type: string + query_cache.memory_size: + description: used query cache + type: string + pri.query_cache.memory_size: + description: used query cache + type: string + query_cache.evictions: + description: query cache evictions + type: string + pri.query_cache.evictions: + description: query cache evictions + type: string + request_cache.memory_size: + description: used request cache + type: string + pri.request_cache.memory_size: + description: used request cache + type: string + request_cache.evictions: + description: request cache evictions + type: string + pri.request_cache.evictions: + description: request cache evictions + type: string + request_cache.hit_count: + description: request cache hit count + type: string + pri.request_cache.hit_count: + description: request cache hit count + type: string + request_cache.miss_count: + description: request cache miss count + type: string + pri.request_cache.miss_count: + description: request cache miss count + type: string + flush.total: + description: number of flushes + type: string + pri.flush.total: + description: number of flushes + type: string + flush.total_time: + description: time spent in flush + type: string + pri.flush.total_time: + description: time spent in flush + type: string + get.current: + description: number of current get ops + type: string + pri.get.current: + description: number of current get ops + type: string + get.time: + description: time spent in get + type: string + pri.get.time: + description: time spent in get + type: string + get.total: + description: number of get ops + type: string + pri.get.total: + description: number of get ops + type: string + get.exists_time: + description: time spent in successful gets + type: string + pri.get.exists_time: + description: time spent in successful gets + type: string + get.exists_total: + description: number of successful gets + type: string + pri.get.exists_total: + description: number of successful gets + type: string + get.missing_time: + description: time spent in failed gets + type: string + pri.get.missing_time: + description: time spent in failed gets + type: string + get.missing_total: + description: number of failed gets + type: string + pri.get.missing_total: + description: number of failed gets + type: string + indexing.delete_current: + description: number of current deletions + type: string + pri.indexing.delete_current: + description: number of current deletions + type: string + indexing.delete_time: + description: time spent in deletions + type: string + pri.indexing.delete_time: + description: time spent in deletions + type: string + indexing.delete_total: + description: number of delete ops + type: string + pri.indexing.delete_total: + description: number of delete ops + type: string + indexing.index_current: + description: number of current indexing ops + type: string + pri.indexing.index_current: + description: number of current indexing ops + type: string + indexing.index_time: + description: time spent in indexing + type: string + pri.indexing.index_time: + description: time spent in indexing + type: string + indexing.index_total: + description: number of indexing ops + type: string + pri.indexing.index_total: + description: number of indexing ops + type: string + indexing.index_failed: + description: number of failed indexing ops + type: string + pri.indexing.index_failed: + description: number of failed indexing ops + type: string + merges.current: + description: number of current merges + type: string + pri.merges.current: + description: number of current merges + type: string + merges.current_docs: + description: number of current merging docs + type: string + pri.merges.current_docs: + description: number of current merging docs + type: string + merges.current_size: + description: size of current merges + type: string + pri.merges.current_size: + description: size of current merges + type: string + merges.total: + description: number of completed merge ops + type: string + pri.merges.total: + description: number of completed merge ops + type: string + merges.total_docs: + description: docs merged + type: string + pri.merges.total_docs: + description: docs merged + type: string + merges.total_size: + description: size merged + type: string + pri.merges.total_size: + description: size merged + type: string + merges.total_time: + description: time spent in merges + type: string + pri.merges.total_time: + description: time spent in merges + type: string + refresh.total: + description: total refreshes + type: string + pri.refresh.total: + description: total refreshes + type: string + refresh.time: + description: time spent in refreshes + type: string + pri.refresh.time: + description: time spent in refreshes + type: string + refresh.external_total: + description: total external refreshes + type: string + pri.refresh.external_total: + description: total external refreshes + type: string + refresh.external_time: + description: time spent in external refreshes + type: string + pri.refresh.external_time: + description: time spent in external refreshes + type: string + refresh.listeners: + description: number of pending refresh listeners + type: string + pri.refresh.listeners: + description: number of pending refresh listeners + type: string + search.fetch_current: + description: current fetch phase ops + type: string + pri.search.fetch_current: + description: current fetch phase ops + type: string + search.fetch_time: + description: time spent in fetch phase + type: string + pri.search.fetch_time: + description: time spent in fetch phase + type: string + search.fetch_total: + description: total fetch ops + type: string + pri.search.fetch_total: + description: total fetch ops + type: string + search.open_contexts: + description: open search contexts + type: string + pri.search.open_contexts: + description: open search contexts + type: string + search.query_current: + description: current query phase ops + type: string + pri.search.query_current: + description: current query phase ops + type: string + search.query_time: + description: time spent in query phase + type: string + pri.search.query_time: + description: time spent in query phase + type: string + search.query_total: + description: total query phase ops + type: string + pri.search.query_total: + description: total query phase ops + type: string + search.scroll_current: + description: open scroll contexts + type: string + pri.search.scroll_current: + description: open scroll contexts + type: string + search.scroll_time: + description: time scroll contexts held open + type: string + pri.search.scroll_time: + description: time scroll contexts held open + type: string + search.scroll_total: + description: completed scroll contexts + type: string + pri.search.scroll_total: + description: completed scroll contexts + type: string + segments.count: + description: number of segments + type: string + pri.segments.count: + description: number of segments + type: string + segments.memory: + description: memory used by segments + type: string + pri.segments.memory: + description: memory used by segments + type: string + segments.index_writer_memory: + description: memory used by index writer + type: string + pri.segments.index_writer_memory: + description: memory used by index writer + type: string + segments.version_map_memory: + description: memory used by version map + type: string + pri.segments.version_map_memory: + description: memory used by version map + type: string + segments.fixed_bitset_memory: + description: memory used by fixed bit sets for nested object field types and export type filters for types referred in _parent fields + type: string + pri.segments.fixed_bitset_memory: + description: memory used by fixed bit sets for nested object field types and export type filters for types referred in _parent fields + type: string + warmer.current: + description: current warmer ops + type: string + pri.warmer.current: + description: current warmer ops + type: string + warmer.total: + description: total warmer ops + type: string + pri.warmer.total: + description: total warmer ops + type: string + warmer.total_time: + description: time spent in warmers + type: string + pri.warmer.total_time: + description: time spent in warmers + type: string + suggest.current: + description: number of current suggest ops + type: string + pri.suggest.current: + description: number of current suggest ops + type: string + suggest.time: + description: time spend in suggest + type: string + pri.suggest.time: + description: time spend in suggest + type: string + suggest.total: + description: number of suggest ops + type: string + pri.suggest.total: + description: number of suggest ops + type: string + memory.total: + description: total used memory + type: string + pri.memory.total: + description: total user memory + type: string + search.throttled: + description: indicates if the index is search throttled + type: string + bulk.total_operations: + description: number of bulk shard ops + type: string + pri.bulk.total_operations: + description: number of bulk shard ops + type: string + bulk.total_time: + description: time spend in shard bulk + type: string + pri.bulk.total_time: + description: time spend in shard bulk + type: string + bulk.total_size_in_bytes: + description: total size in bytes of shard bulk + type: string + pri.bulk.total_size_in_bytes: + description: total size in bytes of shard bulk + type: string + bulk.avg_time: + description: average time spend in shard bulk + type: string + pri.bulk.avg_time: + description: average time spend in shard bulk + type: string + bulk.avg_size_in_bytes: + description: average size in bytes of shard bulk + type: string + pri.bulk.avg_size_in_bytes: + description: average size in bytes of shard bulk + type: string + cat.master:MasterRecord: + type: object + properties: + id: + description: node id + type: string + host: + description: host name + type: string + ip: + description: ip address + type: string + node: + description: node name + type: string + cat.nodeattrs:NodeAttributesRecord: + type: object + properties: + node: + description: The node name. + type: string + id: + description: The unique node identifier. + type: string + pid: + description: The process identifier. + type: string + host: + description: The host name. + type: string + ip: + description: The IP address. + type: string + port: + description: The bound transport port. + type: string + attr: + description: The attribute name. + type: string + value: + description: The attribute value. + type: string + cat.nodes:NodesRecord: + type: object + properties: + id: + $ref: '#/components/schemas/_common:Id' + pid: + description: The process identifier. + type: string + ip: + description: The IP address. + type: string + port: + description: The bound transport port. + type: string + http_address: + description: The bound HTTP address. + type: string + version: + $ref: '#/components/schemas/_common:VersionString' + flavor: + description: The Opensearch distribution flavor. + type: string + type: + description: The Opensearch distribution type. + type: string + build: + description: The Opensearch build hash. + type: string + jdk: + description: The Java version. + type: string + disk.total: + $ref: '#/components/schemas/_common:ByteSize' + disk.used: + $ref: '#/components/schemas/_common:ByteSize' + disk.avail: + $ref: '#/components/schemas/_common:ByteSize' + disk.used_percent: + $ref: '#/components/schemas/_common:Percentage' + heap.current: + description: The used heap. + type: string + heap.percent: + $ref: '#/components/schemas/_common:Percentage' + heap.max: + description: The maximum configured heap. + type: string + ram.current: + description: The used machine memory. + type: string + ram.percent: + $ref: '#/components/schemas/_common:Percentage' + ram.max: + description: The total machine memory. + type: string + file_desc.current: + description: The used file descriptors. + type: string + file_desc.percent: + $ref: '#/components/schemas/_common:Percentage' + file_desc.max: + description: The maximum number of file descriptors. + type: string + cpu: + description: The recent system CPU usage as a percentage. + type: string + load_1m: + description: The load average for the most recent minute. + type: string + load_5m: + description: The load average for the last five minutes. + type: string + load_15m: + description: The load average for the last fifteen minutes. + type: string + uptime: + description: The node uptime. + type: string + node.role: + description: |- + The roles of the node. + Returned values include `c`(cold node), `d`(data node), `f`(frozen node), `h`(hot node), `i`(ingest node), `l`(machine learning node), `m` (cluster-manager eligible node), `r`(remote cluster client node), `s`(content node), `t`(transform node), `v`(voting-only node), `w`(warm node),and `-`(coordinating node only). + type: string + node.roles: + description: |- + A comma-separated list of the roles of the node. + Returned values may include but are not limited to: `data`, `ingest`, `master`, `cluster_manager`, `remote_cluster_client`, `search`, and `-`(coordinating node only). + type: string + cluster_manager: + description: |- + Indicates whether the node is the elected cluster-manager node. + Returned values include `*`(elected cluster-manager) and `-`(not elected cluster-manager). + type: string + master: + description: |- + Indicates whether the node is the elected master node. + Returned values include `*`(elected master) and `-`(not elected master). + type: string + x-version-deprecated: 2.0.0 + x-deprecation-message: To promote inclusive language, use 'cluster_manager' instead. + name: + $ref: '#/components/schemas/_common:Name' + completion.size: + description: The size of completion. + type: string + fielddata.memory_size: + description: The used fielddata cache. + type: string + fielddata.evictions: + description: The fielddata evictions. + type: string + query_cache.memory_size: + description: The used query cache. + type: string + query_cache.evictions: + description: The query cache evictions. + type: string + query_cache.hit_count: + description: The query cache hit counts. + type: string + query_cache.miss_count: + description: The query cache miss counts. + type: string + request_cache.memory_size: + description: The used request cache. + type: string + request_cache.evictions: + description: The request cache evictions. + type: string + request_cache.hit_count: + description: The request cache hit counts. + type: string + request_cache.miss_count: + description: The request cache miss counts. + type: string + flush.total: + description: The number of flushes. + type: string + flush.total_time: + description: The time spent in flush. + type: string + get.current: + description: The number of current get ops. + type: string + get.time: + description: The time spent in get. + type: string + get.total: + description: The number of get ops. + type: string + get.exists_time: + description: The time spent in successful gets. + type: string + get.exists_total: + description: The number of successful get operations. + type: string + get.missing_time: + description: The time spent in failed gets. + type: string + get.missing_total: + description: The number of failed gets. + type: string + indexing.delete_current: + description: The number of current deletions. + type: string + indexing.delete_time: + description: The time spent in deletions. + type: string + indexing.delete_total: + description: The number of delete operations. + type: string + indexing.index_current: + description: The number of current indexing operations. + type: string + indexing.index_time: + description: The time spent in indexing. + type: string + indexing.index_total: + description: The number of indexing operations. + type: string + indexing.index_failed: + description: The number of failed indexing operations. + type: string + merges.current: + description: The number of current merges. + type: string + merges.current_docs: + description: The number of current merging docs. + type: string + merges.current_size: + description: The size of current merges. + type: string + merges.total: + description: The number of completed merge operations. + type: string + merges.total_docs: + description: The docs merged. + type: string + merges.total_size: + description: The size merged. + type: string + merges.total_time: + description: The time spent in merges. + type: string + refresh.total: + description: The total refreshes. + type: string + refresh.time: + description: The time spent in refreshes. + type: string + refresh.external_total: + description: The total external refreshes. + type: string + refresh.external_time: + description: The time spent in external refreshes. + type: string + refresh.listeners: + description: The number of pending refresh listeners. + type: string + script.compilations: + description: The total script compilations. + type: string + script.cache_evictions: + description: The total compiled scripts evicted from the cache. + type: string + script.compilation_limit_triggered: + description: The script cache compilation limit triggered. + type: string + search.fetch_current: + description: The current fetch phase operations. + type: string + search.fetch_time: + description: The time spent in fetch phase. + type: string + search.fetch_total: + description: The total fetch operations. + type: string + search.open_contexts: + description: The open search contexts. + type: string + search.query_current: + description: The current query phase operations. + type: string + search.query_time: + description: The time spent in query phase. + type: string + search.query_total: + description: The total query phase operations. + type: string + search.scroll_current: + description: The open scroll contexts. + type: string + search.scroll_time: + description: The time scroll contexts held open. + type: string + search.scroll_total: + description: The completed scroll contexts. + type: string + segments.count: + description: The number of segments. + type: string + segments.memory: + description: The memory used by segments. + type: string + segments.index_writer_memory: + description: The memory used by the index writer. + type: string + segments.version_map_memory: + description: The memory used by the version map. + type: string + segments.fixed_bitset_memory: + description: The memory used by fixed bit sets for nested object field types and export type filters for types referred in _parent fields. + type: string + suggest.current: + description: The number of current suggest operations. + type: string + suggest.time: + description: The time spend in suggest. + type: string + suggest.total: + description: The number of suggest operations. + type: string + bulk.total_operations: + description: The number of bulk shard operations. + type: string + bulk.total_time: + description: The time spend in shard bulk. + type: string + bulk.total_size_in_bytes: + description: The total size in bytes of shard bulk. + type: string + bulk.avg_time: + description: The average time spend in shard bulk. + type: string + bulk.avg_size_in_bytes: + description: The average size in bytes of shard bulk. + type: string + cat.pending_tasks:PendingTasksRecord: + type: object + properties: + insertOrder: + description: The task insertion order. + type: string + timeInQueue: + description: Indicates how long the task has been in queue. + type: string + priority: + description: The task priority. + type: string + source: + description: The task source. + type: string + cat.plugins:PluginsRecord: + type: object + properties: + id: + $ref: '#/components/schemas/_common:NodeId' + name: + $ref: '#/components/schemas/_common:Name' + component: + description: The component name. + type: string + version: + $ref: '#/components/schemas/_common:VersionString' + description: + description: The plugin details. + type: string + type: + description: The plugin type. + type: string + cat.recovery:RecoveryRecord: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + shard: + description: The shard name. + type: string + start_time: + $ref: '#/components/schemas/_common:DateTime' + start_time_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + stop_time: + $ref: '#/components/schemas/_common:DateTime' + stop_time_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + time: + $ref: '#/components/schemas/_common:Duration' + type: + description: The recovery type. + type: string + stage: + description: The recovery stage. + type: string + source_host: + description: The source host. + type: string + source_node: + description: The source node name. + type: string + target_host: + description: The target host. + type: string + target_node: + description: The target node name. + type: string + repository: + description: The repository name. + type: string + snapshot: + description: The snapshot name. + type: string + files: + description: The number of files to recover. + type: string + files_recovered: + description: The files recovered. + type: string + files_percent: + $ref: '#/components/schemas/_common:Percentage' + files_total: + description: The total number of files. + type: string + bytes: + description: The number of bytes to recover. + type: string + bytes_recovered: + description: The bytes recovered. + type: string + bytes_percent: + $ref: '#/components/schemas/_common:Percentage' + bytes_total: + description: The total number of bytes. + type: string + translog_ops: + description: The number of translog operations to recover. + type: string + translog_ops_recovered: + description: The translog operations recovered. + type: string + translog_ops_percent: + $ref: '#/components/schemas/_common:Percentage' + cat.repositories:RepositoriesRecord: + type: object + properties: + id: + description: The unique repository identifier. + type: string + type: + description: The repository type. + type: string + cat.segments:SegmentsRecord: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + shard: + description: The shard name. + type: string + prirep: + description: 'The shard type: `primary` or `replica`.' + type: string + ip: + description: The IP address of the node where it lives. + type: string + id: + $ref: '#/components/schemas/_common:NodeId' + segment: + description: The segment name, which is derived from the segment generation and used internally to create file names in the directory of the shard. + type: string + generation: + description: |- + The segment generation number. + Opensearch increments this generation number for each segment written then uses this number to derive the segment name. + type: string + docs.count: + description: |- + The number of documents in the segment. + This excludes deleted documents and counts any nested documents separately from their parents. + It also excludes documents which were indexed recently and do not yet belong to a segment. + type: string + docs.deleted: + description: |- + The number of deleted documents in the segment, which might be higher or lower than the number of delete operations you have performed. + This number excludes deletes that were performed recently and do not yet belong to a segment. + Deleted documents are cleaned up by the automatic merge process if it makes sense to do so. + Also, Opensearch creates extra deleted documents to internally track the recent history of operations on a shard. + type: string + size: + $ref: '#/components/schemas/_common:ByteSize' + size.memory: + $ref: '#/components/schemas/_common:ByteSize' + committed: + description: |- + If `true`, the segment is synced to disk. + Segments that are synced can survive a hard reboot. + If `false`, the data from uncommitted segments is also stored in the transaction log so that Opensearch is able to replay changes on the next start. + type: string + searchable: + description: |- + If `true`, the segment is searchable. + If `false`, the segment has most likely been written to disk but needs a refresh to be searchable. + type: string + version: + $ref: '#/components/schemas/_common:VersionString' + compound: + description: |- + If `true`, the segment is stored in a compound file. + This means Lucene merged all files from the segment in a single file to save file descriptors. + type: string + cat.shards:ShardsRecord: + type: object + properties: + index: + description: The index name. + type: string + shard: + description: The shard name. + type: string + prirep: + description: 'The shard type: `primary` or `replica`.' + type: string + state: + description: |- + The shard state. + Returned values include: + `INITIALIZING`: The shard is recovering from a peer shard or gateway. + `RELOCATING`: The shard is relocating. + `STARTED`: The shard has started. + `UNASSIGNED`: The shard is not assigned to any node. + type: string + docs: + description: The number of documents in the shard. + oneOf: + - type: string + - nullable: true + type: string + store: + description: The disk space used by the shard. + oneOf: + - type: string + - nullable: true + type: string + ip: + description: The IP address of the node. + oneOf: + - type: string + - nullable: true + type: string + id: + description: The unique identifier for the node. + type: string + node: + description: The name of node. + oneOf: + - type: string + - nullable: true + type: string + sync_id: + description: The sync identifier. + type: string + unassigned.reason: + description: |- + The reason for the last change to the state of an unassigned shard. + It does not explain why the shard is currently unassigned; use the cluster allocation explain API for that information. + Returned values include: + `ALLOCATION_FAILED`: Unassigned as a result of a failed allocation of the shard. + `CLUSTER_RECOVERED`: Unassigned as a result of a full cluster recovery. + `DANGLING_INDEX_IMPORTED`: Unassigned as a result of importing a dangling index. + `EXISTING_INDEX_RESTORED`: Unassigned as a result of restoring into a closed index. + `FORCED_EMPTY_PRIMARY`: The shard’s allocation was last modified by forcing an empty primary using the cluster reroute API. + `INDEX_CLOSED`: Unassigned because the index was closed. + `INDEX_CREATED`: Unassigned as a result of an API creation of an index. + `INDEX_REOPENED`: Unassigned as a result of opening a closed index. + `MANUAL_ALLOCATION`: The shard’s allocation was last modified by the cluster reroute API. + `NEW_INDEX_RESTORED`: Unassigned as a result of restoring into a new index. + `NODE_LEFT`: Unassigned as a result of the node hosting it leaving the cluster. + `NODE_RESTARTING`: Similar to `NODE_LEFT`, except that the node was registered as restarting using the node shutdown API. + `PRIMARY_FAILED`: The shard was initializing as a replica, but the primary shard failed before the initialization completed. + `REALLOCATED_REPLICA`: A better replica location is identified and causes the existing replica allocation to be cancelled. + `REINITIALIZED`: When a shard moves from started back to initializing. + `REPLICA_ADDED`: Unassigned as a result of explicit addition of a replica. + `REROUTE_CANCELLED`: Unassigned as a result of explicit cancel reroute command. + type: string + unassigned.at: + description: The time at which the shard became unassigned in Coordinated Universal Time (UTC). + type: string + unassigned.for: + description: The time at which the shard was requested to be unassigned in Coordinated Universal Time (UTC). + type: string + unassigned.details: + description: |- + Additional details as to why the shard became unassigned. + It does not explain why the shard is not assigned; use the cluster allocation explain API for that information. + type: string + recoverysource.type: + description: The type of recovery source. + type: string + completion.size: + description: The size of completion. + type: string + fielddata.memory_size: + description: The used fielddata cache memory. + type: string + fielddata.evictions: + description: The fielddata cache evictions. + type: string + query_cache.memory_size: + description: The used query cache memory. + type: string + query_cache.evictions: + description: The query cache evictions. + type: string + flush.total: + description: The number of flushes. + type: string + flush.total_time: + description: The time spent in flush. + type: string + get.current: + description: The number of current get operations. + type: string + get.time: + description: The time spent in get operations. + type: string + get.total: + description: The number of get operations. + type: string + get.exists_time: + description: The time spent in successful get operations. + type: string + get.exists_total: + description: The number of successful get operations. + type: string + get.missing_time: + description: The time spent in failed get operations. + type: string + get.missing_total: + description: The number of failed get operations. + type: string + indexing.delete_current: + description: The number of current deletion operations. + type: string + indexing.delete_time: + description: The time spent in deletion operations. + type: string + indexing.delete_total: + description: The number of delete operations. + type: string + indexing.index_current: + description: The number of current indexing operations. + type: string + indexing.index_time: + description: The time spent in indexing operations. + type: string + indexing.index_total: + description: The number of indexing operations. + type: string + indexing.index_failed: + description: The number of failed indexing operations. + type: string + merges.current: + description: The number of current merge operations. + type: string + merges.current_docs: + description: The number of current merging documents. + type: string + merges.current_size: + description: The size of current merge operations. + type: string + merges.total: + description: The number of completed merge operations. + type: string + merges.total_docs: + description: The nuber of merged documents. + type: string + merges.total_size: + description: The size of current merges. + type: string + merges.total_time: + description: The time spent merging documents. + type: string + refresh.total: + description: The total number of refreshes. + type: string + refresh.time: + description: The time spent in refreshes. + type: string + refresh.external_total: + description: The total nunber of external refreshes. + type: string + refresh.external_time: + description: The time spent in external refreshes. + type: string + refresh.listeners: + description: The number of pending refresh listeners. + type: string + search.fetch_current: + description: The current fetch phase operations. + type: string + search.fetch_time: + description: The time spent in fetch phase. + type: string + search.fetch_total: + description: The total number of fetch operations. + type: string + search.open_contexts: + description: The number of open search contexts. + type: string + search.query_current: + description: The current query phase operations. + type: string + search.query_time: + description: The time spent in query phase. + type: string + search.query_total: + description: The total number of query phase operations. + type: string + search.scroll_current: + description: The open scroll contexts. + type: string + search.scroll_time: + description: The time scroll contexts were held open. + type: string + search.scroll_total: + description: The number of completed scroll contexts. + type: string + segments.count: + description: The number of segments. + type: string + segments.memory: + description: The memory used by segments. + type: string + segments.index_writer_memory: + description: The memory used by the index writer. + type: string + segments.version_map_memory: + description: The memory used by the version map. + type: string + segments.fixed_bitset_memory: + description: The memory used by fixed bit sets for nested object field types and export type filters for types referred in `_parent` fields. + type: string + seq_no.max: + description: The maximum sequence number. + type: string + seq_no.local_checkpoint: + description: The local checkpoint. + type: string + seq_no.global_checkpoint: + description: The global checkpoint. + type: string + warmer.current: + description: The number of current warmer operations. + type: string + warmer.total: + description: The total number of warmer operations. + type: string + warmer.total_time: + description: The time spent in warmer operations. + type: string + path.data: + description: The shard data path. + type: string + path.state: + description: The shard state path. + type: string + bulk.total_operations: + description: The number of bulk shard operations. + type: string + bulk.total_time: + description: The time spent in shard bulk operations. + type: string + bulk.total_size_in_bytes: + description: The total size in bytes of shard bulk operations. + type: string + bulk.avg_time: + description: The average time spent in shard bulk operations. + type: string + bulk.avg_size_in_bytes: + description: The average size in bytes of shard bulk operations. + type: string + cat.snapshots:SnapshotsRecord: + type: object + properties: + id: + description: The unique identifier for the snapshot. + type: string + repository: + description: The repository name. + type: string + status: + description: |- + The state of the snapshot process. + Returned values include: + `FAILED`: The snapshot process failed. + `INCOMPATIBLE`: The snapshot process is incompatible with the current cluster version. + `IN_PROGRESS`: The snapshot process started but has not completed. + `PARTIAL`: The snapshot process completed with a partial success. + `SUCCESS`: The snapshot process completed with a full success. + type: string + start_epoch: + $ref: '#/components/schemas/_common:StringifiedEpochTimeUnitSeconds' + start_time: + $ref: '#/components/schemas/_common:ScheduleTimeOfDay' + end_epoch: + $ref: '#/components/schemas/_common:StringifiedEpochTimeUnitSeconds' + end_time: + $ref: '#/components/schemas/_common:TimeOfDay' + duration: + $ref: '#/components/schemas/_common:Duration' + indices: + description: The number of indices in the snapshot. + type: string + successful_shards: + description: The number of successful shards in the snapshot. + type: string + failed_shards: + description: The number of failed shards in the snapshot. + type: string + total_shards: + description: The total number of shards in the snapshot. + type: string + reason: + description: The reason for any snapshot failures. + type: string + cat.tasks:TasksRecord: + type: object + properties: + id: + $ref: '#/components/schemas/_common:Id' + action: + description: The task action. + type: string + task_id: + $ref: '#/components/schemas/_common:Id' + parent_task_id: + description: The parent task identifier. + type: string + type: + description: The task type. + type: string + start_time: + description: The start time in milliseconds. + type: string + timestamp: + description: The start time in `HH:MM:SS` format. + type: string + running_time_ns: + description: The running time in nanoseconds. + type: string + running_time: + description: The running time. + type: string + node_id: + $ref: '#/components/schemas/_common:NodeId' + ip: + description: The IP address for the node. + type: string + port: + description: The bound transport port for the node. + type: string + node: + description: The node name. + type: string + version: + $ref: '#/components/schemas/_common:VersionString' + x_opaque_id: + description: The X-Opaque-ID header. + type: string + description: + description: The task action description. + type: string + cat.templates:TemplatesRecord: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + index_patterns: + description: The template index patterns. + type: string + order: + description: The template application order or priority number. + type: string + version: + description: The template version. + oneOf: + - $ref: '#/components/schemas/_common:VersionString' + - nullable: true + type: string + composed_of: + description: The component templates that comprise the index template. + type: string + cat.thread_pool:ThreadPoolRecord: + type: object + properties: + node_name: + description: The node name. + type: string + node_id: + $ref: '#/components/schemas/_common:NodeId' + ephemeral_node_id: + description: The ephemeral node identifier. + type: string + pid: + description: The process identifier. + type: string + host: + description: The host name for the current node. + type: string + ip: + description: The IP address for the current node. + type: string + port: + description: The bound transport port for the current node. + type: string + name: + description: The thread pool name. + type: string + type: + description: |- + The thread pool type. + Returned values include `fixed`, `fixed_auto_queue_size`, `direct`, and `scaling`. + type: string + active: + description: The number of active threads in the current thread pool. + type: string + pool_size: + description: The number of threads in the current thread pool. + type: string + queue: + description: The number of tasks currently in queue. + type: string + queue_size: + description: The maximum number of tasks permitted in the queue. + type: string + rejected: + description: The number of rejected tasks. + type: string + largest: + description: The highest number of active threads in the current thread pool. + type: string + completed: + description: The number of completed tasks. + type: string + core: + description: The core number of active threads allowed in a scaling thread pool. + oneOf: + - type: string + - nullable: true + type: string + max: + description: The maximum number of active threads allowed in a scaling thread pool. + oneOf: + - type: string + - nullable: true + type: string + size: + description: The number of active threads allowed in a fixed thread pool. + oneOf: + - type: string + - nullable: true + type: string + keep_alive: + description: The thread keep alive time. + oneOf: + - type: string + - nullable: true + type: string + cluster._common:ComponentTemplate: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + component_template: + $ref: '#/components/schemas/cluster._common:ComponentTemplateNode' + required: + - name + - component_template + cluster._common:ComponentTemplateNode: + type: object + properties: + template: + $ref: '#/components/schemas/cluster._common:ComponentTemplateSummary' + version: + $ref: '#/components/schemas/_common:VersionNumber' + _meta: + $ref: '#/components/schemas/_common:Metadata' + required: + - template + cluster._common:ComponentTemplateSummary: + type: object + properties: + _meta: + $ref: '#/components/schemas/_common:Metadata' + version: + $ref: '#/components/schemas/_common:VersionNumber' + settings: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:IndexSettings' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + aliases: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:AliasDefinition' + lifecycle: + $ref: '#/components/schemas/indices._common:DataStreamLifecycleWithRollover' + cluster.allocation_explain:AllocationDecision: + type: object + properties: + decider: + type: string + decision: + $ref: '#/components/schemas/cluster.allocation_explain:AllocationExplainDecision' + explanation: + type: string + required: + - decider + - decision + - explanation + cluster.allocation_explain:AllocationExplainDecision: + type: string + enum: + - NO + - YES + - THROTTLE + - ALWAYS + cluster.allocation_explain:AllocationStore: + type: object + properties: + allocation_id: + type: string + found: + type: boolean + in_sync: + type: boolean + matching_size_in_bytes: + type: number + matching_sync_id: + type: boolean + store_exception: + type: string + required: + - allocation_id + - found + - in_sync + - matching_size_in_bytes + - matching_sync_id + - store_exception + cluster.allocation_explain:ClusterInfo: + type: object + properties: + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/cluster.allocation_explain:NodeDiskUsage' + shard_sizes: + type: object + additionalProperties: + type: number + shard_data_set_sizes: + type: object + additionalProperties: + type: string + shard_paths: + type: object + additionalProperties: + type: string + reserved_sizes: + type: array + items: + $ref: '#/components/schemas/cluster.allocation_explain:ReservedSize' + required: + - nodes + - shard_sizes + - shard_paths + - reserved_sizes + cluster.allocation_explain:CurrentNode: + type: object + properties: + id: + $ref: '#/components/schemas/_common:Id' + name: + $ref: '#/components/schemas/_common:Name' + attributes: + type: object + additionalProperties: + type: string + transport_address: + $ref: '#/components/schemas/_common:TransportAddress' + weight_ranking: + type: number + required: + - id + - name + - attributes + - transport_address + - weight_ranking + cluster.allocation_explain:Decision: + type: string + enum: + - yes + - no + - worse_balance + - throttled + - awaiting_info + - allocation_delayed + - no_valid_shard_copy + - no_attempt + cluster.allocation_explain:DiskUsage: + type: object + properties: + path: + type: string + total_bytes: + type: number + used_bytes: + type: number + free_bytes: + type: number + free_disk_percent: + type: number + used_disk_percent: + type: number + required: + - path + - total_bytes + - used_bytes + - free_bytes + - free_disk_percent + - used_disk_percent + cluster.allocation_explain:NodeAllocationExplanation: + type: object + properties: + deciders: + type: array + items: + $ref: '#/components/schemas/cluster.allocation_explain:AllocationDecision' + node_attributes: + type: object + additionalProperties: + type: string + node_decision: + $ref: '#/components/schemas/cluster.allocation_explain:Decision' + node_id: + $ref: '#/components/schemas/_common:Id' + node_name: + $ref: '#/components/schemas/_common:Name' + store: + $ref: '#/components/schemas/cluster.allocation_explain:AllocationStore' + transport_address: + $ref: '#/components/schemas/_common:TransportAddress' + weight_ranking: + type: number + required: + - deciders + - node_attributes + - node_decision + - node_id + - node_name + - transport_address + - weight_ranking + cluster.allocation_explain:NodeDiskUsage: + type: object + properties: + node_name: + $ref: '#/components/schemas/_common:Name' + least_available: + $ref: '#/components/schemas/cluster.allocation_explain:DiskUsage' + most_available: + $ref: '#/components/schemas/cluster.allocation_explain:DiskUsage' + required: + - node_name + - least_available + - most_available + cluster.allocation_explain:ReservedSize: + type: object + properties: + node_id: + $ref: '#/components/schemas/_common:Id' + path: + type: string + total: + type: number + shards: + type: array + items: + type: string + required: + - node_id + - path + - total + - shards + cluster.allocation_explain:UnassignedInformation: + type: object + properties: + at: + $ref: '#/components/schemas/_common:DateTime' + last_allocation_status: + type: string + reason: + $ref: '#/components/schemas/cluster.allocation_explain:UnassignedInformationReason' + details: + type: string + failed_allocation_attempts: + type: number + delayed: + type: boolean + allocation_status: + type: string + required: + - at + - reason + cluster.allocation_explain:UnassignedInformationReason: + type: string + enum: + - INDEX_CREATED + - CLUSTER_RECOVERED + - INDEX_REOPENED + - DANGLING_INDEX_IMPORTED + - NEW_INDEX_RESTORED + - EXISTING_INDEX_RESTORED + - REPLICA_ADDED + - ALLOCATION_FAILED + - NODE_LEFT + - REROUTE_CANCELLED + - REINITIALIZED + - REALLOCATED_REPLICA + - PRIMARY_FAILED + - FORCED_EMPTY_PRIMARY + - MANUAL_ALLOCATION + cluster.health:HealthResponseBody: + type: object + properties: + active_primary_shards: + description: The number of active primary shards. + type: number + active_shards: + description: The total number of active primary and replica shards. + type: number + active_shards_percent_as_number: + $ref: '#/components/schemas/_common:Percentage' + cluster_name: + $ref: '#/components/schemas/_common:Name' + delayed_unassigned_shards: + description: The number of shards whose allocation has been delayed by the timeout settings. + type: number + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/cluster.health:IndexHealthStats' + initializing_shards: + description: The number of shards that are under initialization. + type: number + number_of_data_nodes: + description: The number of nodes that are dedicated data nodes. + type: number + number_of_in_flight_fetch: + description: The number of unfinished fetches. + type: number + number_of_nodes: + description: The number of nodes within the cluster. + type: number + number_of_pending_tasks: + description: The number of cluster-level changes that have not yet been executed. + type: number + relocating_shards: + description: The number of shards that are under relocation. + type: number + status: + $ref: '#/components/schemas/_common:HealthStatus' + task_max_waiting_in_queue: + $ref: '#/components/schemas/_common:Duration' + task_max_waiting_in_queue_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + timed_out: + description: If false the response returned within the period of time that is specified by the timeout parameter (30s by default) + type: boolean + unassigned_shards: + description: The number of shards that are not allocated. + type: number + required: + - active_primary_shards + - active_shards + - active_shards_percent_as_number + - cluster_name + - delayed_unassigned_shards + - initializing_shards + - number_of_data_nodes + - number_of_in_flight_fetch + - number_of_nodes + - number_of_pending_tasks + - relocating_shards + - status + - task_max_waiting_in_queue_millis + - timed_out + - unassigned_shards + cluster.health:IndexHealthStats: + type: object + properties: + active_primary_shards: + type: number + active_shards: + type: number + initializing_shards: + type: number + number_of_replicas: + type: number + number_of_shards: + type: number + relocating_shards: + type: number + shards: + type: object + additionalProperties: + $ref: '#/components/schemas/cluster.health:ShardHealthStats' + status: + $ref: '#/components/schemas/_common:HealthStatus' + unassigned_shards: + type: number + required: + - active_primary_shards + - active_shards + - initializing_shards + - number_of_replicas + - number_of_shards + - relocating_shards + - status + - unassigned_shards + cluster.health:Level: + type: string + enum: + - cluster + - indices + - shards + - awareness_attributes + cluster.health:ShardHealthStats: + type: object + properties: + active_shards: + type: number + initializing_shards: + type: number + primary_active: + type: boolean + relocating_shards: + type: number + status: + $ref: '#/components/schemas/_common:HealthStatus' + unassigned_shards: + type: number + required: + - active_shards + - initializing_shards + - primary_active + - relocating_shards + - status + - unassigned_shards + cluster.pending_tasks:PendingTask: + type: object + properties: + executing: + description: Indicates whether the pending tasks are currently executing or not. + type: boolean + insert_order: + description: The number that represents when the task has been inserted into the task queue. + type: number + priority: + description: |- + The priority of the pending task. + The valid priorities in descending priority order are: `IMMEDIATE` > `URGENT` > `HIGH` > `NORMAL` > `LOW` > `LANGUID`. + type: string + source: + description: A general description of the cluster task that may include a reason and origin. + type: string + time_in_queue: + $ref: '#/components/schemas/_common:Duration' + time_in_queue_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - executing + - insert_order + - priority + - source + - time_in_queue_millis + cluster.remote_info:ClusterRemoteInfo: + discriminator: + propertyName: mode + oneOf: + - $ref: '#/components/schemas/cluster.remote_info:ClusterRemoteSniffInfo' + - $ref: '#/components/schemas/cluster.remote_info:ClusterRemoteProxyInfo' + cluster.remote_info:ClusterRemoteProxyInfo: + type: object + properties: + mode: + type: string + enum: + - proxy + connected: + type: boolean + initial_connect_timeout: + $ref: '#/components/schemas/_common:Duration' + skip_unavailable: + type: boolean + proxy_address: + type: string + server_name: + type: string + num_proxy_sockets_connected: + type: number + max_proxy_socket_connections: + type: number + required: + - mode + - connected + - initial_connect_timeout + - skip_unavailable + - proxy_address + - server_name + - num_proxy_sockets_connected + - max_proxy_socket_connections + cluster.remote_info:ClusterRemoteSniffInfo: + type: object + properties: + mode: + type: string + enum: + - sniff + connected: + type: boolean + max_connections_per_cluster: + type: number + num_nodes_connected: + type: number + initial_connect_timeout: + $ref: '#/components/schemas/_common:Duration' + skip_unavailable: + type: boolean + seeds: + type: array + items: + type: string + required: + - mode + - connected + - max_connections_per_cluster + - num_nodes_connected + - initial_connect_timeout + - skip_unavailable + - seeds + cluster.reroute:Command: + type: object + properties: + cancel: + $ref: '#/components/schemas/cluster.reroute:CommandCancelAction' + move: + $ref: '#/components/schemas/cluster.reroute:CommandMoveAction' + allocate_replica: + $ref: '#/components/schemas/cluster.reroute:CommandAllocateReplicaAction' + allocate_stale_primary: + $ref: '#/components/schemas/cluster.reroute:CommandAllocatePrimaryAction' + allocate_empty_primary: + $ref: '#/components/schemas/cluster.reroute:CommandAllocatePrimaryAction' + cluster.reroute:CommandAllocatePrimaryAction: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + shard: + type: number + node: + type: string + accept_data_loss: + description: If a node which has a copy of the data rejoins the cluster later on, that data will be deleted. To ensure that these implications are well-understood, this command requires the flag accept_data_loss to be explicitly set to true + type: boolean + required: + - index + - shard + - node + - accept_data_loss + cluster.reroute:CommandAllocateReplicaAction: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + shard: + type: number + node: + type: string + required: + - index + - shard + - node + cluster.reroute:CommandCancelAction: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + shard: + type: number + node: + type: string + allow_primary: + type: boolean + required: + - index + - shard + - node + cluster.reroute:CommandMoveAction: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + shard: + type: number + from_node: + description: The node to move the shard from + type: string + to_node: + description: The node to move the shard to + type: string + required: + - index + - shard + - from_node + - to_node + cluster.reroute:RerouteDecision: + type: object + properties: + decider: + type: string + decision: + type: string + explanation: + type: string + required: + - decider + - decision + - explanation + cluster.reroute:RerouteExplanation: + type: object + properties: + command: + type: string + decisions: + type: array + items: + $ref: '#/components/schemas/cluster.reroute:RerouteDecision' + parameters: + $ref: '#/components/schemas/cluster.reroute:RerouteParameters' + required: + - command + - decisions + - parameters + cluster.reroute:RerouteParameters: + type: object + properties: + allow_primary: + type: boolean + index: + $ref: '#/components/schemas/_common:IndexName' + node: + $ref: '#/components/schemas/_common:NodeName' + shard: + type: number + from_node: + $ref: '#/components/schemas/_common:NodeName' + to_node: + $ref: '#/components/schemas/_common:NodeName' + required: + - allow_primary + - index + - node + - shard + cluster.state:Metric: + type: string + enum: + - blocks + - metadata + - nodes + - routing_table + - routing_nodes + - master_node + - cluster_manager_node + - version + - _all + cluster.stats:CharFilterTypes: + type: object + properties: + analyzer_types: + description: Contains statistics about analyzer types used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + built_in_analyzers: + description: Contains statistics about built-in analyzers used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + built_in_char_filters: + description: Contains statistics about built-in character filters used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + built_in_filters: + description: Contains statistics about built-in token filters used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + built_in_tokenizers: + description: Contains statistics about built-in tokenizers used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + char_filter_types: + description: Contains statistics about character filter types used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + filter_types: + description: Contains statistics about token filter types used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + tokenizer_types: + description: Contains statistics about tokenizer types used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + required: + - analyzer_types + - built_in_analyzers + - built_in_char_filters + - built_in_filters + - built_in_tokenizers + - char_filter_types + - filter_types + - tokenizer_types + cluster.stats:ClusterFileSystem: + type: object + properties: + available_in_bytes: + description: |- + Total number of bytes available to JVM in file stores across all selected nodes. + Depending on operating system or process-level restrictions, this number may be less than `nodes.fs.free_in_byes`. + This is the actual amount of free disk space the selected Opensearch nodes can use. + type: number + free_in_bytes: + description: Total number of unallocated bytes in file stores across all selected nodes. + type: number + total_in_bytes: + description: Total size, in bytes, of all file stores across all selected nodes. + type: number + required: + - available_in_bytes + - free_in_bytes + - total_in_bytes + cluster.stats:ClusterIndices: + type: object + properties: + analysis: + $ref: '#/components/schemas/cluster.stats:CharFilterTypes' + completion: + $ref: '#/components/schemas/_common:CompletionStats' + count: + description: Total number of indices with shards assigned to selected nodes. + type: number + docs: + $ref: '#/components/schemas/_common:DocStats' + fielddata: + $ref: '#/components/schemas/_common:FielddataStats' + query_cache: + $ref: '#/components/schemas/_common:QueryCacheStats' + segments: + $ref: '#/components/schemas/_common:SegmentsStats' + shards: + $ref: '#/components/schemas/cluster.stats:ClusterIndicesShards' + store: + $ref: '#/components/schemas/_common:StoreStats' + mappings: + $ref: '#/components/schemas/cluster.stats:FieldTypesMappings' + versions: + description: Contains statistics about analyzers and analyzer components used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:IndicesVersions' + required: + - analysis + - completion + - count + - docs + - fielddata + - query_cache + - segments + - shards + - store + - mappings + cluster.stats:ClusterIndicesShards: + type: object + properties: + index: + $ref: '#/components/schemas/cluster.stats:ClusterIndicesShardsIndex' + primaries: + description: Number of primary shards assigned to selected nodes. + type: number + replication: + description: Ratio of replica shards to primary shards across all selected nodes. + type: number + total: + description: Total number of shards assigned to selected nodes. + type: number + cluster.stats:ClusterIndicesShardsIndex: + type: object + properties: + primaries: + $ref: '#/components/schemas/cluster.stats:ClusterShardMetrics' + replication: + $ref: '#/components/schemas/cluster.stats:ClusterShardMetrics' + shards: + $ref: '#/components/schemas/cluster.stats:ClusterShardMetrics' + required: + - primaries + - replication + - shards + cluster.stats:ClusterIngest: + type: object + properties: + number_of_pipelines: + type: number + processor_stats: + type: object + additionalProperties: + $ref: '#/components/schemas/cluster.stats:ClusterProcessor' + required: + - number_of_pipelines + - processor_stats + cluster.stats:ClusterJvm: + type: object + properties: + max_uptime_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + mem: + $ref: '#/components/schemas/cluster.stats:ClusterJvmMemory' + threads: + description: Number of active threads in use by JVM across all selected nodes. + type: number + versions: + description: Contains statistics about the JVM versions used by selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:ClusterJvmVersion' + required: + - max_uptime_in_millis + - mem + - threads + - versions + cluster.stats:ClusterJvmMemory: + type: object + properties: + heap_max_in_bytes: + description: Maximum amount of memory, in bytes, available for use by the heap across all selected nodes. + type: number + heap_used_in_bytes: + description: Memory, in bytes, currently in use by the heap across all selected nodes. + type: number + required: + - heap_max_in_bytes + - heap_used_in_bytes + cluster.stats:ClusterJvmVersion: + type: object + properties: + bundled_jdk: + description: Always `true`. All distributions come with a bundled Java Development Kit (JDK). + type: boolean + count: + description: Total number of selected nodes using JVM. + type: number + using_bundled_jdk: + description: If `true`, a bundled JDK is in use by JVM. + type: boolean + version: + $ref: '#/components/schemas/_common:VersionString' + vm_name: + description: Name of the JVM. + type: string + vm_vendor: + description: Vendor of the JVM. + type: string + vm_version: + $ref: '#/components/schemas/_common:VersionString' + required: + - bundled_jdk + - count + - using_bundled_jdk + - version + - vm_name + - vm_vendor + - vm_version + cluster.stats:ClusterNetworkTypes: + type: object + properties: + http_types: + description: Contains statistics about the HTTP network types used by selected nodes. + type: object + additionalProperties: + type: number + transport_types: + description: Contains statistics about the transport network types used by selected nodes. + type: object + additionalProperties: + type: number + required: + - http_types + - transport_types + cluster.stats:ClusterNodeCount: + type: object + properties: + coordinating_only: + type: number + data: + type: number + data_cold: + type: number + data_content: + type: number + data_frozen: + type: number + data_hot: + type: number + data_warm: + type: number + ingest: + type: number + master: + type: number + ml: + type: number + remote_cluster_client: + type: number + total: + type: number + transform: + type: number + voting_only: + type: number + required: + - coordinating_only + - data + - data_cold + - data_content + - data_hot + - data_warm + - ingest + - master + - ml + - remote_cluster_client + - total + - transform + - voting_only + cluster.stats:ClusterNodes: + type: object + properties: + count: + $ref: '#/components/schemas/cluster.stats:ClusterNodeCount' + discovery_types: + description: Contains statistics about the discovery types used by selected nodes. + type: object + additionalProperties: + type: number + fs: + $ref: '#/components/schemas/cluster.stats:ClusterFileSystem' + indexing_pressure: + $ref: '#/components/schemas/cluster.stats:IndexingPressure' + ingest: + $ref: '#/components/schemas/cluster.stats:ClusterIngest' + jvm: + $ref: '#/components/schemas/cluster.stats:ClusterJvm' + network_types: + $ref: '#/components/schemas/cluster.stats:ClusterNetworkTypes' + os: + $ref: '#/components/schemas/cluster.stats:ClusterOperatingSystem' + packaging_types: + description: Contains statistics about Opensearch distributions installed on selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:NodePackagingType' + plugins: + description: |- + Contains statistics about installed plugins and modules by selected nodes. + If no plugins or modules are installed, this array is empty. + type: array + items: + $ref: '#/components/schemas/_common:PluginStats' + process: + $ref: '#/components/schemas/cluster.stats:ClusterProcess' + versions: + description: Array of Opensearch versions used on selected nodes. + type: array + items: + $ref: '#/components/schemas/_common:VersionString' + required: + - count + - discovery_types + - fs + - indexing_pressure + - ingest + - jvm + - network_types + - os + - packaging_types + - plugins + - process + - versions + cluster.stats:ClusterOperatingSystem: + type: object + properties: + allocated_processors: + description: |- + Number of processors used to calculate thread pool size across all selected nodes. + This number can be set with the processors setting of a node and defaults to the number of processors reported by the operating system. + In both cases, this number will never be larger than 32. + type: number + architectures: + description: Contains statistics about processor architectures (for example, x86_64 or aarch64) used by selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:ClusterOperatingSystemArchitecture' + available_processors: + description: Number of processors available to JVM across all selected nodes. + type: number + mem: + $ref: '#/components/schemas/cluster.stats:OperatingSystemMemoryInfo' + names: + description: Contains statistics about operating systems used by selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:ClusterOperatingSystemName' + pretty_names: + description: Contains statistics about operating systems used by selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:ClusterOperatingSystemPrettyName' + required: + - allocated_processors + - available_processors + - mem + - names + - pretty_names + cluster.stats:ClusterOperatingSystemArchitecture: + type: object + properties: + arch: + description: Name of an architecture used by one or more selected nodes. + type: string + count: + description: Number of selected nodes using the architecture. + type: number + required: + - arch + - count + cluster.stats:ClusterOperatingSystemName: + type: object + properties: + count: + description: Number of selected nodes using the operating system. + type: number + name: + $ref: '#/components/schemas/_common:Name' + required: + - count + - name + cluster.stats:ClusterOperatingSystemPrettyName: + type: object + properties: + count: + description: Number of selected nodes using the operating system. + type: number + pretty_name: + $ref: '#/components/schemas/_common:Name' + required: + - count + - pretty_name + cluster.stats:ClusterProcess: + type: object + properties: + cpu: + $ref: '#/components/schemas/cluster.stats:ClusterProcessCpu' + open_file_descriptors: + $ref: '#/components/schemas/cluster.stats:ClusterProcessOpenFileDescriptors' + required: + - cpu + - open_file_descriptors + cluster.stats:ClusterProcessCpu: + type: object + properties: + percent: + description: |- + Percentage of CPU used across all selected nodes. + Returns `-1` if not supported. + type: number + required: + - percent + cluster.stats:ClusterProcessOpenFileDescriptors: + type: object + properties: + avg: + description: |- + Average number of concurrently open file descriptors. + Returns `-1` if not supported. + type: number + max: + description: |- + Maximum number of concurrently open file descriptors allowed across all selected nodes. + Returns `-1` if not supported. + type: number + min: + description: |- + Minimum number of concurrently open file descriptors across all selected nodes. + Returns -1 if not supported. + type: number + required: + - avg + - max + - min + cluster.stats:ClusterProcessor: + type: object + properties: + count: + type: number + current: + type: number + failed: + type: number + time: + $ref: '#/components/schemas/_common:Duration' + time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - count + - current + - failed + - time_in_millis + cluster.stats:ClusterShardMetrics: + type: object + properties: + avg: + description: Mean number of shards in an index, counting only shards assigned to selected nodes. + type: number + max: + description: Maximum number of shards in an index, counting only shards assigned to selected nodes. + type: number + min: + description: Minimum number of shards in an index, counting only shards assigned to selected nodes. + type: number + required: + - avg + - max + - min + cluster.stats:FieldTypes: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + count: + description: The number of occurrences of the field type in selected nodes. + type: number + index_count: + description: The number of indices containing the field type in selected nodes. + type: number + indexed_vector_count: + description: For dense_vector field types, number of indexed vector types in selected nodes. + type: number + indexed_vector_dim_max: + description: For dense_vector field types, the maximum dimension of all indexed vector types in selected nodes. + type: number + indexed_vector_dim_min: + description: For dense_vector field types, the minimum dimension of all indexed vector types in selected nodes. + type: number + script_count: + description: The number of fields that declare a script. + type: number + required: + - name + - count + - index_count + cluster.stats:FieldTypesMappings: + type: object + properties: + field_types: + description: Contains statistics about field data types used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:FieldTypes' + runtime_field_types: + description: Contains statistics about runtime field data types used in selected nodes. + type: array + items: + $ref: '#/components/schemas/cluster.stats:RuntimeFieldTypes' + total_field_count: + description: Total number of fields in all non-system indices. + type: number + total_deduplicated_field_count: + description: Total number of fields in all non-system indices, accounting for mapping deduplication. + type: number + total_deduplicated_mapping_size: + $ref: '#/components/schemas/_common:ByteSize' + total_deduplicated_mapping_size_in_bytes: + description: Total size of all mappings, in bytes, after deduplication and compression. + type: number + required: + - field_types + cluster.stats:IndexingPressure: + type: object + properties: + memory: + $ref: '#/components/schemas/cluster.stats:IndexingPressureMemory' + required: + - memory + cluster.stats:IndexingPressureMemory: + type: object + properties: + current: + $ref: '#/components/schemas/cluster.stats:IndexingPressureMemorySummary' + limit_in_bytes: + type: number + total: + $ref: '#/components/schemas/cluster.stats:IndexingPressureMemorySummary' + required: + - current + - limit_in_bytes + - total + cluster.stats:IndexingPressureMemorySummary: + type: object + properties: + all_in_bytes: + type: number + combined_coordinating_and_primary_in_bytes: + type: number + coordinating_in_bytes: + type: number + coordinating_rejections: + type: number + primary_in_bytes: + type: number + primary_rejections: + type: number + replica_in_bytes: + type: number + replica_rejections: + type: number + required: + - all_in_bytes + - combined_coordinating_and_primary_in_bytes + - coordinating_in_bytes + - primary_in_bytes + - replica_in_bytes + cluster.stats:IndicesVersions: + type: object + properties: + index_count: + type: number + primary_shard_count: + type: number + total_primary_bytes: + type: number + version: + $ref: '#/components/schemas/_common:VersionString' + required: + - index_count + - primary_shard_count + - total_primary_bytes + - version + cluster.stats:NodePackagingType: + type: object + properties: + count: + description: Number of selected nodes using the distribution flavor and file type. + type: number + flavor: + description: Type of Opensearch distribution. This is always `default`. + type: string + type: + description: File type (such as `tar` or `zip`) used for the distribution package. + type: string + required: + - count + - flavor + - type + cluster.stats:OperatingSystemMemoryInfo: + type: object + properties: + adjusted_total_in_bytes: + description: Total amount, in bytes, of memory across all selected nodes, but using the value specified using the `es.total_memory_bytes` system property instead of measured total memory for those nodes where that system property was set. + type: number + free_in_bytes: + description: Amount, in bytes, of free physical memory across all selected nodes. + type: number + free_percent: + description: Percentage of free physical memory across all selected nodes. + type: number + total_in_bytes: + description: Total amount, in bytes, of physical memory across all selected nodes. + type: number + used_in_bytes: + description: Amount, in bytes, of physical memory in use across all selected nodes. + type: number + used_percent: + description: Percentage of physical memory in use across all selected nodes. + type: number + required: + - free_in_bytes + - free_percent + - total_in_bytes + - used_in_bytes + - used_percent + cluster.stats:RuntimeFieldTypes: + type: object + properties: + chars_max: + description: Maximum number of characters for a single runtime field script. + type: number + chars_total: + description: Total number of characters for the scripts that define the current runtime field data type. + type: number + count: + description: Number of runtime fields mapped to the field data type in selected nodes. + type: number + doc_max: + description: Maximum number of accesses to doc_values for a single runtime field script + type: number + doc_total: + description: Total number of accesses to doc_values for the scripts that define the current runtime field data type. + type: number + index_count: + description: Number of indices containing a mapping of the runtime field data type in selected nodes. + type: number + lang: + description: Script languages used for the runtime fields scripts. + type: array + items: + type: string + lines_max: + description: Maximum number of lines for a single runtime field script. + type: number + lines_total: + description: Total number of lines for the scripts that define the current runtime field data type. + type: number + name: + $ref: '#/components/schemas/_common:Name' + scriptless_count: + description: Number of runtime fields that don’t declare a script. + type: number + shadowed_count: + description: Number of runtime fields that shadow an indexed field. + type: number + source_max: + description: Maximum number of accesses to _source for a single runtime field script. + type: number + source_total: + description: Total number of accesses to _source for the scripts that define the current runtime field data type. + type: number + required: + - chars_max + - chars_total + - count + - doc_max + - doc_total + - index_count + - lang + - lines_max + - lines_total + - name + - scriptless_count + - shadowed_count + - source_max + - source_total + cluster.stats:StatsResponseBase: + allOf: + - $ref: '#/components/schemas/nodes._common:NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common:Name' + cluster_uuid: + $ref: '#/components/schemas/_common:Uuid' + indices: + $ref: '#/components/schemas/cluster.stats:ClusterIndices' + nodes: + $ref: '#/components/schemas/cluster.stats:ClusterNodes' + status: + $ref: '#/components/schemas/_common:HealthStatus' + timestamp: + description: Unix timestamp, in milliseconds, for the last time the cluster statistics were refreshed. + type: number + required: + - cluster_name + - cluster_uuid + - indices + - nodes + - status + - timestamp + dangling_indices.list_dangling_indices:DanglingIndex: + type: object + properties: + index_name: + type: string + index_uuid: + type: string + creation_date_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + node_ids: + $ref: '#/components/schemas/_common:Ids' + required: + - index_name + - index_uuid + - creation_date_millis + - node_ids + indices._common:Alias: + type: object + properties: + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + index_routing: + $ref: '#/components/schemas/_common:Routing' + is_hidden: + description: |- + If `true`, the alias is hidden. + All indices for the alias must have the same `is_hidden` value. + type: boolean + is_write_index: + description: If `true`, the index is the write index for the alias. + type: boolean + routing: + $ref: '#/components/schemas/_common:Routing' + search_routing: + $ref: '#/components/schemas/_common:Routing' + indices._common:AliasDefinition: + type: object + properties: + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + index_routing: + description: |- + Value used to route indexing operations to a specific shard. + If specified, this overwrites the `routing` value for indexing operations. + type: string + is_write_index: + description: If `true`, the index is the write index for the alias. + type: boolean + routing: + description: Value used to route indexing and search operations to a specific shard. + type: string + search_routing: + description: |- + Value used to route search operations to a specific shard. + If specified, this overwrites the `routing` value for search operations. + type: string + is_hidden: + description: |- + If `true`, the alias is hidden. + All indices for the alias must have the same `is_hidden` value. + type: boolean + indices._common:CacheQueries: + type: object + properties: + enabled: + type: boolean + required: + - enabled + indices._common:DataStream: + type: object + properties: + _meta: + $ref: '#/components/schemas/_common:Metadata' + allow_custom_routing: + description: If `true`, the data stream allows custom routing on write request. + type: boolean + generation: + description: Current generation for the data stream. This number acts as a cumulative count of the stream’s rollovers, starting at 1. + type: number + hidden: + description: If `true`, the data stream is hidden. + type: boolean + ilm_policy: + $ref: '#/components/schemas/_common:Name' + next_generation_managed_by: + $ref: '#/components/schemas/indices._common:ManagedBy' + prefer_ilm: + description: Indicates if ILM should take precedence over DSL in case both are configured to managed this data stream. + type: boolean + indices: + description: |- + Array of objects containing information about the data stream’s backing indices. + The last item in this array contains information about the stream’s current write index. + type: array + items: + $ref: '#/components/schemas/indices._common:DataStreamIndex' + lifecycle: + $ref: '#/components/schemas/indices._common:DataStreamLifecycleWithRollover' + name: + $ref: '#/components/schemas/_common:DataStreamName' + replicated: + description: If `true`, the data stream is created and managed by cross-cluster replication and the local cluster can not write into this data stream or change its mappings. + type: boolean + status: + $ref: '#/components/schemas/_common:HealthStatus' + system: + description: If `true`, the data stream is created and managed by an Opensearch stack component and cannot be modified through normal user interaction. + type: boolean + template: + $ref: '#/components/schemas/_common:Name' + timestamp_field: + $ref: '#/components/schemas/indices._common:DataStreamTimestampField' + required: + - generation + - hidden + - next_generation_managed_by + - prefer_ilm + - indices + - name + - status + - template + - timestamp_field + indices._common:DataStreamIndex: + type: object + properties: + index_name: + $ref: '#/components/schemas/_common:IndexName' + index_uuid: + $ref: '#/components/schemas/_common:Uuid' + ilm_policy: + $ref: '#/components/schemas/_common:Name' + managed_by: + $ref: '#/components/schemas/indices._common:ManagedBy' + prefer_ilm: + description: Indicates if ILM should take precedence over DSL in case both are configured to manage this index. + type: boolean + required: + - index_name + - index_uuid + - managed_by + - prefer_ilm + indices._common:DataStreamLifecycle: + type: object + properties: + data_retention: + $ref: '#/components/schemas/_common:Duration' + downsampling: + $ref: '#/components/schemas/indices._common:DataStreamLifecycleDownsampling' + indices._common:DataStreamLifecycleDownsampling: + type: object + properties: + rounds: + description: The list of downsampling rounds to execute as part of this downsampling configuration + type: array + items: + $ref: '#/components/schemas/indices._common:DownsamplingRound' + required: + - rounds + indices._common:DataStreamLifecycleRolloverConditions: + type: object + properties: + min_age: + $ref: '#/components/schemas/_common:Duration' + max_age: + type: string + min_docs: + type: number + max_docs: + type: number + min_size: + $ref: '#/components/schemas/_common:ByteSize' + max_size: + $ref: '#/components/schemas/_common:ByteSize' + min_primary_shard_size: + $ref: '#/components/schemas/_common:ByteSize' + max_primary_shard_size: + $ref: '#/components/schemas/_common:ByteSize' + min_primary_shard_docs: + type: number + max_primary_shard_docs: + type: number + indices._common:DataStreamLifecycleWithRollover: + type: object + properties: + data_retention: + $ref: '#/components/schemas/_common:Duration' + downsampling: + $ref: '#/components/schemas/indices._common:DataStreamLifecycleDownsampling' + rollover: + $ref: '#/components/schemas/indices._common:DataStreamLifecycleRolloverConditions' + indices._common:DataStreamTimestampField: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Field' + required: + - name + indices._common:DataStreamVisibility: + type: object + properties: + hidden: + type: boolean + indices._common:DownsampleConfig: + type: object + properties: + fixed_interval: + $ref: '#/components/schemas/_common:DurationLarge' + required: + - fixed_interval + indices._common:DownsamplingRound: + type: object + properties: + after: + $ref: '#/components/schemas/_common:Duration' + config: + $ref: '#/components/schemas/indices._common:DownsampleConfig' + required: + - after + - config + indices._common:FielddataFrequencyFilter: + type: object + properties: + max: + type: number + min: + type: number + min_segment_size: + type: number + required: + - max + - min + - min_segment_size + indices._common:IndexCheckOnStartup: + type: string + enum: + - 'true' + - 'false' + - checksum + indices._common:IndexRouting: + type: object + properties: + allocation: + $ref: '#/components/schemas/indices._common:IndexRoutingAllocation' + rebalance: + $ref: '#/components/schemas/indices._common:IndexRoutingRebalance' + indices._common:IndexRoutingAllocation: + type: object + properties: + enable: + $ref: '#/components/schemas/indices._common:IndexRoutingAllocationOptions' + include: + $ref: '#/components/schemas/indices._common:IndexRoutingAllocationInclude' + initial_recovery: + $ref: '#/components/schemas/indices._common:IndexRoutingAllocationInitialRecovery' + disk: + $ref: '#/components/schemas/indices._common:IndexRoutingAllocationDisk' + indices._common:IndexRoutingAllocationDisk: + type: object + properties: + threshold_enabled: + oneOf: + - type: boolean + - type: string + indices._common:IndexRoutingAllocationInclude: + type: object + properties: + _tier_preference: + type: string + _id: + $ref: '#/components/schemas/_common:Id' + indices._common:IndexRoutingAllocationInitialRecovery: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + indices._common:IndexRoutingAllocationOptions: + type: string + enum: + - all + - primaries + - new_primaries + - none + indices._common:IndexRoutingRebalance: + type: object + properties: + enable: + $ref: '#/components/schemas/indices._common:IndexRoutingRebalanceOptions' + required: + - enable + indices._common:IndexRoutingRebalanceOptions: + type: string + enum: + - all + - primaries + - replicas + - none + indices._common:IndexSegmentSort: + type: object + properties: + field: + $ref: '#/components/schemas/_common:Fields' + order: + oneOf: + - $ref: '#/components/schemas/indices._common:SegmentSortOrder' + - type: array + items: + $ref: '#/components/schemas/indices._common:SegmentSortOrder' + mode: + oneOf: + - $ref: '#/components/schemas/indices._common:SegmentSortMode' + - type: array + items: + $ref: '#/components/schemas/indices._common:SegmentSortMode' + missing: + oneOf: + - $ref: '#/components/schemas/indices._common:SegmentSortMissing' + - type: array + items: + $ref: '#/components/schemas/indices._common:SegmentSortMissing' + indices._common:IndexSettingBlocks: + type: object + properties: + read_only: + $ref: '#/components/schemas/_common:Stringifiedboolean' + read_only_allow_delete: + $ref: '#/components/schemas/_common:Stringifiedboolean' + read: + $ref: '#/components/schemas/_common:Stringifiedboolean' + write: + $ref: '#/components/schemas/_common:Stringifiedboolean' + metadata: + $ref: '#/components/schemas/_common:Stringifiedboolean' + indices._common:IndexSettings: + type: object + properties: + index: + $ref: '#/components/schemas/indices._common:IndexSettings' + mode: + type: string + routing_path: + oneOf: + - type: string + - type: array + items: + type: string + soft_deletes: + $ref: '#/components/schemas/indices._common:SoftDeletes' + sort: + $ref: '#/components/schemas/indices._common:IndexSegmentSort' + number_of_shards: + oneOf: + - type: number + - type: string + number_of_replicas: + oneOf: + - type: number + - type: string + number_of_routing_shards: + type: number + check_on_startup: + $ref: '#/components/schemas/indices._common:IndexCheckOnStartup' + codec: + type: string + routing_partition_size: + $ref: '#/components/schemas/_common:Stringifiedinteger' + load_fixed_bitset_filters_eagerly: + type: boolean + hidden: + oneOf: + - type: boolean + - type: string + auto_expand_replicas: + type: string + merge: + $ref: '#/components/schemas/indices._common:Merge' + search: + $ref: '#/components/schemas/indices._common:SettingsSearch' + refresh_interval: + $ref: '#/components/schemas/_common:Duration' + max_result_window: + type: number + max_inner_result_window: + type: number + max_rescore_window: + type: number + max_docvalue_fields_search: + type: number + max_script_fields: + type: number + max_ngram_diff: + type: number + max_shingle_diff: + type: number + blocks: + $ref: '#/components/schemas/indices._common:IndexSettingBlocks' + max_refresh_listeners: + type: number + analyze: + $ref: '#/components/schemas/indices._common:SettingsAnalyze' + highlight: + $ref: '#/components/schemas/indices._common:SettingsHighlight' + max_terms_count: + type: number + max_regex_length: + type: number + routing: + $ref: '#/components/schemas/indices._common:IndexRouting' + gc_deletes: + $ref: '#/components/schemas/_common:Duration' + default_pipeline: + $ref: '#/components/schemas/_common:PipelineName' + final_pipeline: + $ref: '#/components/schemas/_common:PipelineName' + lifecycle: + $ref: '#/components/schemas/indices._common:IndexSettingsLifecycle' + provided_name: + $ref: '#/components/schemas/_common:Name' + creation_date: + $ref: '#/components/schemas/_common:StringifiedEpochTimeUnitMillis' + creation_date_string: + $ref: '#/components/schemas/_common:DateTime' + uuid: + $ref: '#/components/schemas/_common:Uuid' + version: + $ref: '#/components/schemas/indices._common:IndexVersioning' + verified_before_close: + oneOf: + - type: boolean + - type: string + format: + oneOf: + - type: string + - type: number + max_slices_per_scroll: + type: number + translog: + $ref: '#/components/schemas/indices._common:Translog' + query_string: + $ref: '#/components/schemas/indices._common:SettingsQueryString' + priority: + oneOf: + - type: number + - type: string + top_metrics_max_size: + type: number + analysis: + $ref: '#/components/schemas/indices._common:IndexSettingsAnalysis' + settings: + $ref: '#/components/schemas/indices._common:IndexSettings' + time_series: + $ref: '#/components/schemas/indices._common:IndexSettingsTimeSeries' + queries: + $ref: '#/components/schemas/indices._common:Queries' + similarity: + $ref: '#/components/schemas/indices._common:SettingsSimilarity' + mapping: + $ref: '#/components/schemas/indices._common:MappingLimitSettings' + indexing.slowlog: + $ref: '#/components/schemas/indices._common:IndexingSlowlogSettings' + indexing_pressure: + $ref: '#/components/schemas/indices._common:IndexingPressure' + store: + $ref: '#/components/schemas/indices._common:Storage' + description: The index settings to be updated + indices._common:IndexSettingsAnalysis: + type: object + properties: + analyzer: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.analysis:Analyzer' + char_filter: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.analysis:CharFilter' + filter: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.analysis:TokenFilter' + normalizer: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.analysis:Normalizer' + tokenizer: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.analysis:Tokenizer' + indices._common:IndexSettingsLifecycle: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + indexing_complete: + $ref: '#/components/schemas/_common:Stringifiedboolean' + origination_date: + description: |- + If specified, this is the timestamp used to calculate the index age for its phase transitions. Use this setting + if you create a new index that contains old data and want to use the original creation date to calculate the index + age. Specified as a Unix epoch value in milliseconds. + type: number + parse_origination_date: + description: |- + Set to true to parse the origination date from the index name. This origination date is used to calculate the index age + for its phase transitions. The index name must match the pattern ^.*-{date_format}-\\d+, where the date_format is + yyyy.MM.dd and the trailing digits are optional. An index that was rolled over would normally match the full format, + for example logs-2016.10.31-000002). If the index name doesn’t match the pattern, index creation fails. + type: boolean + step: + $ref: '#/components/schemas/indices._common:IndexSettingsLifecycleStep' + rollover_alias: + description: |- + The index alias to update when the index rolls over. Specify when using a policy that contains a rollover action. + When the index rolls over, the alias is updated to reflect that the index is no longer the write index. For more + information about rolling indices, see Rollover. + type: string + required: + - name + indices._common:IndexSettingsLifecycleStep: + type: object + properties: + wait_time_threshold: + $ref: '#/components/schemas/_common:Duration' + indices._common:IndexSettingsTimeSeries: + type: object + properties: + end_time: + $ref: '#/components/schemas/_common:DateTime' + start_time: + $ref: '#/components/schemas/_common:DateTime' + indices._common:IndexState: + type: object + properties: + aliases: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + settings: + $ref: '#/components/schemas/indices._common:IndexSettings' + defaults: + $ref: '#/components/schemas/indices._common:IndexSettings' + data_stream: + $ref: '#/components/schemas/_common:DataStreamName' + lifecycle: + $ref: '#/components/schemas/indices._common:DataStreamLifecycle' + indices._common:IndexTemplate: + type: object + properties: + index_patterns: + $ref: '#/components/schemas/_common:Names' + composed_of: + description: |- + An ordered list of component template names. + Component templates are merged in the order specified, meaning that the last component template specified has the highest precedence. + type: array + items: + $ref: '#/components/schemas/_common:Name' + template: + $ref: '#/components/schemas/indices._common:IndexTemplateSummary' + version: + $ref: '#/components/schemas/_common:VersionNumber' + priority: + description: |- + Priority to determine index template precedence when a new data stream or index is created. + The index template with the highest priority is chosen. + If no priority is specified the template is treated as though it is of priority 0 (lowest priority). + This number is not automatically generated by Opensearch. + type: number + _meta: + $ref: '#/components/schemas/_common:Metadata' + allow_auto_create: + type: boolean + data_stream: + $ref: '#/components/schemas/indices._common:IndexTemplateDataStreamConfiguration' + required: + - index_patterns + - composed_of + description: New index template definition to be simulated, if no index template name is specified + indices._common:IndexTemplateDataStreamConfiguration: + type: object + properties: + hidden: + description: If true, the data stream is hidden. + type: boolean + allow_custom_routing: + description: If true, the data stream supports custom routing. + type: boolean + indices._common:IndexTemplateSummary: + type: object + properties: + aliases: + description: |- + Aliases to add. + If the index template includes a `data_stream` object, these are data stream aliases. + Otherwise, these are index aliases. + Data stream aliases ignore the `index_routing`, `routing`, and `search_routing` options. + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + settings: + $ref: '#/components/schemas/indices._common:IndexSettings' + lifecycle: + $ref: '#/components/schemas/indices._common:DataStreamLifecycleWithRollover' + indices._common:IndexVersioning: + type: object + properties: + created: + $ref: '#/components/schemas/_common:VersionString' + created_string: + type: string + indices._common:IndexingPressure: + type: object + properties: + memory: + $ref: '#/components/schemas/indices._common:IndexingPressureMemory' + required: + - memory + indices._common:IndexingPressureMemory: + type: object + properties: + limit: + description: |- + Number of outstanding bytes that may be consumed by indexing requests. When this limit is reached or exceeded, + the node will reject new coordinating and primary operations. When replica operations consume 1.5x this limit, + the node will reject new replica operations. Defaults to 10% of the heap. + type: number + indices._common:IndexingSlowlogSettings: + type: object + properties: + level: + type: string + source: + type: number + reformat: + type: boolean + threshold: + $ref: '#/components/schemas/indices._common:IndexingSlowlogTresholds' + indices._common:IndexingSlowlogTresholds: + type: object + properties: + index: + $ref: '#/components/schemas/indices._common:SlowlogTresholdLevels' + indices._common:ManagedBy: + type: string + enum: + - Index Lifecycle Management + - Data stream lifecycle + - Unmanaged + indices._common:MappingLimitSettings: + type: object + properties: + coerce: + type: boolean + total_fields: + $ref: '#/components/schemas/indices._common:MappingLimitSettingsTotalFields' + depth: + $ref: '#/components/schemas/indices._common:MappingLimitSettingsDepth' + nested_fields: + $ref: '#/components/schemas/indices._common:MappingLimitSettingsNestedFields' + nested_objects: + $ref: '#/components/schemas/indices._common:MappingLimitSettingsNestedObjects' + field_name_length: + $ref: '#/components/schemas/indices._common:MappingLimitSettingsFieldNameLength' + dimension_fields: + $ref: '#/components/schemas/indices._common:MappingLimitSettingsDimensionFields' + ignore_malformed: + type: boolean + indices._common:MappingLimitSettingsDepth: + type: object + properties: + limit: + description: |- + The maximum depth for a field, which is measured as the number of inner objects. For instance, if all fields are defined + at the root object level, then the depth is 1. If there is one object mapping, then the depth is 2, etc. + type: number + indices._common:MappingLimitSettingsDimensionFields: + type: object + properties: + limit: + description: |- + [preview] This functionality is in technical preview and may be changed or removed in a future release. + Opensearch will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. + type: number + indices._common:MappingLimitSettingsFieldNameLength: + type: object + properties: + limit: + description: |- + Setting for the maximum length of a field name. This setting isn’t really something that addresses mappings explosion but + might still be useful if you want to limit the field length. It usually shouldn’t be necessary to set this setting. The + default is okay unless a user starts to add a huge number of fields with really long names. Default is `Long.MAX_VALUE` (no limit). + type: number + indices._common:MappingLimitSettingsNestedFields: + type: object + properties: + limit: + description: |- + The maximum number of distinct nested mappings in an index. The nested type should only be used in special cases, when + arrays of objects need to be queried independently of each other. To safeguard against poorly designed mappings, this + setting limits the number of unique nested types per index. + type: number + indices._common:MappingLimitSettingsNestedObjects: + type: object + properties: + limit: + description: |- + The maximum number of nested JSON objects that a single document can contain across all nested types. This limit helps + to prevent out of memory errors when a document contains too many nested objects. + type: number + indices._common:MappingLimitSettingsTotalFields: + type: object + properties: + limit: + description: |- + The maximum number of fields in an index. Field and object mappings, as well as field aliases count towards this limit. + The limit is in place to prevent mappings and searches from becoming too large. Higher values can lead to performance + degradations and memory issues, especially in clusters with a high load or few resources. + type: number + indices._common:Merge: + type: object + properties: + scheduler: + $ref: '#/components/schemas/indices._common:MergeScheduler' + indices._common:MergeScheduler: + type: object + properties: + max_thread_count: + $ref: '#/components/schemas/_common:Stringifiedinteger' + max_merge_count: + $ref: '#/components/schemas/_common:Stringifiedinteger' + indices._common:NumericFielddata: + type: object + properties: + format: + $ref: '#/components/schemas/indices._common:NumericFielddataFormat' + required: + - format + indices._common:NumericFielddataFormat: + type: string + enum: + - array + - disabled + indices._common:Queries: + type: object + properties: + cache: + $ref: '#/components/schemas/indices._common:CacheQueries' + indices._common:RetentionLease: + type: object + properties: + period: + $ref: '#/components/schemas/_common:Duration' + required: + - period + indices._common:SearchIdle: + type: object + properties: + after: + $ref: '#/components/schemas/_common:Duration' + indices._common:SegmentSortMissing: + type: string + enum: + - _last + - _first + indices._common:SegmentSortMode: + type: string + enum: + - min + - max + indices._common:SegmentSortOrder: + type: string + enum: + - asc + - desc + indices._common:SettingsAnalyze: + type: object + properties: + max_token_count: + $ref: '#/components/schemas/_common:Stringifiedinteger' + indices._common:SettingsHighlight: + type: object + properties: + max_analyzed_offset: + type: number + indices._common:SettingsQueryString: + type: object + properties: + lenient: + $ref: '#/components/schemas/_common:Stringifiedboolean' + required: + - lenient + indices._common:SettingsSearch: + type: object + properties: + idle: + $ref: '#/components/schemas/indices._common:SearchIdle' + slowlog: + $ref: '#/components/schemas/indices._common:SlowlogSettings' + indices._common:SettingsSimilarity: + type: object + properties: + bm25: + $ref: '#/components/schemas/indices._common:SettingsSimilarityBm25' + dfi: + $ref: '#/components/schemas/indices._common:SettingsSimilarityDfi' + dfr: + $ref: '#/components/schemas/indices._common:SettingsSimilarityDfr' + ib: + $ref: '#/components/schemas/indices._common:SettingsSimilarityIb' + lmd: + $ref: '#/components/schemas/indices._common:SettingsSimilarityLmd' + lmj: + $ref: '#/components/schemas/indices._common:SettingsSimilarityLmj' + scripted_tfidf: + $ref: '#/components/schemas/indices._common:SettingsSimilarityScriptedTfidf' + indices._common:SettingsSimilarityBm25: + type: object + properties: + b: + type: number + discount_overlaps: + type: boolean + k1: + type: number + type: + type: string + enum: + - BM25 + required: + - b + - discount_overlaps + - k1 + - type + indices._common:SettingsSimilarityDfi: + type: object + properties: + independence_measure: + $ref: '#/components/schemas/_common:DFIIndependenceMeasure' + type: + type: string + enum: + - DFI + required: + - independence_measure + - type + indices._common:SettingsSimilarityDfr: + type: object + properties: + after_effect: + $ref: '#/components/schemas/_common:DFRAfterEffect' + basic_model: + $ref: '#/components/schemas/_common:DFRBasicModel' + normalization: + $ref: '#/components/schemas/_common:Normalization' + type: + type: string + enum: + - DFR + required: + - after_effect + - basic_model + - normalization + - type + indices._common:SettingsSimilarityIb: + type: object + properties: + distribution: + $ref: '#/components/schemas/_common:IBDistribution' + lambda: + $ref: '#/components/schemas/_common:IBLambda' + normalization: + $ref: '#/components/schemas/_common:Normalization' + type: + type: string + enum: + - IB + required: + - distribution + - lambda + - normalization + - type + indices._common:SettingsSimilarityLmd: + type: object + properties: + mu: + type: number + type: + type: string + enum: + - LMDirichlet + required: + - mu + - type + indices._common:SettingsSimilarityLmj: + type: object + properties: + lambda: + type: number + type: + type: string + enum: + - LMJelinekMercer + required: + - lambda + - type + indices._common:SettingsSimilarityScriptedTfidf: + type: object + properties: + script: + $ref: '#/components/schemas/_common:Script' + type: + type: string + enum: + - scripted + required: + - script + - type + indices._common:SlowlogSettings: + type: object + properties: + level: + type: string + source: + type: number + reformat: + type: boolean + threshold: + $ref: '#/components/schemas/indices._common:SlowlogTresholds' + indices._common:SlowlogTresholdLevels: + type: object + properties: + warn: + $ref: '#/components/schemas/_common:Duration' + info: + $ref: '#/components/schemas/_common:Duration' + debug: + $ref: '#/components/schemas/_common:Duration' + trace: + $ref: '#/components/schemas/_common:Duration' + indices._common:SlowlogTresholds: + type: object + properties: + query: + $ref: '#/components/schemas/indices._common:SlowlogTresholdLevels' + fetch: + $ref: '#/components/schemas/indices._common:SlowlogTresholdLevels' + indices._common:SoftDeletes: + type: object + properties: + enabled: + description: Indicates whether soft deletes are enabled on the index. + type: boolean + retention_lease: + $ref: '#/components/schemas/indices._common:RetentionLease' + indices._common:Storage: + type: object + properties: + type: + $ref: '#/components/schemas/indices._common:StorageType' + allow_mmap: + description: |- + You can restrict the use of the mmapfs and the related hybridfs store type via the setting node.store.allow_mmap. + This is a boolean setting indicating whether or not memory-mapping is allowed. The default is to allow it. This + setting is useful, for example, if you are in an environment where you can not control the ability to create a lot + of memory maps so you need disable the ability to use memory-mapping. + type: boolean + required: + - type + indices._common:StorageType: + type: string + enum: + - fs + - niofs + - mmapfs + - hybridfs + indices._common:TemplateMapping: + type: object + properties: + aliases: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + index_patterns: + type: array + items: + $ref: '#/components/schemas/_common:Name' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + order: + type: number + settings: + type: object + additionalProperties: + type: object + version: + $ref: '#/components/schemas/_common:VersionNumber' + required: + - aliases + - index_patterns + - mappings + - order + - settings + indices._common:Translog: + type: object + properties: + sync_interval: + $ref: '#/components/schemas/_common:Duration' + durability: + $ref: '#/components/schemas/indices._common:TranslogDurability' + flush_threshold_size: + $ref: '#/components/schemas/_common:ByteSize' + retention: + $ref: '#/components/schemas/indices._common:TranslogRetention' + indices._common:TranslogDurability: + type: string + enum: + - request + - async + indices._common:TranslogRetention: + type: object + properties: + size: + $ref: '#/components/schemas/_common:ByteSize' + age: + $ref: '#/components/schemas/_common:Duration' + indices.add_block:IndicesBlockOptions: + type: string + enum: + - metadata + - read + - read_only + - write + indices.add_block:IndicesBlockStatus: + type: object + properties: + name: + $ref: '#/components/schemas/_common:IndexName' + blocked: + type: boolean + required: + - name + - blocked + indices.analyze:AnalyzeDetail: + type: object + properties: + analyzer: + $ref: '#/components/schemas/indices.analyze:AnalyzerDetail' + charfilters: + type: array + items: + $ref: '#/components/schemas/indices.analyze:CharFilterDetail' + custom_analyzer: + type: boolean + tokenfilters: + type: array + items: + $ref: '#/components/schemas/indices.analyze:TokenDetail' + tokenizer: + $ref: '#/components/schemas/indices.analyze:TokenDetail' + required: + - custom_analyzer + indices.analyze:AnalyzeToken: + type: object + properties: + end_offset: + type: number + position: + type: number + positionLength: + type: number + start_offset: + type: number + token: + type: string + type: + type: string + required: + - end_offset + - position + - start_offset + - token + - type + indices.analyze:AnalyzerDetail: + type: object + properties: + name: + type: string + tokens: + type: array + items: + $ref: '#/components/schemas/indices.analyze:ExplainAnalyzeToken' + required: + - name + - tokens + indices.analyze:CharFilterDetail: + type: object + properties: + filtered_text: + type: array + items: + type: string + name: + type: string + required: + - filtered_text + - name + indices.analyze:ExplainAnalyzeToken: + type: object + properties: + bytes: + type: string + end_offset: + type: number + keyword: + type: boolean + position: + type: number + positionLength: + type: number + start_offset: + type: number + termFrequency: + type: number + token: + type: string + type: + type: string + required: + - bytes + - end_offset + - position + - positionLength + - start_offset + - termFrequency + - token + - type + indices.analyze:TextToAnalyze: + oneOf: + - type: string + - type: array + items: + type: string + indices.analyze:TokenDetail: + type: object + properties: + name: + type: string + tokens: + type: array + items: + $ref: '#/components/schemas/indices.analyze:ExplainAnalyzeToken' + required: + - name + - tokens + indices.close:CloseIndexResult: + type: object + properties: + closed: + type: boolean + shards: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.close:CloseShardResult' + required: + - closed + indices.close:CloseShardResult: + type: object + properties: + failures: + type: array + items: + $ref: '#/components/schemas/_common:ShardFailure' + required: + - failures + indices.data_streams_stats:DataStreamsStatsItem: + type: object + properties: + backing_indices: + description: Current number of backing indices for the data stream. + type: number + data_stream: + $ref: '#/components/schemas/_common:Name' + maximum_timestamp: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + store_size: + $ref: '#/components/schemas/_common:ByteSize' + store_size_bytes: + description: Total size, in bytes, of all shards for the data stream’s backing indices. + type: number + required: + - backing_indices + - data_stream + - maximum_timestamp + - store_size_bytes + indices.forcemerge._types:ForceMergeResponseBody: + allOf: + - $ref: '#/components/schemas/_common:ShardsOperationResponseBase' + - type: object + properties: + task: + description: |- + task contains a task id returned when wait_for_completion=false, + you can use the task_id to get the status of the task at _tasks/ + type: string + indices.get_alias:IndexAliases: + type: object + properties: + aliases: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:AliasDefinition' + required: + - aliases + indices.get_field_mapping:TypeFieldMappings: + type: object + properties: + mappings: + type: object + additionalProperties: + $ref: '#/components/schemas/_common.mapping:FieldMapping' + required: + - mappings + indices.get_index_template:IndexTemplateItem: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + index_template: + $ref: '#/components/schemas/indices._common:IndexTemplate' + required: + - name + - index_template + indices.get_mapping:IndexMappingRecord: + type: object + properties: + item: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + required: + - mappings + indices.put_index_template:IndexTemplateMapping: + type: object + properties: + aliases: + description: |- + Aliases to add. + If the index template includes a `data_stream` object, these are data stream aliases. + Otherwise, these are index aliases. + Data stream aliases ignore the `index_routing`, `routing`, and `search_routing` options. + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + settings: + $ref: '#/components/schemas/indices._common:IndexSettings' + lifecycle: + $ref: '#/components/schemas/indices._common:DataStreamLifecycle' + indices.recovery:FileDetails: + type: object + properties: + length: + type: number + name: + type: string + recovered: + type: number + required: + - length + - name + - recovered + indices.recovery:RecoveryBytes: + type: object + properties: + percent: + $ref: '#/components/schemas/_common:Percentage' + recovered: + $ref: '#/components/schemas/_common:ByteSize' + recovered_in_bytes: + $ref: '#/components/schemas/_common:ByteSize' + recovered_from_snapshot: + $ref: '#/components/schemas/_common:ByteSize' + recovered_from_snapshot_in_bytes: + $ref: '#/components/schemas/_common:ByteSize' + reused: + $ref: '#/components/schemas/_common:ByteSize' + reused_in_bytes: + $ref: '#/components/schemas/_common:ByteSize' + total: + $ref: '#/components/schemas/_common:ByteSize' + total_in_bytes: + $ref: '#/components/schemas/_common:ByteSize' + required: + - percent + - recovered_in_bytes + - reused_in_bytes + - total_in_bytes + indices.recovery:RecoveryFiles: + type: object + properties: + details: + type: array + items: + $ref: '#/components/schemas/indices.recovery:FileDetails' + percent: + $ref: '#/components/schemas/_common:Percentage' + recovered: + type: number + reused: + type: number + total: + type: number + required: + - percent + - recovered + - reused + - total + indices.recovery:RecoveryIndexStatus: + type: object + properties: + bytes: + $ref: '#/components/schemas/indices.recovery:RecoveryBytes' + files: + $ref: '#/components/schemas/indices.recovery:RecoveryFiles' + size: + $ref: '#/components/schemas/indices.recovery:RecoveryBytes' + source_throttle_time: + $ref: '#/components/schemas/_common:Duration' + source_throttle_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + target_throttle_time: + $ref: '#/components/schemas/_common:Duration' + target_throttle_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - files + - size + - source_throttle_time_in_millis + - target_throttle_time_in_millis + - total_time_in_millis + indices.recovery:RecoveryOrigin: + type: object + properties: + hostname: + type: string + host: + $ref: '#/components/schemas/_common:Host' + transport_address: + $ref: '#/components/schemas/_common:TransportAddress' + id: + $ref: '#/components/schemas/_common:Id' + ip: + $ref: '#/components/schemas/_common:Ip' + name: + $ref: '#/components/schemas/_common:Name' + bootstrap_new_history_uuid: + type: boolean + repository: + $ref: '#/components/schemas/_common:Name' + snapshot: + $ref: '#/components/schemas/_common:Name' + version: + $ref: '#/components/schemas/_common:VersionString' + restoreUUID: + $ref: '#/components/schemas/_common:Uuid' + index: + $ref: '#/components/schemas/_common:IndexName' + indices.recovery:RecoveryStartStatus: + type: object + properties: + check_index_time: + $ref: '#/components/schemas/_common:Duration' + check_index_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - check_index_time_in_millis + - total_time_in_millis + indices.recovery:RecoveryStatus: + type: object + properties: + shards: + type: array + items: + $ref: '#/components/schemas/indices.recovery:ShardRecovery' + required: + - shards + indices.recovery:ShardRecovery: + type: object + properties: + id: + type: number + index: + $ref: '#/components/schemas/indices.recovery:RecoveryIndexStatus' + primary: + type: boolean + source: + $ref: '#/components/schemas/indices.recovery:RecoveryOrigin' + stage: + type: string + start: + $ref: '#/components/schemas/indices.recovery:RecoveryStartStatus' + start_time: + $ref: '#/components/schemas/_common:DateTime' + start_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + stop_time: + $ref: '#/components/schemas/_common:DateTime' + stop_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + target: + $ref: '#/components/schemas/indices.recovery:RecoveryOrigin' + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + translog: + $ref: '#/components/schemas/indices.recovery:TranslogStatus' + type: + type: string + verify_index: + $ref: '#/components/schemas/indices.recovery:VerifyIndex' + required: + - id + - index + - primary + - source + - stage + - start_time_in_millis + - target + - total_time_in_millis + - translog + - type + - verify_index + indices.recovery:TranslogStatus: + type: object + properties: + percent: + $ref: '#/components/schemas/_common:Percentage' + recovered: + type: number + total: + type: number + total_on_start: + type: number + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - percent + - recovered + - total + - total_on_start + - total_time_in_millis + indices.recovery:VerifyIndex: + type: object + properties: + check_index_time: + $ref: '#/components/schemas/_common:Duration' + check_index_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total_time: + $ref: '#/components/schemas/_common:Duration' + total_time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - check_index_time_in_millis + - total_time_in_millis + indices.resolve_index:ResolveIndexAliasItem: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + indices: + $ref: '#/components/schemas/_common:Indices' + required: + - name + - indices + indices.resolve_index:ResolveIndexDataStreamsItem: + type: object + properties: + name: + $ref: '#/components/schemas/_common:DataStreamName' + timestamp_field: + $ref: '#/components/schemas/_common:Field' + backing_indices: + $ref: '#/components/schemas/_common:Indices' + required: + - name + - timestamp_field + - backing_indices + indices.resolve_index:ResolveIndexItem: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + aliases: + type: array + items: + type: string + attributes: + type: array + items: + type: string + data_stream: + $ref: '#/components/schemas/_common:DataStreamName' + required: + - name + - attributes + indices.rollover:RolloverConditions: + type: object + properties: + min_age: + $ref: '#/components/schemas/_common:Duration' + max_age: + $ref: '#/components/schemas/_common:Duration' + max_age_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + min_docs: + type: number + max_docs: + type: number + max_size: + $ref: '#/components/schemas/_common:ByteSize' + max_size_bytes: + type: number + min_size: + $ref: '#/components/schemas/_common:ByteSize' + min_size_bytes: + type: number + max_primary_shard_size: + $ref: '#/components/schemas/_common:ByteSize' + max_primary_shard_size_bytes: + type: number + min_primary_shard_size: + $ref: '#/components/schemas/_common:ByteSize' + min_primary_shard_size_bytes: + type: number + max_primary_shard_docs: + type: number + min_primary_shard_docs: + type: number + indices.segments:IndexSegment: + type: object + properties: + shards: + type: object + additionalProperties: + oneOf: + - $ref: '#/components/schemas/indices.segments:ShardsSegment' + - type: array + items: + $ref: '#/components/schemas/indices.segments:ShardsSegment' + required: + - shards + indices.segments:Segment: + type: object + properties: + attributes: + type: object + additionalProperties: + type: string + committed: + type: boolean + compound: + type: boolean + deleted_docs: + type: number + generation: + type: number + search: + type: boolean + size_in_bytes: + type: number + num_docs: + type: number + version: + $ref: '#/components/schemas/_common:VersionString' + required: + - attributes + - committed + - compound + - deleted_docs + - generation + - search + - size_in_bytes + - num_docs + - version + indices.segments:ShardSegmentRouting: + type: object + properties: + node: + type: string + primary: + type: boolean + state: + type: string + required: + - node + - primary + - state + indices.segments:ShardsSegment: + type: object + properties: + num_committed_segments: + type: number + routing: + $ref: '#/components/schemas/indices.segments:ShardSegmentRouting' + num_search_segments: + type: number + segments: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.segments:Segment' + required: + - num_committed_segments + - routing + - num_search_segments + - segments + indices.shard_stores:IndicesShardStores: + type: object + properties: + shards: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.shard_stores:ShardStoreWrapper' + required: + - shards + indices.shard_stores:ShardStore: + type: object + properties: + allocation: + $ref: '#/components/schemas/indices.shard_stores:ShardStoreAllocation' + allocation_id: + $ref: '#/components/schemas/_common:Id' + store_exception: + $ref: '#/components/schemas/indices.shard_stores:ShardStoreException' + required: + - allocation + indices.shard_stores:ShardStoreAllocation: + type: string + enum: + - primary + - replica + - unused + indices.shard_stores:ShardStoreException: + type: object + properties: + reason: + type: string + type: + type: string + required: + - reason + - type + indices.shard_stores:ShardStoreStatus: + type: string + enum: + - green + - yellow + - red + - all + indices.shard_stores:ShardStoreWrapper: + type: object + properties: + stores: + type: array + items: + $ref: '#/components/schemas/indices.shard_stores:ShardStore' + required: + - stores + indices.simulate_template:Overlapping: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + index_patterns: + type: array + items: + type: string + required: + - name + - index_patterns + indices.simulate_template:Template: + type: object + properties: + aliases: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common:Alias' + mappings: + $ref: '#/components/schemas/_common.mapping:TypeMapping' + settings: + $ref: '#/components/schemas/indices._common:IndexSettings' + required: + - aliases + - mappings + - settings + indices.stats:IndexMetadataState: + type: string + enum: + - open + - close + indices.stats:IndexStats: + type: object + properties: + completion: + $ref: '#/components/schemas/_common:CompletionStats' + docs: + $ref: '#/components/schemas/_common:DocStats' + fielddata: + $ref: '#/components/schemas/_common:FielddataStats' + flush: + $ref: '#/components/schemas/_common:FlushStats' + get: + $ref: '#/components/schemas/_common:GetStats' + indexing: + $ref: '#/components/schemas/_common:IndexingStats' + indices: + $ref: '#/components/schemas/indices.stats:IndicesStats' + merges: + $ref: '#/components/schemas/_common:MergesStats' + query_cache: + $ref: '#/components/schemas/_common:QueryCacheStats' + recovery: + $ref: '#/components/schemas/_common:RecoveryStats' + refresh: + $ref: '#/components/schemas/_common:RefreshStats' + request_cache: + $ref: '#/components/schemas/_common:RequestCacheStats' + search: + $ref: '#/components/schemas/_common:SearchStats' + segments: + $ref: '#/components/schemas/_common:SegmentsStats' + store: + $ref: '#/components/schemas/_common:StoreStats' + translog: + $ref: '#/components/schemas/_common:TranslogStats' + warmer: + $ref: '#/components/schemas/_common:WarmerStats' + bulk: + $ref: '#/components/schemas/_common:BulkStats' + shard_stats: + $ref: '#/components/schemas/indices.stats:ShardsTotalStats' + indices.stats:IndicesStats: + type: object + properties: + primaries: + $ref: '#/components/schemas/indices.stats:IndexStats' + shards: + type: object + additionalProperties: + type: array + items: + $ref: '#/components/schemas/indices.stats:ShardStats' + total: + $ref: '#/components/schemas/indices.stats:IndexStats' + uuid: + $ref: '#/components/schemas/_common:Uuid' + health: + $ref: '#/components/schemas/_common:HealthStatus' + status: + $ref: '#/components/schemas/indices.stats:IndexMetadataState' + indices.stats:MappingStats: + type: object + properties: + total_count: + type: number + total_estimated_overhead: + $ref: '#/components/schemas/_common:ByteSize' + total_estimated_overhead_in_bytes: + type: number + required: + - total_count + - total_estimated_overhead_in_bytes + indices.stats:ShardCommit: + type: object + properties: + generation: + type: number + id: + $ref: '#/components/schemas/_common:Id' + num_docs: + type: number + user_data: + type: object + additionalProperties: + type: string + required: + - generation + - id + - num_docs + - user_data + indices.stats:ShardFileSizeInfo: + type: object + properties: + description: + type: string + size_in_bytes: + type: number + min_size_in_bytes: + type: number + max_size_in_bytes: + type: number + average_size_in_bytes: + type: number + count: + type: number + required: + - description + - size_in_bytes + indices.stats:ShardLease: + type: object + properties: + id: + $ref: '#/components/schemas/_common:Id' + retaining_seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + timestamp: + type: number + source: + type: string + required: + - id + - retaining_seq_no + - timestamp + - source + indices.stats:ShardPath: + type: object + properties: + data_path: + type: string + is_custom_data_path: + type: boolean + state_path: + type: string + required: + - data_path + - is_custom_data_path + - state_path + indices.stats:ShardQueryCache: + type: object + properties: + cache_count: + type: number + cache_size: + type: number + evictions: + type: number + hit_count: + type: number + memory_size_in_bytes: + type: number + miss_count: + type: number + total_count: + type: number + required: + - cache_count + - cache_size + - evictions + - hit_count + - memory_size_in_bytes + - miss_count + - total_count + indices.stats:ShardRetentionLeases: + type: object + properties: + primary_term: + type: number + version: + $ref: '#/components/schemas/_common:VersionNumber' + leases: + type: array + items: + $ref: '#/components/schemas/indices.stats:ShardLease' + required: + - primary_term + - version + - leases + indices.stats:ShardRouting: + type: object + properties: + node: + type: string + primary: + type: boolean + relocating_node: + oneOf: + - type: string + - nullable: true + type: string + state: + $ref: '#/components/schemas/indices.stats:ShardRoutingState' + required: + - node + - primary + - state + indices.stats:ShardRoutingState: + type: string + enum: + - UNASSIGNED + - INITIALIZING + - STARTED + - RELOCATING + indices.stats:ShardSequenceNumber: + type: object + properties: + global_checkpoint: + type: number + local_checkpoint: + type: number + max_seq_no: + $ref: '#/components/schemas/_common:SequenceNumber' + required: + - global_checkpoint + - local_checkpoint + - max_seq_no + indices.stats:ShardStats: + type: object + properties: + commit: + $ref: '#/components/schemas/indices.stats:ShardCommit' + completion: + $ref: '#/components/schemas/_common:CompletionStats' + docs: + $ref: '#/components/schemas/_common:DocStats' + fielddata: + $ref: '#/components/schemas/_common:FielddataStats' + flush: + $ref: '#/components/schemas/_common:FlushStats' + get: + $ref: '#/components/schemas/_common:GetStats' + indexing: + $ref: '#/components/schemas/_common:IndexingStats' + mappings: + $ref: '#/components/schemas/indices.stats:MappingStats' + merges: + $ref: '#/components/schemas/_common:MergesStats' + shard_path: + $ref: '#/components/schemas/indices.stats:ShardPath' + query_cache: + $ref: '#/components/schemas/indices.stats:ShardQueryCache' + recovery: + $ref: '#/components/schemas/_common:RecoveryStats' + refresh: + $ref: '#/components/schemas/_common:RefreshStats' + request_cache: + $ref: '#/components/schemas/_common:RequestCacheStats' + retention_leases: + $ref: '#/components/schemas/indices.stats:ShardRetentionLeases' + routing: + $ref: '#/components/schemas/indices.stats:ShardRouting' + search: + $ref: '#/components/schemas/_common:SearchStats' + segments: + $ref: '#/components/schemas/_common:SegmentsStats' + seq_no: + $ref: '#/components/schemas/indices.stats:ShardSequenceNumber' + store: + $ref: '#/components/schemas/_common:StoreStats' + translog: + $ref: '#/components/schemas/_common:TranslogStats' + warmer: + $ref: '#/components/schemas/_common:WarmerStats' + bulk: + $ref: '#/components/schemas/_common:BulkStats' + shards: + type: object + additionalProperties: + type: object + shard_stats: + $ref: '#/components/schemas/indices.stats:ShardsTotalStats' + indices: + $ref: '#/components/schemas/indices.stats:IndicesStats' + indices.stats:ShardsTotalStats: + type: object + properties: + total_count: + type: number + required: + - total_count + indices.update_aliases:Action: + type: object + properties: + add: + $ref: '#/components/schemas/indices.update_aliases:AddAction' + remove: + $ref: '#/components/schemas/indices.update_aliases:RemoveAction' + remove_index: + $ref: '#/components/schemas/indices.update_aliases:RemoveIndexAction' + minProperties: 1 + maxProperties: 1 + indices.update_aliases:AddAction: + type: object + properties: + alias: + $ref: '#/components/schemas/_common:IndexAlias' + aliases: + description: |- + Aliases for the action. + Index alias names support date math. + oneOf: + - $ref: '#/components/schemas/_common:IndexAlias' + - type: array + items: + $ref: '#/components/schemas/_common:IndexAlias' + filter: + $ref: '#/components/schemas/_common.query_dsl:QueryContainer' + index: + $ref: '#/components/schemas/_common:IndexName' + indices: + $ref: '#/components/schemas/_common:Indices' + index_routing: + $ref: '#/components/schemas/_common:Routing' + is_hidden: + description: If `true`, the alias is hidden. + type: boolean + is_write_index: + description: If `true`, sets the write index or data stream for the alias. + type: boolean + routing: + $ref: '#/components/schemas/_common:Routing' + search_routing: + $ref: '#/components/schemas/_common:Routing' + must_exist: + description: If `true`, the alias must exist to perform the action. + type: boolean + indices.update_aliases:RemoveAction: + type: object + properties: + alias: + $ref: '#/components/schemas/_common:IndexAlias' + aliases: + description: |- + Aliases for the action. + Index alias names support date math. + oneOf: + - $ref: '#/components/schemas/_common:IndexAlias' + - type: array + items: + $ref: '#/components/schemas/_common:IndexAlias' + index: + $ref: '#/components/schemas/_common:IndexName' + indices: + $ref: '#/components/schemas/_common:Indices' + must_exist: + description: If `true`, the alias must exist to perform the action. + type: boolean + indices.update_aliases:RemoveIndexAction: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + indices: + $ref: '#/components/schemas/_common:Indices' + must_exist: + description: If `true`, the alias must exist to perform the action. + type: boolean + indices.validate_query:IndicesValidationExplanation: + type: object + properties: + error: + type: string + explanation: + type: string + index: + $ref: '#/components/schemas/_common:IndexName' + valid: + type: boolean + required: + - index + - valid + ingest._common:AppendProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + value: + description: The value to be appended. Supports template snippets. + type: array + items: + type: object + allow_duplicates: + description: If `false`, the processor does not append values already present in the field. + type: boolean + required: + - field + - value + ingest._common:AttachmentProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and field does not exist, the processor quietly exits without modifying the document. + type: boolean + indexed_chars: + description: |- + The number of chars being used for extraction to prevent huge fields. + Use `-1` for no limit. + type: number + indexed_chars_field: + $ref: '#/components/schemas/_common:Field' + properties: + description: |- + Array of properties to select to be stored. + Can be `content`, `title`, `name`, `author`, `keywords`, `date`, `content_type`, `content_length`, `language`. + type: array + items: + type: string + target_field: + $ref: '#/components/schemas/_common:Field' + resource_name: + description: |- + Field containing the name of the resource to decode. + If specified, the processor passes this resource name to the underlying Tika library to enable Resource Name Based Detection. + type: string + required: + - field + ingest._common:BytesProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:CircleProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + error_distance: + description: The difference between the resulting inscribed distance from center to side and the circle’s radius (measured in meters for `geo_shape`, unit-less for `shape`). + type: number + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist, the processor quietly exits without modifying the document. + type: boolean + shape_type: + $ref: '#/components/schemas/ingest._common:ShapeType' + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - error_distance + - field + - shape_type + ingest._common:ConvertProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + target_field: + $ref: '#/components/schemas/_common:Field' + type: + $ref: '#/components/schemas/ingest._common:ConvertType' + required: + - field + - type + ingest._common:ConvertType: + type: string + enum: + - integer + - long + - float + - double + - string + - boolean + - auto + ingest._common:CsvProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + empty_value: + description: |- + Value used to fill empty fields. + Empty fields are skipped if this is not provided. + An empty field is one with no value (2 consecutive separators) or empty quotes (`""`). + type: object + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist, the processor quietly exits without modifying the document. + type: boolean + quote: + description: Quote used in CSV, has to be single character string. + type: string + separator: + description: Separator used in CSV, has to be single character string. + type: string + target_fields: + $ref: '#/components/schemas/_common:Fields' + trim: + description: Trim whitespaces in unquoted fields. + type: boolean + required: + - field + - target_fields + ingest._common:DateIndexNameProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + date_formats: + description: |- + An array of the expected date formats for parsing dates / timestamps in the document being preprocessed. + Can be a java time pattern or one of the following formats: ISO8601, UNIX, UNIX_MS, or TAI64N. + type: array + items: + type: string + date_rounding: + description: |- + How to round the date when formatting the date into the index name. Valid values are: + `y` (year), `M` (month), `w` (week), `d` (day), `h` (hour), `m` (minute) and `s` (second). + Supports template snippets. + type: string + field: + $ref: '#/components/schemas/_common:Field' + index_name_format: + description: |- + The format to be used when printing the parsed date into the index name. + A valid java time pattern is expected here. + Supports template snippets. + type: string + index_name_prefix: + description: |- + A prefix of the index name to be prepended before the printed date. + Supports template snippets. + type: string + locale: + description: The locale to use when parsing the date from the document being preprocessed, relevant when parsing month names or week days. + type: string + timezone: + description: The timezone to use when parsing the date and when date math index supports resolves expressions into concrete index names. + type: string + required: + - date_formats + - date_rounding + - field + ingest._common:DateProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + formats: + description: |- + An array of the expected date formats. + Can be a java time pattern or one of the following formats: ISO8601, UNIX, UNIX_MS, or TAI64N. + type: array + items: + type: string + locale: + description: |- + The locale to use when parsing the date, relevant when parsing month names or week days. + Supports template snippets. + type: string + target_field: + $ref: '#/components/schemas/_common:Field' + timezone: + description: |- + The timezone to use when parsing the date. + Supports template snippets. + type: string + required: + - field + - formats + ingest._common:DissectProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + append_separator: + description: The character(s) that separate the appended fields. + type: string + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + pattern: + description: The pattern to apply to the field. + type: string + required: + - field + - pattern + ingest._common:DotExpanderProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + path: + description: |- + The field that contains the field to expand. + Only required if the field to expand is part another object field, because the `field` option can only understand leaf fields. + type: string + required: + - field + ingest._common:DropProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + ingest._common:EnrichProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist, the processor quietly exits without modifying the document. + type: boolean + max_matches: + description: |- + The maximum number of matched documents to include under the configured target field. + The `target_field` will be turned into a json array if `max_matches` is higher than 1, otherwise `target_field` will become a json object. + In order to avoid documents getting too large, the maximum allowed value is 128. + type: number + override: + description: |- + If processor will update fields with pre-existing non-null-valued field. + When set to `false`, such fields will not be touched. + type: boolean + policy_name: + description: The name of the enrich policy to use. + type: string + shape_relation: + $ref: '#/components/schemas/_common:GeoShapeRelation' + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + - policy_name + - target_field + ingest._common:FailProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + message: + description: |- + The error message thrown by the processor. + Supports template snippets. + type: string + required: + - message + ingest._common:ForeachProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true`, the processor silently exits without changing the document if the `field` is `null` or missing. + type: boolean + processor: + $ref: '#/components/schemas/ingest._common:ProcessorContainer' + required: + - field + - processor + ingest._common:GeoIpProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + database_file: + description: The database filename referring to a database the module ships with (GeoLite2-City.mmdb, GeoLite2-Country.mmdb, or GeoLite2-ASN.mmdb) or a custom database in the ingest-geoip config directory. + type: string + field: + $ref: '#/components/schemas/_common:Field' + first_only: + description: If `true`, only the first found geoip data will be returned, even if the field contains an array. + type: boolean + ignore_missing: + description: If `true` and `field` does not exist, the processor quietly exits without modifying the document. + type: boolean + properties: + description: Controls what properties are added to the `target_field` based on the geoip lookup. + type: array + items: + type: string + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:GrokProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + pattern_definitions: + description: |- + A map of pattern-name and pattern tuples defining custom patterns to be used by the current processor. + Patterns matching existing names will override the pre-existing definition. + type: object + additionalProperties: + type: string + patterns: + description: |- + An ordered list of grok expression to match and extract named captures with. + Returns on the first expression in the list that matches. + type: array + items: + type: string + trace_match: + description: When `true`, `_ingest._grok_match_index` will be inserted into your matched document’s metadata with the index into the pattern found in `patterns` that matched. + type: boolean + required: + - field + - patterns + ingest._common:GsubProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + pattern: + description: The pattern to be replaced. + type: string + replacement: + description: The string to replace the matching patterns with. + type: string + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + - pattern + - replacement + ingest._common:InferenceConfig: + type: object + properties: + regression: + $ref: '#/components/schemas/ingest._common:InferenceConfigRegression' + classification: + $ref: '#/components/schemas/ingest._common:InferenceConfigClassification' + minProperties: 1 + maxProperties: 1 + ingest._common:InferenceConfigClassification: + type: object + properties: + num_top_classes: + description: Specifies the number of top class predictions to return. + type: number + num_top_feature_importance_values: + description: Specifies the maximum number of feature importance values per document. + type: number + results_field: + $ref: '#/components/schemas/_common:Field' + top_classes_results_field: + $ref: '#/components/schemas/_common:Field' + prediction_field_type: + description: |- + Specifies the type of the predicted field to write. + Valid values are: `string`, `number`, `boolean`. + type: string + ingest._common:InferenceConfigRegression: + type: object + properties: + results_field: + $ref: '#/components/schemas/_common:Field' + num_top_feature_importance_values: + description: Specifies the maximum number of feature importance values per document. + type: number + ingest._common:InferenceProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + model_id: + $ref: '#/components/schemas/_common:Id' + target_field: + $ref: '#/components/schemas/_common:Field' + field_map: + description: |- + Maps the document field names to the known field names of the model. + This mapping takes precedence over any default mappings provided in the model configuration. + type: object + additionalProperties: + type: object + inference_config: + $ref: '#/components/schemas/ingest._common:InferenceConfig' + required: + - model_id + ingest._common:JoinProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + separator: + description: The separator character. + type: string + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + - separator + ingest._common:JsonProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + add_to_root: + description: |- + Flag that forces the parsed JSON to be added at the top level of the document. + `target_field` must not be set when this option is chosen. + type: boolean + add_to_root_conflict_strategy: + $ref: '#/components/schemas/ingest._common:JsonProcessorConflictStrategy' + allow_duplicate_keys: + description: |- + When set to `true`, the JSON parser will not fail if the JSON contains duplicate keys. + Instead, the last encountered value for any duplicate key wins. + type: boolean + field: + $ref: '#/components/schemas/_common:Field' + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:JsonProcessorConflictStrategy: + type: string + enum: + - replace + - merge + ingest._common:KeyValueProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + exclude_keys: + description: List of keys to exclude from document. + type: array + items: + type: string + field: + $ref: '#/components/schemas/_common:Field' + field_split: + description: Regex pattern to use for splitting key-value pairs. + type: string + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + include_keys: + description: |- + List of keys to filter and insert into document. + Defaults to including all keys. + type: array + items: + type: string + prefix: + description: Prefix to be added to extracted keys. + type: string + strip_brackets: + description: If `true`. strip brackets `()`, `<>`, `[]` as well as quotes `'` and `"` from extracted values. + type: boolean + target_field: + $ref: '#/components/schemas/_common:Field' + trim_key: + description: String of characters to trim from extracted keys. + type: string + trim_value: + description: String of characters to trim from extracted values. + type: string + value_split: + description: Regex pattern to use for splitting the key from the value within a key-value pair. + type: string + required: + - field + - field_split + - value_split + ingest._common:LowercaseProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:Pipeline: + type: object + properties: + description: + description: Description of the ingest pipeline. + type: string + on_failure: + description: Processors to run immediately after a processor failure. + type: array + items: + $ref: '#/components/schemas/ingest._common:ProcessorContainer' + processors: + description: |- + Processors used to perform transformations on documents before indexing. + Processors run sequentially in the order specified. + type: array + items: + $ref: '#/components/schemas/ingest._common:ProcessorContainer' + version: + $ref: '#/components/schemas/_common:VersionNumber' + _meta: + $ref: '#/components/schemas/_common:Metadata' + required: + - _meta + ingest._common:PipelineProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + ignore_missing_pipeline: + description: Whether to ignore missing pipelines instead of failing. + type: boolean + required: + - name + ingest._common:ProcessorBase: + type: object + properties: + description: + description: |- + Description of the processor. + Useful for describing the purpose of the processor or its configuration. + type: string + if: + description: Conditionally execute the processor. + type: string + ignore_failure: + description: Ignore failures for the processor. + type: boolean + on_failure: + description: Handle failures for the processor. + type: array + items: + $ref: '#/components/schemas/ingest._common:ProcessorContainer' + tag: + description: |- + Identifier for the processor. + Useful for debugging and metrics. + type: string + ingest._common:ProcessorContainer: + type: object + properties: + attachment: + $ref: '#/components/schemas/ingest._common:AttachmentProcessor' + append: + $ref: '#/components/schemas/ingest._common:AppendProcessor' + csv: + $ref: '#/components/schemas/ingest._common:CsvProcessor' + convert: + $ref: '#/components/schemas/ingest._common:ConvertProcessor' + date: + $ref: '#/components/schemas/ingest._common:DateProcessor' + date_index_name: + $ref: '#/components/schemas/ingest._common:DateIndexNameProcessor' + dot_expander: + $ref: '#/components/schemas/ingest._common:DotExpanderProcessor' + enrich: + $ref: '#/components/schemas/ingest._common:EnrichProcessor' + fail: + $ref: '#/components/schemas/ingest._common:FailProcessor' + foreach: + $ref: '#/components/schemas/ingest._common:ForeachProcessor' + json: + $ref: '#/components/schemas/ingest._common:JsonProcessor' + user_agent: + $ref: '#/components/schemas/ingest._common:UserAgentProcessor' + kv: + $ref: '#/components/schemas/ingest._common:KeyValueProcessor' + geoip: + $ref: '#/components/schemas/ingest._common:GeoIpProcessor' + grok: + $ref: '#/components/schemas/ingest._common:GrokProcessor' + gsub: + $ref: '#/components/schemas/ingest._common:GsubProcessor' + join: + $ref: '#/components/schemas/ingest._common:JoinProcessor' + lowercase: + $ref: '#/components/schemas/ingest._common:LowercaseProcessor' + remove: + $ref: '#/components/schemas/ingest._common:RemoveProcessor' + rename: + $ref: '#/components/schemas/ingest._common:RenameProcessor' + script: + $ref: '#/components/schemas/_common:Script' + set: + $ref: '#/components/schemas/ingest._common:SetProcessor' + sort: + $ref: '#/components/schemas/ingest._common:SortProcessor' + split: + $ref: '#/components/schemas/ingest._common:SplitProcessor' + trim: + $ref: '#/components/schemas/ingest._common:TrimProcessor' + uppercase: + $ref: '#/components/schemas/ingest._common:UppercaseProcessor' + urldecode: + $ref: '#/components/schemas/ingest._common:UrlDecodeProcessor' + bytes: + $ref: '#/components/schemas/ingest._common:BytesProcessor' + dissect: + $ref: '#/components/schemas/ingest._common:DissectProcessor' + set_security_user: + $ref: '#/components/schemas/ingest._common:SetSecurityUserProcessor' + pipeline: + $ref: '#/components/schemas/ingest._common:PipelineProcessor' + drop: + $ref: '#/components/schemas/ingest._common:DropProcessor' + circle: + $ref: '#/components/schemas/ingest._common:CircleProcessor' + inference: + $ref: '#/components/schemas/ingest._common:InferenceProcessor' + minProperties: 1 + maxProperties: 1 + ingest._common:RemoveProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Fields' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + required: + - field + ingest._common:RenameProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist, the processor quietly exits without modifying the document. + type: boolean + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + - target_field + ingest._common:SetProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + copy_from: + $ref: '#/components/schemas/_common:Field' + field: + $ref: '#/components/schemas/_common:Field' + ignore_empty_value: + description: If `true` and `value` is a template snippet that evaluates to `null` or the empty string, the processor quietly exits without modifying the document. + type: boolean + media_type: + description: |- + The media type for encoding `value`. + Applies only when value is a template snippet. + Must be one of `application/json`, `text/plain`, or `application/x-www-form-urlencoded`. + type: string + override: + description: |- + If `true` processor will update fields with pre-existing non-null-valued field. + When set to `false`, such fields will not be touched. + type: boolean + value: + description: |- + The value to be set for the field. + Supports template snippets. + May specify only one of `value` or `copy_from`. + type: object + required: + - field + ingest._common:SetSecurityUserProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + properties: + description: Controls what user related properties are added to the field. + type: array + items: + type: string + required: + - field + ingest._common:ShapeType: + type: string + enum: + - geo_shape + - shape + ingest._common:SortProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + order: + $ref: '#/components/schemas/_common:SortOrder' + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:SplitProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist, the processor quietly exits without modifying the document. + type: boolean + preserve_trailing: + description: Preserves empty trailing fields, if any. + type: boolean + separator: + description: A regex which matches the separator, for example, `,` or `\s+`. + type: string + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + - separator + ingest._common:TrimProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist, the processor quietly exits without modifying the document. + type: boolean + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:UppercaseProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:UrlDecodeProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist or is `null`, the processor quietly exits without modifying the document. + type: boolean + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:UserAgentProcessor: + allOf: + - $ref: '#/components/schemas/ingest._common:ProcessorBase' + - type: object + properties: + field: + $ref: '#/components/schemas/_common:Field' + ignore_missing: + description: If `true` and `field` does not exist, the processor quietly exits without modifying the document. + type: boolean + options: + type: array + items: + $ref: '#/components/schemas/ingest._common:UserAgentProperty' + regex_file: + description: The name of the file in the `config/ingest-user-agent` directory containing the regular expressions for parsing the user agent string. Both the directory and the file have to be created before starting Opensearch. If not specified, ingest-user-agent will use the `regexes.yaml` from uap-core it ships with. + type: string + target_field: + $ref: '#/components/schemas/_common:Field' + required: + - field + ingest._common:UserAgentProperty: + type: string + enum: + - NAME + - MAJOR + - MINOR + - PATCH + - OS + - OS_NAME + - OS_MAJOR + - OS_MINOR + - DEVICE + - BUILD + ingest.simulate:Document: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + _source: + description: JSON body for the document. + type: object + required: + - _source + ingest.simulate:DocumentSimulation: + type: object + properties: + _id: + $ref: '#/components/schemas/_common:Id' + _index: + $ref: '#/components/schemas/_common:IndexName' + _ingest: + $ref: '#/components/schemas/ingest.simulate:Ingest' + _routing: + description: Value used to send the document to a specific primary shard. + type: string + _source: + description: JSON body for the document. + type: object + additionalProperties: + type: object + _version: + $ref: '#/components/schemas/_common:StringifiedVersionNumber' + _version_type: + $ref: '#/components/schemas/_common:VersionType' + required: + - _id + - _index + - _ingest + - _source + ingest.simulate:Ingest: + type: object + properties: + timestamp: + $ref: '#/components/schemas/_common:DateTime' + pipeline: + $ref: '#/components/schemas/_common:Name' + required: + - timestamp + ingest.simulate:PipelineSimulation: + type: object + properties: + doc: + $ref: '#/components/schemas/ingest.simulate:DocumentSimulation' + processor_results: + type: array + items: + $ref: '#/components/schemas/ingest.simulate:PipelineSimulation' + tag: + type: string + processor_type: + type: string + status: + $ref: '#/components/schemas/_common:ActionStatusOptions' + knn._common:DefaultOperator: + type: string + description: The default operator for query string query (AND or OR). + enum: + - AND + - OR + knn._common:SearchType: + type: string + description: Search operation type. + enum: + - query_then_fetch + - dfs_query_then_fetch + knn._common:SuggestMode: + type: string + description: Specify suggest mode. + enum: + - missing + - popular + - always + nodes._common:AdaptiveSelection: + type: object + properties: + avg_queue_size: + description: The exponentially weighted moving average queue size of search requests on the keyed node. + type: number + avg_response_time: + $ref: '#/components/schemas/_common:Duration' + avg_response_time_ns: + description: The exponentially weighted moving average response time, in nanoseconds, of search requests on the keyed node. + type: number + avg_service_time: + $ref: '#/components/schemas/_common:Duration' + avg_service_time_ns: + description: The exponentially weighted moving average service time, in nanoseconds, of search requests on the keyed node. + type: number + outgoing_searches: + description: The number of outstanding search requests to the keyed node from the node these stats are for. + type: number + rank: + description: The rank of this node; used for shard selection when routing search requests. + type: string + nodes._common:Breaker: + type: object + properties: + estimated_size: + description: Estimated memory used for the operation. + type: string + estimated_size_in_bytes: + description: Estimated memory used, in bytes, for the operation. + type: number + limit_size: + description: Memory limit for the circuit breaker. + type: string + limit_size_in_bytes: + description: Memory limit, in bytes, for the circuit breaker. + type: number + overhead: + description: A constant that all estimates for the circuit breaker are multiplied with to calculate a final estimate. + type: number + tripped: + description: Total number of times the circuit breaker has been triggered and prevented an out of memory error. + type: number + nodes._common:Cgroup: + type: object + properties: + cpuacct: + $ref: '#/components/schemas/nodes._common:CpuAcct' + cpu: + $ref: '#/components/schemas/nodes._common:CgroupCpu' + memory: + $ref: '#/components/schemas/nodes._common:CgroupMemory' + nodes._common:CgroupCpu: + type: object + properties: + control_group: + description: The `cpu` control group to which the Opensearch process belongs. + type: string + cfs_period_micros: + description: The period of time, in microseconds, for how regularly all tasks in the same cgroup as the Opensearch process should have their access to CPU resources reallocated. + type: number + cfs_quota_micros: + description: The total amount of time, in microseconds, for which all tasks in the same cgroup as the Opensearch process can run during one period `cfs_period_micros`. + type: number + stat: + $ref: '#/components/schemas/nodes._common:CgroupCpuStat' + nodes._common:CgroupCpuStat: + type: object + properties: + number_of_elapsed_periods: + description: The number of reporting periods (as specified by `cfs_period_micros`) that have elapsed. + type: number + number_of_times_throttled: + description: The number of times all tasks in the same cgroup as the Opensearch process have been throttled. + type: number + time_throttled_nanos: + $ref: '#/components/schemas/_common:DurationValueUnitNanos' + nodes._common:CgroupMemory: + type: object + properties: + control_group: + description: The `memory` control group to which the Opensearch process belongs. + type: string + limit_in_bytes: + description: |- + The maximum amount of user memory (including file cache) allowed for all tasks in the same cgroup as the Opensearch process. + This value can be too big to store in a `long`, so is returned as a string so that the value returned can exactly match what the underlying operating system interface returns. + Any value that is too large to parse into a `long` almost certainly means no limit has been set for the cgroup. + type: string + usage_in_bytes: + description: |- + The total current memory usage by processes in the cgroup, in bytes, by all tasks in the same cgroup as the Opensearch process. + This value is stored as a string for consistency with `limit_in_bytes`. + type: string + nodes._common:Client: + type: object + properties: + id: + description: Unique ID for the HTTP client. + type: number + agent: + description: |- + Reported agent for the HTTP client. + If unavailable, this property is not included in the response. + type: string + local_address: + description: Local address for the HTTP connection. + type: string + remote_address: + description: Remote address for the HTTP connection. + type: string + last_uri: + description: The URI of the client’s most recent request. + type: string + opened_time_millis: + description: Time at which the client opened the connection. + type: number + closed_time_millis: + description: Time at which the client closed the connection if the connection is closed. + type: number + last_request_time_millis: + description: Time of the most recent request from this client. + type: number + request_count: + description: Number of requests from this client. + type: number + request_size_bytes: + description: Cumulative size in bytes of all requests from this client. + type: number + x_opaque_id: + description: |- + Value from the client’s `x-opaque-id` HTTP header. + If unavailable, this property is not included in the response. + type: string + nodes._common:ClusterAppliedStats: + type: object + properties: + recordings: + type: array + items: + $ref: '#/components/schemas/nodes._common:Recording' + nodes._common:ClusterStateQueue: + type: object + properties: + total: + description: Total number of cluster states in queue. + type: number + pending: + description: Number of pending cluster states in queue. + type: number + committed: + description: Number of committed cluster states in queue. + type: number + nodes._common:ClusterStateUpdate: + type: object + properties: + count: + description: The number of cluster state update attempts that did not change the cluster state since the node started. + type: number + computation_time: + $ref: '#/components/schemas/_common:Duration' + computation_time_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + publication_time: + $ref: '#/components/schemas/_common:Duration' + publication_time_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + context_construction_time: + $ref: '#/components/schemas/_common:Duration' + context_construction_time_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + commit_time: + $ref: '#/components/schemas/_common:Duration' + commit_time_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + completion_time: + $ref: '#/components/schemas/_common:Duration' + completion_time_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + master_apply_time: + $ref: '#/components/schemas/_common:Duration' + master_apply_time_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + notification_time: + $ref: '#/components/schemas/_common:Duration' + notification_time_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - count + nodes._common:Context: + type: object + properties: + context: + type: string + compilations: + type: number + cache_evictions: + type: number + compilation_limit_triggered: + type: number + nodes._common:Cpu: + type: object + properties: + percent: + type: number + sys: + $ref: '#/components/schemas/_common:Duration' + sys_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total: + $ref: '#/components/schemas/_common:Duration' + total_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + user: + $ref: '#/components/schemas/_common:Duration' + user_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + load_average: + type: object + additionalProperties: + type: number + nodes._common:CpuAcct: + type: object + properties: + control_group: + description: The `cpuacct` control group to which the Opensearch process belongs. + type: string + usage_nanos: + $ref: '#/components/schemas/_common:DurationValueUnitNanos' + nodes._common:DataPathStats: + type: object + properties: + available: + description: Total amount of disk space available to this Java virtual machine on this file store. + type: string + available_in_bytes: + description: Total number of bytes available to this Java virtual machine on this file store. + type: number + disk_queue: + type: string + disk_reads: + type: number + disk_read_size: + type: string + disk_read_size_in_bytes: + type: number + disk_writes: + type: number + disk_write_size: + type: string + disk_write_size_in_bytes: + type: number + free: + description: Total amount of unallocated disk space in the file store. + type: string + free_in_bytes: + description: Total number of unallocated bytes in the file store. + type: number + mount: + description: 'Mount point of the file store (for example: `/dev/sda2`).' + type: string + path: + description: Path to the file store. + type: string + total: + description: Total size of the file store. + type: string + total_in_bytes: + description: Total size of the file store in bytes. + type: number + type: + description: 'Type of the file store (ex: ext4).' + type: string + nodes._common:Discovery: + type: object + properties: + cluster_state_queue: + $ref: '#/components/schemas/nodes._common:ClusterStateQueue' + published_cluster_states: + $ref: '#/components/schemas/nodes._common:PublishedClusterStates' + cluster_state_update: + description: |- + Contains low-level statistics about how long various activities took during cluster state updates while the node was the elected master. + Omitted if the node is not master-eligible. + Every field whose name ends in `_time` within this object is also represented as a raw number of milliseconds in a field whose name ends in `_time_millis`. + The human-readable fields with a `_time` suffix are only returned if requested with the `?human=true` query parameter. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:ClusterStateUpdate' + serialized_cluster_states: + $ref: '#/components/schemas/nodes._common:SerializedClusterState' + cluster_applier_stats: + $ref: '#/components/schemas/nodes._common:ClusterAppliedStats' + nodes._common:ExtendedMemoryStats: + allOf: + - $ref: '#/components/schemas/nodes._common:MemoryStats' + - type: object + properties: + free_percent: + description: Percentage of free memory. + type: number + used_percent: + description: Percentage of used memory. + type: number + nodes._common:FileSystem: + type: object + properties: + data: + description: List of all file stores. + type: array + items: + $ref: '#/components/schemas/nodes._common:DataPathStats' + timestamp: + description: |- + Last time the file stores statistics were refreshed. + Recorded in milliseconds since the Unix Epoch. + type: number + total: + $ref: '#/components/schemas/nodes._common:FileSystemTotal' + io_stats: + $ref: '#/components/schemas/nodes._common:IoStats' + nodes._common:FileSystemTotal: + type: object + properties: + available: + description: |- + Total disk space available to this Java virtual machine on all file stores. + Depending on OS or process level restrictions, this might appear less than `free`. + This is the actual amount of free disk space the Opensearch node can utilise. + type: string + available_in_bytes: + description: |- + Total number of bytes available to this Java virtual machine on all file stores. + Depending on OS or process level restrictions, this might appear less than `free_in_bytes`. + This is the actual amount of free disk space the Opensearch node can utilise. + type: number + free: + description: Total unallocated disk space in all file stores. + type: string + free_in_bytes: + description: Total number of unallocated bytes in all file stores. + type: number + total: + description: Total size of all file stores. + type: string + total_in_bytes: + description: Total size of all file stores in bytes. + type: number + nodes._common:GarbageCollector: + type: object + properties: + collectors: + description: Contains statistics about JVM garbage collectors for the node. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:GarbageCollectorTotal' + nodes._common:GarbageCollectorTotal: + type: object + properties: + collection_count: + description: Total number of JVM garbage collectors that collect objects. + type: number + collection_time: + description: Total time spent by JVM collecting objects. + type: string + collection_time_in_millis: + description: Total time, in milliseconds, spent by JVM collecting objects. + type: number + nodes._common:Http: + type: object + properties: + current_open: + description: Current number of open HTTP connections for the node. + type: number + total_opened: + description: Total number of HTTP connections opened for the node. + type: number + clients: + description: |- + Information on current and recently-closed HTTP client connections. + Clients that have been closed longer than the `http.client_stats.closed_channels.max_age` setting will not be represented here. + type: array + items: + $ref: '#/components/schemas/nodes._common:Client' + nodes._common:IndexingPressure: + type: object + properties: + memory: + $ref: '#/components/schemas/nodes._common:IndexingPressureMemory' + nodes._common:IndexingPressureMemory: + type: object + properties: + limit: + $ref: '#/components/schemas/_common:ByteSize' + limit_in_bytes: + description: |- + Configured memory limit, in bytes, for the indexing requests. + Replica requests have an automatic limit that is 1.5x this value. + type: number + current: + $ref: '#/components/schemas/nodes._common:PressureMemory' + total: + $ref: '#/components/schemas/nodes._common:PressureMemory' + nodes._common:Ingest: + type: object + properties: + pipelines: + description: Contains statistics about ingest pipelines for the node. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:IngestTotal' + total: + $ref: '#/components/schemas/nodes._common:IngestTotal' + nodes._common:IngestTotal: + type: object + properties: + count: + description: Total number of documents ingested during the lifetime of this node. + type: number + current: + description: Total number of documents currently being ingested. + type: number + failed: + description: Total number of failed ingest operations during the lifetime of this node. + type: number + processors: + description: Total number of ingest processors. + type: array + items: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:KeyedProcessor' + time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + nodes._common:IoStatDevice: + type: object + properties: + device_name: + description: The Linux device name. + type: string + operations: + description: The total number of read and write operations for the device completed since starting Opensearch. + type: number + read_kilobytes: + description: The total number of kilobytes read for the device since starting Opensearch. + type: number + read_operations: + description: The total number of read operations for the device completed since starting Opensearch. + type: number + write_kilobytes: + description: The total number of kilobytes written for the device since starting Opensearch. + type: number + write_operations: + description: The total number of write operations for the device completed since starting Opensearch. + type: number + nodes._common:IoStats: + type: object + properties: + devices: + description: |- + Array of disk metrics for each device that is backing an Opensearch data path. + These disk metrics are probed periodically and averages between the last probe and the current probe are computed. + type: array + items: + $ref: '#/components/schemas/nodes._common:IoStatDevice' + total: + $ref: '#/components/schemas/nodes._common:IoStatDevice' + nodes._common:Jvm: + type: object + properties: + buffer_pools: + description: Contains statistics about JVM buffer pools for the node. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:NodeBufferPool' + classes: + $ref: '#/components/schemas/nodes._common:JvmClasses' + gc: + $ref: '#/components/schemas/nodes._common:GarbageCollector' + mem: + $ref: '#/components/schemas/nodes._common:JvmMemoryStats' + threads: + $ref: '#/components/schemas/nodes._common:JvmThreads' + timestamp: + description: Last time JVM statistics were refreshed. + type: number + uptime: + description: |- + Human-readable JVM uptime. + Only returned if the `human` query parameter is `true`. + type: string + uptime_in_millis: + description: JVM uptime in milliseconds. + type: number + nodes._common:JvmClasses: + type: object + properties: + current_loaded_count: + description: Number of classes currently loaded by JVM. + type: number + total_loaded_count: + description: Total number of classes loaded since the JVM started. + type: number + total_unloaded_count: + description: Total number of classes unloaded since the JVM started. + type: number + nodes._common:JvmMemoryStats: + type: object + properties: + heap_used_in_bytes: + description: Memory, in bytes, currently in use by the heap. + type: number + heap_used_percent: + description: Percentage of memory currently in use by the heap. + type: number + heap_committed_in_bytes: + description: Amount of memory, in bytes, available for use by the heap. + type: number + heap_max_in_bytes: + description: Maximum amount of memory, in bytes, available for use by the heap. + type: number + non_heap_used_in_bytes: + description: Non-heap memory used, in bytes. + type: number + non_heap_committed_in_bytes: + description: Amount of non-heap memory available, in bytes. + type: number + pools: + description: Contains statistics about heap memory usage for the node. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:Pool' + nodes._common:JvmThreads: + type: object + properties: + count: + description: Number of active threads in use by JVM. + type: number + peak_count: + description: Highest number of threads used by JVM. + type: number + nodes._common:KeyedProcessor: + type: object + properties: + stats: + $ref: '#/components/schemas/nodes._common:Processor' + type: + type: string + nodes._common:MemoryStats: + type: object + properties: + adjusted_total_in_bytes: + description: |- + If the amount of physical memory has been overridden using the `es`.`total_memory_bytes` system property then this reports the overridden value in bytes. + Otherwise it reports the same value as `total_in_bytes`. + type: number + resident: + type: string + resident_in_bytes: + type: number + share: + type: string + share_in_bytes: + type: number + total_virtual: + type: string + total_virtual_in_bytes: + type: number + total_in_bytes: + description: Total amount of physical memory in bytes. + type: number + free_in_bytes: + description: Amount of free physical memory in bytes. + type: number + used_in_bytes: + description: Amount of used physical memory in bytes. + type: number + nodes._common:NodeBufferPool: + type: object + properties: + count: + description: Number of buffer pools. + type: number + total_capacity: + description: Total capacity of buffer pools. + type: string + total_capacity_in_bytes: + description: Total capacity of buffer pools in bytes. + type: number + used: + description: Size of buffer pools. + type: string + used_in_bytes: + description: Size of buffer pools in bytes. + type: number + nodes._common:NodeReloadError: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + reload_exception: + $ref: '#/components/schemas/_common:ErrorCause' + required: + - name + nodes._common:NodeReloadResult: + oneOf: + - $ref: '#/components/schemas/nodes._common:Stats' + - $ref: '#/components/schemas/nodes._common:NodeReloadError' + nodes._common:NodesResponseBase: + type: object + properties: + _nodes: + $ref: '#/components/schemas/_common:NodeStatistics' + nodes._common:OperatingSystem: + type: object + properties: + cpu: + $ref: '#/components/schemas/nodes._common:Cpu' + mem: + $ref: '#/components/schemas/nodes._common:ExtendedMemoryStats' + swap: + $ref: '#/components/schemas/nodes._common:MemoryStats' + cgroup: + $ref: '#/components/schemas/nodes._common:Cgroup' + timestamp: + type: number + nodes._common:Pool: + type: object + properties: + used_in_bytes: + description: Memory, in bytes, used by the heap. + type: number + max_in_bytes: + description: Maximum amount of memory, in bytes, available for use by the heap. + type: number + peak_used_in_bytes: + description: Largest amount of memory, in bytes, historically used by the heap. + type: number + peak_max_in_bytes: + description: Largest amount of memory, in bytes, historically used by the heap. + type: number + nodes._common:PressureMemory: + type: object + properties: + all: + $ref: '#/components/schemas/_common:ByteSize' + all_in_bytes: + description: Memory consumed, in bytes, by indexing requests in the coordinating, primary, or replica stage. + type: number + combined_coordinating_and_primary: + $ref: '#/components/schemas/_common:ByteSize' + combined_coordinating_and_primary_in_bytes: + description: |- + Memory consumed, in bytes, by indexing requests in the coordinating or primary stage. + This value is not the sum of coordinating and primary as a node can reuse the coordinating memory if the primary stage is executed locally. + type: number + coordinating: + $ref: '#/components/schemas/_common:ByteSize' + coordinating_in_bytes: + description: Memory consumed, in bytes, by indexing requests in the coordinating stage. + type: number + primary: + $ref: '#/components/schemas/_common:ByteSize' + primary_in_bytes: + description: Memory consumed, in bytes, by indexing requests in the primary stage. + type: number + replica: + $ref: '#/components/schemas/_common:ByteSize' + replica_in_bytes: + description: Memory consumed, in bytes, by indexing requests in the replica stage. + type: number + coordinating_rejections: + description: Number of indexing requests rejected in the coordinating stage. + type: number + primary_rejections: + description: Number of indexing requests rejected in the primary stage. + type: number + replica_rejections: + description: Number of indexing requests rejected in the replica stage. + type: number + nodes._common:Process: + type: object + properties: + cpu: + $ref: '#/components/schemas/nodes._common:Cpu' + mem: + $ref: '#/components/schemas/nodes._common:MemoryStats' + open_file_descriptors: + description: Number of opened file descriptors associated with the current or `-1` if not supported. + type: number + max_file_descriptors: + description: Maximum number of file descriptors allowed on the system, or `-1` if not supported. + type: number + timestamp: + description: |- + Last time the statistics were refreshed. + Recorded in milliseconds since the Unix Epoch. + type: number + nodes._common:Processor: + type: object + properties: + count: + description: Number of documents transformed by the processor. + type: number + current: + description: Number of documents currently being transformed by the processor. + type: number + failed: + description: Number of failed operations for the processor. + type: number + time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + nodes._common:PublishedClusterStates: + type: object + properties: + full_states: + description: Number of published cluster states. + type: number + incompatible_diffs: + description: Number of incompatible differences between published cluster states. + type: number + compatible_diffs: + description: Number of compatible differences between published cluster states. + type: number + nodes._common:Recording: + type: object + properties: + name: + type: string + cumulative_execution_count: + type: number + cumulative_execution_time: + $ref: '#/components/schemas/_common:Duration' + cumulative_execution_time_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + nodes._common:SampleType: + type: string + description: The type to sample. + enum: + - cpu + - wait + - block + nodes._common:ScriptCache: + type: object + properties: + cache_evictions: + description: Total number of times the script cache has evicted old data. + type: number + compilation_limit_triggered: + description: Total number of times the script compilation circuit breaker has limited inline script compilations. + type: number + compilations: + description: Total number of inline script compilations performed by the node. + type: number + context: + type: string + nodes._common:Scripting: + type: object + properties: + cache_evictions: + description: Total number of times the script cache has evicted old data. + type: number + compilations: + description: Total number of inline script compilations performed by the node. + type: number + compilations_history: + description: Contains this recent history of script compilations. + type: object + additionalProperties: + type: number + compilation_limit_triggered: + description: Total number of times the script compilation circuit breaker has limited inline script compilations. + type: number + contexts: + type: array + items: + $ref: '#/components/schemas/nodes._common:Context' + nodes._common:SerializedClusterState: + type: object + properties: + full_states: + $ref: '#/components/schemas/nodes._common:SerializedClusterStateDetail' + diffs: + $ref: '#/components/schemas/nodes._common:SerializedClusterStateDetail' + nodes._common:SerializedClusterStateDetail: + type: object + properties: + count: + type: number + uncompressed_size: + type: string + uncompressed_size_in_bytes: + type: number + compressed_size: + type: string + compressed_size_in_bytes: + type: number + nodes._common:Stats: + type: object + properties: + adaptive_selection: + description: Statistics about adaptive replica selection. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:AdaptiveSelection' + breakers: + description: Statistics about the field data circuit breaker. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:Breaker' + fs: + $ref: '#/components/schemas/nodes._common:FileSystem' + host: + $ref: '#/components/schemas/_common:Host' + http: + $ref: '#/components/schemas/nodes._common:Http' + ingest: + $ref: '#/components/schemas/nodes._common:Ingest' + ip: + description: IP address and port for the node. + oneOf: + - $ref: '#/components/schemas/_common:Ip' + - type: array + items: + $ref: '#/components/schemas/_common:Ip' + jvm: + $ref: '#/components/schemas/nodes._common:Jvm' + name: + $ref: '#/components/schemas/_common:Name' + os: + $ref: '#/components/schemas/nodes._common:OperatingSystem' + process: + $ref: '#/components/schemas/nodes._common:Process' + roles: + $ref: '#/components/schemas/_common:NodeRoles' + script: + $ref: '#/components/schemas/nodes._common:Scripting' + script_cache: + type: object + additionalProperties: + oneOf: + - $ref: '#/components/schemas/nodes._common:ScriptCache' + - type: array + items: + $ref: '#/components/schemas/nodes._common:ScriptCache' + thread_pool: + description: Statistics about each thread pool, including current size, queue and rejected tasks. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:ThreadCount' + timestamp: + type: number + transport: + $ref: '#/components/schemas/nodes._common:Transport' + transport_address: + $ref: '#/components/schemas/_common:TransportAddress' + attributes: + description: Contains a list of attributes for the node. + type: object + additionalProperties: + type: string + discovery: + $ref: '#/components/schemas/nodes._common:Discovery' + indexing_pressure: + $ref: '#/components/schemas/nodes._common:IndexingPressure' + indices: + $ref: '#/components/schemas/indices.stats:ShardStats' + nodes._common:ThreadCount: + type: object + properties: + active: + description: Number of active threads in the thread pool. + type: number + completed: + description: Number of tasks completed by the thread pool executor. + type: number + largest: + description: Highest number of active threads in the thread pool. + type: number + queue: + description: Number of tasks in queue for the thread pool. + type: number + rejected: + description: Number of tasks rejected by the thread pool executor. + type: number + threads: + description: Number of threads in the thread pool. + type: number + nodes._common:Transport: + type: object + properties: + inbound_handling_time_histogram: + description: The distribution of the time spent handling each inbound message on a transport thread, represented as a histogram. + type: array + items: + $ref: '#/components/schemas/nodes._common:TransportHistogram' + outbound_handling_time_histogram: + description: The distribution of the time spent sending each outbound transport message on a transport thread, represented as a histogram. + type: array + items: + $ref: '#/components/schemas/nodes._common:TransportHistogram' + rx_count: + description: Total number of RX (receive) packets received by the node during internal cluster communication. + type: number + rx_size: + description: Size of RX packets received by the node during internal cluster communication. + type: string + rx_size_in_bytes: + description: Size, in bytes, of RX packets received by the node during internal cluster communication. + type: number + server_open: + description: Current number of inbound TCP connections used for internal communication between nodes. + type: number + tx_count: + description: Total number of TX (transmit) packets sent by the node during internal cluster communication. + type: number + tx_size: + description: Size of TX packets sent by the node during internal cluster communication. + type: string + tx_size_in_bytes: + description: Size, in bytes, of TX packets sent by the node during internal cluster communication. + type: number + total_outbound_connections: + description: |- + The cumulative number of outbound transport connections that this node has opened since it started. + Each transport connection may comprise multiple TCP connections but is only counted once in this statistic. + Transport connections are typically long-lived so this statistic should remain constant in a stable cluster. + type: number + nodes._common:TransportHistogram: + type: object + properties: + count: + description: The number of times a transport thread took a period of time within the bounds of this bucket to handle an inbound message. + type: number + lt_millis: + description: |- + The exclusive upper bound of the bucket in milliseconds. + May be omitted on the last bucket if this bucket has no upper bound. + type: number + ge_millis: + description: The inclusive lower bound of the bucket in milliseconds. May be omitted on the first bucket if this bucket has no lower bound. + type: number + nodes.info:DeprecationIndexing: + type: object + properties: + enabled: + oneOf: + - type: boolean + - type: string + required: + - enabled + nodes.info:Metric: + type: string + enum: + - settings + - os + - process + - jvm + - thread_pool + - transport + - http + - plugins + - ingest + - aggregations + - indices + - search_pipelines + - _all + nodes.info:NodeInfo: + type: object + properties: + attributes: + type: object + additionalProperties: + type: string + build_flavor: + type: string + build_hash: + description: Short hash of the last git commit in this release. + type: string + build_type: + type: string + host: + $ref: '#/components/schemas/_common:Host' + http: + $ref: '#/components/schemas/nodes.info:NodeInfoHttp' + ip: + $ref: '#/components/schemas/_common:Ip' + jvm: + $ref: '#/components/schemas/nodes.info:NodeJvmInfo' + name: + $ref: '#/components/schemas/_common:Name' + network: + $ref: '#/components/schemas/nodes.info:NodeInfoNetwork' + os: + $ref: '#/components/schemas/nodes.info:NodeOperatingSystemInfo' + plugins: + type: array + items: + $ref: '#/components/schemas/_common:PluginStats' + process: + $ref: '#/components/schemas/nodes.info:NodeProcessInfo' + roles: + $ref: '#/components/schemas/_common:NodeRoles' + settings: + $ref: '#/components/schemas/nodes.info:NodeInfoSettings' + thread_pool: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.info:NodeThreadPoolInfo' + total_indexing_buffer: + description: Total heap allowed to be used to hold recently indexed documents before they must be written to disk. This size is a shared pool across all shards on this node, and is controlled by Indexing Buffer settings. + type: number + total_indexing_buffer_in_bytes: + $ref: '#/components/schemas/_common:ByteSize' + transport: + $ref: '#/components/schemas/nodes.info:NodeInfoTransport' + transport_address: + $ref: '#/components/schemas/_common:TransportAddress' + version: + $ref: '#/components/schemas/_common:VersionString' + modules: + type: array + items: + $ref: '#/components/schemas/_common:PluginStats' + ingest: + $ref: '#/components/schemas/nodes.info:NodeInfoIngest' + aggregations: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.info:NodeInfoAggregation' + required: + - attributes + - build_flavor + - build_hash + - build_type + - host + - ip + - name + - roles + - transport_address + - version + nodes.info:NodeInfoAction: + type: object + properties: + destructive_requires_name: + type: string + required: + - destructive_requires_name + nodes.info:NodeInfoAggregation: + type: object + properties: + types: + type: array + items: + type: string + required: + - types + nodes.info:NodeInfoBootstrap: + type: object + properties: + memory_lock: + type: string + required: + - memory_lock + nodes.info:NodeInfoClient: + type: object + properties: + type: + type: string + required: + - type + nodes.info:NodeInfoDiscover: + type: object + properties: + seed_hosts: + type: string + required: + - seed_hosts + nodes.info:NodeInfoHttp: + type: object + properties: + bound_address: + type: array + items: + type: string + max_content_length: + $ref: '#/components/schemas/_common:ByteSize' + max_content_length_in_bytes: + type: number + publish_address: + type: string + required: + - bound_address + - max_content_length_in_bytes + - publish_address + nodes.info:NodeInfoIngest: + type: object + properties: + processors: + type: array + items: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestProcessor' + required: + - processors + nodes.info:NodeInfoIngestDownloader: + type: object + properties: + enabled: + type: string + required: + - enabled + nodes.info:NodeInfoIngestInfo: + type: object + properties: + downloader: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestDownloader' + required: + - downloader + nodes.info:NodeInfoIngestProcessor: + type: object + properties: + type: + type: string + required: + - type + nodes.info:NodeInfoJvmMemory: + type: object + properties: + direct_max: + $ref: '#/components/schemas/_common:ByteSize' + direct_max_in_bytes: + type: number + heap_init: + $ref: '#/components/schemas/_common:ByteSize' + heap_init_in_bytes: + type: number + heap_max: + $ref: '#/components/schemas/_common:ByteSize' + heap_max_in_bytes: + type: number + non_heap_init: + $ref: '#/components/schemas/_common:ByteSize' + non_heap_init_in_bytes: + type: number + non_heap_max: + $ref: '#/components/schemas/_common:ByteSize' + non_heap_max_in_bytes: + type: number + required: + - direct_max_in_bytes + - heap_init_in_bytes + - heap_max_in_bytes + - non_heap_init_in_bytes + - non_heap_max_in_bytes + nodes.info:NodeInfoMemory: + type: object + properties: + total: + type: string + total_in_bytes: + type: number + required: + - total + - total_in_bytes + nodes.info:NodeInfoNetwork: + type: object + properties: + primary_interface: + $ref: '#/components/schemas/nodes.info:NodeInfoNetworkInterface' + refresh_interval: + type: number + required: + - primary_interface + - refresh_interval + nodes.info:NodeInfoNetworkInterface: + type: object + properties: + address: + type: string + mac_address: + type: string + name: + $ref: '#/components/schemas/_common:Name' + required: + - address + - mac_address + - name + nodes.info:NodeInfoOSCPU: + type: object + properties: + cache_size: + type: string + cache_size_in_bytes: + type: number + cores_per_socket: + type: number + mhz: + type: number + model: + type: string + total_cores: + type: number + total_sockets: + type: number + vendor: + type: string + required: + - cache_size + - cache_size_in_bytes + - cores_per_socket + - mhz + - model + - total_cores + - total_sockets + - vendor + nodes.info:NodeInfoPath: + type: object + properties: + logs: + type: string + home: + type: string + repo: + type: array + items: + type: string + data: + type: array + items: + type: string + required: + - logs + - home + - repo + nodes.info:NodeInfoRepositories: + type: object + properties: + url: + $ref: '#/components/schemas/nodes.info:NodeInfoRepositoriesUrl' + required: + - url + nodes.info:NodeInfoRepositoriesUrl: + type: object + properties: + allowed_urls: + type: string + required: + - allowed_urls + nodes.info:NodeInfoScript: + type: object + properties: + allowed_types: + type: string + disable_max_compilations_rate: + type: string + required: + - allowed_types + - disable_max_compilations_rate + nodes.info:NodeInfoSearch: + type: object + properties: + remote: + $ref: '#/components/schemas/nodes.info:NodeInfoSearchRemote' + required: + - remote + nodes.info:NodeInfoSearchRemote: + type: object + properties: + connect: + type: string + required: + - connect + nodes.info:NodeInfoSettings: + type: object + properties: + cluster: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsCluster' + node: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsNode' + path: + $ref: '#/components/schemas/nodes.info:NodeInfoPath' + repositories: + $ref: '#/components/schemas/nodes.info:NodeInfoRepositories' + discovery: + $ref: '#/components/schemas/nodes.info:NodeInfoDiscover' + action: + $ref: '#/components/schemas/nodes.info:NodeInfoAction' + client: + $ref: '#/components/schemas/nodes.info:NodeInfoClient' + http: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsHttp' + bootstrap: + $ref: '#/components/schemas/nodes.info:NodeInfoBootstrap' + transport: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsTransport' + network: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsNetwork' + script: + $ref: '#/components/schemas/nodes.info:NodeInfoScript' + search: + $ref: '#/components/schemas/nodes.info:NodeInfoSearch' + ingest: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsIngest' + required: + - cluster + - node + - path + - client + - http + - transport + nodes.info:NodeInfoSettingsCluster: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + routing: + $ref: '#/components/schemas/indices._common:IndexRouting' + election: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsClusterElection' + initial_master_nodes: + type: string + deprecation_indexing: + $ref: '#/components/schemas/nodes.info:DeprecationIndexing' + required: + - name + - election + nodes.info:NodeInfoSettingsClusterElection: + type: object + properties: + strategy: + $ref: '#/components/schemas/_common:Name' + required: + - strategy + nodes.info:NodeInfoSettingsHttp: + type: object + properties: + type: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsHttpType' + type.default: + type: string + compression: + oneOf: + - type: boolean + - type: string + port: + oneOf: + - type: number + - type: string + required: + - type + nodes.info:NodeInfoSettingsHttpType: + type: object + properties: + default: + type: string + required: + - default + nodes.info:NodeInfoSettingsIngest: + type: object + properties: + attachment: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + append: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + csv: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + convert: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + date: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + date_index_name: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + dot_expander: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + enrich: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + fail: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + foreach: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + json: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + user_agent: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + kv: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + geoip: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + grok: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + gsub: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + join: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + lowercase: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + remove: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + rename: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + script: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + set: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + sort: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + split: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + trim: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + uppercase: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + urldecode: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + bytes: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + dissect: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + set_security_user: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + pipeline: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + drop: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + circle: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + inference: + $ref: '#/components/schemas/nodes.info:NodeInfoIngestInfo' + nodes.info:NodeInfoSettingsNetwork: + type: object + properties: + host: + $ref: '#/components/schemas/_common:Host' + required: + - host + nodes.info:NodeInfoSettingsNode: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + attr: + type: object + additionalProperties: + type: object + max_local_storage_nodes: + type: string + required: + - name + - attr + nodes.info:NodeInfoSettingsTransport: + type: object + properties: + type: + $ref: '#/components/schemas/nodes.info:NodeInfoSettingsTransportType' + type.default: + type: string + required: + - type + nodes.info:NodeInfoSettingsTransportType: + type: object + properties: + default: + type: string + required: + - default + nodes.info:NodeInfoTransport: + type: object + properties: + bound_address: + type: array + items: + type: string + publish_address: + type: string + profiles: + type: object + additionalProperties: + type: string + required: + - bound_address + - publish_address + - profiles + nodes.info:NodeJvmInfo: + type: object + properties: + gc_collectors: + type: array + items: + type: string + mem: + $ref: '#/components/schemas/nodes.info:NodeInfoJvmMemory' + memory_pools: + type: array + items: + type: string + pid: + type: number + start_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + version: + $ref: '#/components/schemas/_common:VersionString' + vm_name: + $ref: '#/components/schemas/_common:Name' + vm_vendor: + type: string + vm_version: + $ref: '#/components/schemas/_common:VersionString' + using_bundled_jdk: + type: boolean + using_compressed_ordinary_object_pointers: + oneOf: + - type: boolean + - type: string + input_arguments: + type: array + items: + type: string + required: + - gc_collectors + - mem + - memory_pools + - pid + - start_time_in_millis + - version + - vm_name + - vm_vendor + - vm_version + - using_bundled_jdk + - input_arguments + nodes.info:NodeOperatingSystemInfo: + type: object + properties: + arch: + description: 'Name of the JVM architecture (ex: amd64, x86)' + type: string + available_processors: + description: Number of processors available to the Java virtual machine + type: number + allocated_processors: + description: The number of processors actually used to calculate thread pool size. This number can be set with the node.processors setting of a node and defaults to the number of processors reported by the OS. + type: number + name: + $ref: '#/components/schemas/_common:Name' + pretty_name: + $ref: '#/components/schemas/_common:Name' + refresh_interval_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + version: + $ref: '#/components/schemas/_common:VersionString' + cpu: + $ref: '#/components/schemas/nodes.info:NodeInfoOSCPU' + mem: + $ref: '#/components/schemas/nodes.info:NodeInfoMemory' + swap: + $ref: '#/components/schemas/nodes.info:NodeInfoMemory' + required: + - arch + - available_processors + - name + - pretty_name + - refresh_interval_in_millis + - version + nodes.info:NodeProcessInfo: + type: object + properties: + id: + description: Process identifier (PID) + type: number + mlockall: + description: Indicates if the process address space has been successfully locked in memory + type: boolean + refresh_interval_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - id + - mlockall + - refresh_interval_in_millis + nodes.info:NodeThreadPoolInfo: + type: object + properties: + core: + type: number + keep_alive: + $ref: '#/components/schemas/_common:Duration' + max: + type: number + queue_size: + type: number + size: + type: number + type: + type: string + required: + - queue_size + - type + nodes.info:ResponseBase: + allOf: + - $ref: '#/components/schemas/nodes._common:NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common:Name' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.info:NodeInfo' + required: + - cluster_name + - nodes + nodes.reload_secure_settings:ResponseBase: + allOf: + - $ref: '#/components/schemas/nodes._common:NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common:Name' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:NodeReloadResult' + required: + - cluster_name + - nodes + nodes.stats:IndexMetric: + type: string + enum: + - store + - indexing + - get + - search + - merge + - flush + - refresh + - query_cache + - fielddata + - docs + - warmer + - completion + - segments + - translog + - suggest + - request_cache + - recovery + - _all + nodes.stats:Metric: + type: string + enum: + - breaker + - fs + - http + - indices + - jvm + - os + - process + - thread_pool + - transport + - discovery + - indexing_pressure + - search_pipeline + - _all + nodes.stats:ResponseBase: + allOf: + - $ref: '#/components/schemas/nodes._common:NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common:Name' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes._common:Stats' + required: + - nodes + nodes.usage:Metric: + type: string + enum: + - rest_actions + - _all + nodes.usage:NodeUsage: + type: object + properties: + rest_actions: + type: object + additionalProperties: + type: number + since: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + timestamp: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + aggregations: + type: object + additionalProperties: + type: object + required: + - rest_actions + - since + - timestamp + - aggregations + nodes.usage:ResponseBase: + allOf: + - $ref: '#/components/schemas/nodes._common:NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common:Name' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.usage:NodeUsage' + required: + - cluster_name + - nodes + notifications._common:Chime: + type: object + properties: + url: + type: string + required: + - url + notifications._common:DeleteConfigsResponse: + type: object + properties: + delete_response_list: + $ref: '#/components/schemas/notifications._common:DeleteResponseList' + notifications._common:DeleteResponseList: + type: object + additionalProperties: + $ref: '#/components/schemas/notifications._common:RestStatus' + notifications._common:DeliveryStatus: + type: object + properties: + status_code: + type: string + status_text: + type: string + notifications._common:Email: + type: object + properties: + email_account_id: + type: string + recipient_list: + type: array + items: + $ref: '#/components/schemas/notifications._common:RecipientListItem' + required: + - email_account_id + notifications._common:EmailEncryptionMethod: + type: string + enum: + - ssl + - start_tls + - none + notifications._common:EmailGroup: + type: object + properties: + recipient_list: + type: array + items: + $ref: '#/components/schemas/notifications._common:RecipientListItem' + email_group_id_list: + type: array + items: + type: string + required: + - recipient_list + notifications._common:EmailRecipientStatus: + type: object + properties: + recipient: + type: string + delivery_status: + $ref: '#/components/schemas/notifications._common:DeliveryStatus' + notifications._common:EventSource: + type: object + properties: + title: + type: string + reference_id: + type: string + severity: + $ref: '#/components/schemas/notifications._common:SeverityType' + tags: + type: array + items: + type: string + notifications._common:EventStatus: + type: object + properties: + config_id: + type: string + config_name: + type: string + config_type: + $ref: '#/components/schemas/notifications._common:NotificationConfigType' + email_recipient_status: + type: array + items: + $ref: '#/components/schemas/notifications._common:EmailRecipientStatus' + delivery_status: + $ref: '#/components/schemas/notifications._common:DeliveryStatus' + notifications._common:GetConfigsResponse: + type: object + properties: + start_index: + type: integer + format: int64 + total_hits: + type: integer + format: int64 + total_hit_relation: + $ref: '#/components/schemas/notifications._common:TotalHitRelation' + config_list: + type: array + maxItems: 1 + items: + $ref: '#/components/schemas/notifications._common:NotificationsConfigsOutputItem' + notifications._common:HeaderParamsMap: + type: object + additionalProperties: + type: integer + format: int32 + notifications._common:HttpMethodType: + type: string + enum: + - POST + - PUT + - PATCH + notifications._common:MicrosoftTeamsItem: + type: object + properties: + url: + type: string + required: + - url + notifications._common:NotificationConfigType: + type: string + description: Type of notification configuration. + enum: + - slack + - chime + - microsoft_teams + - webhook + - email + - sns + - ses_account + - smtp_account + - email_group + notifications._common:NotificationsConfig: + type: object + properties: + config_id: + type: string + config: + $ref: '#/components/schemas/notifications._common:NotificationsConfigItem' + required: + - config + notifications._common:NotificationsConfigItem: + type: object + properties: + name: + type: string + description: + type: string + config_type: + $ref: '#/components/schemas/notifications._common:NotificationConfigType' + is_enabled: + type: boolean + sns: + $ref: '#/components/schemas/notifications._common:SnsItem' + slack: + $ref: '#/components/schemas/notifications._common:SlackItem' + chime: + $ref: '#/components/schemas/notifications._common:Chime' + webhook: + $ref: '#/components/schemas/notifications._common:Webhook' + smtp_account: + $ref: '#/components/schemas/notifications._common:SmtpAccount' + ses_account: + $ref: '#/components/schemas/notifications._common:SesAccount' + email_group: + $ref: '#/components/schemas/notifications._common:EmailGroup' + email: + $ref: '#/components/schemas/notifications._common:Email' + microsoft_teams: + $ref: '#/components/schemas/notifications._common:MicrosoftTeamsItem' + required: + - config_type + - name + notifications._common:NotificationsConfigsOutputItem: + type: object + properties: + config_id: + type: string + last_updated_time_ms: + type: integer + format: int64 + created_time_ms: + type: integer + format: int64 + config: + $ref: '#/components/schemas/notifications._common:NotificationsConfigItem' + notifications._common:NotificationsPluginFeaturesMap: + type: object + additionalProperties: + type: string + notifications._common:RecipientListItem: + type: object + properties: + recipient: + type: string + notifications._common:RestStatus: + type: string + enum: + - continue + - switching_protocols + - ok + - created + - accepted + - non_authoritative_information + - no_content + - reset_content + - partial_content + - multi_status + - multiple_choices + - moved_permanently + - found + - see_other + - not_modified + - use_proxy + - temporary_redirect + notifications._common:SesAccount: + type: object + properties: + region: + type: string + role_arn: + type: string + from_addess: + type: string + required: + - from_addess + - region + notifications._common:SeverityType: + type: string + enum: + - high + - info + - critical + notifications._common:SlackItem: + type: object + properties: + url: + type: string + required: + - url + notifications._common:SmtpAccount: + type: object + properties: + host: + type: string + port: + type: integer + format: int32 + method: + $ref: '#/components/schemas/notifications._common:EmailEncryptionMethod' + from_addess: + type: string + required: + - from_addess + - host + - method + - port + notifications._common:SnsItem: + type: object + properties: + topic_arn: + type: string + role_arn: + type: string + required: + - topic_arn + notifications._common:TotalHitRelation: + type: string + enum: + - eq + - gte + notifications._common:Webhook: + type: object + properties: + url: + type: string + method: + $ref: '#/components/schemas/notifications._common:HttpMethodType' + header_params: + $ref: '#/components/schemas/notifications._common:HeaderParamsMap' + required: + - url + remote_store._common:RemoteStoreRestoreInfo: + type: object + properties: + snapshot: + type: string + indices: + type: array + items: + type: string + shards: + $ref: '#/components/schemas/remote_store._common:RemoteStoreRestoreShardsInfo' + remote_store._common:RemoteStoreRestoreShardsInfo: + type: object + properties: + total: + type: integer + format: int32 + failed: + type: integer + format: int32 + successful: + type: integer + format: int32 + search_pipeline._common:FilterQueryRequestProcessor: + type: object + properties: + tag: + type: string + description: + type: string + ignore_failure: + type: boolean + query: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedObjectStructure' + search_pipeline._common:NeuralFieldMap: + type: object + additionalProperties: + type: string + search_pipeline._common:NeuralQueryEnricherRequestProcessor: + type: object + properties: + tag: + type: string + description: + type: string + default_model_id: + type: string + neural_field_default_id: + $ref: '#/components/schemas/search_pipeline._common:NeuralFieldMap' + search_pipeline._common:NormalizationPhaseResultsProcessor: + type: object + properties: + tag: + type: string + description: + type: string + ignore_failure: + type: boolean + normalization: + $ref: '#/components/schemas/search_pipeline._common:ScoreNormalization' + combination: + $ref: '#/components/schemas/search_pipeline._common:ScoreCombination' + search_pipeline._common:OversampleRequestProcessor: + type: object + properties: + tag: + type: string + description: + type: string + ignore_failure: + type: boolean + sample_factor: + type: number + format: float + content_prefix: + type: string + required: + - sample_factor + search_pipeline._common:PhaseResultsProcessor: + oneOf: + - type: object + title: normalization-processor + properties: + normalization-processor: + $ref: '#/components/schemas/search_pipeline._common:NormalizationPhaseResultsProcessor' + required: + - normalization-processor + search_pipeline._common:RequestProcessor: + oneOf: + - type: object + title: filter_query + properties: + filter_query: + $ref: '#/components/schemas/search_pipeline._common:FilterQueryRequestProcessor' + required: + - filter_query + - type: object + title: neural_query_enricher + properties: + neural_query_enricher: + $ref: '#/components/schemas/search_pipeline._common:NeuralQueryEnricherRequestProcessor' + required: + - neural_query_enricher + - type: object + title: script + properties: + script: + $ref: '#/components/schemas/search_pipeline._common:SearchScriptRequestProcessor' + required: + - script + - type: object + title: oversample + properties: + oversample: + $ref: '#/components/schemas/search_pipeline._common:OversampleRequestProcessor' + required: + - oversample + search_pipeline._common:ScoreCombination: + type: object + properties: + technique: + $ref: '#/components/schemas/search_pipeline._common:ScoreCombinationTechnique' + parameters: + type: array + items: + type: number + format: float + search_pipeline._common:ScoreCombinationTechnique: + type: string + enum: + - arithmetic_mean + - geometric_mean + - harmonic_mean + search_pipeline._common:ScoreNormalization: + type: object + properties: + technique: + $ref: '#/components/schemas/search_pipeline._common:ScoreNormalizationTechnique' + search_pipeline._common:ScoreNormalizationTechnique: + type: string + enum: + - min_max + - l2 + search_pipeline._common:SearchPipelineMap: + type: object + additionalProperties: + $ref: '#/components/schemas/search_pipeline._common:SearchPipelineStructure' + search_pipeline._common:SearchPipelineStructure: + type: object + properties: + version: + type: integer + format: int32 + request_processors: + type: array + items: + $ref: '#/components/schemas/search_pipeline._common:RequestProcessor' + response_processors: + type: array + items: + $ref: '#/components/schemas/search_pipeline._common:RequestProcessor' + phase_results_processors: + type: array + items: + $ref: '#/components/schemas/search_pipeline._common:PhaseResultsProcessor' + search_pipeline._common:SearchScriptRequestProcessor: + type: object + properties: + tag: + type: string + description: + type: string + ignore_failure: + type: boolean + source: + type: string + lang: + type: string + required: + - source + search_pipeline._common:UserDefinedObjectStructure: + type: object + properties: + bool: {} + boosting: {} + combined_fields: {} + constant_score: {} + dis_max: {} + distance_feature: {} + exists: {} + function_score: {} + fuzzy: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + geo_bounding_box: {} + geo_distance: {} + geo_polygon: {} + geo_shape: {} + has_child: {} + has_parent: {} + ids: {} + intervals: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + knn: {} + match: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + match_all: {} + match_bool_prefix: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + match_none: {} + match_phrase: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + match_phrase_prefix: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + more_like_this: {} + multi_match: {} + nested: {} + parent_id: {} + percolate: {} + pinned: {} + prefix: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + query_string: {} + range: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + rank_feature: {} + regexp: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + script: {} + script_score: {} + shape: {} + simple_query_string: {} + span_containing: {} + field_masking_span: {} + span_first: {} + span_multi: {} + span_near: {} + span_not: {} + span_or: {} + span_term: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + span_within: {} + term: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + terms: {} + terms_set: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + wildcard: + $ref: '#/components/schemas/search_pipeline._common:UserDefinedValueMap' + wrapper: {} + search_pipeline._common:UserDefinedValueMap: + type: object + additionalProperties: {} + security._common:AccountDetails: + type: object + properties: + user_name: + type: string + is_reserved: + type: boolean + is_hidden: + type: boolean + is_internal_user: + type: boolean + user_requested_tenant: + type: string + backend_roles: + type: array + items: + type: string + custom_attribute_names: + type: array + items: + type: string + tenants: + $ref: '#/components/schemas/security._common:UserTenants' + roles: + type: array + items: + type: string + security._common:ActionGroupsMap: + type: object + additionalProperties: + $ref: '#/components/schemas/security._common:Action_Group' + security._common:Action_Group: + type: object + properties: + reserved: + type: boolean + hidden: + type: boolean + allowed_actions: + type: array + items: + type: string + type: + type: string + description: + type: string + static: + type: boolean + security._common:AuditConfig: + type: object + properties: + compliance: + $ref: '#/components/schemas/security._common:ComplianceConfig' + enabled: + type: boolean + audit: + $ref: '#/components/schemas/security._common:AuditLogsConfig' + security._common:AuditConfigWithReadOnly: + type: object + properties: + _readonly: + type: array + items: + type: string + config: + $ref: '#/components/schemas/security._common:AuditConfig' + security._common:AuditLogsConfig: + type: object + properties: + ignore_users: + type: array + items: + type: string + ignore_requests: + type: array + items: + type: string + disabled_rest_categories: + type: array + items: + type: string + disabled_transport_categories: + type: array + items: + type: string + log_request_body: + type: boolean + resolve_indices: + type: boolean + resolve_bulk_requests: + type: boolean + exclude_sensitive_headers: + type: boolean + enable_transport: + type: boolean + enable_rest: + type: boolean + security._common:CertificatesDetail: + type: object + properties: + issuer_dn: + type: string + subject_dn: + type: string + san: + type: string + not_before: + type: string + not_after: + type: string + security._common:ChangePasswordRequestContent: + type: object + properties: + current_password: + type: string + description: The current password + password: + type: string + description: The new password to set + required: + - current_password + - password + security._common:ComplianceConfig: + type: object + properties: + enabled: + type: boolean + write_log_diffs: + type: boolean + read_watched_fields: {} + read_ignore_users: + type: array + items: + type: string + write_watched_indices: + type: array + items: + type: string + write_ignore_users: + type: array + items: + type: string + read_metadata_only: + type: boolean + write_metadata_only: + type: boolean + external_config: + type: boolean + internal_config: + type: boolean + security._common:CreateTenantParams: + type: object + properties: + description: + type: string + security._common:DistinguishedNames: + type: object + properties: + nodes_dn: + type: array + items: + type: string + security._common:DistinguishedNamesMap: + type: object + additionalProperties: + $ref: '#/components/schemas/security._common:DistinguishedNames' + security._common:DynamicConfig: + type: object + properties: + dynamic: + $ref: '#/components/schemas/security._common:DynamicOptions' + security._common:DynamicOptions: + type: object + properties: + filteredAliasMode: + type: string + disableRestAuth: + type: boolean + disableIntertransportAuth: + type: boolean + respectRequestIndicesOptions: + type: boolean + kibana: {} + http: {} + authc: {} + authz: {} + authFailureListeners: {} + doNotFailOnForbidden: + type: boolean + multiRolespanEnabled: + type: boolean + hostsResolverMode: + type: string + doNotFailOnForbiddenEmpty: + type: boolean + security._common:IndexPermission: + type: object + properties: + index_patterns: + type: array + items: + type: string + dls: + type: string + fls: + type: array + items: + type: string + masked_fields: + type: array + items: + type: string + allowed_actions: + type: array + items: + type: string + security._common:PatchOperation: + type: object + properties: + op: + type: string + description: 'The operation to perform. Possible values: remove,add, replace, move, copy, test.' + path: + type: string + description: The path to the resource. + value: + description: The new values used for the update. + required: + - op + - path + security._common:Role: + type: object + properties: + reserved: + type: boolean + hidden: + type: boolean + description: + type: string + cluster_permissions: + type: array + items: + type: string + index_permissions: + type: array + items: + $ref: '#/components/schemas/security._common:IndexPermission' + tenant_permissions: + type: array + items: + $ref: '#/components/schemas/security._common:TenantPermission' + static: + type: boolean + security._common:RoleMapping: + type: object + properties: + hosts: + type: array + items: + type: string + users: + type: array + items: + type: string + reserved: + type: boolean + hidden: + type: boolean + backend_roles: + type: array + items: + type: string + and_backend_roles: + type: array + items: + type: string + description: + type: string + security._common:RoleMappings: + type: object + additionalProperties: + $ref: '#/components/schemas/security._common:RoleMapping' + security._common:RolesMap: + type: object + additionalProperties: + $ref: '#/components/schemas/security._common:Role' + security._common:Tenant: + type: object + properties: + reserved: + type: boolean + hidden: + type: boolean + description: + type: string + static: + type: boolean + security._common:TenantPermission: + type: object + properties: + tenant_patterns: + type: array + items: + type: string + allowed_actions: + type: array + items: + type: string + security._common:TenantsMap: + type: object + additionalProperties: + $ref: '#/components/schemas/security._common:Tenant' + security._common:User: + type: object + properties: + hash: + type: string + reserved: + type: boolean + hidden: + type: boolean + backend_roles: + type: array + items: + type: string + attributes: + $ref: '#/components/schemas/security._common:UserAttributes' + description: + type: string + opendistro_security_roles: + type: array + items: + type: string + static: + type: boolean + security._common:UserAttributes: + type: object + additionalProperties: + type: string + security._common:UserTenants: + type: object + properties: + global_tenant: + type: boolean + admin_tenant: + type: boolean + admin: + type: boolean + security._common:UsersMap: + type: object + additionalProperties: + $ref: '#/components/schemas/security._common:User' + snapshot._common:FileCountSnapshotStats: + type: object + properties: + file_count: + type: number + size_in_bytes: + type: number + required: + - file_count + - size_in_bytes + snapshot._common:IndexDetails: + type: object + properties: + shard_count: + type: number + size: + $ref: '#/components/schemas/_common:ByteSize' + size_in_bytes: + type: number + max_segments_per_shard: + type: number + required: + - shard_count + - size_in_bytes + - max_segments_per_shard + snapshot._common:InfoFeatureState: + type: object + properties: + feature_name: + type: string + indices: + $ref: '#/components/schemas/_common:Indices' + required: + - feature_name + - indices + snapshot._common:Repository: + type: object + properties: + type: + type: string + uuid: + $ref: '#/components/schemas/_common:Uuid' + settings: + $ref: '#/components/schemas/snapshot._common:RepositorySettings' + required: + - type + - settings + snapshot._common:RepositorySettings: + type: object + properties: + chunk_size: + type: string + compress: + oneOf: + - type: string + - type: boolean + concurrent_streams: + oneOf: + - type: string + - type: number + location: + type: string + read_only: + oneOf: + - type: string + - type: boolean + required: + - location + snapshot._common:ShardsStats: + type: object + properties: + done: + type: number + failed: + type: number + finalizing: + type: number + initializing: + type: number + started: + type: number + total: + type: number + required: + - done + - failed + - finalizing + - initializing + - started + - total + snapshot._common:ShardsStatsStage: + type: string + enum: + - DONE + - FAILURE + - FINALIZE + - INIT + - STARTED + snapshot._common:ShardsStatsSummary: + type: object + properties: + incremental: + $ref: '#/components/schemas/snapshot._common:ShardsStatsSummaryItem' + total: + $ref: '#/components/schemas/snapshot._common:ShardsStatsSummaryItem' + start_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + time: + $ref: '#/components/schemas/_common:Duration' + time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + required: + - incremental + - total + - start_time_in_millis + - time_in_millis + snapshot._common:ShardsStatsSummaryItem: + type: object + properties: + file_count: + type: number + size_in_bytes: + type: number + required: + - file_count + - size_in_bytes + snapshot._common:SnapshotIndexStats: + type: object + properties: + shards: + type: object + additionalProperties: + $ref: '#/components/schemas/snapshot._common:SnapshotShardsStatus' + shards_stats: + $ref: '#/components/schemas/snapshot._common:ShardsStats' + stats: + $ref: '#/components/schemas/snapshot._common:SnapshotStats' + required: + - shards + - shards_stats + - stats + snapshot._common:SnapshotInfo: + type: object + properties: + data_streams: + type: array + items: + type: string + duration: + $ref: '#/components/schemas/_common:Duration' + duration_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + end_time: + $ref: '#/components/schemas/_common:DateTime' + end_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + failures: + type: array + items: + $ref: '#/components/schemas/snapshot._common:SnapshotShardFailure' + include_global_state: + type: boolean + indices: + type: array + items: + $ref: '#/components/schemas/_common:IndexName' + index_details: + type: object + additionalProperties: + $ref: '#/components/schemas/snapshot._common:IndexDetails' + metadata: + $ref: '#/components/schemas/_common:Metadata' + reason: + type: string + repository: + $ref: '#/components/schemas/_common:Name' + snapshot: + $ref: '#/components/schemas/_common:Name' + shards: + $ref: '#/components/schemas/_common:ShardStatistics' + start_time: + $ref: '#/components/schemas/_common:DateTime' + start_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + state: + type: string + uuid: + $ref: '#/components/schemas/_common:Uuid' + version: + $ref: '#/components/schemas/_common:VersionString' + version_id: + $ref: '#/components/schemas/_common:VersionNumber' + feature_states: + type: array + items: + $ref: '#/components/schemas/snapshot._common:InfoFeatureState' + required: + - data_streams + - snapshot + - uuid + snapshot._common:SnapshotShardFailure: + type: object + properties: + index: + $ref: '#/components/schemas/_common:IndexName' + node_id: + $ref: '#/components/schemas/_common:Id' + reason: + type: string + shard_id: + $ref: '#/components/schemas/_common:Id' + status: + type: string + required: + - index + - reason + - shard_id + - status + snapshot._common:SnapshotShardsStatus: + type: object + properties: + stage: + $ref: '#/components/schemas/snapshot._common:ShardsStatsStage' + stats: + $ref: '#/components/schemas/snapshot._common:ShardsStatsSummary' + required: + - stage + - stats + snapshot._common:SnapshotStats: + type: object + properties: + incremental: + $ref: '#/components/schemas/snapshot._common:FileCountSnapshotStats' + start_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + time: + $ref: '#/components/schemas/_common:Duration' + time_in_millis: + $ref: '#/components/schemas/_common:DurationValueUnitMillis' + total: + $ref: '#/components/schemas/snapshot._common:FileCountSnapshotStats' + required: + - incremental + - start_time_in_millis + - time_in_millis + - total + snapshot._common:Status: + type: object + properties: + include_global_state: + type: boolean + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/snapshot._common:SnapshotIndexStats' + repository: + type: string + shards_stats: + $ref: '#/components/schemas/snapshot._common:ShardsStats' + snapshot: + type: string + state: + type: string + stats: + $ref: '#/components/schemas/snapshot._common:SnapshotStats' + uuid: + $ref: '#/components/schemas/_common:Uuid' + required: + - include_global_state + - indices + - repository + - shards_stats + - snapshot + - state + - stats + - uuid + snapshot.cleanup_repository:CleanupRepositoryResults: + type: object + properties: + deleted_blobs: + description: Number of binary large objects (blobs) removed during cleanup. + type: number + deleted_bytes: + description: Number of bytes freed by cleanup operations. + type: number + required: + - deleted_blobs + - deleted_bytes + snapshot.get:SnapshotResponseItem: + type: object + properties: + repository: + $ref: '#/components/schemas/_common:Name' + snapshots: + type: array + items: + $ref: '#/components/schemas/snapshot._common:SnapshotInfo' + error: + $ref: '#/components/schemas/_common:ErrorCause' + required: + - repository + snapshot.restore:SnapshotRestore: + type: object + properties: + indices: + type: array + items: + $ref: '#/components/schemas/_common:IndexName' + snapshot: + type: string + shards: + $ref: '#/components/schemas/_common:ShardStatistics' + required: + - indices + - snapshot + - shards + snapshot.verify_repository:CompactNodeInfo: + type: object + properties: + name: + $ref: '#/components/schemas/_common:Name' + required: + - name + tasks._common:GroupBy: + type: string + enum: + - nodes + - parents + - none + tasks._common:NodeTasks: + type: object + properties: + name: + $ref: '#/components/schemas/_common:NodeId' + transport_address: + $ref: '#/components/schemas/_common:TransportAddress' + host: + $ref: '#/components/schemas/_common:Host' + ip: + $ref: '#/components/schemas/_common:Ip' + roles: + type: array + items: + type: string + attributes: + type: object + additionalProperties: + type: string + tasks: + type: object + additionalProperties: + $ref: '#/components/schemas/tasks._common:TaskInfo' + required: + - tasks + tasks._common:ParentTaskInfo: + allOf: + - $ref: '#/components/schemas/tasks._common:TaskInfo' + - type: object + properties: + children: + type: array + items: + $ref: '#/components/schemas/tasks._common:TaskInfo' + tasks._common:TaskInfo: + type: object + properties: + action: + type: string + cancelled: + type: boolean + cancellable: + type: boolean + description: + type: string + headers: + type: object + additionalProperties: + type: string + id: + type: number + node: + $ref: '#/components/schemas/_common:NodeId' + running_time: + $ref: '#/components/schemas/_common:Duration' + running_time_in_nanos: + $ref: '#/components/schemas/_common:DurationValueUnitNanos' + start_time_in_millis: + $ref: '#/components/schemas/_common:EpochTimeUnitMillis' + status: + description: Task status information can vary wildly from task to task. + type: object + type: + type: string + parent_task_id: + $ref: '#/components/schemas/_common:TaskId' + required: + - action + - cancellable + - headers + - id + - node + - running_time_in_nanos + - start_time_in_millis + - type + tasks._common:TaskInfos: + oneOf: + - type: array + items: + $ref: '#/components/schemas/tasks._common:TaskInfo' + - type: object + additionalProperties: + $ref: '#/components/schemas/tasks._common:ParentTaskInfo' + tasks._common:TaskListResponseBase: + type: object + properties: + node_failures: + type: array + items: + $ref: '#/components/schemas/_common:ErrorCause' + task_failures: + type: array + items: + $ref: '#/components/schemas/_common:TaskFailure' + nodes: + description: Task information grouped by node, if `group_by` was set to `node` (the default). + type: object + additionalProperties: + $ref: '#/components/schemas/tasks._common:NodeTasks' + tasks: + $ref: '#/components/schemas/tasks._common:TaskInfos' diff --git a/src/OpenSearch.Client/Cluster/ClusterHealth/ClusterHealthResponse.cs b/src/OpenSearch.Client/Cluster/ClusterHealth/ClusterHealthResponse.cs index 7acdfcbdfc..37dde3bdad 100644 --- a/src/OpenSearch.Client/Cluster/ClusterHealth/ClusterHealthResponse.cs +++ b/src/OpenSearch.Client/Cluster/ClusterHealth/ClusterHealthResponse.cs @@ -75,7 +75,7 @@ public class ClusterHealthResponse : ResponseBase public int RelocatingShards { get; internal set; } [DataMember(Name = "status")] - public Health Status { get; internal set; } + public HealthStatus Status { get; internal set; } [DataMember(Name = "task_max_waiting_in_queue_millis")] public long TaskMaxWaitTimeInQueueInMilliseconds { get; internal set; } diff --git a/src/OpenSearch.Client/Cluster/ClusterHealth/IndexHealthStats.cs b/src/OpenSearch.Client/Cluster/ClusterHealth/IndexHealthStats.cs index e744c25307..5acca17c9a 100644 --- a/src/OpenSearch.Client/Cluster/ClusterHealth/IndexHealthStats.cs +++ b/src/OpenSearch.Client/Cluster/ClusterHealth/IndexHealthStats.cs @@ -59,7 +59,7 @@ public class IndexHealthStats public IReadOnlyDictionary Shards { get; internal set; } = EmptyReadOnly.Dictionary; [DataMember(Name = "status")] - public Health Status { get; internal set; } + public HealthStatus Status { get; internal set; } [DataMember(Name = "unassigned_shards")] public int UnassignedShards { get; internal set; } diff --git a/src/OpenSearch.Client/Cluster/ClusterHealth/ShardHealthStats.cs b/src/OpenSearch.Client/Cluster/ClusterHealth/ShardHealthStats.cs index ab229f9ab3..2974106f2f 100644 --- a/src/OpenSearch.Client/Cluster/ClusterHealth/ShardHealthStats.cs +++ b/src/OpenSearch.Client/Cluster/ClusterHealth/ShardHealthStats.cs @@ -47,7 +47,7 @@ public class ShardHealthStats public int RelocatingShards { get; internal set; } [DataMember(Name ="status")] - public Health Status { get; internal set; } + public HealthStatus Status { get; internal set; } [DataMember(Name ="unassigned_shards")] public int UnassignedShards { get; internal set; } diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Cat.cs b/src/OpenSearch.Client/_Generated/Descriptors.Cat.cs index a35fb0c7f2..855fc353c9 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Cat.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Cat.cs @@ -80,7 +80,7 @@ public CatAliasesDescriptor(Names name) // values part of the url path Names ICatAliasesRequest.Name => Self.RouteValues.Get("name"); - /// Comma-separated list of alias names. + /// A comma-separated list of aliases to retrieve. Supports wildcards (`*`). To retrieve all aliases, omit this parameter or use `*` or `_all`. public CatAliasesDescriptor Name(Names name) => Assign(name, (a, v) => a.RouteValues.Optional("name", v)); @@ -165,12 +165,12 @@ public CatAllocationDescriptor(NodeIds nodeId) // values part of the url path NodeIds ICatAllocationRequest.NodeId => Self.RouteValues.Get("node_id"); - /// Comma-separated list of node IDs or names to limit the returned information. + /// Comma-separated list of node identifiers or names used to limit the returned information. public CatAllocationDescriptor NodeId(NodeIds nodeId) => Assign(nodeId, (a, v) => a.RouteValues.Optional("node_id", v)); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public CatAllocationDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes); /// Operation timeout for connection to cluster-manager node. @@ -269,7 +269,7 @@ public CatCountDescriptor(Indices index) // values part of the url path Indices ICatCountRequest.Index => Self.RouteValues.Get("index"); - /// Comma-separated list of indices to limit the returned information. + /// Comma-separated list of data streams, indices, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`. public CatCountDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -322,16 +322,16 @@ public CatFielddataDescriptor(Fields fields) // values part of the url path Fields ICatFielddataRequest.Fields => Self.RouteValues.Get("fields"); - /// Comma-separated list of fields to return the fielddata size. + /// Comma-separated list of fields used to limit returned information. To retrieve all fields, omit this parameter. public CatFielddataDescriptor Fields(Fields fields) => Assign(fields, (a, v) => a.RouteValues.Optional("fields", v)); - /// Comma-separated list of fields to return the fielddata size. + /// Comma-separated list of fields used to limit returned information. To retrieve all fields, omit this parameter. public CatFielddataDescriptor Fields(params Expression>[] fields) => Assign(fields, (a, v) => a.RouteValues.Optional("fields", (Fields)v)); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public CatFielddataDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes); /// A short version of the Accept header, e.g. json, yaml. @@ -369,7 +369,7 @@ public partial class CatHealthDescriptor /// Return help information. public CatHealthDescriptor Help(bool? help = true) => Qs("help", help); - /// Set to false to disable timestamping. + /// If true, returns `HH:MM:SS` and Unix epoch timestamps. public CatHealthDescriptor IncludeTimestamp(bool? includetimestamp = true) => Qs("ts", includetimestamp); @@ -421,7 +421,7 @@ public CatIndicesDescriptor(Indices index) // values part of the url path Indices ICatIndicesRequest.Index => Self.RouteValues.Get("index"); - /// Comma-separated list of indices to limit the returned information. + /// Comma-separated list of data streams, indices, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`. public CatIndicesDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -434,7 +434,7 @@ public CatIndicesDescriptor Index() public CatIndicesDescriptor AllIndices() => Index(Indices.All); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public CatIndicesDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes); /// Operation timeout for connection to cluster-manager node. @@ -442,7 +442,7 @@ public CatIndicesDescriptor Index() public CatIndicesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Whether to expand wildcard expression to concrete indices that are open, closed or both. + /// The type of index that wildcard patterns can match. public CatIndicesDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards); @@ -452,13 +452,13 @@ public CatIndicesDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => /// Comma-separated list of column names to display. public CatIndicesDescriptor Headers(params string[] headers) => Qs("h", headers); - /// Health status ('green', 'yellow', or 'red') to filter only indices matching the specified health status. - public CatIndicesDescriptor Health(Health? health) => Qs("health", health); + /// The health status used to limit returned indices. By default, the response includes indices of any health status. + public CatIndicesDescriptor Health(HealthStatus? health) => Qs("health", health); /// Return help information. public CatIndicesDescriptor Help(bool? help = true) => Qs("help", help); - /// If set to true segment stats will include stats for segments that are not currently loaded into memory. + /// If true, the response includes information from segments that are not loaded into memory. public CatIndicesDescriptor IncludeUnloadedSegments(bool? includeunloadedsegments = true) => Qs("include_unloaded_segments", includeunloadedsegments); @@ -472,7 +472,7 @@ public CatIndicesDescriptor IncludeUnloadedSegments(bool? includeunloadedsegment public CatIndicesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Set to true to return stats only for primary shards. + /// If true, the response only includes information from primary shards. public CatIndicesDescriptor Pri(bool? pri = true) => Qs("pri", pri); /// Comma-separated list of column names or column aliases to sort by. @@ -578,7 +578,7 @@ public partial class CatNodesDescriptor // values part of the url path // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public CatNodesDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes); /// Operation timeout for connection to cluster-manager node. @@ -589,7 +589,7 @@ public CatNodesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => /// A short version of the Accept header, e.g. json, yaml. public CatNodesDescriptor Format(string format) => Qs("format", format); - /// Return the full node ID instead of the shortened version. + /// If `true`, return the full node ID. If `false`, return the shortened node ID. public CatNodesDescriptor FullId(bool? fullid = true) => Qs("full_id", fullid); /// Comma-separated list of column names to display. @@ -765,7 +765,7 @@ public CatRecoveryDescriptor(Indices index) // values part of the url path Indices ICatRecoveryRequest.Index => Self.RouteValues.Get("index"); - /// Comma-separated list or wildcard expression of index names to limit the returned information. + /// A comma-separated list of data streams, indices, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`. public CatRecoveryDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -782,7 +782,7 @@ public CatRecoveryDescriptor Index() public CatRecoveryDescriptor ActiveOnly(bool? activeonly = true) => Qs("active_only", activeonly); - /// The unit in which to display byte values. + /// The unit used to display byte values. public CatRecoveryDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes); /// If `true`, the response includes detailed information about shard recoveries. @@ -964,7 +964,7 @@ public CatSegmentsDescriptor(Indices index) // values part of the url path Indices ICatSegmentsRequest.Index => Self.RouteValues.Get("index"); - /// Comma-separated list of indices to limit the returned information. + /// A comma-separated list of data streams, indices, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`. public CatSegmentsDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -977,7 +977,7 @@ public CatSegmentsDescriptor Index() public CatSegmentsDescriptor AllIndices() => Index(Indices.All); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public CatSegmentsDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes); /// Operation timeout for connection to cluster-manager node. @@ -1028,7 +1028,7 @@ public CatShardsDescriptor(Indices index) // values part of the url path Indices ICatShardsRequest.Index => Self.RouteValues.Get("index"); - /// Comma-separated list of indices to limit the returned information. + /// A comma-separated list of data streams, indices, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indices, omit this parameter or use `*` or `_all`. public CatShardsDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -1041,7 +1041,7 @@ public CatShardsDescriptor Index() public CatShardsDescriptor AllIndices() => Index(Indices.All); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public CatShardsDescriptor Bytes(Bytes? bytes) => Qs("bytes", bytes); /// Operation timeout for connection to cluster-manager node. @@ -1099,7 +1099,7 @@ public CatSnapshotsDescriptor(Names repository) // values part of the url path Names ICatSnapshotsRequest.RepositoryName => Self.RouteValues.Get("repository"); - /// Comma-separated list of repository names. + /// A comma-separated list of snapshot repositories used to limit the request. Accepts wildcard expressions. `_all` returns all repositories. If any repository fails during the request, Opensearch returns an error. public CatSnapshotsDescriptor RepositoryName(Names repository) => Assign(repository, (a, v) => a.RouteValues.Optional("repository", v)); @@ -1118,7 +1118,7 @@ public CatSnapshotsDescriptor ClusterManagerTimeout(Time clustermanagertimeout) /// Return help information. public CatSnapshotsDescriptor Help(bool? help = true) => Qs("help", help); - /// Whether specified concrete indices should be ignored when unavailable (missing or closed). + /// If `true`, the response does not include information from unavailable snapshots. public CatSnapshotsDescriptor IgnoreUnavailable(bool? ignoreunavailable = true) => Qs("ignore_unavailable", ignoreunavailable); @@ -1146,10 +1146,10 @@ public partial class CatTasksDescriptor // values part of the url path // Request parameters - /// Comma-separated list of actions that should be returned. Leave empty to return all. + /// The task action names, which are used to limit the response. public CatTasksDescriptor Actions(params string[] actions) => Qs("actions", actions); - /// Return detailed task information. + /// If `true`, the response includes detailed information about shard recoveries. public CatTasksDescriptor Detailed(bool? detailed = true) => Qs("detailed", detailed); /// A short version of the Accept header, e.g. json, yaml. @@ -1164,7 +1164,7 @@ public partial class CatTasksDescriptor /// 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. public CatTasksDescriptor Nodes(params string[] nodes) => Qs("nodes", nodes); - /// Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all. + /// The parent task identifier, which is used to limit the response. public CatTasksDescriptor ParentTaskId(string parenttaskid) => Qs("parent_task_id", parenttaskid); @@ -1199,7 +1199,7 @@ public CatTemplatesDescriptor(Name name) // values part of the url path Name ICatTemplatesRequest.Name => Self.RouteValues.Get("name"); - /// The name of the template. + /// The name of the template to return. Accepts wildcard expressions. If omitted, all templates are returned. public CatTemplatesDescriptor Name(Name name) => Assign(name, (a, v) => a.RouteValues.Optional("name", v)); @@ -1260,7 +1260,7 @@ public CatThreadPoolDescriptor(Names threadPoolPatterns) Names ICatThreadPoolRequest.ThreadPoolPatterns => Self.RouteValues.Get("thread_pool_patterns"); - /// Comma-separated list of regular-expressions to filter the thread pools in the output. + /// A comma-separated list of thread pool names used to limit the request. Accepts wildcard expressions. public CatThreadPoolDescriptor ThreadPoolPatterns(Names threadPoolPatterns) => Assign(threadPoolPatterns, (a, v) => a.RouteValues.Optional("thread_pool_patterns", v)); diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Cluster.cs b/src/OpenSearch.Client/_Generated/Descriptors.Cluster.cs index 75dbc7a633..30c6705853 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Cluster.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Cluster.cs @@ -70,11 +70,11 @@ public partial class ClusterAllocationExplainDescriptor // values part of the url path // Request parameters - /// Return information about disk usage and shard sizes. + /// If true, returns information about disk usage and shard sizes. public ClusterAllocationExplainDescriptor IncludeDiskInfo(bool? includediskinfo = true) => Qs("include_disk_info", includediskinfo); - /// Return 'YES' decisions in explanation. + /// If true, returns YES decisions in explanation. public ClusterAllocationExplainDescriptor IncludeYesDecisions( bool? includeyesdecisions = true ) => Qs("include_yes_decisions", includeyesdecisions); @@ -111,14 +111,14 @@ public DeleteComponentTemplateDescriptor ClusterManagerTimeout( Time clustermanagertimeout ) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public DeleteComponentTemplateDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public DeleteComponentTemplateDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -135,7 +135,7 @@ public partial class DeleteVotingConfigExclusionsDescriptor // values part of the url path // Request parameters - /// Specifies whether to wait for all excluded nodes to be removed from the cluster before clearing the voting configuration exclusions list. + /// Specifies whether to wait for all excluded nodes to be removed from the cluster before clearing the voting configuration exclusions list. Defaults to true, meaning that all excluded nodes must be removed from the cluster before this API takes any action. If set to false then the voting configuration exclusions list is cleared even if some excluded nodes are still in the cluster. public DeleteVotingConfigExclusionsDescriptor WaitForRemoval(bool? waitforremoval = true) => Qs("wait_for_removal", waitforremoval); } @@ -171,10 +171,10 @@ public ComponentTemplateExistsDescriptor ClusterManagerTimeout( Time clustermanagertimeout ) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Return local information, do not retrieve the state from cluster-manager node. + /// If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. public ComponentTemplateExistsDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -199,14 +199,14 @@ public GetComponentTemplateDescriptor() /// /_component_template/{name} /// Optional, accepts null - public GetComponentTemplateDescriptor(Names name) + public GetComponentTemplateDescriptor(Name name) : base(r => r.Optional("name", name)) { } // values part of the url path - Names IGetComponentTemplateRequest.Name => Self.RouteValues.Get("name"); + Name IGetComponentTemplateRequest.Name => Self.RouteValues.Get("name"); - /// The Comma-separated names of the component templates. - public GetComponentTemplateDescriptor Name(Names name) => + /// Name of the component template to retrieve. Wildcard (`*`) expressions are supported. + public GetComponentTemplateDescriptor Name(Name name) => Assign(name, (a, v) => a.RouteValues.Optional("name", v)); // Request parameters @@ -215,10 +215,10 @@ public GetComponentTemplateDescriptor Name(Names name) => public GetComponentTemplateDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Return local information, do not retrieve the state from cluster-manager node. + /// If `true`, the request retrieves information from the local node only. If `false`, information is retrieved from the master node. public GetComponentTemplateDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -244,22 +244,22 @@ public partial class ClusterGetSettingsDescriptor public ClusterGetSettingsDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Return settings in flat format. + /// If `true`, returns settings in flat format. public ClusterGetSettingsDescriptor FlatSettings(bool? flatsettings = true) => Qs("flat_settings", flatsettings); - /// Whether to return all default clusters setting. + /// If `true`, returns default cluster settings from the local node. public ClusterGetSettingsDescriptor IncludeDefaults(bool? includedefaults = true) => Qs("include_defaults", includedefaults); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public ClusterGetSettingsDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public ClusterGetSettingsDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -286,7 +286,7 @@ public ClusterHealthDescriptor(Indices index) // values part of the url path Indices IClusterHealthRequest.Index => Self.RouteValues.Get("index"); - /// Limit the information returned to specific indicies. + /// Comma-separated list of data streams, indices, and index aliases used to limit the request. Wildcard expressions (*) are supported. To target all data streams and indices in a cluster, omit this parameter or use _all or *. public ClusterHealthDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -303,10 +303,6 @@ public ClusterHealthDescriptor Index() public ClusterHealthDescriptor AwarenessAttribute(string awarenessattribute) => Qs("awareness_attribute", awarenessattribute); - /// Specify the level of detail for returned information. - public ClusterHealthDescriptor ClusterHealthLevel(ClusterHealthLevel? clusterhealthlevel) => - Qs("level", clusterhealthlevel); - /// Operation timeout for connection to cluster-manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public ClusterHealthDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => @@ -316,43 +312,46 @@ public ClusterHealthDescriptor ClusterManagerTimeout(Time clustermanagertimeout) public ClusterHealthDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Can be one of cluster, indices or shards. Controls the details level of the health information returned. + public ClusterHealthDescriptor Level(ClusterHealthLevel? level) => Qs("level", level); + + /// If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. public ClusterHealthDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public ClusterHealthDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public ClusterHealthDescriptor Timeout(Time timeout) => Qs("timeout", timeout); - /// Wait until the specified number of shards is active. + /// A number controlling to how many active shards to wait for, all to wait for all shards in the cluster to be active, or 0 to not wait. public ClusterHealthDescriptor WaitForActiveShards(string waitforactiveshards) => Qs("wait_for_active_shards", waitforactiveshards); - /// Wait until all currently queued events with the given priority are processed. + /// Can be one of immediate, urgent, high, normal, low, languid. Wait until all currently queued events with the given priority are processed. public ClusterHealthDescriptor WaitForEvents(WaitForEvents? waitforevents) => Qs("wait_for_events", waitforevents); - /// Wait until the specified number of nodes is available. + /// The request waits until the specified number N of nodes is available. It also accepts >=N, <=N, >N and public ClusterHealthDescriptor WaitForNodes(string waitfornodes) => Qs("wait_for_nodes", waitfornodes); - /// Whether to wait until there are no initializing shards in the cluster. + /// A boolean value which controls whether to wait (until the timeout provided) for the cluster to have no shard initializations. Defaults to false, which means it will not wait for initializing shards. public ClusterHealthDescriptor WaitForNoInitializingShards( bool? waitfornoinitializingshards = true ) => Qs("wait_for_no_initializing_shards", waitfornoinitializingshards); - /// Whether to wait until there are no relocating shards in the cluster. + /// A boolean value which controls whether to wait (until the timeout provided) for the cluster to have no shard relocations. Defaults to false, which means it will not wait for relocating shards. public ClusterHealthDescriptor WaitForNoRelocatingShards( bool? waitfornorelocatingshards = true ) => Qs("wait_for_no_relocating_shards", waitfornorelocatingshards); - /// Wait until cluster is in a specific state. - public ClusterHealthDescriptor WaitForStatus(WaitForStatus? waitforstatus) => + /// One of green, yellow or red. Will wait (until the timeout provided) until the status of the cluster changes to the one provided or better, i.e. green > yellow > red. By default, will not wait for any status. + public ClusterHealthDescriptor WaitForStatus(HealthStatus? waitforstatus) => Qs("wait_for_status", waitforstatus); } @@ -374,10 +373,10 @@ public partial class ClusterPendingTasksDescriptor public ClusterPendingTasksDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Return local information, do not retrieve the state from cluster-manager node. + /// If `true`, the request retrieves information from the local node only. If `false`, information is retrieved from the master node. public ClusterPendingTasksDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -398,15 +397,15 @@ public partial class PostVotingConfigExclusionsDescriptor // values part of the url path // Request parameters - /// Comma-separated list of the persistent ids of the nodes to exclude from the voting configuration. If specified, you may not also specify ?node_names. - public PostVotingConfigExclusionsDescriptor NodeIds(string nodeids) => + /// A comma-separated list of the persistent ids of the nodes to exclude from the voting configuration. If specified, you may not also specify node_names. + public PostVotingConfigExclusionsDescriptor NodeIds(params string[] nodeids) => Qs("node_ids", nodeids); - /// Comma-separated list of the names of the nodes to exclude from the voting configuration. If specified, you may not also specify ?node_ids. - public PostVotingConfigExclusionsDescriptor NodeNames(string nodenames) => + /// A comma-separated list of the names of the nodes to exclude from the voting configuration. If specified, you may not also specify node_ids. + public PostVotingConfigExclusionsDescriptor NodeNames(params string[] nodenames) => Qs("node_names", nodenames); - /// Operation timeout. + /// When adding a voting configuration exclusion, the API waits for the specified nodes to be excluded from the voting configuration before returning. If the timeout expires before the appropriate condition is satisfied, the request fails and returns an error. public PostVotingConfigExclusionsDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -440,10 +439,10 @@ protected PutComponentTemplateDescriptor() public PutComponentTemplateDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Whether the index template should only be added if new or can also replace an existing one. + /// If `true`, this request cannot replace or update existing component templates. public PutComponentTemplateDescriptor Create(bool? create = true) => Qs("create", create); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -472,18 +471,18 @@ public partial class ClusterPutSettingsDescriptor public ClusterPutSettingsDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Return settings in flat format. + /// Return settings in flat format (default: false). public ClusterPutSettingsDescriptor FlatSettings(bool? flatsettings = true) => Qs("flat_settings", flatsettings); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public ClusterPutSettingsDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Explicit operation timeout. public ClusterPutSettingsDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -519,27 +518,27 @@ public partial class ClusterRerouteDescriptor public ClusterRerouteDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Simulate the operation only and return the resulting state. + /// If true, then the request simulates the operation only and returns the resulting state. public ClusterRerouteDescriptor DryRun(bool? dryrun = true) => Qs("dry_run", dryrun); - /// Return an explanation of why the commands can or cannot be executed. + /// If true, then the response contains an explanation of why the commands can or cannot be executed. public ClusterRerouteDescriptor Explain(bool? explain = true) => Qs("explain", explain); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public ClusterRerouteDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Limit the information returned to the specified metrics. Defaults to all but metadata. + /// Limits the information returned to the specified metrics. public ClusterRerouteDescriptor Metric(params string[] metric) => Qs("metric", metric); - /// Retries allocation of shards that are blocked due to too many subsequent allocation failures. + /// If true, then retries allocation of shards that are blocked due to too many subsequent allocation failures. public ClusterRerouteDescriptor RetryFailed(bool? retryfailed = true) => Qs("retry_failed", retryfailed); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public ClusterRerouteDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -573,7 +572,7 @@ public ClusterStateDescriptor(Metrics metric, Indices index) Indices IClusterStateRequest.Index => Self.RouteValues.Get("index"); Metrics IClusterStateRequest.Metric => Self.RouteValues.Get("metric"); - /// Comma-separated list of indices; use the special string `_all` or Indices.All to perform the operation on all indices. + /// A comma-separated list of index names; use the special string `_all` or Indices.All to perform the operation on all indices. public ClusterStateDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -603,7 +602,7 @@ public ClusterStateDescriptor ClusterManagerTimeout(Time clustermanagertimeout) public ClusterStateDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards); - /// Return settings in flat format. + /// Return settings in flat format (default: false). public ClusterStateDescriptor FlatSettings(bool? flatsettings = true) => Qs("flat_settings", flatsettings); @@ -611,10 +610,10 @@ public ClusterStateDescriptor FlatSettings(bool? flatsettings = true) => public ClusterStateDescriptor IgnoreUnavailable(bool? ignoreunavailable = true) => Qs("ignore_unavailable", ignoreunavailable); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Return local information, do not retrieve the state from cluster-manager node (default: false). public ClusterStateDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to master node. + /// Specify timeout for connection to master. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -653,16 +652,16 @@ public ClusterStatsDescriptor(NodeIds nodeId) // values part of the url path NodeIds IClusterStatsRequest.NodeId => Self.RouteValues.Get("node_id"); - /// 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. + /// Comma-separated list of node filters used to limit returned information. Defaults to all nodes in the cluster. public ClusterStatsDescriptor NodeId(NodeIds nodeId) => Assign(nodeId, (a, v) => a.RouteValues.Optional("node_id", v)); // Request parameters - /// Return settings in flat format. + /// If `true`, returns settings in flat format. public ClusterStatsDescriptor FlatSettings(bool? flatsettings = true) => Qs("flat_settings", flatsettings); - /// Operation timeout. + /// Period to wait for each node to respond. If a node does not respond before its timeout expires, the response does not include its stats. However, timed out nodes are included in the response’s `_nodes.failed` property. Defaults to no timeout. public ClusterStatsDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } } diff --git a/src/OpenSearch.Client/_Generated/Descriptors.DanglingIndices.cs b/src/OpenSearch.Client/_Generated/Descriptors.DanglingIndices.cs index 41b073e5cc..b27f71aa69 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.DanglingIndices.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.DanglingIndices.cs @@ -92,14 +92,14 @@ public DeleteDanglingIndexDescriptor AcceptDataLoss(bool? acceptdataloss = true) public DeleteDanglingIndexDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Specify timeout for connection to master. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public DeleteDanglingIndexDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Explicit operation timeout. public DeleteDanglingIndexDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -138,14 +138,14 @@ public ImportDanglingIndexDescriptor AcceptDataLoss(bool? acceptdataloss = true) public ImportDanglingIndexDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Specify timeout for connection to master. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public ImportDanglingIndexDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Explicit operation timeout. public ImportDanglingIndexDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Indices.cs b/src/OpenSearch.Client/_Generated/Descriptors.Indices.cs index 770ec7cb62..df68ddd1d5 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Indices.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Indices.cs @@ -88,14 +88,14 @@ public DeleteComposableIndexTemplateDescriptor ClusterManagerTimeout( Time clustermanagertimeout ) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public DeleteComposableIndexTemplateDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public DeleteComposableIndexTemplateDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -139,7 +139,7 @@ public ComposableIndexTemplateExistsDescriptor FlatSettings(bool? flatsettings = public ComposableIndexTemplateExistsDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -164,14 +164,14 @@ public GetComposableIndexTemplateDescriptor() /// /_index_template/{name} /// Optional, accepts null - public GetComposableIndexTemplateDescriptor(Names name) + public GetComposableIndexTemplateDescriptor(Name name) : base(r => r.Optional("name", name)) { } // values part of the url path - Names IGetComposableIndexTemplateRequest.Name => Self.RouteValues.Get("name"); + Name IGetComposableIndexTemplateRequest.Name => Self.RouteValues.Get("name"); - /// Comma-separated names of the index templates. - public GetComposableIndexTemplateDescriptor Name(Names name) => + /// Name of the index template to retrieve. Wildcard (*) expressions are supported. + public GetComposableIndexTemplateDescriptor Name(Name name) => Assign(name, (a, v) => a.RouteValues.Optional("name", v)); // Request parameters @@ -181,14 +181,14 @@ public GetComposableIndexTemplateDescriptor ClusterManagerTimeout( Time clustermanagertimeout ) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Return settings in flat format. + /// If true, returns settings in flat format. public GetComposableIndexTemplateDescriptor FlatSettings(bool? flatsettings = true) => Qs("flat_settings", flatsettings); - /// Return local information, do not retrieve the state from cluster-manager node. + /// If true, the request retrieves information from the local node only. Defaults to false, which means information is retrieved from the master node. public GetComposableIndexTemplateDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -230,7 +230,7 @@ public PutComposableIndexTemplateDescriptor ClusterManagerTimeout( Time clustermanagertimeout ) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Whether the index template should only be added if new or can also replace an existing one. + /// If `true`, this request cannot replace or update existing index templates. public PutComposableIndexTemplateDescriptor Create(bool? create = true) => Qs("create", create); diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Ingest.cs b/src/OpenSearch.Client/_Generated/Descriptors.Ingest.cs index 0700f7e7ea..7fe0558ed6 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Ingest.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Ingest.cs @@ -87,14 +87,14 @@ protected DeletePipelineDescriptor() public DeletePipelineDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public DeletePipelineDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public DeletePipelineDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -121,7 +121,7 @@ public GetPipelineDescriptor(Id id) // values part of the url path Id IGetPipelineRequest.Id => Self.RouteValues.Get("id"); - /// Comma-separated list of pipeline ids. Wildcards supported. + /// Comma-separated list of pipeline IDs to retrieve. Wildcard (`*`) expressions are supported. To get all ingest pipelines, omit this parameter or use `*`. public GetPipelineDescriptor Id(Id id) => Assign(id, (a, v) => a.RouteValues.Optional("id", v)); @@ -131,7 +131,7 @@ public GetPipelineDescriptor Id(Id id) => public GetPipelineDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -183,14 +183,14 @@ protected PutPipelineDescriptor() public PutPipelineDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public PutPipelineDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public PutPipelineDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -217,12 +217,12 @@ public SimulatePipelineDescriptor(Id id) // values part of the url path Id ISimulatePipelineRequest.Id => Self.RouteValues.Get("id"); - /// Pipeline ID. + /// Pipeline to test. If you don’t specify a `pipeline` in the request body, this parameter is required. public SimulatePipelineDescriptor Id(Id id) => Assign(id, (a, v) => a.RouteValues.Optional("id", v)); // Request parameters - /// Verbose mode. Display data output for each processor in executed pipeline. + /// If `true`, the response includes output data for each processor in the executed pipeline. public SimulatePipelineDescriptor Verbose(bool? verbose = true) => Qs("verbose", verbose); } } diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Nodes.cs b/src/OpenSearch.Client/_Generated/Descriptors.Nodes.cs index 6c09ea7b43..4caeb869f8 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Nodes.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Nodes.cs @@ -92,10 +92,6 @@ public NodesHotThreadsDescriptor IgnoreIdleThreads(bool? ignoreidlethreads = tru /// The interval for the second sampling of threads. public NodesHotThreadsDescriptor Interval(Time interval) => Qs("interval", interval); - /// The type to sample. - public NodesHotThreadsDescriptor SampleType(SampleType? sampletype) => - Qs("type", sampletype); - /// Number of samples of thread stacktrace. public NodesHotThreadsDescriptor Snapshots(long? snapshots) => Qs("snapshots", snapshots); @@ -104,6 +100,9 @@ public NodesHotThreadsDescriptor SampleType(SampleType? sampletype) => /// Operation timeout. public NodesHotThreadsDescriptor Timeout(Time timeout) => Qs("timeout", timeout); + + /// The type to sample. + public NodesHotThreadsDescriptor Type(NodesSampleType? type) => Qs("type", type); } /// Descriptor for Info https://opensearch.org/docs/latest/api-reference/nodes-apis/nodes-info/ @@ -137,20 +136,20 @@ public NodesInfoDescriptor(NodeIds nodeId, Metrics metric) Metrics INodesInfoRequest.Metric => Self.RouteValues.Get("metric"); NodeIds INodesInfoRequest.NodeId => Self.RouteValues.Get("node_id"); - /// Comma-separated list of metrics you wish returned. Leave empty to return all. + /// Limits the information returned to the specific metrics. Supports a comma-separated list, such as http,ingest. public NodesInfoDescriptor Metric(Metrics metric) => Assign(metric, (a, v) => a.RouteValues.Optional("metric", v)); - /// 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. + /// Comma-separated list of node IDs or names used to limit returned information. public NodesInfoDescriptor NodeId(NodeIds nodeId) => Assign(nodeId, (a, v) => a.RouteValues.Optional("node_id", v)); // Request parameters - /// Return settings in flat format. + /// If true, returns settings in flat format. public NodesInfoDescriptor FlatSettings(bool? flatsettings = true) => Qs("flat_settings", flatsettings); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public NodesInfoDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -177,12 +176,12 @@ public ReloadSecureSettingsDescriptor(NodeIds nodeId) // values part of the url path NodeIds IReloadSecureSettingsRequest.NodeId => Self.RouteValues.Get("node_id"); - /// Comma-separated list of node IDs to span the reload/reinit call. Should stay empty because reloading usually involves all cluster nodes. + /// The names of particular nodes in the cluster to target. public ReloadSecureSettingsDescriptor NodeId(NodeIds nodeId) => Assign(nodeId, (a, v) => a.RouteValues.Optional("node_id", v)); // Request parameters - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public ReloadSecureSettingsDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -228,11 +227,10 @@ public NodesStatsDescriptor(NodeIds nodeId, Metrics metric) /// Optional, accepts null /// Optional, accepts null public NodesStatsDescriptor(NodeIds nodeId, Metrics metric, IndexMetrics indexMetric) - : base( - r => - r.Optional("node_id", nodeId) - .Optional("metric", metric) - .Optional("index_metric", indexMetric) + : base(r => + r.Optional("node_id", nodeId) + .Optional("metric", metric) + .Optional("index_metric", indexMetric) ) { } // values part of the url path @@ -241,7 +239,7 @@ public NodesStatsDescriptor(NodeIds nodeId, Metrics metric, IndexMetrics indexMe Metrics INodesStatsRequest.Metric => Self.RouteValues.Get("metric"); NodeIds INodesStatsRequest.NodeId => Self.RouteValues.Get("node_id"); - /// Limit the information returned for `indices` metric to the specific index metrics. Isn't used if `indices` (or `all`) metric isn't specified. + /// Limit the information returned for indices metric to the specific index metrics. It can be used only if indices (or all) metric is specified. public NodesStatsDescriptor IndexMetric(IndexMetrics indexMetric) => Assign(indexMetric, (a, v) => a.RouteValues.Optional("index_metric", v)); @@ -249,49 +247,48 @@ public NodesStatsDescriptor IndexMetric(IndexMetrics indexMetric) => public NodesStatsDescriptor Metric(Metrics metric) => Assign(metric, (a, v) => a.RouteValues.Optional("metric", v)); - /// 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. + /// Comma-separated list of node IDs or names used to limit returned information. public NodesStatsDescriptor NodeId(NodeIds nodeId) => Assign(nodeId, (a, v) => a.RouteValues.Optional("node_id", v)); // Request parameters - /// Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards). + /// Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics. public NodesStatsDescriptor CompletionFields(Fields completionfields) => Qs("completion_fields", completionfields); - /// Comma-separated list of fields for `fielddata` and `suggest` index metric (supports wildcards). + /// Comma-separated list or wildcard expressions of fields to include in fielddata and suggest statistics. public NodesStatsDescriptor CompletionFields(params Expression>[] fields) where T : class => Qs("completion_fields", fields?.Select(e => (Field)e)); - /// Comma-separated list of fields for `fielddata` index metric (supports wildcards). + /// Comma-separated list or wildcard expressions of fields to include in fielddata statistics. public NodesStatsDescriptor FielddataFields(Fields fielddatafields) => Qs("fielddata_fields", fielddatafields); - /// Comma-separated list of fields for `fielddata` index metric (supports wildcards). + /// Comma-separated list or wildcard expressions of fields to include in fielddata statistics. public NodesStatsDescriptor FielddataFields(params Expression>[] fields) where T : class => Qs("fielddata_fields", fields?.Select(e => (Field)e)); - /// Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards). + /// Comma-separated list or wildcard expressions of fields to include in the statistics. public NodesStatsDescriptor Fields(Fields fields) => Qs("fields", fields); - /// Comma-separated list of fields for `fielddata` and `completion` index metric (supports wildcards). + /// Comma-separated list or wildcard expressions of fields to include in the statistics. public NodesStatsDescriptor Fields(params Expression>[] fields) where T : class => Qs("fields", fields?.Select(e => (Field)e)); - /// Comma-separated list of search groups for `search` index metric. + /// Comma-separated list of search groups to include in the search statistics. public NodesStatsDescriptor Groups(params string[] groups) => Qs("groups", groups); - /// Whether to report the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested). + /// If true, the call reports the aggregated disk usage of each one of the Lucene index files (only applies if segment stats are requested). public NodesStatsDescriptor IncludeSegmentFileSizes(bool? includesegmentfilesizes = true) => Qs("include_segment_file_sizes", includesegmentfilesizes); - /// Return indices stats aggregated at index, node or shard level. - public NodesStatsDescriptor NodesStatLevel(NodesStatLevel? nodesstatlevel) => - Qs("level", nodesstatlevel); + /// Indicates whether statistics are aggregated at the cluster, index, or shard level. + public NodesStatsDescriptor Level(Level? level) => Qs("level", level); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public NodesStatsDescriptor Timeout(Time timeout) => Qs("timeout", timeout); - /// Comma-separated list of document types for the `indexing` index metric. + /// A comma-separated list of document types for the indexing index metric. public NodesStatsDescriptor Types(params string[] types) => Qs("types", types); } @@ -330,16 +327,16 @@ public NodesUsageDescriptor(NodeIds nodeId, Metrics metric) Metrics INodesUsageRequest.Metric => Self.RouteValues.Get("metric"); NodeIds INodesUsageRequest.NodeId => Self.RouteValues.Get("node_id"); - /// Limit the information returned to the specified metrics. + /// Limits the information returned to the specific metrics. A comma-separated list of the following options: `_all`, `rest_actions`. public NodesUsageDescriptor Metric(Metrics metric) => Assign(metric, (a, v) => a.RouteValues.Optional("metric", v)); - /// 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. + /// 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. public NodesUsageDescriptor NodeId(NodeIds nodeId) => Assign(nodeId, (a, v) => a.RouteValues.Optional("node_id", v)); // Request parameters - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public NodesUsageDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } } diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Snapshot.cs b/src/OpenSearch.Client/_Generated/Descriptors.Snapshot.cs index 43fb17f3cf..fa0f00b86d 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Snapshot.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Snapshot.cs @@ -87,14 +87,14 @@ protected CleanupRepositoryDescriptor() public CleanupRepositoryDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public CleanupRepositoryDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Period to wait for a response. public CleanupRepositoryDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -114,11 +114,10 @@ public partial class CloneSnapshotDescriptor /// this parameter is required /// this parameter is required public CloneSnapshotDescriptor(Name repository, Name snapshot, Name targetSnapshot) - : base( - r => - r.Required("repository", repository) - .Required("snapshot", snapshot) - .Required("target_snapshot", targetSnapshot) + : base(r => + r.Required("repository", repository) + .Required("snapshot", snapshot) + .Required("target_snapshot", targetSnapshot) ) { } /// Used for serialization purposes, making sure we have a parameterless constructor @@ -137,7 +136,7 @@ protected CloneSnapshotDescriptor() public CloneSnapshotDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -173,14 +172,14 @@ protected SnapshotDescriptor() public SnapshotDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public SnapshotDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Should this request wait until the operation has completed before returning. + /// If `true`, the request returns a response when the snapshot is complete. If `false`, the request returns a response when the snapshot initializes. public SnapshotDescriptor WaitForCompletion(bool? waitforcompletion = true) => Qs("wait_for_completion", waitforcompletion); } @@ -215,14 +214,14 @@ protected CreateRepositoryDescriptor() public CreateRepositoryDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public CreateRepositoryDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Explicit operation timeout. public CreateRepositoryDescriptor Timeout(Time timeout) => Qs("timeout", timeout); /// Whether to verify the repository after creation. @@ -261,7 +260,7 @@ protected DeleteSnapshotDescriptor() public DeleteSnapshotDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -299,14 +298,14 @@ protected DeleteRepositoryDescriptor() public DeleteRepositoryDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public DeleteRepositoryDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Explicit operation timeout. public DeleteRepositoryDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } @@ -342,18 +341,18 @@ protected GetSnapshotDescriptor() public GetSnapshotDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Whether to ignore unavailable snapshots, defaults to false which means a SnapshotMissingException is thrown. + /// If false, the request returns an error for any snapshots that are unavailable. public GetSnapshotDescriptor IgnoreUnavailable(bool? ignoreunavailable = true) => Qs("ignore_unavailable", ignoreunavailable); - /// Operation timeout for connection to master node. + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public GetSnapshotDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Whether to show verbose snapshot info or only show the basic info found in the repository index blob. + /// If true, returns additional information about each snapshot such as the version of Opensearch which took the snapshot, the start and end times of the snapshot, and the number of shards snapshotted. public GetSnapshotDescriptor Verbose(bool? verbose = true) => Qs("verbose", verbose); } @@ -380,7 +379,7 @@ public GetRepositoryDescriptor(Names repository) // values part of the url path Names IGetRepositoryRequest.RepositoryName => Self.RouteValues.Get("repository"); - /// Comma-separated list of repository names. + /// A comma-separated list of repository names. public GetRepositoryDescriptor RepositoryName(Names repository) => Assign(repository, (a, v) => a.RouteValues.Optional("repository", v)); @@ -390,10 +389,10 @@ public GetRepositoryDescriptor RepositoryName(Names repository) => public GetRepositoryDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Return local information, do not retrieve the state from cluster-manager node (default: false). public GetRepositoryDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -429,7 +428,7 @@ protected RestoreDescriptor() public RestoreDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -471,11 +470,11 @@ public SnapshotStatusDescriptor(Name repository, Names snapshot) Name ISnapshotStatusRequest.RepositoryName => Self.RouteValues.Get("repository"); Names ISnapshotStatusRequest.Snapshot => Self.RouteValues.Get("snapshot"); - /// Repository name. + /// A repository name. public SnapshotStatusDescriptor RepositoryName(Name repository) => Assign(repository, (a, v) => a.RouteValues.Optional("repository", v)); - /// Comma-separated list of snapshot names. + /// A comma-separated list of snapshot names. public SnapshotStatusDescriptor Snapshot(Names snapshot) => Assign(snapshot, (a, v) => a.RouteValues.Optional("snapshot", v)); @@ -489,7 +488,7 @@ public SnapshotStatusDescriptor ClusterManagerTimeout(Time clustermanagertimeout public SnapshotStatusDescriptor IgnoreUnavailable(bool? ignoreunavailable = true) => Qs("ignore_unavailable", ignoreunavailable); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -527,14 +526,14 @@ protected VerifyRepositoryDescriptor() public VerifyRepositoryDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// Operation timeout for connection to master node. + /// Explicit operation timeout for connection to master node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] public VerifyRepositoryDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Operation timeout. + /// Explicit operation timeout. public VerifyRepositoryDescriptor Timeout(Time timeout) => Qs("timeout", timeout); } } diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Tasks.cs b/src/OpenSearch.Client/_Generated/Descriptors.Tasks.cs index 123027a22d..3f19f53440 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Tasks.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Tasks.cs @@ -80,22 +80,22 @@ public CancelTasksDescriptor(TaskId taskId) // values part of the url path TaskId ICancelTasksRequest.TaskId => Self.RouteValues.Get("task_id"); - /// Cancel the task with specified task id (node_id:task_number). + /// ID of the task. public CancelTasksDescriptor TaskId(TaskId taskId) => Assign(taskId, (a, v) => a.RouteValues.Optional("task_id", v)); // Request parameters - /// Comma-separated list of actions that should be cancelled. Leave empty to cancel all. + /// Comma-separated list or wildcard expression of actions used to limit the request. public CancelTasksDescriptor Actions(params string[] actions) => Qs("actions", actions); - /// 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. + /// Comma-separated list of node IDs or names used to limit the request. public CancelTasksDescriptor Nodes(params string[] nodes) => Qs("nodes", nodes); - /// Cancel tasks with specified parent task id (node_id:task_number). Set to -1 to cancel all. + /// Parent task ID used to limit the tasks. public CancelTasksDescriptor ParentTaskId(string parenttaskid) => Qs("parent_task_id", parenttaskid); - /// Should this request wait until the operation has completed before returning. + /// Should the request block until the cancellation of the task and its descendant tasks is completed. Defaults to false. public CancelTasksDescriptor WaitForCompletion(bool? waitforcompletion = true) => Qs("wait_for_completion", waitforcompletion); } @@ -121,10 +121,10 @@ protected GetTaskDescriptor() TaskId IGetTaskRequest.TaskId => Self.RouteValues.Get("task_id"); // Request parameters - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public GetTaskDescriptor Timeout(Time timeout) => Qs("timeout", timeout); - /// Should this request wait until the operation has completed before returning. + /// If `true`, the request blocks until the task has completed. public GetTaskDescriptor WaitForCompletion(bool? waitforcompletion = true) => Qs("wait_for_completion", waitforcompletion); } @@ -138,26 +138,26 @@ public partial class ListTasksDescriptor // values part of the url path // Request parameters - /// Comma-separated list of actions that should be returned. Leave empty to return all. + /// Comma-separated list or wildcard expression of actions used to limit the request. public ListTasksDescriptor Actions(params string[] actions) => Qs("actions", actions); - /// Return detailed task information. + /// If `true`, the response includes detailed information about shard recoveries. public ListTasksDescriptor Detailed(bool? detailed = true) => Qs("detailed", detailed); - /// Group tasks by nodes or parent/child relationships. - public ListTasksDescriptor GroupBy(GroupBy? groupby) => Qs("group_by", groupby); + /// Key used to group tasks in the response. + public ListTasksDescriptor GroupBy(TasksGroupBy? groupby) => Qs("group_by", groupby); /// 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. public ListTasksDescriptor Nodes(params string[] nodes) => Qs("nodes", nodes); - /// Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all. + /// Parent task ID used to limit returned information. To return all tasks, omit this parameter or use a value of `-1`. public ListTasksDescriptor ParentTaskId(string parenttaskid) => Qs("parent_task_id", parenttaskid); - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public ListTasksDescriptor Timeout(Time timeout) => Qs("timeout", timeout); - /// Should this request wait until the operation has completed before returning. + /// If `true`, the request blocks until the operation is complete. public ListTasksDescriptor WaitForCompletion(bool? waitforcompletion = true) => Qs("wait_for_completion", waitforcompletion); } diff --git a/src/OpenSearch.Client/_Generated/OpenSearchClient.Cluster.cs b/src/OpenSearch.Client/_Generated/OpenSearchClient.Cluster.cs index 4424aa800e..6e4194dbe9 100644 --- a/src/OpenSearch.Client/_Generated/OpenSearchClient.Cluster.cs +++ b/src/OpenSearch.Client/_Generated/OpenSearchClient.Cluster.cs @@ -292,7 +292,7 @@ public Task ComponentTemplateExistsAsync( /// https://opensearch.org/docs/latest /// public GetComponentTemplateResponse GetComponentTemplate( - Names name = null, + Name name = null, Func selector = null ) => GetComponentTemplate( @@ -305,7 +305,7 @@ public GetComponentTemplateResponse GetComponentTemplate( /// https://opensearch.org/docs/latest /// public Task GetComponentTemplateAsync( - Names name = null, + Name name = null, Func selector = null, CancellationToken ct = default ) => diff --git a/src/OpenSearch.Client/_Generated/OpenSearchClient.Indices.cs b/src/OpenSearch.Client/_Generated/OpenSearchClient.Indices.cs index 624ce9d9b7..d0b77e1c2f 100644 --- a/src/OpenSearch.Client/_Generated/OpenSearchClient.Indices.cs +++ b/src/OpenSearch.Client/_Generated/OpenSearchClient.Indices.cs @@ -191,7 +191,7 @@ public Task ComposableTemplateExistsAsync( /// https://opensearch.org/docs/latest/im-plugin/index-templates/ /// public GetComposableIndexTemplateResponse GetComposableTemplate( - Names name = null, + Name name = null, Func< GetComposableIndexTemplateDescriptor, IGetComposableIndexTemplateRequest @@ -209,7 +209,7 @@ public GetComposableIndexTemplateResponse GetComposableTemplate( /// https://opensearch.org/docs/latest/im-plugin/index-templates/ /// public Task GetComposableTemplateAsync( - Names name = null, + Name name = null, Func< GetComposableIndexTemplateDescriptor, IGetComposableIndexTemplateRequest diff --git a/src/OpenSearch.Client/_Generated/Requests.Cat.cs b/src/OpenSearch.Client/_Generated/Requests.Cat.cs index b3ff283684..5e8c854fda 100644 --- a/src/OpenSearch.Client/_Generated/Requests.Cat.cs +++ b/src/OpenSearch.Client/_Generated/Requests.Cat.cs @@ -232,7 +232,7 @@ public CatAllocationRequest(NodeIds nodeId) NodeIds ICatAllocationRequest.NodeId => Self.RouteValues.Get("node_id"); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public Bytes? Bytes { get => Q("bytes"); @@ -482,7 +482,7 @@ public CatFielddataRequest(Fields fields) Fields ICatFielddataRequest.Fields => Self.RouteValues.Get("fields"); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public Bytes? Bytes { get => Q("bytes"); @@ -568,7 +568,7 @@ public bool? Help set => Q("help", value); } - /// Set to false to disable timestamping. + /// If true, returns `HH:MM:SS` and Unix epoch timestamps. public bool? IncludeTimestamp { get => Q("ts"); @@ -648,7 +648,7 @@ public CatIndicesRequest(Indices index) Indices ICatIndicesRequest.Index => Self.RouteValues.Get("index"); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public Bytes? Bytes { get => Q("bytes"); @@ -663,7 +663,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// Whether to expand wildcard expression to concrete indices that are open, closed or both. + /// The type of index that wildcard patterns can match. public ExpandWildcards? ExpandWildcards { get => Q("expand_wildcards"); @@ -688,10 +688,10 @@ public string[] Headers set => Q("h", value); } - /// Health status ('green', 'yellow', or 'red') to filter only indices matching the specified health status. - public Health? Health + /// The health status used to limit returned indices. By default, the response includes indices of any health status. + public HealthStatus? Health { - get => Q("health"); + get => Q("health"); set => Q("health", value); } @@ -702,7 +702,7 @@ public bool? Help set => Q("help", value); } - /// If set to true segment stats will include stats for segments that are not currently loaded into memory. + /// If true, the response includes information from segments that are not loaded into memory. public bool? IncludeUnloadedSegments { get => Q("include_unloaded_segments"); @@ -726,7 +726,7 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Set to true to return stats only for primary shards. + /// If true, the response only includes information from primary shards. public bool? Pri { get => Q("pri"); @@ -921,7 +921,7 @@ public partial class CatNodesRequest // values part of the url path // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public Bytes? Bytes { get => Q("bytes"); @@ -947,7 +947,7 @@ public string Format } } - /// Return the full node ID instead of the shortened version. + /// If `true`, return the full node ID. If `false`, return the shortened node ID. public bool? FullId { get => Q("full_id"); @@ -1259,7 +1259,7 @@ public bool? ActiveOnly set => Q("active_only", value); } - /// The unit in which to display byte values. + /// The unit used to display byte values. public Bytes? Bytes { get => Q("bytes"); @@ -1565,7 +1565,7 @@ public CatSegmentsRequest(Indices index) Indices ICatSegmentsRequest.Index => Self.RouteValues.Get("index"); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public Bytes? Bytes { get => Q("bytes"); @@ -1659,7 +1659,7 @@ public CatShardsRequest(Indices index) Indices ICatShardsRequest.Index => Self.RouteValues.Get("index"); // Request parameters - /// The unit in which to display byte values. + /// The unit used to display byte values. public Bytes? Bytes { get => Q("bytes"); @@ -1793,7 +1793,7 @@ public bool? Help set => Q("help", value); } - /// Whether specified concrete indices should be ignored when unavailable (missing or closed). + /// If `true`, the response does not include information from unavailable snapshots. public bool? IgnoreUnavailable { get => Q("ignore_unavailable"); @@ -1839,14 +1839,14 @@ public partial class CatTasksRequest // values part of the url path // Request parameters - /// Comma-separated list of actions that should be returned. Leave empty to return all. + /// The task action names, which are used to limit the response. public string[] Actions { get => Q("actions"); set => Q("actions", value); } - /// Return detailed task information. + /// If `true`, the response includes detailed information about shard recoveries. public bool? Detailed { get => Q("detailed"); @@ -1888,7 +1888,7 @@ public string[] Nodes set => Q("nodes", value); } - /// Return tasks with specified parent task id (node_id:task_number). Set to -1 to return all. + /// The parent task identifier, which is used to limit the response. public string ParentTaskId { get => Q("parent_task_id"); diff --git a/src/OpenSearch.Client/_Generated/Requests.Cluster.cs b/src/OpenSearch.Client/_Generated/Requests.Cluster.cs index 542473a080..4c32c79440 100644 --- a/src/OpenSearch.Client/_Generated/Requests.Cluster.cs +++ b/src/OpenSearch.Client/_Generated/Requests.Cluster.cs @@ -73,14 +73,14 @@ public partial class ClusterAllocationExplainRequest // values part of the url path // Request parameters - /// Return information about disk usage and shard sizes. + /// If true, returns information about disk usage and shard sizes. public bool? IncludeDiskInfo { get => Q("include_disk_info"); set => Q("include_disk_info", value); } - /// Return 'YES' decisions in explanation. + /// If true, returns YES decisions in explanation. public bool? IncludeYesDecisions { get => Q("include_yes_decisions"); @@ -127,7 +127,10 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// Operation timeout for connection to master node. + /// + /// Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns + /// an error. + /// [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use 'cluster_manager_timeout' instead." )] @@ -137,7 +140,7 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Operation timeout. + /// Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. public Time Timeout { get => Q