diff --git a/compiler/src/steps/add-description.ts b/compiler/src/steps/add-description.ts index e34c17b1c0..ab817db9af 100644 --- a/compiler/src/steps/add-description.ts +++ b/compiler/src/steps/add-description.ts @@ -32,28 +32,6 @@ export default async function addDescription (model: model.Model, jsonSpec: Map< const spec = jsonSpec.get(endpoint.name) assert(spec, `Can't find the json spec for ${endpoint.name}`) - for (const property of requestDefinition.path) { - const definition = spec.url.paths.find(path => { - if (path.parts == null) return false - return path.parts[property.name] != null - }) - if (definition?.parts != null) { - const { description } = definition.parts[property.name] - if (typeof description === 'string') { - property.description = property.description ?? description - } - } - } - - if (spec.params != null) { - for (const property of requestDefinition.query) { - const param = spec.params[property.name] - if (param != null && typeof param.description === 'string') { - property.description = property.description ?? param.description - } - } - } - if (spec.documentation.description != null) { requestDefinition.description = requestDefinition.description ?? spec.documentation.description } diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index 9533f9fadc..a872667489 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -526,7 +526,7 @@ { "in": "path", "name": "name", - "description": "the name of the autoscaling policy", + "description": "Name of the autoscaling policy", "required": true, "deprecated": false, "schema": { @@ -586,7 +586,7 @@ { "in": "path", "name": "name", - "description": "the name of the autoscaling policy", + "description": "Name of the autoscaling policy", "required": true, "deprecated": false, "schema": { @@ -676,7 +676,7 @@ { "in": "path", "name": "name", - "description": "the name of the autoscaling policy", + "description": "Name of the autoscaling policy", "required": true, "deprecated": false, "schema": { @@ -3725,7 +3725,7 @@ { "in": "path", "name": "index", - "description": "the name of the leader index for which specified follower retention leases should be removed", + "description": "Name of the leader index for which specified follower retention leases should be removed", "required": true, "deprecated": false, "schema": { @@ -4046,7 +4046,7 @@ { "in": "path", "name": "index", - "description": "The name of the follow index to resume following.", + "description": "Name of the follow index to resume following", "required": true, "deprecated": false, "schema": { @@ -5153,7 +5153,7 @@ { "in": "query", "name": "flat_settings", - "description": "Return settings in flat format (default: false)", + "description": "Return settings in flat format", "deprecated": false, "schema": { "type": "boolean" @@ -5163,7 +5163,7 @@ { "in": "query", "name": "master_timeout", - "description": "Explicit operation timeout for connection to master node", + "description": "The period to wait for a connection to the master node.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -5173,7 +5173,7 @@ { "in": "query", "name": "timeout", - "description": "Explicit operation timeout", + "description": "The period to wait for a response.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -8504,7 +8504,7 @@ { "in": "query", "name": "master_timeout", - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -8514,7 +8514,7 @@ { "in": "query", "name": "timeout", - "description": "Explicit operation timeout", + "description": "The period to wait for a response.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -8580,7 +8580,7 @@ { "in": "query", "name": "master_timeout", - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -8590,7 +8590,7 @@ { "in": "query", "name": "timeout", - "description": "Explicit operation timeout", + "description": "The period to wait for a response.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -15621,7 +15621,7 @@ { "in": "path", "name": "name", - "description": "A comma-separated list of data streams of which the data stream lifecycle will be deleted; use `*` to get all data streams", + "description": "A comma-separated list of data streams of which the data stream lifecycle will be deleted.\nUse `*` to get all data streams", "required": true, "deprecated": false, "schema": { @@ -15642,7 +15642,7 @@ { "in": "query", "name": "master_timeout", - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -15652,7 +15652,7 @@ { "in": "query", "name": "timeout", - "description": "Explicit timestamp for the document", + "description": "The period to wait for a response.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -16435,7 +16435,7 @@ { "in": "path", "name": "index", - "description": "The name of the index to explain", + "description": "Comma-separated list of index names to explain", "required": true, "deprecated": false, "schema": { @@ -16446,7 +16446,7 @@ { "in": "query", "name": "include_defaults", - "description": "indicates if the API should return the default values the system uses for the index's lifecycle", + "description": "Indicates if the API should return the default values the system uses for the index's lifecycle", "deprecated": false, "schema": { "type": "boolean" @@ -16456,7 +16456,7 @@ { "in": "query", "name": "master_timeout", - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -18252,7 +18252,7 @@ { "in": "path", "name": "name", - "description": "The name of the data stream", + "description": "The name of the data stream to promote", "required": true, "deprecated": false, "schema": { @@ -24696,7 +24696,7 @@ { "in": "query", "name": "acknowledge", - "description": "whether the user has acknowledged acknowledge messages (default: false)", + "description": "Whether the user has acknowledged acknowledge messages", "deprecated": false, "schema": { "type": "boolean" @@ -24801,7 +24801,7 @@ { "in": "query", "name": "acknowledge", - "description": "whether the user has acknowledged acknowledge messages (default: false)", + "description": "Whether the user has acknowledged acknowledge messages", "deprecated": false, "schema": { "type": "boolean" @@ -24811,7 +24811,7 @@ { "in": "query", "name": "type", - "description": "The type of trial license to generate (default: \"trial\")", + "description": "The type of trial license to generate", "deprecated": false, "schema": { "type": "string" @@ -31538,7 +31538,7 @@ { "in": "query", "name": "priority", - "description": "The deployment priority.", + "description": "The deployment priority", "deprecated": false, "schema": { "$ref": "#/components/schemas/ml._types.TrainingPriority" @@ -40571,7 +40571,7 @@ { "in": "query", "name": "refresh", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` (the default) then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes.", + "description": "If `true` (the default) 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` then do nothing with refreshes.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Refresh" @@ -52219,7 +52219,7 @@ { "in": "query", "name": "accept_enterprise", - "description": "If this param is used it must be set to true", + "description": "If used, this otherwise ignored parameter must be set to true", "deprecated": true, "schema": { "type": "boolean" @@ -133951,7 +133951,7 @@ "async_search.submit-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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "deprecated": false, "schema": { "type": "boolean" @@ -133981,7 +133981,7 @@ "async_search.submit-analyze_wildcard": { "in": "query", "name": "analyze_wildcard", - "description": "Specify whether wildcard and prefix queries should be analyzed (default: false)", + "description": "Specify whether wildcard and prefix queries should be analyzed", "deprecated": false, "schema": { "type": "boolean" @@ -134041,7 +134041,7 @@ "async_search.submit-expand_wildcards": { "in": "query", "name": "expand_wildcards", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", + "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.ExpandWildcards" @@ -134091,7 +134091,7 @@ "async_search.submit-max_concurrent_shard_requests": { "in": "query", "name": "max_concurrent_shard_requests", - "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", + "description": "The number of concurrent shard requests per node this search executes concurrently.\nThis value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests", "deprecated": false, "schema": { "type": "number" @@ -134101,7 +134101,7 @@ "async_search.submit-preference": { "in": "query", "name": "preference", - "description": "Specify the node or shard the operation should be performed on (default: random)", + "description": "Specify the node or shard the operation should be performed on", "deprecated": false, "schema": { "type": "string" @@ -134204,7 +134204,7 @@ "async_search.submit-terminate_after": { "in": "query", "name": "terminate_after", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", + "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early", "deprecated": false, "schema": { "type": "number" @@ -134224,7 +134224,7 @@ "async_search.submit-track_total_hits": { "in": "query", "name": "track_total_hits", - "description": "Indicate if the number of documents that match the query should be tracked. A number can also be specified, to accurately track the total hit count up to the number.", + "description": "Indicate if the number of documents that match the query should be tracked.\nA number can also be specified, to accurately track the total hit count up to the number.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_global.search._types.TrackHits" @@ -134324,7 +134324,7 @@ "async_search.submit-size": { "in": "query", "name": "size", - "description": "Number of hits to return (default: 10)", + "description": "Number of hits to return", "deprecated": false, "schema": { "type": "number" @@ -134334,7 +134334,7 @@ "async_search.submit-from": { "in": "query", "name": "from", - "description": "Starting offset (default: 0)", + "description": "Starting offset", "deprecated": false, "schema": { "type": "number" @@ -135505,7 +135505,7 @@ "cluster.get_component_template-include_defaults": { "in": "query", "name": "include_defaults", - "description": "Return all default configurations for the component template (default: false)", + "description": "Return all default configurations for the component template", "deprecated": false, "schema": { "type": "boolean" @@ -135698,7 +135698,7 @@ "cluster.state-metric": { "in": "path", "name": "metric", - "description": "Limit the information returned to the specified metrics", + "description": "Limit the information returned to the specified metrics.", "required": true, "deprecated": false, "schema": { @@ -135720,7 +135720,7 @@ "cluster.state-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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "deprecated": false, "schema": { "type": "boolean" @@ -135730,7 +135730,7 @@ "cluster.state-expand_wildcards": { "in": "query", "name": "expand_wildcards", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", + "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.ExpandWildcards" @@ -135740,7 +135740,7 @@ "cluster.state-flat_settings": { "in": "query", "name": "flat_settings", - "description": "Return settings in flat format (default: false)", + "description": "Return settings in flat format", "deprecated": false, "schema": { "type": "boolean" @@ -135760,7 +135760,7 @@ "cluster.state-local": { "in": "query", "name": "local", - "description": "Return local information, do not retrieve the state from master node (default: false)", + "description": "Return local information, do not retrieve the state from master node", "deprecated": true, "schema": { "type": "boolean" @@ -136136,7 +136136,7 @@ "eql.search-index": { "in": "path", "name": "index", - "description": "The name of the index to scope the operation", + "description": "Comma-separated list of index names to scope the operation", "required": true, "deprecated": false, "schema": { @@ -136147,7 +136147,7 @@ "eql.search-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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "deprecated": false, "schema": { "type": "boolean" @@ -137709,7 +137709,7 @@ "indices.forcemerge-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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "deprecated": false, "schema": { "type": "boolean" @@ -137729,7 +137729,7 @@ "indices.forcemerge-flush": { "in": "query", "name": "flush", - "description": "Specify whether the index should be flushed after performing the operation (default: true)", + "description": "Specify whether the index should be flushed after performing the operation", "deprecated": false, "schema": { "type": "boolean" @@ -137749,7 +137749,7 @@ "indices.forcemerge-max_num_segments": { "in": "query", "name": "max_num_segments", - "description": "The number of segments the index should be merged into (default: dynamic)", + "description": "The number of segments the index should be merged into (defayult: dynamic)", "deprecated": false, "schema": { "type": "number" @@ -137769,7 +137769,7 @@ "indices.forcemerge-wait_for_completion": { "in": "query", "name": "wait_for_completion", - "description": "Should the request wait until the force merge is completed.", + "description": "Should the request wait until the force merge is completed", "deprecated": false, "schema": { "type": "boolean" @@ -138284,7 +138284,7 @@ "indices.put_index_template-cause": { "in": "query", "name": "cause", - "description": "User defined reason for creating/updating the index template", + "description": "User defined reason for creating or updating the index template", "deprecated": false, "schema": { "type": "string" @@ -138294,7 +138294,7 @@ "indices.put_mapping-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.", + "description": "A comma-separated list of index names the mapping should be added to (supports wildcards).\nUse `_all` or omit to add the mapping on all indices.", "required": true, "deprecated": false, "schema": { @@ -138497,7 +138497,7 @@ "indices.put_template-cause": { "in": "query", "name": "cause", - "description": "User defined reason for creating/updating the index template", + "description": "User defined reason for creating or updating the index template", "deprecated": false, "schema": { "type": "string" @@ -138620,7 +138620,7 @@ "indices.reload_search_analyzers-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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "deprecated": false, "schema": { "type": "boolean" @@ -139061,7 +139061,7 @@ "indices.stats-metric": { "in": "path", "name": "metric", - "description": "Limit the information returned the specific metrics.", + "description": "Limit the information returned the specific metrics", "required": true, "deprecated": false, "schema": { @@ -139507,7 +139507,7 @@ "ingest.get_pipeline-summary": { "in": "query", "name": "summary", - "description": "Return pipelines without their definitions (default: false)", + "description": "Return pipelines without their definitions", "deprecated": false, "schema": { "type": "boolean" @@ -141223,7 +141223,7 @@ "nodes.hot_threads-sort": { "in": "query", "name": "sort", - "description": "The sort order for 'cpu' type (default: total)", + "description": "The sort order for 'cpu' type", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.ThreadType" @@ -141307,7 +141307,7 @@ "nodes.stats-metric": { "in": "path", "name": "metric", - "description": "Limit the information returned to the specified metrics", + "description": "Limits the information returned to the specific metrics.", "required": true, "deprecated": false, "schema": { @@ -141422,7 +141422,7 @@ "nodes.usage-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", + "description": "A comma-separated list of node IDs or names to limit the returned information.\nUse `_local` to return information from the node you're connecting to, leave empty to get information from all nodes.", "required": true, "deprecated": false, "schema": { @@ -141642,7 +141642,7 @@ "scroll-scroll_id_": { "in": "query", "name": "scroll_id", - "description": "The scroll ID for scrolled search", + "description": "The scroll ID", "deprecated": true, "schema": { "$ref": "#/components/schemas/_types.ScrollId" @@ -142162,7 +142162,7 @@ "search_mvt-index": { "in": "path", "name": "index", - "description": "Comma-separated list of data streams, indices, or aliases to search", + "description": "A list of indices, data streams, or aliases to search.\nIt supports wildcards (`*`).\nTo search all data streams and indices, omit this parameter or use `*` or `_all`.\nTo search a remote cluster, use the `:` syntax.", "required": true, "deprecated": false, "schema": { @@ -142173,7 +142173,7 @@ "search_mvt-field": { "in": "path", "name": "field", - "description": "Field containing geospatial data to return", + "description": "A field that contains the geospatial data to return.\nIt must be a `geo_point` or `geo_shape` field.\nThe field must have doc values enabled. It cannot be a nested field.\n\nNOTE: Vector tiles do not natively support geometry collections.\nFor `geometrycollection` values in a `geo_shape` field, the API returns a hits layer feature for each element of the collection.\nThis behavior may change in a future release.", "required": true, "deprecated": false, "schema": { @@ -142184,7 +142184,7 @@ "search_mvt-zoom": { "in": "path", "name": "zoom", - "description": "Zoom level for the vector tile to search", + "description": "The zoom level of the vector tile to search. It accepts `0` to `29`.", "required": true, "deprecated": false, "schema": { @@ -142195,7 +142195,7 @@ "search_mvt-x": { "in": "path", "name": "x", - "description": "X coordinate for the vector tile to search", + "description": "The X coordinate for the vector tile to search.", "required": true, "deprecated": false, "schema": { @@ -142206,7 +142206,7 @@ "search_mvt-y": { "in": "path", "name": "y", - "description": "Y coordinate for the vector tile to search", + "description": "The Y coordinate for the vector tile to search.", "required": true, "deprecated": false, "schema": { @@ -142551,7 +142551,7 @@ "searchable_snapshots.clear_cache-expand_wildcards": { "in": "query", "name": "expand_wildcards", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", + "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.ExpandWildcards" @@ -142561,7 +142561,7 @@ "searchable_snapshots.clear_cache-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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "deprecated": false, "schema": { "type": "boolean" @@ -142666,7 +142666,7 @@ "security.create_service_token-refresh": { "in": "query", "name": "refresh", - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` (the default) then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes.", + "description": "If `true` (the default) 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` then do nothing with refreshes.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Refresh" @@ -143046,7 +143046,7 @@ "shutdown.get_node-node_id": { "in": "path", "name": "node_id", - "description": "Which node for which to retrieve the shutdown status", + "description": "Comma-separated list of nodes for which to retrieve the shutdown status", "required": true, "deprecated": false, "schema": { @@ -143088,7 +143088,7 @@ "slm.get_lifecycle-policy_id": { "in": "path", "name": "policy_id", - "description": "Comma-separated list of snapshot lifecycle policies to retrieve", + "description": "A comma-separated list of snapshot lifecycle policy identifiers.", "required": true, "deprecated": false, "schema": { @@ -143770,7 +143770,7 @@ "watcher.put_watch-if_primary_term": { "in": "query", "name": "if_primary_term", - "description": "only update the watch if the last operation that has changed the watch has the specified primary term", + "description": "Only update the watch if the last operation that has changed the watch has the specified primary term", "deprecated": false, "schema": { "type": "number" @@ -143780,7 +143780,7 @@ "watcher.put_watch-if_seq_no": { "in": "query", "name": "if_seq_no", - "description": "only update the watch if the last operation that has changed the watch has the specified sequence number", + "description": "Only update the watch if the last operation that has changed the watch has the specified sequence number", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.SequenceNumber" diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index 73203937af..ef206b1169 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -8680,7 +8680,7 @@ { "in": "path", "name": "name", - "description": "A comma-separated list of data streams of which the data stream lifecycle will be deleted; use `*` to get all data streams", + "description": "A comma-separated list of data streams of which the data stream lifecycle will be deleted.\nUse `*` to get all data streams", "required": true, "deprecated": false, "schema": { @@ -8701,7 +8701,7 @@ { "in": "query", "name": "master_timeout", - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -8711,7 +8711,7 @@ { "in": "query", "name": "timeout", - "description": "Explicit timestamp for the document", + "description": "The period to wait for a response.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -9076,7 +9076,7 @@ { "in": "path", "name": "index", - "description": "The name of the index to explain", + "description": "Comma-separated list of index names to explain", "required": true, "deprecated": false, "schema": { @@ -9087,7 +9087,7 @@ { "in": "query", "name": "include_defaults", - "description": "indicates if the API should return the default values the system uses for the index's lifecycle", + "description": "Indicates if the API should return the default values the system uses for the index's lifecycle", "deprecated": false, "schema": { "type": "boolean" @@ -9097,7 +9097,7 @@ { "in": "query", "name": "master_timeout", - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.Duration" @@ -19496,7 +19496,7 @@ { "in": "query", "name": "priority", - "description": "The deployment priority.", + "description": "The deployment priority", "deprecated": false, "schema": { "$ref": "#/components/schemas/ml._types.TrainingPriority" @@ -81005,7 +81005,7 @@ "async_search.submit-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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "deprecated": false, "schema": { "type": "boolean" @@ -81035,7 +81035,7 @@ "async_search.submit-analyze_wildcard": { "in": "query", "name": "analyze_wildcard", - "description": "Specify whether wildcard and prefix queries should be analyzed (default: false)", + "description": "Specify whether wildcard and prefix queries should be analyzed", "deprecated": false, "schema": { "type": "boolean" @@ -81095,7 +81095,7 @@ "async_search.submit-expand_wildcards": { "in": "query", "name": "expand_wildcards", - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", + "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types.ExpandWildcards" @@ -81145,7 +81145,7 @@ "async_search.submit-max_concurrent_shard_requests": { "in": "query", "name": "max_concurrent_shard_requests", - "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", + "description": "The number of concurrent shard requests per node this search executes concurrently.\nThis value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests", "deprecated": false, "schema": { "type": "number" @@ -81155,7 +81155,7 @@ "async_search.submit-preference": { "in": "query", "name": "preference", - "description": "Specify the node or shard the operation should be performed on (default: random)", + "description": "Specify the node or shard the operation should be performed on", "deprecated": false, "schema": { "type": "string" @@ -81258,7 +81258,7 @@ "async_search.submit-terminate_after": { "in": "query", "name": "terminate_after", - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", + "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early", "deprecated": false, "schema": { "type": "number" @@ -81278,7 +81278,7 @@ "async_search.submit-track_total_hits": { "in": "query", "name": "track_total_hits", - "description": "Indicate if the number of documents that match the query should be tracked. A number can also be specified, to accurately track the total hit count up to the number.", + "description": "Indicate if the number of documents that match the query should be tracked.\nA number can also be specified, to accurately track the total hit count up to the number.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_global.search._types.TrackHits" @@ -81378,7 +81378,7 @@ "async_search.submit-size": { "in": "query", "name": "size", - "description": "Number of hits to return (default: 10)", + "description": "Number of hits to return", "deprecated": false, "schema": { "type": "number" @@ -81388,7 +81388,7 @@ "async_search.submit-from": { "in": "query", "name": "from", - "description": "Starting offset (default: 0)", + "description": "Starting offset", "deprecated": false, "schema": { "type": "number" @@ -82060,7 +82060,7 @@ "cluster.get_component_template-include_defaults": { "in": "query", "name": "include_defaults", - "description": "Return all default configurations for the component template (default: false)", + "description": "Return all default configurations for the component template", "deprecated": false, "schema": { "type": "boolean" @@ -82437,7 +82437,7 @@ "eql.search-index": { "in": "path", "name": "index", - "description": "The name of the index to scope the operation", + "description": "Comma-separated list of index names to scope the operation", "required": true, "deprecated": false, "schema": { @@ -82448,7 +82448,7 @@ "eql.search-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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "deprecated": false, "schema": { "type": "boolean" @@ -83498,7 +83498,7 @@ "indices.put_index_template-cause": { "in": "query", "name": "cause", - "description": "User defined reason for creating/updating the index template", + "description": "User defined reason for creating or updating the index template", "deprecated": false, "schema": { "type": "string" @@ -83508,7 +83508,7 @@ "indices.put_mapping-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.", + "description": "A comma-separated list of index names the mapping should be added to (supports wildcards).\nUse `_all` or omit to add the mapping on all indices.", "required": true, "deprecated": false, "schema": { @@ -83711,7 +83711,7 @@ "indices.put_template-cause": { "in": "query", "name": "cause", - "description": "User defined reason for creating/updating the index template", + "description": "User defined reason for creating or updating the index template", "deprecated": false, "schema": { "type": "string" @@ -84166,7 +84166,7 @@ "ingest.get_pipeline-summary": { "in": "query", "name": "summary", - "description": "Return pipelines without their definitions (default: false)", + "description": "Return pipelines without their definitions", "deprecated": false, "schema": { "type": "boolean" @@ -85341,7 +85341,7 @@ "scroll-scroll_id_": { "in": "query", "name": "scroll_id", - "description": "The scroll ID for scrolled search", + "description": "The scroll ID", "deprecated": true, "schema": { "$ref": "#/components/schemas/_types.ScrollId" @@ -85861,7 +85861,7 @@ "search_mvt-index": { "in": "path", "name": "index", - "description": "Comma-separated list of data streams, indices, or aliases to search", + "description": "A list of indices, data streams, or aliases to search.\nIt supports wildcards (`*`).\nTo search all data streams and indices, omit this parameter or use `*` or `_all`.\nTo search a remote cluster, use the `:` syntax.", "required": true, "deprecated": false, "schema": { @@ -85872,7 +85872,7 @@ "search_mvt-field": { "in": "path", "name": "field", - "description": "Field containing geospatial data to return", + "description": "A field that contains the geospatial data to return.\nIt must be a `geo_point` or `geo_shape` field.\nThe field must have doc values enabled. It cannot be a nested field.\n\nNOTE: Vector tiles do not natively support geometry collections.\nFor `geometrycollection` values in a `geo_shape` field, the API returns a hits layer feature for each element of the collection.\nThis behavior may change in a future release.", "required": true, "deprecated": false, "schema": { @@ -85883,7 +85883,7 @@ "search_mvt-zoom": { "in": "path", "name": "zoom", - "description": "Zoom level for the vector tile to search", + "description": "The zoom level of the vector tile to search. It accepts `0` to `29`.", "required": true, "deprecated": false, "schema": { @@ -85894,7 +85894,7 @@ "search_mvt-x": { "in": "path", "name": "x", - "description": "X coordinate for the vector tile to search", + "description": "The X coordinate for the vector tile to search.", "required": true, "deprecated": false, "schema": { @@ -85905,7 +85905,7 @@ "search_mvt-y": { "in": "path", "name": "y", - "description": "Y coordinate for the vector tile to search", + "description": "The Y coordinate for the vector tile to search.", "required": true, "deprecated": false, "schema": { diff --git a/output/schema/schema.json b/output/schema/schema.json index 70825d16c4..0857c65ff0 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -34640,7 +34640,7 @@ } } ], - "specLocation": "_global/mtermvectors/MultiTermVectorsRequest.ts#L31-L134" + "specLocation": "_global/mtermvectors/MultiTermVectorsRequest.ts#L31-L137" }, { "kind": "response", @@ -34935,7 +34935,7 @@ } } ], - "specLocation": "_global/open_point_in_time/OpenPointInTimeRequest.ts#L26-L127" + "specLocation": "_global/open_point_in_time/OpenPointInTimeRequest.ts#L26-L130" }, { "kind": "response", @@ -35919,7 +35919,7 @@ } } ], - "specLocation": "_global/rank_eval/RankEvalRequest.ts#L24-L79" + "specLocation": "_global/rank_eval/RankEvalRequest.ts#L24-L83" }, { "kind": "response", @@ -38158,7 +38158,7 @@ "description": "", "version": "7.0.0" }, - "description": "The scroll ID for scrolled search", + "description": "The scroll ID", "name": "scroll_id", "required": false, "type": { @@ -38183,7 +38183,7 @@ } } ], - "specLocation": "_global/scroll/ScrollRequest.ts#L24-L88" + "specLocation": "_global/scroll/ScrollRequest.ts#L24-L94" }, { "kind": "response", @@ -45628,7 +45628,7 @@ }, "path": [ { - "description": "Comma-separated list of data streams, indices, or aliases to search", + "description": "A list of indices, data streams, or aliases to search.\nIt supports wildcards (`*`).\nTo search all data streams and indices, omit this parameter or use `*` or `_all`.\nTo search a remote cluster, use the `:` syntax.", "name": "index", "required": true, "type": { @@ -45640,7 +45640,7 @@ } }, { - "description": "Field containing geospatial data to return", + "description": "A field that contains the geospatial data to return.\nIt must be a `geo_point` or `geo_shape` field.\nThe field must have doc values enabled. It cannot be a nested field.\n\nNOTE: Vector tiles do not natively support geometry collections.\nFor `geometrycollection` values in a `geo_shape` field, the API returns a hits layer feature for each element of the collection.\nThis behavior may change in a future release.", "name": "field", "required": true, "type": { @@ -45652,7 +45652,7 @@ } }, { - "description": "Zoom level for the vector tile to search", + "description": "The zoom level of the vector tile to search. It accepts `0` to `29`.", "name": "zoom", "required": true, "type": { @@ -45664,7 +45664,7 @@ } }, { - "description": "X coordinate for the vector tile to search", + "description": "The X coordinate for the vector tile to search.", "name": "x", "required": true, "type": { @@ -45676,7 +45676,7 @@ } }, { - "description": "Y coordinate for the vector tile to search", + "description": "The Y coordinate for the vector tile to search.", "name": "y", "required": true, "type": { @@ -49362,7 +49362,7 @@ } } ], - "specLocation": "_global/update_by_query/UpdateByQueryRequest.ts#L37-L340" + "specLocation": "_global/update_by_query/UpdateByQueryRequest.ts#L37-L343" }, { "kind": "response", @@ -98628,7 +98628,7 @@ } } ], - "specLocation": "async_search/get/AsyncSearchGetRequest.ts#L24-L63" + "specLocation": "async_search/get/AsyncSearchGetRequest.ts#L24-L66" }, { "kind": "response", @@ -99448,7 +99448,7 @@ } }, { - "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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "name": "allow_no_indices", "required": false, "type": { @@ -99485,9 +99485,10 @@ } }, { - "description": "Specify whether wildcard and prefix queries should be analyzed (default: false)", + "description": "Specify whether wildcard and prefix queries should be analyzed", "name": "analyze_wildcard", "required": false, + "serverDefault": false, "type": { "kind": "instance_of", "type": { @@ -99560,7 +99561,7 @@ } }, { - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", + "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both", "name": "expand_wildcards", "required": false, "serverDefault": "open", @@ -99621,7 +99622,7 @@ } }, { - "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", + "description": "The number of concurrent shard requests per node this search executes concurrently.\nThis value should be used to limit the impact of the search on the cluster in order to limit the number of concurrent shard requests", "name": "max_concurrent_shard_requests", "required": false, "serverDefault": 5, @@ -99634,9 +99635,10 @@ } }, { - "description": "Specify the node or shard the operation should be performed on (default: random)", + "description": "Specify the node or shard the operation should be performed on", "name": "preference", "required": false, + "serverDefault": "random", "type": { "kind": "instance_of", "type": { @@ -99759,7 +99761,7 @@ } }, { - "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early.", + "description": "The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early", "name": "terminate_after", "required": false, "type": { @@ -99783,7 +99785,7 @@ } }, { - "description": "Indicate if the number of documents that match the query should be tracked. A number can also be specified, to accurately track the total hit count up to the number.", + "description": "Indicate if the number of documents that match the query should be tracked.\nA number can also be specified, to accurately track the total hit count up to the number.", "name": "track_total_hits", "required": false, "type": { @@ -99904,9 +99906,10 @@ } }, { - "description": "Number of hits to return (default: 10)", + "description": "Number of hits to return", "name": "size", "required": false, + "serverDefault": 10, "type": { "kind": "instance_of", "type": { @@ -99916,9 +99919,10 @@ } }, { - "description": "Starting offset (default: 0)", + "description": "Starting offset", "name": "from", "required": false, + "serverDefault": 0, "type": { "kind": "instance_of", "type": { @@ -99955,7 +99959,7 @@ } } ], - "specLocation": "async_search/submit/AsyncSearchSubmitRequest.ts#L54-L312" + "specLocation": "async_search/submit/AsyncSearchSubmitRequest.ts#L54-L416" }, { "kind": "response", @@ -100122,7 +100126,7 @@ }, "path": [ { - "description": "the name of the autoscaling policy", + "description": "Name of the autoscaling policy", "name": "name", "required": true, "type": { @@ -100162,7 +100166,7 @@ } } ], - "specLocation": "autoscaling/delete_autoscaling_policy/DeleteAutoscalingPolicyRequest.ts#L24-L54" + "specLocation": "autoscaling/delete_autoscaling_policy/DeleteAutoscalingPolicyRequest.ts#L24-L55" }, { "kind": "response", @@ -100543,7 +100547,7 @@ }, "path": [ { - "description": "the name of the autoscaling policy", + "description": "Name of the autoscaling policy", "name": "name", "required": true, "type": { @@ -100570,7 +100574,7 @@ } } ], - "specLocation": "autoscaling/get_autoscaling_policy/GetAutoscalingPolicyRequest.ts#L24-L50" + "specLocation": "autoscaling/get_autoscaling_policy/GetAutoscalingPolicyRequest.ts#L24-L51" }, { "kind": "response", @@ -100691,7 +100695,7 @@ }, "path": [ { - "description": "the name of the autoscaling policy", + "description": "Name of the autoscaling policy", "name": "name", "required": true, "type": { @@ -100731,7 +100735,7 @@ } } ], - "specLocation": "autoscaling/put_autoscaling_policy/PutAutoscalingPolicyRequest.ts#L25-L57" + "specLocation": "autoscaling/put_autoscaling_policy/PutAutoscalingPolicyRequest.ts#L25-L58" }, { "kind": "response", @@ -109095,7 +109099,7 @@ } } ], - "specLocation": "cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts#L23-L69" + "specLocation": "cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts#L23-L70" }, { "kind": "response", @@ -119811,7 +119815,7 @@ }, "path": [ { - "description": "the name of the leader index for which specified follower retention leases should be removed", + "description": "Name of the leader index for which specified follower retention leases should be removed", "name": "index", "required": true, "type": { @@ -119838,7 +119842,7 @@ } } ], - "specLocation": "ccr/forget_follower/ForgetFollowerIndexRequest.ts#L24-L65" + "specLocation": "ccr/forget_follower/ForgetFollowerIndexRequest.ts#L24-L66" }, { "kind": "response", @@ -120892,7 +120896,7 @@ }, "path": [ { - "description": "The name of the follow index to resume following.", + "description": "Name of the follow index to resume following", "name": "index", "required": true, "type": { @@ -120919,7 +120923,7 @@ } } ], - "specLocation": "ccr/resume_follow/ResumeFollowIndexRequest.ts#L25-L65" + "specLocation": "ccr/resume_follow/ResumeFollowIndexRequest.ts#L25-L66" }, { "kind": "response", @@ -123205,7 +123209,7 @@ "stability": "stable" } }, - "description": "Return all default configurations for the component template (default: false)", + "description": "Return all default configurations for the component template", "name": "include_defaults", "required": false, "serverDefault": false, @@ -123248,7 +123252,7 @@ } } ], - "specLocation": "cluster/get_component_template/ClusterGetComponentTemplateRequest.ts#L24-L82" + "specLocation": "cluster/get_component_template/ClusterGetComponentTemplateRequest.ts#L24-L83" }, { "kind": "response", @@ -124047,7 +124051,7 @@ } } ], - "specLocation": "cluster/health/ClusterHealthRequest.ts#L32-L121" + "specLocation": "cluster/health/ClusterHealthRequest.ts#L32-L122" }, { "kind": "response", @@ -124963,9 +124967,10 @@ "path": [], "query": [ { - "description": "Return settings in flat format (default: false)", + "description": "Return settings in flat format", "name": "flat_settings", "required": false, + "serverDefault": false, "type": { "kind": "instance_of", "type": { @@ -124975,7 +124980,7 @@ } }, { - "description": "Explicit operation timeout for connection to master node", + "description": "The period to wait for a connection to the master node.", "name": "master_timeout", "required": false, "serverDefault": "30s", @@ -124988,7 +124993,7 @@ } }, { - "description": "Explicit operation timeout", + "description": "The period to wait for a response.", "name": "timeout", "required": false, "serverDefault": "30s", @@ -125001,7 +125006,7 @@ } } ], - "specLocation": "cluster/put_settings/ClusterPutSettingsRequest.ts#L25-L71" + "specLocation": "cluster/put_settings/ClusterPutSettingsRequest.ts#L25-L81" }, { "kind": "response", @@ -126078,7 +126083,7 @@ }, "path": [ { - "description": "Limit the information returned to the specified metrics", + "description": "Limit the information returned to the specified metrics.", "name": "metric", "required": false, "type": { @@ -126104,7 +126109,7 @@ ], "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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "name": "allow_no_indices", "required": false, "serverDefault": true, @@ -126117,7 +126122,7 @@ } }, { - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", + "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both", "name": "expand_wildcards", "required": false, "serverDefault": "open", @@ -126130,7 +126135,7 @@ } }, { - "description": "Return settings in flat format (default: false)", + "description": "Return settings in flat format", "name": "flat_settings", "required": false, "serverDefault": false, @@ -126160,7 +126165,7 @@ "description": "This parameter has no effect, is now deprecated, and will be removed in a future version.", "version": "9.0.0" }, - "description": "Return local information, do not retrieve the state from master node (default: false)", + "description": "Return local information, do not retrieve the state from master node", "name": "local", "required": false, "serverDefault": false, @@ -126210,7 +126215,7 @@ } } ], - "specLocation": "cluster/state/ClusterStateRequest.ts#L29-L96" + "specLocation": "cluster/state/ClusterStateRequest.ts#L29-L119" }, { "kind": "response", @@ -136271,7 +136276,7 @@ } }, { - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "name": "master_timeout", "required": false, "serverDefault": "30s", @@ -136284,9 +136289,10 @@ } }, { - "description": "Explicit operation timeout", + "description": "The period to wait for a response.", "name": "timeout", "required": false, + "serverDefault": "30s", "type": { "kind": "instance_of", "type": { @@ -136296,7 +136302,7 @@ } } ], - "specLocation": "dangling_indices/delete_dangling_index/DeleteDanglingIndexRequest.ts#L24-L59" + "specLocation": "dangling_indices/delete_dangling_index/DeleteDanglingIndexRequest.ts#L24-L64" }, { "kind": "response", @@ -136395,7 +136401,7 @@ } }, { - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "name": "master_timeout", "required": false, "serverDefault": "30s", @@ -136408,9 +136414,10 @@ } }, { - "description": "Explicit operation timeout", + "description": "The period to wait for a response.", "name": "timeout", "required": false, + "serverDefault": "30s", "type": { "kind": "instance_of", "type": { @@ -136420,7 +136427,7 @@ } } ], - "specLocation": "dangling_indices/import_dangling_index/ImportDanglingIndexRequest.ts#L24-L61" + "specLocation": "dangling_indices/import_dangling_index/ImportDanglingIndexRequest.ts#L24-L66" }, { "kind": "response", @@ -138661,7 +138668,7 @@ }, "path": [ { - "description": "The name of the index to scope the operation", + "description": "Comma-separated list of index names to scope the operation", "name": "index", "required": true, "type": { @@ -138675,7 +138682,7 @@ ], "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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "name": "allow_no_indices", "required": false, "serverDefault": true, @@ -138791,7 +138798,7 @@ } } ], - "specLocation": "eql/search/EqlSearchRequest.ts#L28-L167" + "specLocation": "eql/search/EqlSearchRequest.ts#L28-L171" }, { "kind": "response", @@ -145173,7 +145180,7 @@ } ], "query": [], - "specLocation": "ilm/move_to_step/MoveToStepRequest.ts#L24-L64" + "specLocation": "ilm/move_to_step/MoveToStepRequest.ts#L24-L65" }, { "kind": "response", @@ -145443,7 +145450,7 @@ } ], "query": [], - "specLocation": "ilm/remove_policy/RemovePolicyRequest.ts#L23-L42" + "specLocation": "ilm/remove_policy/RemovePolicyRequest.ts#L23-L43" }, { "kind": "response", @@ -145554,7 +145561,7 @@ } ], "query": [], - "specLocation": "ilm/retry/RetryIlmRequest.ts#L23-L43" + "specLocation": "ilm/retry/RetryIlmRequest.ts#L23-L44" }, { "kind": "response", @@ -153391,7 +153398,7 @@ }, "path": [ { - "description": "A comma-separated list of data streams of which the data stream lifecycle will be deleted; use `*` to get all data streams", + "description": "A comma-separated list of data streams of which the data stream lifecycle will be deleted.\nUse `*` to get all data streams", "name": "name", "required": true, "type": { @@ -153418,7 +153425,7 @@ } }, { - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "name": "master_timeout", "required": false, "serverDefault": "30s", @@ -153431,9 +153438,10 @@ } }, { - "description": "Explicit timestamp for the document", + "description": "The period to wait for a response.", "name": "timeout", "required": false, + "serverDefault": "30s", "type": { "kind": "instance_of", "type": { @@ -153443,7 +153451,7 @@ } } ], - "specLocation": "indices/delete_data_lifecycle/IndicesDeleteDataLifecycleRequest.ts#L24-L54" + "specLocation": "indices/delete_data_lifecycle/IndicesDeleteDataLifecycleRequest.ts#L24-L64" }, { "kind": "response", @@ -154750,7 +154758,7 @@ }, "path": [ { - "description": "The name of the index to explain", + "description": "Comma-separated list of index names to explain", "name": "index", "required": true, "type": { @@ -154764,9 +154772,10 @@ ], "query": [ { - "description": "indicates if the API should return the default values the system uses for the index's lifecycle", + "description": "Indicates if the API should return the default values the system uses for the index's lifecycle", "name": "include_defaults", "required": false, + "serverDefault": false, "type": { "kind": "instance_of", "type": { @@ -154776,7 +154785,7 @@ } }, { - "description": "Specify timeout for connection to master", + "description": "The period to wait for a connection to the master node.", "name": "master_timeout", "required": false, "serverDefault": "30s", @@ -154789,7 +154798,7 @@ } } ], - "specLocation": "indices/explain_data_lifecycle/IndicesExplainDataLifecycleRequest.ts#L24-L51" + "specLocation": "indices/explain_data_lifecycle/IndicesExplainDataLifecycleRequest.ts#L24-L57" }, { "kind": "response", @@ -155564,7 +155573,7 @@ ], "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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "name": "allow_no_indices", "required": false, "type": { @@ -155589,9 +155598,10 @@ } }, { - "description": "Specify whether the index should be flushed after performing the operation (default: true)", + "description": "Specify whether the index should be flushed after performing the operation", "name": "flush", "required": false, + "serverDefault": true, "type": { "kind": "instance_of", "type": { @@ -155613,7 +155623,7 @@ } }, { - "description": "The number of segments the index should be merged into (default: dynamic)", + "description": "The number of segments the index should be merged into (defayult: dynamic)", "name": "max_num_segments", "required": false, "type": { @@ -155628,6 +155638,7 @@ "description": "Specify whether the operation should only expunge deleted documents", "name": "only_expunge_deletes", "required": false, + "serverDefault": false, "type": { "kind": "instance_of", "type": { @@ -155637,7 +155648,7 @@ } }, { - "description": "Should the request wait until the force merge is completed.", + "description": "Should the request wait until the force merge is completed", "name": "wait_for_completion", "required": false, "serverDefault": true, @@ -155650,7 +155661,7 @@ } } ], - "specLocation": "indices/forcemerge/IndicesForceMergeRequest.ts#L24-L114" + "specLocation": "indices/forcemerge/IndicesForceMergeRequest.ts#L24-L137" }, { "kind": "response", @@ -158797,7 +158808,7 @@ }, "path": [ { - "description": "The name of the data stream", + "description": "The name of the data stream to promote", "name": "name", "required": true, "type": { @@ -158824,7 +158835,7 @@ } } ], - "specLocation": "indices/promote_data_stream/IndicesPromoteDataStreamRequest.ts#L24-L58" + "specLocation": "indices/promote_data_stream/IndicesPromoteDataStreamRequest.ts#L24-L59" }, { "kind": "response", @@ -159647,7 +159658,7 @@ } } ], - "specLocation": "indices/put_index_template/IndicesPutIndexTemplateRequest.ts#L161-L183" + "specLocation": "indices/put_index_template/IndicesPutIndexTemplateRequest.ts#L162-L184" }, { "kind": "request", @@ -159905,7 +159916,7 @@ } }, { - "description": "User defined reason for creating/updating the index template", + "description": "User defined reason for creating or updating the index template", "name": "cause", "required": false, "serverDefault": "api", @@ -159918,7 +159929,7 @@ } } ], - "specLocation": "indices/put_index_template/IndicesPutIndexTemplateRequest.ts#L37-L159" + "specLocation": "indices/put_index_template/IndicesPutIndexTemplateRequest.ts#L37-L160" }, { "kind": "response", @@ -160156,7 +160167,7 @@ }, "path": [ { - "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.", + "description": "A comma-separated list of index names the mapping should be added to (supports wildcards).\nUse `_all` or omit to add the mapping on all indices.", "name": "index", "required": true, "type": { @@ -160248,7 +160259,7 @@ } } ], - "specLocation": "indices/put_mapping/IndicesPutMappingRequest.ts#L41-L180" + "specLocation": "indices/put_mapping/IndicesPutMappingRequest.ts#L41-L184" }, { "kind": "response", @@ -160766,7 +160777,7 @@ } }, { - "description": "User defined reason for creating/updating the index template", + "description": "User defined reason for creating or updating the index template", "name": "cause", "required": false, "serverDefault": "", @@ -160779,7 +160790,7 @@ } } ], - "specLocation": "indices/put_template/IndicesPutTemplateRequest.ts#L29-L127" + "specLocation": "indices/put_template/IndicesPutTemplateRequest.ts#L29-L129" }, { "kind": "response", @@ -162208,7 +162219,7 @@ ], "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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "name": "allow_no_indices", "required": false, "type": { @@ -162257,7 +162268,7 @@ } } ], - "specLocation": "indices/reload_search_analyzers/ReloadSearchAnalyzersRequest.ts#L23-L64" + "specLocation": "indices/reload_search_analyzers/ReloadSearchAnalyzersRequest.ts#L23-L75" }, { "kind": "response", @@ -165711,7 +165722,7 @@ }, "path": [ { - "description": "Limit the information returned the specific metrics.", + "description": "Limit the information returned the specific metrics", "name": "metric", "required": false, "type": { @@ -165865,7 +165876,7 @@ } } ], - "specLocation": "indices/stats/IndicesStatsRequest.ts#L29-L115" + "specLocation": "indices/stats/IndicesStatsRequest.ts#L29-L117" }, { "kind": "response", @@ -184222,7 +184233,7 @@ } }, { - "description": "Return pipelines without their definitions (default: false)", + "description": "Return pipelines without their definitions", "name": "summary", "required": false, "serverDefault": false, @@ -184235,7 +184246,7 @@ } } ], - "specLocation": "ingest/get_pipeline/GetPipelineRequest.ts#L24-L64" + "specLocation": "ingest/get_pipeline/GetPipelineRequest.ts#L24-L65" }, { "kind": "response", @@ -186032,9 +186043,10 @@ "path": [], "query": [ { - "description": "whether the user has acknowledged acknowledge messages (default: false)", + "description": "Whether the user has acknowledged acknowledge messages", "name": "acknowledge", "required": false, + "serverDefault": false, "type": { "kind": "instance_of", "type": { @@ -186070,7 +186082,7 @@ } } ], - "specLocation": "license/post_start_basic/StartBasicLicenseRequest.ts#L23-L59" + "specLocation": "license/post_start_basic/StartBasicLicenseRequest.ts#L23-L63" }, { "kind": "response", @@ -186225,9 +186237,10 @@ "path": [], "query": [ { - "description": "whether the user has acknowledged acknowledge messages (default: false)", + "description": "Whether the user has acknowledged acknowledge messages", "name": "acknowledge", "required": false, + "serverDefault": false, "type": { "kind": "instance_of", "type": { @@ -186237,9 +186250,10 @@ } }, { - "description": "The type of trial license to generate (default: \"trial\")", + "description": "The type of trial license to generate", "name": "type", "required": false, + "serverDefault": "trial", "type": { "kind": "instance_of", "type": { @@ -186262,7 +186276,7 @@ } } ], - "specLocation": "license/post_start_trial/StartTrialLicenseRequest.ts#L23-L52" + "specLocation": "license/post_start_trial/StartTrialLicenseRequest.ts#L23-L60" }, { "kind": "response", @@ -208931,7 +208945,7 @@ } } ], - "specLocation": "ml/preview_datafeed/MlPreviewDatafeedRequest.ts#L26-L81" + "specLocation": "ml/preview_datafeed/MlPreviewDatafeedRequest.ts#L26-L83" }, { "kind": "response", @@ -212915,7 +212929,7 @@ } }, { - "description": "The deployment priority.", + "description": "The deployment priority", "name": "priority", "required": false, "type": { @@ -212979,7 +212993,7 @@ } } ], - "specLocation": "ml/start_trained_model_deployment/MlStartTrainedModelDeploymentRequest.ts#L30-L111" + "specLocation": "ml/start_trained_model_deployment/MlStartTrainedModelDeploymentRequest.ts#L30-L112" }, { "kind": "response", @@ -220872,9 +220886,10 @@ } }, { - "description": "The sort order for 'cpu' type (default: total)", + "description": "The sort order for 'cpu' type", "name": "sort", "required": false, + "serverDefault": "total", "type": { "kind": "instance_of", "type": { @@ -220884,7 +220899,7 @@ } } ], - "specLocation": "nodes/hot_threads/NodesHotThreadsRequest.ts#L25-L88" + "specLocation": "nodes/hot_threads/NodesHotThreadsRequest.ts#L25-L92" }, { "kind": "response", @@ -224333,7 +224348,7 @@ } }, { - "description": "Limit the information returned to the specified metrics", + "description": "Limits the information returned to the specific metrics.", "name": "metric", "required": false, "type": { @@ -224685,7 +224700,7 @@ }, "path": [ { - "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", + "description": "A comma-separated list of node IDs or names to limit the returned information.\nUse `_local` to return information from the node you're connecting to, leave empty to get information from all nodes.", "name": "node_id", "required": false, "type": { @@ -224724,7 +224739,7 @@ } } ], - "specLocation": "nodes/usage/NodesUsageRequest.ts#L24-L68" + "specLocation": "nodes/usage/NodesUsageRequest.ts#L24-L72" }, { "kind": "response", @@ -228022,6 +228037,7 @@ "description": "Specify whether aggregation and suggester names should be prefixed by their respective types in the response", "name": "typed_keys", "required": false, + "serverDefault": false, "type": { "kind": "instance_of", "type": { @@ -228031,7 +228047,7 @@ } } ], - "specLocation": "rollup/rollup_search/RollupSearchRequest.ts#L27-L112" + "specLocation": "rollup/rollup_search/RollupSearchRequest.ts#L27-L117" }, { "kind": "response", @@ -230014,7 +230030,7 @@ ], "query": [ { - "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both.", + "description": "Whether to expand wildcard expression to concrete indices that are open, closed or both", "name": "expand_wildcards", "required": false, "serverDefault": "open", @@ -230027,7 +230043,7 @@ } }, { - "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)", + "description": "Whether to ignore if a wildcard indices expression resolves into no concrete indices.\n(This includes `_all` string or when no indices have been specified)", "name": "allow_no_indices", "required": false, "type": { @@ -230051,7 +230067,7 @@ } } ], - "specLocation": "searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts#L23-L57" + "specLocation": "searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts#L23-L67" }, { "kind": "response", @@ -230395,7 +230411,7 @@ } } ], - "specLocation": "searchable_snapshots/stats/SearchableSnapshotsStatsRequest.ts#L24-L55" + "specLocation": "searchable_snapshots/stats/SearchableSnapshotsStatsRequest.ts#L24-L56" }, { "kind": "response", @@ -233793,7 +233809,7 @@ } } ], - "specLocation": "security/bulk_delete_role/SecurityBulkDeleteRoleRequest.ts#L23-L50" + "specLocation": "security/bulk_delete_role/SecurityBulkDeleteRoleRequest.ts#L23-L53" }, { "kind": "response", @@ -234024,7 +234040,7 @@ } } ], - "specLocation": "security/bulk_put_role/SecurityBulkPutRoleRequest.ts#L25-L52" + "specLocation": "security/bulk_put_role/SecurityBulkPutRoleRequest.ts#L25-L55" }, { "kind": "response", @@ -234435,7 +234451,7 @@ } } ], - "specLocation": "security/change_password/SecurityChangePasswordRequest.ts#L23-L65" + "specLocation": "security/change_password/SecurityChangePasswordRequest.ts#L23-L68" }, { "kind": "response", @@ -235250,7 +235266,7 @@ } } ], - "specLocation": "security/create_api_key/SecurityCreateApiKeyRequest.ts#L26-L86" + "specLocation": "security/create_api_key/SecurityCreateApiKeyRequest.ts#L26-L89" }, { "kind": "response", @@ -235621,7 +235637,7 @@ ], "query": [ { - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` (the default) then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes.", + "description": "If `true` (the default) 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` then do nothing with refreshes.", "name": "refresh", "required": false, "type": { @@ -235633,7 +235649,7 @@ } } ], - "specLocation": "security/create_service_token/CreateServiceTokenRequest.ts#L23-L72" + "specLocation": "security/create_service_token/CreateServiceTokenRequest.ts#L23-L75" }, { "kind": "response", @@ -236181,7 +236197,7 @@ } } ], - "specLocation": "security/delete_privileges/SecurityDeletePrivilegesRequest.ts#L23-L58" + "specLocation": "security/delete_privileges/SecurityDeletePrivilegesRequest.ts#L23-L61" }, { "kind": "response", @@ -236307,7 +236323,7 @@ } } ], - "specLocation": "security/delete_role/SecurityDeleteRoleRequest.ts#L23-L49" + "specLocation": "security/delete_role/SecurityDeleteRoleRequest.ts#L23-L52" }, { "kind": "response", @@ -236418,7 +236434,7 @@ } } ], - "specLocation": "security/delete_role_mapping/SecurityDeleteRoleMappingRequest.ts#L23-L53" + "specLocation": "security/delete_role_mapping/SecurityDeleteRoleMappingRequest.ts#L23-L56" }, { "kind": "response", @@ -236541,7 +236557,7 @@ ], "query": [ { - "description": "If `true` then refresh the affected shards to make this operation visible to search, if `wait_for` (the default) then wait for a refresh to make this operation visible to search, if `false` then do nothing with refreshes.", + "description": "If `true` (the default) 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` then do nothing with refreshes.", "name": "refresh", "required": false, "type": { @@ -236553,7 +236569,7 @@ } } ], - "specLocation": "security/delete_service_token/DeleteServiceTokenRequest.ts#L23-L58" + "specLocation": "security/delete_service_token/DeleteServiceTokenRequest.ts#L23-L61" }, { "kind": "response", @@ -236664,7 +236680,7 @@ } } ], - "specLocation": "security/delete_user/SecurityDeleteUserRequest.ts#L23-L48" + "specLocation": "security/delete_user/SecurityDeleteUserRequest.ts#L23-L51" }, { "kind": "response", @@ -236775,7 +236791,7 @@ } } ], - "specLocation": "security/disable_user/SecurityDisableUserRequest.ts#L23-L50" + "specLocation": "security/disable_user/SecurityDisableUserRequest.ts#L23-L53" }, { "kind": "response", @@ -236966,7 +236982,7 @@ } } ], - "specLocation": "security/enable_user/SecurityEnableUserRequest.ts#L23-L49" + "specLocation": "security/enable_user/SecurityEnableUserRequest.ts#L23-L52" }, { "kind": "response", @@ -240237,7 +240253,7 @@ } ], "query": [], - "specLocation": "security/has_privileges/SecurityHasPrivilegesRequest.ts#L25-L59" + "specLocation": "security/has_privileges/SecurityHasPrivilegesRequest.ts#L25-L60" }, { "kind": "type_alias", @@ -241983,7 +241999,7 @@ } } ], - "specLocation": "security/put_privileges/SecurityPutPrivilegesRequest.ts#L25-L67" + "specLocation": "security/put_privileges/SecurityPutPrivilegesRequest.ts#L25-L70" }, { "kind": "response", @@ -242349,7 +242365,7 @@ } } ], - "specLocation": "security/put_role/SecurityPutRoleRequest.ts#L32-L111" + "specLocation": "security/put_role/SecurityPutRoleRequest.ts#L32-L114" }, { "kind": "response", @@ -242801,7 +242817,7 @@ } } ], - "specLocation": "security/put_role_mapping/SecurityPutRoleMappingRequest.ts#L25-L103" + "specLocation": "security/put_role_mapping/SecurityPutRoleMappingRequest.ts#L25-L106" }, { "kind": "response", @@ -246918,7 +246934,7 @@ } } ], - "specLocation": "shutdown/delete_node/ShutdownDeleteNodeRequest.ts#L24-L61" + "specLocation": "shutdown/delete_node/ShutdownDeleteNodeRequest.ts#L24-L62" }, { "kind": "response", @@ -247145,7 +247161,7 @@ }, "path": [ { - "description": "Which node for which to retrieve the shutdown status", + "description": "Comma-separated list of nodes for which to retrieve the shutdown status", "name": "node_id", "required": false, "type": { @@ -247172,7 +247188,7 @@ } } ], - "specLocation": "shutdown/get_node/ShutdownGetNodeRequest.ts#L24-L59" + "specLocation": "shutdown/get_node/ShutdownGetNodeRequest.ts#L24-L60" }, { "kind": "response", @@ -248663,7 +248679,7 @@ } } ], - "specLocation": "slm/delete_lifecycle/DeleteSnapshotLifecycleRequest.ts#L24-L58" + "specLocation": "slm/delete_lifecycle/DeleteSnapshotLifecycleRequest.ts#L24-L59" }, { "kind": "response", @@ -248775,7 +248791,7 @@ } } ], - "specLocation": "slm/execute_lifecycle/ExecuteSnapshotLifecycleRequest.ts#L24-L58" + "specLocation": "slm/execute_lifecycle/ExecuteSnapshotLifecycleRequest.ts#L24-L59" }, { "kind": "response", @@ -248958,7 +248974,7 @@ }, "path": [ { - "description": "Comma-separated list of snapshot lifecycle policies to retrieve", + "description": "A comma-separated list of snapshot lifecycle policy identifiers.", "name": "policy_id", "required": false, "type": { @@ -248998,7 +249014,7 @@ } } ], - "specLocation": "slm/get_lifecycle/GetSnapshotLifecycleRequest.ts#L24-L64" + "specLocation": "slm/get_lifecycle/GetSnapshotLifecycleRequest.ts#L24-L62" }, { "kind": "response", @@ -262320,6 +262336,7 @@ "description": "Controls the time to wait for the stats", "name": "timeout", "required": false, + "serverDefault": "30s", "type": { "kind": "instance_of", "type": { @@ -262329,7 +262346,7 @@ } } ], - "specLocation": "transform/get_transform_stats/GetTransformStatsRequest.ts#L25-L77" + "specLocation": "transform/get_transform_stats/GetTransformStatsRequest.ts#L25-L81" }, { "kind": "response", @@ -270258,7 +270275,7 @@ } }, { - "description": "only update the watch if the last operation that has changed the watch has the specified primary term", + "description": "Only update the watch if the last operation that has changed the watch has the specified primary term", "name": "if_primary_term", "required": false, "type": { @@ -270270,7 +270287,7 @@ } }, { - "description": "only update the watch if the last operation that has changed the watch has the specified sequence number", + "description": "Only update the watch if the last operation that has changed the watch has the specified sequence number", "name": "if_seq_no", "required": false, "type": { @@ -270294,7 +270311,7 @@ } } ], - "specLocation": "watcher/put_watch/WatcherPutWatchRequest.ts#L31-L110" + "specLocation": "watcher/put_watch/WatcherPutWatchRequest.ts#L31-L115" }, { "kind": "response", @@ -271880,7 +271897,7 @@ "description": "Supported for backwards compatibility with 7.x", "version": "8.0.0" }, - "description": "If this param is used it must be set to true", + "description": "If used, this otherwise ignored parameter must be set to true", "name": "accept_enterprise", "required": false, "type": { @@ -271905,7 +271922,7 @@ } } ], - "specLocation": "xpack/info/XPackInfoRequest.ts#L22-L59" + "specLocation": "xpack/info/XPackInfoRequest.ts#L22-L60" }, { "kind": "response", @@ -271987,7 +272004,7 @@ "name": "XPackCategory", "namespace": "xpack.info" }, - "specLocation": "xpack/info/XPackInfoRequest.ts#L61-L65" + "specLocation": "xpack/info/XPackInfoRequest.ts#L62-L66" }, { "kind": "interface", diff --git a/specification/_global/mtermvectors/MultiTermVectorsRequest.ts b/specification/_global/mtermvectors/MultiTermVectorsRequest.ts index ae979954b8..4373531571 100644 --- a/specification/_global/mtermvectors/MultiTermVectorsRequest.ts +++ b/specification/_global/mtermvectors/MultiTermVectorsRequest.ts @@ -66,6 +66,9 @@ export interface Request extends RequestBase { index?: IndexName } query_parameters: { + /** + * A comma-separated list of documents ids. You must define ids as parameter or set "ids" or "docs" in the request body + */ ids?: Id[] /** * A comma-separated list or wildcard expressions of fields to include in the statistics. diff --git a/specification/_global/open_point_in_time/OpenPointInTimeRequest.ts b/specification/_global/open_point_in_time/OpenPointInTimeRequest.ts index 57f73828d9..814f70fc58 100644 --- a/specification/_global/open_point_in_time/OpenPointInTimeRequest.ts +++ b/specification/_global/open_point_in_time/OpenPointInTimeRequest.ts @@ -77,6 +77,9 @@ export interface Request extends RequestBase { } ] path_parts: { + /** + * A comma-separated list of index names to open point in time; use `_all` or empty string to perform the operation on all indices + */ index: Indices } query_parameters: { diff --git a/specification/_global/rank_eval/RankEvalRequest.ts b/specification/_global/rank_eval/RankEvalRequest.ts index 56ff06a8e2..22f1842c97 100644 --- a/specification/_global/rank_eval/RankEvalRequest.ts +++ b/specification/_global/rank_eval/RankEvalRequest.ts @@ -58,6 +58,7 @@ export interface Request extends RequestBase { */ allow_no_indices?: boolean /** + * Whether to expand wildcard expression to concrete indices that are open, closed or both. * @server_default open */ expand_wildcards?: ExpandWildcards @@ -66,6 +67,9 @@ export interface Request extends RequestBase { * @server_default false */ ignore_unavailable?: boolean + /** + * Search operation type + */ search_type?: string } body: { diff --git a/specification/_global/scroll/ScrollRequest.ts b/specification/_global/scroll/ScrollRequest.ts index cfca34a718..b0f4150239 100644 --- a/specification/_global/scroll/ScrollRequest.ts +++ b/specification/_global/scroll/ScrollRequest.ts @@ -57,7 +57,10 @@ export interface Request extends RequestBase { } ] path_parts: { - /** @deprecated 7.0.0 */ + /** + * The scroll ID + * @deprecated 7.0.0 + */ scroll_id?: ScrollId } query_parameters: { @@ -67,7 +70,10 @@ export interface Request extends RequestBase { * @server_default 1d */ scroll?: Duration - /** @deprecated 7.0.0 */ + /** + * The scroll ID + * @deprecated 7.0.0 + */ scroll_id?: ScrollId /** * 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. diff --git a/specification/_global/search_mvt/SearchMvtRequest.ts b/specification/_global/search_mvt/SearchMvtRequest.ts index ea6377a16f..8935c9df7e 100644 --- a/specification/_global/search_mvt/SearchMvtRequest.ts +++ b/specification/_global/search_mvt/SearchMvtRequest.ts @@ -182,14 +182,14 @@ export interface Request extends RequestBase { } ] path_parts: { - /* + /** * A list of indices, data streams, or aliases to search. * It supports wildcards (`*`). * To search all data streams and indices, omit this parameter or use `*` or `_all`. * To search a remote cluster, use the `:` syntax. */ index: Indices - /* + /** * A field that contains the geospatial data to return. * It must be a `geo_point` or `geo_shape` field. * The field must have doc values enabled. It cannot be a nested field. @@ -199,11 +199,11 @@ export interface Request extends RequestBase { * This behavior may change in a future release. */ field: Field - /* The zoom level of the vector tile to search. It accepts `0` to `29`. */ + /** The zoom level of the vector tile to search. It accepts `0` to `29`. */ zoom: ZoomLevel - /* The X coordinate for the vector tile to search. */ + /** The X coordinate for the vector tile to search. */ x: Coordinate - /* The Y coordinate for the vector tile to search. */ + /** The Y coordinate for the vector tile to search. */ y: Coordinate } query_parameters: { diff --git a/specification/_global/update_by_query/UpdateByQueryRequest.ts b/specification/_global/update_by_query/UpdateByQueryRequest.ts index d6611fe598..2a77b5e6e2 100644 --- a/specification/_global/update_by_query/UpdateByQueryRequest.ts +++ b/specification/_global/update_by_query/UpdateByQueryRequest.ts @@ -296,6 +296,9 @@ export interface Request extends RequestBase { * If `true`, returns the document version as part of a hit. */ version?: boolean + /** + * Should the document increment the version number (internal) on hit or not (reindex) + */ version_type?: boolean /** * The number of shard copies that must be active before proceeding with the operation. diff --git a/specification/async_search/get/AsyncSearchGetRequest.ts b/specification/async_search/get/AsyncSearchGetRequest.ts index 3c29b4d7a3..bd0abc8f75 100644 --- a/specification/async_search/get/AsyncSearchGetRequest.ts +++ b/specification/async_search/get/AsyncSearchGetRequest.ts @@ -52,6 +52,9 @@ export interface Request extends RequestBase { * If the search is completed, its saved results are deleted. */ keep_alive?: Duration + /** + * Specify whether aggregation and suggester names should be prefixed by their respective types in the response + */ typed_keys?: boolean /** * Specifies to wait for the search to be completed up until the provided timeout. diff --git a/specification/async_search/submit/AsyncSearchSubmitRequest.ts b/specification/async_search/submit/AsyncSearchSubmitRequest.ts index c6fa38d90f..d59bc5c304 100644 --- a/specification/async_search/submit/AsyncSearchSubmitRequest.ts +++ b/specification/async_search/submit/AsyncSearchSubmitRequest.ts @@ -81,6 +81,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** A comma-separated list of index names to search; use `_all` or empty string to perform the operation on all indices */ index?: Indices } query_parameters: { @@ -101,12 +102,24 @@ export interface Request extends RequestBase { * @server_default false */ keep_on_completion?: boolean + /** + * Whether to ignore if a wildcard indices expression resolves into no concrete indices. + * (This includes `_all` string or when no indices have been specified) + */ allow_no_indices?: boolean /** + * Indicate if an error should be returned if there is a partial search failure or timeout * @server_default true */ allow_partial_search_results?: boolean + /** + * The analyzer to use for the query string + */ analyzer?: string + /** + * Specify whether wildcard and prefix queries should be analyzed + * @server_default false + */ analyze_wildcard?: boolean /** * Affects how often partial results become available, which happens whenever shard results are reduced. @@ -120,60 +133,151 @@ export interface Request extends RequestBase { */ ccs_minimize_roundtrips?: boolean /** + * The default operator for query string query (AND or OR) * @server_default or */ default_operator?: Operator + /** + * The field to use as default where no field prefix is given in the query string + */ df?: string + /** + * A comma-separated list of fields to return as the docvalue representation of a field for each hit + */ docvalue_fields?: Fields /** + * Whether to expand wildcard expression to concrete indices that are open, closed or both * @server_default open */ expand_wildcards?: ExpandWildcards + /** + * Specify whether to return detailed information about score computation as part of a hit + */ explain?: boolean + /** + * Whether specified concrete, expanded or aliased indices should be ignored when throttled + */ ignore_throttled?: boolean + /** + * Whether specified concrete indices should be ignored when unavailable (missing or closed) + */ ignore_unavailable?: boolean + /** + * Specify whether format-based query failures (such as providing text to a numeric field) should be ignored + */ lenient?: boolean /** + * 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 * @server_default 5 */ max_concurrent_shard_requests?: long + /** + * Specify the node or shard the operation should be performed on + * @server_default random + */ preference?: string - /** @server_default true */ + /** + * Specify if request cache should be used for this request or not, defaults to true + * @server_default true + */ request_cache?: boolean + /** + * A comma-separated list of specific routing values + */ routing?: Routing + /** + * Search operation type + */ search_type?: SearchType + /** + * Specific 'tag' of the request for logging and statistical purposes + */ stats?: string[] + /** + * A comma-separated list of stored fields to return as part of a hit + */ stored_fields?: Fields /** * Specifies which field to use for suggestions. */ suggest_field?: Field /** + * Specify suggest mode * @server_default missing */ suggest_mode?: SuggestMode + /** + * How many suggestions to return in response + */ suggest_size?: long /** * The source text for which the suggestions should be returned. */ suggest_text?: string + /** + * The maximum number of documents to collect for each shard, upon reaching which the query execution will terminate early + */ terminate_after?: long + /** + * Explicit operation timeout + */ timeout?: Duration + /** + * Indicate if the number of documents that match the query should be tracked. + * A number can also be specified, to accurately track the total hit count up to the number. + */ track_total_hits?: TrackHits + /** + * Whether to calculate and return scores even if they are not used for sorting + */ track_scores?: boolean + /** + * Specify whether aggregation and suggester names should be prefixed by their respective types in the response + */ typed_keys?: boolean /** + * Indicates whether hits.total should be rendered as an integer or an object in the rest search response * @server_default false */ rest_total_hits_as_int?: boolean + /** + * Specify whether to return document version as part of a hit + */ version?: boolean + /** + * True or false to return the _source field or not, or a list of fields to return + */ _source?: SourceConfigParam + /** + * A list of fields to exclude from the returned _source field + */ _source_excludes?: Fields + /** + * A list of fields to extract and return from the _source field + */ _source_includes?: Fields + /** + * Specify whether to return sequence number and primary term of the last modification of each hit + */ seq_no_primary_term?: boolean + /** + * Query in the Lucene query string syntax + */ q?: string + /** + * Number of hits to return + * @server_default 10 + */ size?: integer + /** + * Starting offset + * @server_default 0 + */ from?: integer + /** + * A comma-separated list of : pairs + */ sort?: string | string[] } body?: { diff --git a/specification/autoscaling/delete_autoscaling_policy/DeleteAutoscalingPolicyRequest.ts b/specification/autoscaling/delete_autoscaling_policy/DeleteAutoscalingPolicyRequest.ts index 2fd2c3ca72..af93f8dbed 100644 --- a/specification/autoscaling/delete_autoscaling_policy/DeleteAutoscalingPolicyRequest.ts +++ b/specification/autoscaling/delete_autoscaling_policy/DeleteAutoscalingPolicyRequest.ts @@ -38,6 +38,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Name of the autoscaling policy */ name: Name } query_parameters: { diff --git a/specification/autoscaling/get_autoscaling_policy/GetAutoscalingPolicyRequest.ts b/specification/autoscaling/get_autoscaling_policy/GetAutoscalingPolicyRequest.ts index d0881cc13c..1a34420285 100644 --- a/specification/autoscaling/get_autoscaling_policy/GetAutoscalingPolicyRequest.ts +++ b/specification/autoscaling/get_autoscaling_policy/GetAutoscalingPolicyRequest.ts @@ -38,6 +38,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Name of the autoscaling policy */ name: Name } query_parameters: { diff --git a/specification/autoscaling/put_autoscaling_policy/PutAutoscalingPolicyRequest.ts b/specification/autoscaling/put_autoscaling_policy/PutAutoscalingPolicyRequest.ts index 7672d23156..9fcb9de543 100644 --- a/specification/autoscaling/put_autoscaling_policy/PutAutoscalingPolicyRequest.ts +++ b/specification/autoscaling/put_autoscaling_policy/PutAutoscalingPolicyRequest.ts @@ -39,6 +39,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Name of the autoscaling policy */ name: Name } query_parameters: { diff --git a/specification/cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts b/specification/cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts index 44138f5ba6..65dd92fa84 100644 --- a/specification/cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts +++ b/specification/cat/ml_data_frame_analytics/CatDataFrameAnalyticsRequest.ts @@ -47,6 +47,7 @@ export interface Request extends CatRequestBase { } ] path_parts: { + /** The ID of the data frame analytics to fetch */ id?: Id } query_parameters: { diff --git a/specification/ccr/forget_follower/ForgetFollowerIndexRequest.ts b/specification/ccr/forget_follower/ForgetFollowerIndexRequest.ts index 3ce2b2f7c3..5f9a995569 100644 --- a/specification/ccr/forget_follower/ForgetFollowerIndexRequest.ts +++ b/specification/ccr/forget_follower/ForgetFollowerIndexRequest.ts @@ -47,6 +47,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Name of the leader index for which specified follower retention leases should be removed */ index: IndexName } query_parameters: { diff --git a/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts b/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts index cc8c196c6c..f7d5723bd9 100644 --- a/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts +++ b/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts @@ -41,6 +41,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Name of the follow index to resume following */ index: IndexName } query_parameters: { diff --git a/specification/cluster/get_component_template/ClusterGetComponentTemplateRequest.ts b/specification/cluster/get_component_template/ClusterGetComponentTemplateRequest.ts index aff980511b..297f4fbee0 100644 --- a/specification/cluster/get_component_template/ClusterGetComponentTemplateRequest.ts +++ b/specification/cluster/get_component_template/ClusterGetComponentTemplateRequest.ts @@ -60,6 +60,7 @@ export interface Request extends RequestBase { */ settings_filter?: string | string[] /** + * Return all default configurations for the component template * @server_default false * @availability stack since=8.11.0 stability=stable * @availability serverless stability=stable diff --git a/specification/cluster/health/ClusterHealthRequest.ts b/specification/cluster/health/ClusterHealthRequest.ts index 23b5cd83d5..5bc4a77f3c 100644 --- a/specification/cluster/health/ClusterHealthRequest.ts +++ b/specification/cluster/health/ClusterHealthRequest.ts @@ -67,6 +67,7 @@ export interface Request extends RequestBase { } query_parameters: { /** + * Whether to expand wildcard expression to concrete indices that are open, closed or both. * @server_default all */ expand_wildcards?: ExpandWildcards diff --git a/specification/cluster/put_settings/ClusterPutSettingsRequest.ts b/specification/cluster/put_settings/ClusterPutSettingsRequest.ts index ed10c39634..fd8ac6dae8 100644 --- a/specification/cluster/put_settings/ClusterPutSettingsRequest.ts +++ b/specification/cluster/put_settings/ClusterPutSettingsRequest.ts @@ -56,10 +56,20 @@ export interface Request extends RequestBase { } ] query_parameters: { + /** + * Return settings in flat format + * @server_default false + */ flat_settings?: boolean - /** @server_default 30s */ + /** + * The period to wait for a connection to the master node. + * @server_default 30s + */ master_timeout?: Duration - /** @server_default 30s */ + /** + * The period to wait for a response. + * @server_default 30s + */ timeout?: Duration } body: { diff --git a/specification/cluster/state/ClusterStateRequest.ts b/specification/cluster/state/ClusterStateRequest.ts index 69017251de..28754cf707 100644 --- a/specification/cluster/state/ClusterStateRequest.ts +++ b/specification/cluster/state/ClusterStateRequest.ts @@ -68,19 +68,36 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Limit the information returned to the specified metrics. */ metric?: Metrics + /** + * A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices + */ index?: Indices } query_parameters: { - /** @server_default true */ + /** + * Whether to ignore if a wildcard indices expression resolves into no concrete indices. + * (This includes `_all` string or when no indices have been specified) + * @server_default true */ allow_no_indices?: boolean - /** @server_default open */ + /** + * Whether to expand wildcard expression to concrete indices that are open, closed or both + * @server_default open + */ expand_wildcards?: ExpandWildcards - /** @server_default false */ + /** + * Return settings in flat format + * @server_default false + */ flat_settings?: boolean - /** @server_default false */ + /** + * Whether specified concrete indices should be ignored when unavailable (missing or closed) + * @server_default false + */ ignore_unavailable?: boolean /** + * Return local information, do not retrieve the state from master node * @deprecated 9.0.0 This parameter has no effect, is now deprecated, and will be removed in a future version. * @server_default false */ @@ -90,7 +107,13 @@ export interface Request extends RequestBase { * @server_default 30s * */ master_timeout?: Duration + /** + * Wait for the metadata version to be equal or greater than the specified metadata version + */ wait_for_metadata_version?: VersionNumber + /** + * The maximum time to wait for wait_for_metadata_version before timing out + */ wait_for_timeout?: Duration } } diff --git a/specification/dangling_indices/delete_dangling_index/DeleteDanglingIndexRequest.ts b/specification/dangling_indices/delete_dangling_index/DeleteDanglingIndexRequest.ts index 760dd2ff1c..9bacf770b0 100644 --- a/specification/dangling_indices/delete_dangling_index/DeleteDanglingIndexRequest.ts +++ b/specification/dangling_indices/delete_dangling_index/DeleteDanglingIndexRequest.ts @@ -51,9 +51,14 @@ export interface Request extends RequestBase { */ accept_data_loss?: boolean /** + * The period to wait for a connection to the master node. * @server_default 30s */ master_timeout?: Duration + /** + * The period to wait for a response. + * @server_default 30s + */ timeout?: Duration } } diff --git a/specification/dangling_indices/import_dangling_index/ImportDanglingIndexRequest.ts b/specification/dangling_indices/import_dangling_index/ImportDanglingIndexRequest.ts index 21c4e97314..14e6a1823b 100644 --- a/specification/dangling_indices/import_dangling_index/ImportDanglingIndexRequest.ts +++ b/specification/dangling_indices/import_dangling_index/ImportDanglingIndexRequest.ts @@ -53,9 +53,14 @@ export interface Request extends RequestBase { */ accept_data_loss?: boolean /** + * The period to wait for a connection to the master node. * @server_default 30s */ master_timeout?: Duration + /** + * The period to wait for a response. + * @server_default 30s + */ timeout?: Duration } } diff --git a/specification/eql/search/EqlSearchRequest.ts b/specification/eql/search/EqlSearchRequest.ts index 91ccd44944..d4d2145e47 100644 --- a/specification/eql/search/EqlSearchRequest.ts +++ b/specification/eql/search/EqlSearchRequest.ts @@ -43,10 +43,13 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Comma-separated list of index names to scope the operation */ index: Indices } query_parameters: { /** + * Whether to ignore if a wildcard indices expression resolves into no concrete indices. + * (This includes `_all` string or when no indices have been specified) * @server_default true */ allow_no_indices?: boolean @@ -62,6 +65,7 @@ export interface Request extends RequestBase { */ allow_partial_sequence_results?: boolean /** + * Whether to expand wildcard expression to concrete indices that are open, closed or both. * @server_default open */ expand_wildcards?: ExpandWildcards diff --git a/specification/ilm/move_to_step/MoveToStepRequest.ts b/specification/ilm/move_to_step/MoveToStepRequest.ts index 387d769b0e..bdd10362af 100644 --- a/specification/ilm/move_to_step/MoveToStepRequest.ts +++ b/specification/ilm/move_to_step/MoveToStepRequest.ts @@ -49,6 +49,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** The name of the index whose lifecycle step is to change */ index: IndexName } body: { diff --git a/specification/ilm/remove_policy/RemovePolicyRequest.ts b/specification/ilm/remove_policy/RemovePolicyRequest.ts index 9e2181480a..f94a62900f 100644 --- a/specification/ilm/remove_policy/RemovePolicyRequest.ts +++ b/specification/ilm/remove_policy/RemovePolicyRequest.ts @@ -37,6 +37,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** The name of the index to remove policy on */ index: IndexName } } diff --git a/specification/ilm/retry/RetryIlmRequest.ts b/specification/ilm/retry/RetryIlmRequest.ts index c08af01285..7448f2aae9 100644 --- a/specification/ilm/retry/RetryIlmRequest.ts +++ b/specification/ilm/retry/RetryIlmRequest.ts @@ -38,6 +38,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** The name of the indices (comma-separated) whose failed lifecycle step is to be retry */ index: IndexName } } diff --git a/specification/indices/delete_data_lifecycle/IndicesDeleteDataLifecycleRequest.ts b/specification/indices/delete_data_lifecycle/IndicesDeleteDataLifecycleRequest.ts index da713a9e9d..5048d290db 100644 --- a/specification/indices/delete_data_lifecycle/IndicesDeleteDataLifecycleRequest.ts +++ b/specification/indices/delete_data_lifecycle/IndicesDeleteDataLifecycleRequest.ts @@ -38,17 +38,27 @@ export interface Request extends RequestBase { } ] path_parts: { + /** + * A comma-separated list of data streams of which the data stream lifecycle will be deleted. + * Use `*` to get all data streams + */ name: DataStreamNames } query_parameters: { /** + * Whether wildcard expressions should get expanded to open or closed indices (default: open) * @server_default open */ expand_wildcards?: ExpandWildcards /** + * The period to wait for a connection to the master node. * @server_default 30s */ master_timeout?: Duration + /** + * The period to wait for a response. + * @server_default 30s + */ timeout?: Duration } } diff --git a/specification/indices/explain_data_lifecycle/IndicesExplainDataLifecycleRequest.ts b/specification/indices/explain_data_lifecycle/IndicesExplainDataLifecycleRequest.ts index 0b893a628a..240f3704e9 100644 --- a/specification/indices/explain_data_lifecycle/IndicesExplainDataLifecycleRequest.ts +++ b/specification/indices/explain_data_lifecycle/IndicesExplainDataLifecycleRequest.ts @@ -39,11 +39,17 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Comma-separated list of index names to explain */ index: Indices } query_parameters: { + /** + * Indicates if the API should return the default values the system uses for the index's lifecycle + * @server_default false + */ include_defaults?: boolean /** + * The period to wait for a connection to the master node. * @server_default 30s */ master_timeout?: Duration diff --git a/specification/indices/forcemerge/IndicesForceMergeRequest.ts b/specification/indices/forcemerge/IndicesForceMergeRequest.ts index 108db6fe4f..1016bc2c91 100644 --- a/specification/indices/forcemerge/IndicesForceMergeRequest.ts +++ b/specification/indices/forcemerge/IndicesForceMergeRequest.ts @@ -94,19 +94,42 @@ export interface Request extends RequestBase { } ] path_parts: { + /** + * A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices + */ index?: Indices } query_parameters: { + /** + * Whether to ignore if a wildcard indices expression resolves into no concrete indices. + * (This includes `_all` string or when no indices have been specified) + */ allow_no_indices?: boolean /** + * Whether to expand wildcard expression to concrete indices that are open, closed or both. * @server_default open */ expand_wildcards?: ExpandWildcards + /** + * Specify whether the index should be flushed after performing the operation + * @server_default true + */ flush?: boolean + /** + * Whether specified concrete indices should be ignored when unavailable (missing or closed) + */ ignore_unavailable?: boolean + /** + * The number of segments the index should be merged into (defayult: dynamic) + */ max_num_segments?: long + /** + * Specify whether the operation should only expunge deleted documents + * @server_default false + */ only_expunge_deletes?: boolean /** + * Should the request wait until the force merge is completed * @server_default true */ wait_for_completion?: boolean diff --git a/specification/indices/promote_data_stream/IndicesPromoteDataStreamRequest.ts b/specification/indices/promote_data_stream/IndicesPromoteDataStreamRequest.ts index 906d3510d7..943920373d 100644 --- a/specification/indices/promote_data_stream/IndicesPromoteDataStreamRequest.ts +++ b/specification/indices/promote_data_stream/IndicesPromoteDataStreamRequest.ts @@ -46,6 +46,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** The name of the data stream to promote */ name: IndexName } query_parameters: { diff --git a/specification/indices/put_index_template/IndicesPutIndexTemplateRequest.ts b/specification/indices/put_index_template/IndicesPutIndexTemplateRequest.ts index d655526a64..49667b1c53 100644 --- a/specification/indices/put_index_template/IndicesPutIndexTemplateRequest.ts +++ b/specification/indices/put_index_template/IndicesPutIndexTemplateRequest.ts @@ -152,6 +152,7 @@ export interface Request extends RequestBase { * @server_default 30s */ master_timeout?: Duration /** + * User defined reason for creating or updating the index template * @server_default api */ cause?: string diff --git a/specification/indices/put_mapping/IndicesPutMappingRequest.ts b/specification/indices/put_mapping/IndicesPutMappingRequest.ts index 092c787406..b2e707b879 100644 --- a/specification/indices/put_mapping/IndicesPutMappingRequest.ts +++ b/specification/indices/put_mapping/IndicesPutMappingRequest.ts @@ -83,6 +83,10 @@ export interface Request extends RequestBase { } ] path_parts: { + /** + * 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. + */ index: Indices } query_parameters: { diff --git a/specification/indices/put_template/IndicesPutTemplateRequest.ts b/specification/indices/put_template/IndicesPutTemplateRequest.ts index 5850a83152..b816149dea 100644 --- a/specification/indices/put_template/IndicesPutTemplateRequest.ts +++ b/specification/indices/put_template/IndicesPutTemplateRequest.ts @@ -64,6 +64,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** The name of the template */ name: Name } query_parameters: { @@ -87,6 +88,7 @@ export interface Request extends RequestBase { */ order?: integer /** + * User defined reason for creating or updating the index template * @server_default */ cause?: string diff --git a/specification/indices/reload_search_analyzers/ReloadSearchAnalyzersRequest.ts b/specification/indices/reload_search_analyzers/ReloadSearchAnalyzersRequest.ts index 5bab1b32f8..ff73253e94 100644 --- a/specification/indices/reload_search_analyzers/ReloadSearchAnalyzersRequest.ts +++ b/specification/indices/reload_search_analyzers/ReloadSearchAnalyzersRequest.ts @@ -49,12 +49,23 @@ export interface Request extends RequestBase { } ] path_parts: { + /** A comma-separated list of index names to reload analyzers for */ index: Indices } query_parameters: { + /** + * Whether to ignore if a wildcard indices expression resolves into no concrete indices. + * (This includes `_all` string or when no indices have been specified) + */ allow_no_indices?: boolean - /** @server_default open */ + /** + * Whether to expand wildcard expression to concrete indices that are open, closed or both. + * @server_default open + */ expand_wildcards?: ExpandWildcards + /** + * Whether specified concrete indices should be ignored when unavailable (missing or closed) + */ ignore_unavailable?: boolean /** * Changed resource to reload analyzers from if applicable diff --git a/specification/indices/stats/IndicesStatsRequest.ts b/specification/indices/stats/IndicesStatsRequest.ts index 2ccb72d094..e532182148 100644 --- a/specification/indices/stats/IndicesStatsRequest.ts +++ b/specification/indices/stats/IndicesStatsRequest.ts @@ -64,7 +64,9 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Limit the information returned the specific metrics */ metric?: Metrics + /** A comma-separated list of index names; use `_all` or empty string to perform the operation on all indices */ index?: Indices } query_parameters: { diff --git a/specification/ingest/get_pipeline/GetPipelineRequest.ts b/specification/ingest/get_pipeline/GetPipelineRequest.ts index 9b4a680784..51c69151a6 100644 --- a/specification/ingest/get_pipeline/GetPipelineRequest.ts +++ b/specification/ingest/get_pipeline/GetPipelineRequest.ts @@ -58,6 +58,7 @@ export interface Request extends RequestBase { * @server_default 30s */ master_timeout?: Duration /** + * Return pipelines without their definitions * @server_default false */ summary?: boolean } diff --git a/specification/license/post_start_basic/StartBasicLicenseRequest.ts b/specification/license/post_start_basic/StartBasicLicenseRequest.ts index b9bfadd74d..429792316a 100644 --- a/specification/license/post_start_basic/StartBasicLicenseRequest.ts +++ b/specification/license/post_start_basic/StartBasicLicenseRequest.ts @@ -44,6 +44,10 @@ export interface Request extends RequestBase { } ] query_parameters: { + /** + * Whether the user has acknowledged acknowledge messages + * @server_default false + */ acknowledge?: boolean /** * Period to wait for a connection to the master node. diff --git a/specification/license/post_start_trial/StartTrialLicenseRequest.ts b/specification/license/post_start_trial/StartTrialLicenseRequest.ts index ad33b3072a..9b2a25ea6e 100644 --- a/specification/license/post_start_trial/StartTrialLicenseRequest.ts +++ b/specification/license/post_start_trial/StartTrialLicenseRequest.ts @@ -41,7 +41,15 @@ export interface Request extends RequestBase { } ] query_parameters: { + /** + * Whether the user has acknowledged acknowledge messages + * @server_default false + */ acknowledge?: boolean + /** + * The type of trial license to generate + * @server_default trial + */ type?: string /** * Period to wait for a connection to the master node. diff --git a/specification/ml/preview_datafeed/MlPreviewDatafeedRequest.ts b/specification/ml/preview_datafeed/MlPreviewDatafeedRequest.ts index 8112cf536c..d3fb582d68 100644 --- a/specification/ml/preview_datafeed/MlPreviewDatafeedRequest.ts +++ b/specification/ml/preview_datafeed/MlPreviewDatafeedRequest.ts @@ -62,7 +62,9 @@ export interface Request extends RequestBase { datafeed_id?: Id } query_parameters: { + /** The start time from where the datafeed preview should begin */ start?: DateTime + /** The end time when the datafeed preview should stop */ end?: DateTime } body?: { diff --git a/specification/ml/start_trained_model_deployment/MlStartTrainedModelDeploymentRequest.ts b/specification/ml/start_trained_model_deployment/MlStartTrainedModelDeploymentRequest.ts index c592b880eb..a447d00923 100644 --- a/specification/ml/start_trained_model_deployment/MlStartTrainedModelDeploymentRequest.ts +++ b/specification/ml/start_trained_model_deployment/MlStartTrainedModelDeploymentRequest.ts @@ -73,6 +73,7 @@ export interface Request extends RequestBase { * @server_default 1 */ number_of_allocations?: integer + /** The deployment priority */ priority?: TrainingPriority /** * Specifies the number of inference requests that are allowed in the queue. After the number of requests exceeds diff --git a/specification/nodes/hot_threads/NodesHotThreadsRequest.ts b/specification/nodes/hot_threads/NodesHotThreadsRequest.ts index d1622fd633..d8c41d48bd 100644 --- a/specification/nodes/hot_threads/NodesHotThreadsRequest.ts +++ b/specification/nodes/hot_threads/NodesHotThreadsRequest.ts @@ -83,6 +83,10 @@ export interface Request extends RequestBase { * @server_default cpu */ type?: ThreadType + /** + * The sort order for 'cpu' type + * @server_default total + */ sort?: ThreadType } } diff --git a/specification/nodes/stats/NodesStatsRequest.ts b/specification/nodes/stats/NodesStatsRequest.ts index 58ba90ba9a..1c2e57fff2 100644 --- a/specification/nodes/stats/NodesStatsRequest.ts +++ b/specification/nodes/stats/NodesStatsRequest.ts @@ -62,9 +62,9 @@ export interface Request extends RequestBase { path_parts: { /** Comma-separated list of node IDs or names used to limit returned information. */ node_id?: NodeIds - /*+ Limits the information returned to the specific metrics. */ + /** Limits the information returned to the specific metrics. */ metric?: Metrics - /** Limit the information returned for indices metric to the specific index metrics. It can be used only if indices (or all) metric is 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. */ index_metric?: Metrics } query_parameters: { diff --git a/specification/nodes/usage/NodesUsageRequest.ts b/specification/nodes/usage/NodesUsageRequest.ts index ac676c82d7..064fd9fe82 100644 --- a/specification/nodes/usage/NodesUsageRequest.ts +++ b/specification/nodes/usage/NodesUsageRequest.ts @@ -50,6 +50,10 @@ export interface Request extends RequestBase { } ] path_parts: { + /** + * 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. + */ node_id?: NodeIds /** * Limits the information returned to the specific metrics. diff --git a/specification/rollup/rollup_search/RollupSearchRequest.ts b/specification/rollup/rollup_search/RollupSearchRequest.ts index 1a062c3e61..1b8ec59d60 100644 --- a/specification/rollup/rollup_search/RollupSearchRequest.ts +++ b/specification/rollup/rollup_search/RollupSearchRequest.ts @@ -87,9 +87,14 @@ export interface Request extends RequestBase { } query_parameters: { /** + * Indicates whether hits.total should be rendered as an integer or an object in the rest search response * @server_default false */ rest_total_hits_as_int?: boolean + /** + * Specify whether aggregation and suggester names should be prefixed by their respective types in the response + * @server_default false + */ typed_keys?: boolean } body: { diff --git a/specification/searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts b/specification/searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts index 975650e1bd..f6c25a5ed6 100644 --- a/specification/searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts +++ b/specification/searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts @@ -49,9 +49,19 @@ export interface Request extends RequestBase { index?: Indices } query_parameters: { - /** @server_default open */ + /** + * Whether to expand wildcard expression to concrete indices that are open, closed or both + * @server_default open + */ expand_wildcards?: ExpandWildcards + /** + * Whether to ignore if a wildcard indices expression resolves into no concrete indices. + * (This includes `_all` string or when no indices have been specified) + */ allow_no_indices?: boolean + /** + * Whether specified concrete indices should be ignored when unavailable (missing or closed) + */ ignore_unavailable?: boolean } } diff --git a/specification/searchable_snapshots/stats/SearchableSnapshotsStatsRequest.ts b/specification/searchable_snapshots/stats/SearchableSnapshotsStatsRequest.ts index e376952582..f0caed63cf 100644 --- a/specification/searchable_snapshots/stats/SearchableSnapshotsStatsRequest.ts +++ b/specification/searchable_snapshots/stats/SearchableSnapshotsStatsRequest.ts @@ -48,6 +48,7 @@ export interface Request extends RequestBase { } query_parameters: { /** + * Return stats aggregated at cluster, index or shard level * @server_default indices */ level?: StatsLevel diff --git a/specification/security/bulk_delete_role/SecurityBulkDeleteRoleRequest.ts b/specification/security/bulk_delete_role/SecurityBulkDeleteRoleRequest.ts index da7feb5b66..81c8eba87e 100644 --- a/specification/security/bulk_delete_role/SecurityBulkDeleteRoleRequest.ts +++ b/specification/security/bulk_delete_role/SecurityBulkDeleteRoleRequest.ts @@ -39,6 +39,9 @@ export interface Request extends RequestBase { } ] query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } body: { diff --git a/specification/security/bulk_put_role/SecurityBulkPutRoleRequest.ts b/specification/security/bulk_put_role/SecurityBulkPutRoleRequest.ts index 866d913dd0..3ff7981b55 100644 --- a/specification/security/bulk_put_role/SecurityBulkPutRoleRequest.ts +++ b/specification/security/bulk_put_role/SecurityBulkPutRoleRequest.ts @@ -41,6 +41,9 @@ export interface Request extends RequestBase { } ] query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } body: { diff --git a/specification/security/change_password/SecurityChangePasswordRequest.ts b/specification/security/change_password/SecurityChangePasswordRequest.ts index 59f58d96cd..faf27fbde7 100644 --- a/specification/security/change_password/SecurityChangePasswordRequest.ts +++ b/specification/security/change_password/SecurityChangePasswordRequest.ts @@ -47,6 +47,9 @@ export interface Request extends RequestBase { username?: Username } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } body: { diff --git a/specification/security/create_api_key/SecurityCreateApiKeyRequest.ts b/specification/security/create_api_key/SecurityCreateApiKeyRequest.ts index 2075d8bbb4..55476916e5 100644 --- a/specification/security/create_api_key/SecurityCreateApiKeyRequest.ts +++ b/specification/security/create_api_key/SecurityCreateApiKeyRequest.ts @@ -53,6 +53,9 @@ export interface Request extends RequestBase { } ] query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } body: { diff --git a/specification/security/create_service_token/CreateServiceTokenRequest.ts b/specification/security/create_service_token/CreateServiceTokenRequest.ts index b7eb0f778f..9215033b27 100644 --- a/specification/security/create_service_token/CreateServiceTokenRequest.ts +++ b/specification/security/create_service_token/CreateServiceTokenRequest.ts @@ -67,6 +67,9 @@ export interface Request extends RequestBase { name?: Name } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } } diff --git a/specification/security/delete_privileges/SecurityDeletePrivilegesRequest.ts b/specification/security/delete_privileges/SecurityDeletePrivilegesRequest.ts index 21494e9b76..3514ca1f4e 100644 --- a/specification/security/delete_privileges/SecurityDeletePrivilegesRequest.ts +++ b/specification/security/delete_privileges/SecurityDeletePrivilegesRequest.ts @@ -53,6 +53,9 @@ export interface Request extends RequestBase { name: Names } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } } diff --git a/specification/security/delete_role/SecurityDeleteRoleRequest.ts b/specification/security/delete_role/SecurityDeleteRoleRequest.ts index 6d5a4142ac..5d5d03ab73 100644 --- a/specification/security/delete_role/SecurityDeleteRoleRequest.ts +++ b/specification/security/delete_role/SecurityDeleteRoleRequest.ts @@ -44,6 +44,9 @@ export interface Request extends RequestBase { name: Name } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } } diff --git a/specification/security/delete_role_mapping/SecurityDeleteRoleMappingRequest.ts b/specification/security/delete_role_mapping/SecurityDeleteRoleMappingRequest.ts index 860caa17fa..e516afb02d 100644 --- a/specification/security/delete_role_mapping/SecurityDeleteRoleMappingRequest.ts +++ b/specification/security/delete_role_mapping/SecurityDeleteRoleMappingRequest.ts @@ -48,6 +48,9 @@ export interface Request extends RequestBase { name: Name } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } } diff --git a/specification/security/delete_service_token/DeleteServiceTokenRequest.ts b/specification/security/delete_service_token/DeleteServiceTokenRequest.ts index 3507949cf0..77629dd408 100644 --- a/specification/security/delete_service_token/DeleteServiceTokenRequest.ts +++ b/specification/security/delete_service_token/DeleteServiceTokenRequest.ts @@ -53,6 +53,9 @@ export interface Request extends RequestBase { name: Name } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } } diff --git a/specification/security/delete_user/SecurityDeleteUserRequest.ts b/specification/security/delete_user/SecurityDeleteUserRequest.ts index bc39856160..871d781a2f 100644 --- a/specification/security/delete_user/SecurityDeleteUserRequest.ts +++ b/specification/security/delete_user/SecurityDeleteUserRequest.ts @@ -43,6 +43,9 @@ export interface Request extends RequestBase { username: Username } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } } diff --git a/specification/security/disable_user/SecurityDisableUserRequest.ts b/specification/security/disable_user/SecurityDisableUserRequest.ts index cbbba7450a..a5e4ce404c 100644 --- a/specification/security/disable_user/SecurityDisableUserRequest.ts +++ b/specification/security/disable_user/SecurityDisableUserRequest.ts @@ -45,6 +45,9 @@ export interface Request extends RequestBase { username: Username } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } } diff --git a/specification/security/enable_user/SecurityEnableUserRequest.ts b/specification/security/enable_user/SecurityEnableUserRequest.ts index 60c53228a4..5e7558a4a1 100644 --- a/specification/security/enable_user/SecurityEnableUserRequest.ts +++ b/specification/security/enable_user/SecurityEnableUserRequest.ts @@ -44,6 +44,9 @@ export interface Request extends RequestBase { username: Username } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } } diff --git a/specification/security/has_privileges/SecurityHasPrivilegesRequest.ts b/specification/security/has_privileges/SecurityHasPrivilegesRequest.ts index 4aa616a508..8fc7670211 100644 --- a/specification/security/has_privileges/SecurityHasPrivilegesRequest.ts +++ b/specification/security/has_privileges/SecurityHasPrivilegesRequest.ts @@ -46,6 +46,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Username */ user?: Name } body: { diff --git a/specification/security/put_privileges/SecurityPutPrivilegesRequest.ts b/specification/security/put_privileges/SecurityPutPrivilegesRequest.ts index 213c612a44..b047583d6f 100644 --- a/specification/security/put_privileges/SecurityPutPrivilegesRequest.ts +++ b/specification/security/put_privileges/SecurityPutPrivilegesRequest.ts @@ -57,6 +57,9 @@ export interface Request extends RequestBase { } ] query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } /** diff --git a/specification/security/put_role/SecurityPutRoleRequest.ts b/specification/security/put_role/SecurityPutRoleRequest.ts index 81fbddf81e..a7e99570c6 100644 --- a/specification/security/put_role/SecurityPutRoleRequest.ts +++ b/specification/security/put_role/SecurityPutRoleRequest.ts @@ -56,6 +56,9 @@ export interface Request extends RequestBase { name: Name } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } body: { diff --git a/specification/security/put_role_mapping/SecurityPutRoleMappingRequest.ts b/specification/security/put_role_mapping/SecurityPutRoleMappingRequest.ts index 7aef398301..9c72b7b79f 100644 --- a/specification/security/put_role_mapping/SecurityPutRoleMappingRequest.ts +++ b/specification/security/put_role_mapping/SecurityPutRoleMappingRequest.ts @@ -71,6 +71,9 @@ export interface Request extends RequestBase { name: Name } query_parameters: { + /** + * If `true` (the default) 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` then do nothing with refreshes. + */ refresh?: Refresh } body: { diff --git a/specification/shutdown/delete_node/ShutdownDeleteNodeRequest.ts b/specification/shutdown/delete_node/ShutdownDeleteNodeRequest.ts index 13f07de469..c9238fc1bb 100644 --- a/specification/shutdown/delete_node/ShutdownDeleteNodeRequest.ts +++ b/specification/shutdown/delete_node/ShutdownDeleteNodeRequest.ts @@ -44,6 +44,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** The node id of node to be removed from the shutdown state */ node_id: NodeId } query_parameters: { diff --git a/specification/shutdown/get_node/ShutdownGetNodeRequest.ts b/specification/shutdown/get_node/ShutdownGetNodeRequest.ts index 9c19f823c4..0763eb731a 100644 --- a/specification/shutdown/get_node/ShutdownGetNodeRequest.ts +++ b/specification/shutdown/get_node/ShutdownGetNodeRequest.ts @@ -47,6 +47,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** Comma-separated list of nodes for which to retrieve the shutdown status */ node_id?: NodeIds } query_parameters: { diff --git a/specification/slm/delete_lifecycle/DeleteSnapshotLifecycleRequest.ts b/specification/slm/delete_lifecycle/DeleteSnapshotLifecycleRequest.ts index 931f152090..117eff1ff8 100644 --- a/specification/slm/delete_lifecycle/DeleteSnapshotLifecycleRequest.ts +++ b/specification/slm/delete_lifecycle/DeleteSnapshotLifecycleRequest.ts @@ -39,6 +39,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** The id of the snapshot lifecycle policy to remove */ policy_id: Name } query_parameters: { diff --git a/specification/slm/execute_lifecycle/ExecuteSnapshotLifecycleRequest.ts b/specification/slm/execute_lifecycle/ExecuteSnapshotLifecycleRequest.ts index f9310b5f74..65b5a6dfc9 100644 --- a/specification/slm/execute_lifecycle/ExecuteSnapshotLifecycleRequest.ts +++ b/specification/slm/execute_lifecycle/ExecuteSnapshotLifecycleRequest.ts @@ -39,6 +39,7 @@ export interface Request extends RequestBase { } ] path_parts: { + /** The id of the snapshot lifecycle policy to be executed */ policy_id: Name } query_parameters: { diff --git a/specification/slm/get_lifecycle/GetSnapshotLifecycleRequest.ts b/specification/slm/get_lifecycle/GetSnapshotLifecycleRequest.ts index 288d038222..f91ef5a828 100644 --- a/specification/slm/get_lifecycle/GetSnapshotLifecycleRequest.ts +++ b/specification/slm/get_lifecycle/GetSnapshotLifecycleRequest.ts @@ -42,9 +42,7 @@ export interface Request extends RequestBase { } ] path_parts: { - /* - A comma-separate list of snapshot lifecycle policy identifiers. - */ + /** A comma-separated list of snapshot lifecycle policy identifiers. */ policy_id?: Names } query_parameters: { diff --git a/specification/transform/get_transform_stats/GetTransformStatsRequest.ts b/specification/transform/get_transform_stats/GetTransformStatsRequest.ts index c01aeffcd1..6bac02dbf3 100644 --- a/specification/transform/get_transform_stats/GetTransformStatsRequest.ts +++ b/specification/transform/get_transform_stats/GetTransformStatsRequest.ts @@ -72,6 +72,10 @@ export interface Request extends RequestBase { * @server_default 100 */ size?: long + /** + * Controls the time to wait for the stats + * @server_default 30s + */ timeout?: Duration } } diff --git a/specification/watcher/put_watch/WatcherPutWatchRequest.ts b/specification/watcher/put_watch/WatcherPutWatchRequest.ts index 672c086067..b7c418e79f 100644 --- a/specification/watcher/put_watch/WatcherPutWatchRequest.ts +++ b/specification/watcher/put_watch/WatcherPutWatchRequest.ts @@ -66,8 +66,13 @@ export interface Request extends RequestBase { * @server_default true */ active?: boolean + /** + * Only update the watch if the last operation that has changed the watch has the specified primary term + */ if_primary_term?: long + /** Only update the watch if the last operation that has changed the watch has the specified sequence number */ if_seq_no?: SequenceNumber + /** Explicit version number for concurrency control */ version?: VersionNumber } body: { diff --git a/specification/xpack/info/XPackInfoRequest.ts b/specification/xpack/info/XPackInfoRequest.ts index 7b193c9196..24d657fcb1 100644 --- a/specification/xpack/info/XPackInfoRequest.ts +++ b/specification/xpack/info/XPackInfoRequest.ts @@ -46,6 +46,7 @@ export interface Request extends RequestBase { */ categories?: XPackCategory[] /** + * If used, this otherwise ignored parameter must be set to true * @deprecated 8.0.0 Supported for backwards compatibility with 7.x */ accept_enterprise?: boolean