From 43fccc0b6569dd88a1c2dffcc7c446e05471376d Mon Sep 17 00:00:00 2001 From: Sylvain Wallez Date: Wed, 8 Jan 2025 15:30:16 +0100 Subject: [PATCH 1/3] Fix common query parameters (#3297) * Fix many _cat API issues * Fix "master_timeout" query parameter issues * Fix "timeout" query parameter issues * Fix "pretty" & "human" query parameter issues * Use correct type for the 'time' query parameter * Address review feedback * Reduce diff with main branch * Remove timeout parameter from put_component_template --------- Co-authored-by: Quentin Pradet (cherry picked from commit 7aa6d9cd53e143573e1de75ea225e4a04cdd8dc9) --- output/openapi/elasticsearch-openapi.json | 608 +++++++++----- .../elasticsearch-serverless-openapi.json | 68 ++ output/schema/schema-serverless.json | 99 ++- output/schema/schema.json | 793 +++++++++++++----- output/schema/validation-errors.json | 254 +----- output/typescript/types.ts | 48 +- .../search_shards/SearchShardsRequest.ts | 6 + .../DeleteAutoFollowPatternRequest.ts | 8 + .../ccr/follow/CreateFollowIndexRequest.ts | 5 + .../ccr/follow_info/FollowInfoRequest.ts | 8 + .../follow_stats/FollowIndexStatsRequest.ts | 8 + .../ForgetFollowerIndexRequest.ts | 8 + .../GetAutoFollowPatternRequest.ts | 8 + .../PauseAutoFollowPatternRequest.ts | 8 + .../pause_follow/PauseFollowIndexRequest.ts | 8 + .../PutAutoFollowPatternRequest.ts | 7 + .../ResumeAutoFollowPatternRequest.ts | 8 + .../resume_follow/ResumeFollowIndexRequest.ts | 7 + specification/ccr/stats/CcrStatsRequest.ts | 16 +- .../ccr/unfollow/UnfollowIndexRequest.ts | 8 + .../ClusterAllocationExplainRequest.ts | 6 + ...sterDeleteVotingConfigExclusionsRequest.ts | 6 + ...lusterPostVotingConfigExclusionsRequest.ts | 5 + .../DeleteEnrichPolicyRequest.ts | 8 + .../ExecuteEnrichPolicyRequest.ts | 6 + .../get_policy/GetEnrichPolicyRequest.ts | 8 + .../put_policy/PutEnrichPolicyRequest.ts | 8 + .../enrich/stats/EnrichStatsRequest.ts | 11 +- .../get_features/GetFeaturesRequest.ts | 11 +- .../reset_features/ResetFeaturesRequest.ts | 11 +- .../ExplainLifecycleRequest.ts | 5 - specification/ilm/start/StartIlmRequest.ts | 8 + specification/ilm/stop/StopIlmRequest.ts | 8 + .../IndicesFieldUsageStatsRequest.ts | 13 - .../GetGeoipDatabaseRequest.ts | 8 - .../license/delete/DeleteLicenseRequest.ts | 16 +- .../license/post/PostLicenseRequest.ts | 11 + .../StartBasicLicenseRequest.ts | 11 + .../StartTrialLicenseRequest.ts | 6 + .../MlDeleteTrainedModelRequest.ts | 6 + .../MlGetMemoryStatsRequest.ts | 5 - .../hot_threads/NodesHotThreadsRequest.ts | 7 - specification/nodes/info/NodesInfoRequest.ts | 5 - .../nodes/stats/NodesStatsRequest.ts | 5 - .../SearchableSnapshotsClearCacheRequest.ts | 2 - .../get_node/ShutdownGetNodeRequest.ts | 5 - .../snapshot/clone/SnapshotCloneRequest.ts | 1 - specification/tasks/list/ListTasksRequest.ts | 5 - .../reset_transform/ResetTransformRequest.ts | 6 + .../watcher/start/WatcherStartRequest.ts | 11 +- 50 files changed, 1466 insertions(+), 741 deletions(-) diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index c1541cc4a5..5f054712e4 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -2436,6 +2436,9 @@ "parameters": [ { "$ref": "#/components/parameters/ccr.get_auto_follow_pattern#name" + }, + { + "$ref": "#/components/parameters/ccr.get_auto_follow_pattern#master_timeout" } ], "responses": { @@ -2466,6 +2469,16 @@ "$ref": "#/components/schemas/_types:Name" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "requestBody": { @@ -2573,6 +2586,16 @@ "$ref": "#/components/schemas/_types:Name" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -2610,6 +2633,16 @@ }, "style": "simple" }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, { "in": "query", "name": "wait_for_active_shards", @@ -2739,6 +2772,16 @@ "$ref": "#/components/schemas/_types:Indices" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -2789,6 +2832,16 @@ "$ref": "#/components/schemas/_types:Indices" }, "style": "simple" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -2839,6 +2892,16 @@ "$ref": "#/components/schemas/_types:IndexName" }, "style": "simple" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "requestBody": { @@ -2899,6 +2962,11 @@ "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ccr-auto-follow.html" }, "operationId": "ccr-get-auto-follow-pattern", + "parameters": [ + { + "$ref": "#/components/parameters/ccr.get_auto_follow_pattern#master_timeout" + } + ], "responses": { "200": { "$ref": "#/components/responses/ccr.get_auto_follow_pattern#200" @@ -2929,6 +2997,16 @@ "$ref": "#/components/schemas/_types:Name" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -2965,6 +3043,16 @@ "$ref": "#/components/schemas/_types:IndexName" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -3004,6 +3092,16 @@ "$ref": "#/components/schemas/_types:Name" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -3043,6 +3141,16 @@ "$ref": "#/components/schemas/_types:IndexName" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "requestBody": { @@ -3109,6 +3217,28 @@ "summary": "Get cross-cluster replication stats", "description": "This API returns stats about auto-following and the same shard-level stats as the get follower stats API.", "operationId": "ccr-stats", + "parameters": [ + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + } + ], "responses": { "200": { "description": "", @@ -3158,6 +3288,16 @@ "$ref": "#/components/schemas/_types:IndexName" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -3408,6 +3548,9 @@ }, { "$ref": "#/components/parameters/cluster.allocation_explain#include_yes_decisions" + }, + { + "$ref": "#/components/parameters/cluster.allocation_explain#master_timeout" } ], "requestBody": { @@ -3433,6 +3576,9 @@ }, { "$ref": "#/components/parameters/cluster.allocation_explain#include_yes_decisions" + }, + { + "$ref": "#/components/parameters/cluster.allocation_explain#master_timeout" } ], "requestBody": { @@ -3671,6 +3817,16 @@ }, "style": "form" }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, { "in": "query", "name": "timeout", @@ -3703,6 +3859,16 @@ }, "operationId": "cluster-delete-voting-config-exclusions", "parameters": [ + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, { "in": "query", "name": "wait_for_removal", @@ -7945,6 +8111,9 @@ "parameters": [ { "$ref": "#/components/parameters/enrich.get_policy#name" + }, + { + "$ref": "#/components/parameters/enrich.get_policy#master_timeout" } ], "responses": { @@ -7972,6 +8141,16 @@ "$ref": "#/components/schemas/_types:Name" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "requestBody": { @@ -8027,6 +8206,16 @@ "$ref": "#/components/schemas/_types:Name" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -8064,6 +8253,16 @@ }, "style": "simple" }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, { "in": "query", "name": "wait_for_completion", @@ -8106,6 +8305,11 @@ "summary": "Get an enrich policy", "description": "Returns information about an enrich policy.", "operationId": "enrich-get-policy-1", + "parameters": [ + { + "$ref": "#/components/parameters/enrich.get_policy#master_timeout" + } + ], "responses": { "200": { "$ref": "#/components/responses/enrich.get_policy#200" @@ -8122,6 +8326,18 @@ "summary": "Get enrich stats", "description": "Returns enrich coordinator statistics and information about enrich policies that are currently executing.", "operationId": "enrich-stats", + "parameters": [ + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + } + ], "responses": { "200": { "description": "", @@ -8934,6 +9150,18 @@ "url": "https://www.elastic.co/guide/en/elasticsearch/reference/current/snapshots-take-snapshot.html" }, "operationId": "features-get-features", + "parameters": [ + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + } + ], "responses": { "200": { "description": "", @@ -8968,6 +9196,18 @@ "summary": "Reset the features", "description": "Clear all of the state information stored in system indices by Elasticsearch features, including the security and machine learning indices.\n\nWARNING: Intended for development and testing use only. Do not reset features on a production cluster.\n\nReturn a cluster to the same state as a new installation by resetting the feature state for all Elasticsearch features.\nThis deletes all state information stored in system indices.\n\nThe response code is HTTP 200 if the state is successfully reset for all features.\nIt is HTTP 500 if the reset operation failed for any feature.\n\nNote that select features might provide a way to reset particular system indices.\nUsing this API resets all features, both those that are built-in and implemented as plugins.\n\nTo list the features that will be affected, use the get features API.\n\nIMPORTANT: The features installed on the node you submit this request to are the features that will be reset. Run on the master node if you have any doubts about which plugins are installed on individual nodes.", "operationId": "features-reset-features", + "parameters": [ + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + } + ], "responses": { "200": { "description": "", @@ -10221,16 +10461,6 @@ "$ref": "#/components/schemas/_types:Duration" }, "style": "form" - }, - { - "in": "query", - "name": "timeout", - "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" } ], "responses": { @@ -10573,7 +10803,7 @@ { "in": "query", "name": "master_timeout", - "description": "Explicit operation timeout for connection to master node", + "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types:Duration" @@ -10583,7 +10813,7 @@ { "in": "query", "name": "timeout", - "description": "Explicit operation timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types:Duration" @@ -10618,7 +10848,7 @@ { "in": "query", "name": "master_timeout", - "description": "Explicit operation timeout for connection to master node", + "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types:Duration" @@ -10628,7 +10858,7 @@ { "in": "query", "name": "timeout", - "description": "Explicit operation timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", "deprecated": false, "schema": { "$ref": "#/components/schemas/_types:Duration" @@ -12952,26 +13182,6 @@ }, "style": "form" }, - { - "in": "query", - "name": "master_timeout", - "description": "Period to wait for a connection to the master node.\nIf no response is received before the timeout expires, the request fails and returns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" - }, - { - "in": "query", - "name": "timeout", - "description": "Period to wait for a response.\nIf no response is received before the timeout expires, the request fails and returns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" - }, { "in": "query", "name": "wait_for_active_shards", @@ -15872,9 +16082,6 @@ "parameters": [ { "$ref": "#/components/parameters/ingest.get_geoip_database#id" - }, - { - "$ref": "#/components/parameters/ingest.get_geoip_database#master_timeout" } ], "responses": { @@ -16398,11 +16605,6 @@ "summary": "Get GeoIP database configurations", "description": "Get information about one or more IP geolocation database configurations.", "operationId": "ingest-get-geoip-database", - "parameters": [ - { - "$ref": "#/components/parameters/ingest.get_geoip_database#master_timeout" - } - ], "responses": { "200": { "$ref": "#/components/responses/ingest.get_geoip_database#200" @@ -16708,6 +16910,12 @@ "parameters": [ { "$ref": "#/components/parameters/license.post#acknowledge" + }, + { + "$ref": "#/components/parameters/license.post#master_timeout" + }, + { + "$ref": "#/components/parameters/license.post#timeout" } ], "requestBody": { @@ -16729,6 +16937,12 @@ "parameters": [ { "$ref": "#/components/parameters/license.post#acknowledge" + }, + { + "$ref": "#/components/parameters/license.post#master_timeout" + }, + { + "$ref": "#/components/parameters/license.post#timeout" } ], "requestBody": { @@ -16750,6 +16964,28 @@ "url": "https://www.elastic.co/guide/en/kibana/current/managing-licenses.html" }, "operationId": "license-delete", + "parameters": [ + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + } + ], "responses": { "200": { "description": "", @@ -16842,6 +17078,26 @@ "type": "boolean" }, "style": "form" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -16920,6 +17176,16 @@ "type": "string" }, "style": "form" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -19322,6 +19588,16 @@ "type": "boolean" }, "style": "form" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -20673,9 +20949,6 @@ "description": "Get information about how machine learning jobs and trained models are using memory,\non each node, both within the JVM heap, and natively, outside of the JVM.", "operationId": "ml-get-memory-stats", "parameters": [ - { - "$ref": "#/components/parameters/ml.get_memory_stats#human" - }, { "$ref": "#/components/parameters/ml.get_memory_stats#master_timeout" }, @@ -20703,9 +20976,6 @@ { "$ref": "#/components/parameters/ml.get_memory_stats#node_id" }, - { - "$ref": "#/components/parameters/ml.get_memory_stats#human" - }, { "$ref": "#/components/parameters/ml.get_memory_stats#master_timeout" }, @@ -24260,9 +24530,6 @@ { "$ref": "#/components/parameters/nodes.hot_threads#snapshots" }, - { - "$ref": "#/components/parameters/nodes.hot_threads#master_timeout" - }, { "$ref": "#/components/parameters/nodes.hot_threads#threads" }, @@ -24304,9 +24571,6 @@ { "$ref": "#/components/parameters/nodes.hot_threads#snapshots" }, - { - "$ref": "#/components/parameters/nodes.hot_threads#master_timeout" - }, { "$ref": "#/components/parameters/nodes.hot_threads#threads" }, @@ -24339,9 +24603,6 @@ { "$ref": "#/components/parameters/nodes.info#flat_settings" }, - { - "$ref": "#/components/parameters/nodes.info#master_timeout" - }, { "$ref": "#/components/parameters/nodes.info#timeout" } @@ -24369,9 +24630,6 @@ { "$ref": "#/components/parameters/nodes.info#flat_settings" }, - { - "$ref": "#/components/parameters/nodes.info#master_timeout" - }, { "$ref": "#/components/parameters/nodes.info#timeout" } @@ -24399,9 +24657,6 @@ { "$ref": "#/components/parameters/nodes.info#flat_settings" }, - { - "$ref": "#/components/parameters/nodes.info#master_timeout" - }, { "$ref": "#/components/parameters/nodes.info#timeout" } @@ -24432,9 +24687,6 @@ { "$ref": "#/components/parameters/nodes.info#flat_settings" }, - { - "$ref": "#/components/parameters/nodes.info#master_timeout" - }, { "$ref": "#/components/parameters/nodes.info#timeout" } @@ -24525,9 +24777,6 @@ { "$ref": "#/components/parameters/nodes.stats#level" }, - { - "$ref": "#/components/parameters/nodes.stats#master_timeout" - }, { "$ref": "#/components/parameters/nodes.stats#timeout" }, @@ -24575,9 +24824,6 @@ { "$ref": "#/components/parameters/nodes.stats#level" }, - { - "$ref": "#/components/parameters/nodes.stats#master_timeout" - }, { "$ref": "#/components/parameters/nodes.stats#timeout" }, @@ -24625,9 +24871,6 @@ { "$ref": "#/components/parameters/nodes.stats#level" }, - { - "$ref": "#/components/parameters/nodes.stats#master_timeout" - }, { "$ref": "#/components/parameters/nodes.stats#timeout" }, @@ -24678,9 +24921,6 @@ { "$ref": "#/components/parameters/nodes.stats#level" }, - { - "$ref": "#/components/parameters/nodes.stats#master_timeout" - }, { "$ref": "#/components/parameters/nodes.stats#timeout" }, @@ -24731,9 +24971,6 @@ { "$ref": "#/components/parameters/nodes.stats#level" }, - { - "$ref": "#/components/parameters/nodes.stats#master_timeout" - }, { "$ref": "#/components/parameters/nodes.stats#timeout" }, @@ -24787,9 +25024,6 @@ { "$ref": "#/components/parameters/nodes.stats#level" }, - { - "$ref": "#/components/parameters/nodes.stats#master_timeout" - }, { "$ref": "#/components/parameters/nodes.stats#timeout" }, @@ -27710,6 +27944,9 @@ { "$ref": "#/components/parameters/search_shards#local" }, + { + "$ref": "#/components/parameters/search_shards#master_timeout" + }, { "$ref": "#/components/parameters/search_shards#preference" }, @@ -27743,6 +27980,9 @@ { "$ref": "#/components/parameters/search_shards#local" }, + { + "$ref": "#/components/parameters/search_shards#master_timeout" + }, { "$ref": "#/components/parameters/search_shards#preference" }, @@ -27781,6 +28021,9 @@ { "$ref": "#/components/parameters/search_shards#local" }, + { + "$ref": "#/components/parameters/search_shards#master_timeout" + }, { "$ref": "#/components/parameters/search_shards#preference" }, @@ -27817,6 +28060,9 @@ { "$ref": "#/components/parameters/search_shards#local" }, + { + "$ref": "#/components/parameters/search_shards#master_timeout" + }, { "$ref": "#/components/parameters/search_shards#preference" }, @@ -28152,12 +28398,6 @@ }, { "$ref": "#/components/parameters/searchable_snapshots.clear_cache#ignore_unavailable" - }, - { - "$ref": "#/components/parameters/searchable_snapshots.clear_cache#pretty" - }, - { - "$ref": "#/components/parameters/searchable_snapshots.clear_cache#human" } ], "responses": { @@ -28191,12 +28431,6 @@ }, { "$ref": "#/components/parameters/searchable_snapshots.clear_cache#ignore_unavailable" - }, - { - "$ref": "#/components/parameters/searchable_snapshots.clear_cache#pretty" - }, - { - "$ref": "#/components/parameters/searchable_snapshots.clear_cache#human" } ], "responses": { @@ -32414,9 +32648,6 @@ }, { "$ref": "#/components/parameters/shutdown.get_node#master_timeout" - }, - { - "$ref": "#/components/parameters/shutdown.get_node#timeout" } ], "responses": { @@ -32577,9 +32808,6 @@ "parameters": [ { "$ref": "#/components/parameters/shutdown.get_node#master_timeout" - }, - { - "$ref": "#/components/parameters/shutdown.get_node#timeout" } ], "responses": { @@ -33335,15 +33563,6 @@ "$ref": "#/components/schemas/_types:Duration" }, "style": "form" - }, - { - "in": "query", - "name": "timeout", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" } ], "requestBody": { @@ -35241,16 +35460,6 @@ }, "style": "form" }, - { - "in": "query", - "name": "master_timeout", - "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" - }, { "in": "query", "name": "timeout", @@ -36688,6 +36897,16 @@ "type": "boolean" }, "style": "form" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -38400,6 +38619,18 @@ "summary": "Start the watch service", "description": "Start the Watcher service if it is not already running.", "operationId": "watcher-start", + "parameters": [ + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + } + ], "responses": { "200": { "description": "", @@ -38477,7 +38708,11 @@ { "in": "query", "name": "master_timeout", +<<<<<<< HEAD "description": "The period to wait for the master node.\nIf the master node is not available before the timeout expires, the request fails and returns an error.\nTo indicate that the request should never timeout, set it to `-1`.", +======= + "description": "Period to wait for a connection to the master node.", +>>>>>>> b6a68ae73 (Fix common query parameters (#3297)) "deprecated": false, "schema": { "$ref": "#/components/schemas/_types:Duration" @@ -97272,6 +97507,16 @@ }, "style": "simple" }, + "ccr.get_auto_follow_pattern#master_timeout": { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, "clear_scroll#scroll_id": { "in": "path", "name": "scroll_id", @@ -97303,6 +97548,16 @@ }, "style": "form" }, + "cluster.allocation_explain#master_timeout": { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, "cluster.get_component_template#name": { "in": "path", "name": "name", @@ -97911,6 +98166,16 @@ }, "style": "simple" }, + "enrich.get_policy#master_timeout": { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, "eql.search#index": { "in": "path", "name": "index", @@ -101006,16 +101271,6 @@ }, "style": "simple" }, - "ingest.get_geoip_database#master_timeout": { - "in": "query", - "name": "master_timeout", - "description": "Period to wait for a connection to the master node.\nIf no response is received before the timeout expires, the request fails and returns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" - }, "ingest.get_ip_location_database#id": { "in": "path", "name": "id", @@ -101120,6 +101375,26 @@ }, "style": "form" }, + "license.post#master_timeout": { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, + "license.post#timeout": { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, "logstash.get_pipeline#id": { "in": "path", "name": "id", @@ -101861,16 +102136,6 @@ }, "style": "simple" }, - "ml.get_memory_stats#human": { - "in": "query", - "name": "human", - "description": "Specify this query parameter to include the fields with units in the response. Otherwise only\nthe `_in_bytes` sizes are returned in the response.", - "deprecated": false, - "schema": { - "type": "boolean" - }, - "style": "form" - }, "ml.get_memory_stats#master_timeout": { "in": "query", "name": "master_timeout", @@ -102778,16 +103043,6 @@ }, "style": "form" }, - "nodes.hot_threads#master_timeout": { - "in": "query", - "name": "master_timeout", - "description": "Period to wait for a connection to the master node. If no response\nis received before the timeout expires, the request fails and\nreturns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" - }, "nodes.hot_threads#threads": { "in": "query", "name": "threads", @@ -102860,16 +103115,6 @@ }, "style": "form" }, - "nodes.info#master_timeout": { - "in": "query", - "name": "master_timeout", - "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" - }, "nodes.info#timeout": { "in": "query", "name": "timeout", @@ -102994,16 +103239,6 @@ }, "style": "form" }, - "nodes.stats#master_timeout": { - "in": "query", - "name": "master_timeout", - "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:Duration" - }, - "style": "form" - }, "nodes.stats#timeout": { "in": "query", "name": "timeout", @@ -103952,6 +104187,16 @@ }, "style": "form" }, + "search_shards#master_timeout": { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, "search_shards#preference": { "in": "query", "name": "preference", @@ -104174,24 +104419,6 @@ }, "style": "form" }, - "searchable_snapshots.clear_cache#pretty": { - "in": "query", - "name": "pretty", - "deprecated": false, - "schema": { - "type": "boolean" - }, - "style": "form" - }, - "searchable_snapshots.clear_cache#human": { - "in": "query", - "name": "human", - "deprecated": false, - "schema": { - "type": "boolean" - }, - "style": "form" - }, "searchable_snapshots.stats#index": { "in": "path", "name": "index", @@ -104674,6 +104901,7 @@ }, "style": "form" }, +<<<<<<< HEAD "shutdown.get_node#timeout": { "in": "query", "name": "timeout", @@ -104705,6 +104933,8 @@ }, "style": "form" }, +======= +>>>>>>> be1386ab9 (Fix common query parameters (#3297)) "slm.get_lifecycle#policy_id": { "in": "path", "name": "policy_id", diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index c1bb4be2dd..4a061fa3fa 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -4623,6 +4623,9 @@ "parameters": [ { "$ref": "#/components/parameters/enrich.get_policy#name" + }, + { + "$ref": "#/components/parameters/enrich.get_policy#master_timeout" } ], "responses": { @@ -4650,6 +4653,16 @@ "$ref": "#/components/schemas/_types:Name" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "requestBody": { @@ -4705,6 +4718,16 @@ "$ref": "#/components/schemas/_types:Name" }, "style": "simple" + }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -4742,6 +4765,16 @@ }, "style": "simple" }, + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, { "in": "query", "name": "wait_for_completion", @@ -4784,6 +4817,11 @@ "summary": "Get an enrich policy", "description": "Returns information about an enrich policy.", "operationId": "enrich-get-policy-1", + "parameters": [ + { + "$ref": "#/components/parameters/enrich.get_policy#master_timeout" + } + ], "responses": { "200": { "$ref": "#/components/responses/enrich.get_policy#200" @@ -11392,6 +11430,16 @@ "type": "boolean" }, "style": "form" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -19227,6 +19275,16 @@ "type": "boolean" }, "style": "form" + }, + { + "in": "query", + "name": "timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" } ], "responses": { @@ -58788,6 +58846,16 @@ }, "style": "simple" }, + "enrich.get_policy#master_timeout": { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + }, "eql.search#index": { "in": "path", "name": "index", diff --git a/output/schema/schema-serverless.json b/output/schema/schema-serverless.json index 8d70d68017..20e3066fec 100644 --- a/output/schema/schema-serverless.json +++ b/output/schema/schema-serverless.json @@ -16758,8 +16758,22 @@ } } ], - "query": [], - "specLocation": "enrich/delete_policy/DeleteEnrichPolicyRequest.ts#L23-L37" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "enrich/delete_policy/DeleteEnrichPolicyRequest.ts#L24-L45" }, { "body": { @@ -16813,6 +16827,19 @@ } ], "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, { "description": "If `true`, the request blocks other enrich policy execution requests until complete.", "name": "wait_for_completion", @@ -16827,7 +16854,7 @@ } } ], - "specLocation": "enrich/execute_policy/ExecuteEnrichPolicyRequest.ts#L23-L45" + "specLocation": "enrich/execute_policy/ExecuteEnrichPolicyRequest.ts#L24-L51" }, { "body": { @@ -16897,8 +16924,22 @@ } } ], - "query": [], - "specLocation": "enrich/get_policy/GetEnrichPolicyRequest.ts#L23-L38" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "enrich/get_policy/GetEnrichPolicyRequest.ts#L24-L46" }, { "body": { @@ -16998,8 +17039,22 @@ } } ], - "query": [], - "specLocation": "enrich/put_policy/PutEnrichPolicyRequest.ts#L24-L53" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "enrich/put_policy/PutEnrichPolicyRequest.ts#L25-L61" }, { "body": { @@ -27135,9 +27190,22 @@ "namespace": "_builtins" } } + }, + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } } ], - "specLocation": "ml/delete_trained_model/MlDeleteTrainedModelRequest.ts#L23-L43" + "specLocation": "ml/delete_trained_model/MlDeleteTrainedModelRequest.ts#L24-L49" }, { "body": { @@ -43499,9 +43567,22 @@ "namespace": "_builtins" } } + }, + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } } ], - "specLocation": "transform/reset_transform/ResetTransformRequest.ts#L23-L49" + "specLocation": "transform/reset_transform/ResetTransformRequest.ts#L24-L55" }, { "body": { diff --git a/output/schema/schema.json b/output/schema/schema.json index b4aadb9868..571dbb18d9 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -40768,6 +40768,19 @@ } } }, + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, { "description": "Specifies the node or shard the operation should be performed on.\nRandom by default.", "name": "preference", @@ -40793,7 +40806,7 @@ } } ], - "specLocation": "_global/search_shards/SearchShardsRequest.ts#L23-L76" + "specLocation": "_global/search_shards/SearchShardsRequest.ts#L24-L82" }, { "kind": "response", @@ -104892,8 +104905,22 @@ } } ], - "query": [], - "specLocation": "ccr/delete_auto_follow_pattern/DeleteAutoFollowPatternRequest.ts#L23-L35" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/delete_auto_follow_pattern/DeleteAutoFollowPatternRequest.ts#L24-L43" }, { "kind": "response", @@ -105117,6 +105144,19 @@ } ], "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, { "description": "Specifies the number of shards to wait on being active before responding. This defaults to waiting on none of the shards to be\nactive.\nA shard must be restored from the leader index before being active. Restoring a follower shard requires transferring all the\nremote Lucene segment files to the follower index.", "name": "wait_for_active_shards", @@ -105130,7 +105170,7 @@ } } ], - "specLocation": "ccr/follow/CreateFollowIndexRequest.ts#L26-L113" + "specLocation": "ccr/follow/CreateFollowIndexRequest.ts#L26-L118" }, { "kind": "response", @@ -105422,8 +105462,22 @@ } } ], - "query": [], - "specLocation": "ccr/follow_info/FollowInfoRequest.ts#L23-L36" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/follow_info/FollowInfoRequest.ts#L24-L44" }, { "kind": "response", @@ -105485,8 +105539,22 @@ } } ], - "query": [], - "specLocation": "ccr/follow_stats/FollowIndexStatsRequest.ts#L23-L36" + "query": [ + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/follow_stats/FollowIndexStatsRequest.ts#L24-L44" }, { "kind": "response", @@ -105594,8 +105662,22 @@ } } ], - "query": [], - "specLocation": "ccr/forget_follower/ForgetFollowerIndexRequest.ts#L23-L51" + "query": [ + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/forget_follower/ForgetFollowerIndexRequest.ts#L24-L59" }, { "kind": "response", @@ -105773,8 +105855,22 @@ } } ], - "query": [], - "specLocation": "ccr/get_auto_follow_pattern/GetAutoFollowPatternRequest.ts#L23-L36" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/get_auto_follow_pattern/GetAutoFollowPatternRequest.ts#L24-L44" }, { "kind": "response", @@ -105836,8 +105932,22 @@ } } ], - "query": [], - "specLocation": "ccr/pause_auto_follow_pattern/PauseAutoFollowPatternRequest.ts#L23-L41" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/pause_auto_follow_pattern/PauseAutoFollowPatternRequest.ts#L24-L49" }, { "kind": "response", @@ -105890,8 +106000,22 @@ } } ], - "query": [], - "specLocation": "ccr/pause_follow/PauseFollowIndexRequest.ts#L23-L37" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/pause_follow/PauseFollowIndexRequest.ts#L24-L45" }, { "kind": "response", @@ -106145,8 +106269,22 @@ } } ], - "query": [], - "specLocation": "ccr/put_auto_follow_pattern/PutAutoFollowPatternRequest.ts#L27-L120" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/put_auto_follow_pattern/PutAutoFollowPatternRequest.ts#L27-L127" }, { "kind": "response", @@ -106199,8 +106337,22 @@ } } ], - "query": [], - "specLocation": "ccr/resume_auto_follow_pattern/ResumeAutoFollowPatternRequest.ts#L23-L37" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/resume_auto_follow_pattern/ResumeAutoFollowPatternRequest.ts#L24-L45" }, { "kind": "response", @@ -106365,8 +106517,22 @@ } } ], - "query": [], - "specLocation": "ccr/resume_follow/ResumeFollowIndexRequest.ts#L25-L52" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/resume_follow/ResumeFollowIndexRequest.ts#L25-L59" }, { "kind": "response", @@ -106553,8 +106719,35 @@ "namespace": "ccr.stats" }, "path": [], - "query": [], - "specLocation": "ccr/stats/CcrStatsRequest.ts#L22-L29" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/stats/CcrStatsRequest.ts#L23-L43" }, { "kind": "response", @@ -106624,8 +106817,22 @@ } } ], - "query": [], - "specLocation": "ccr/unfollow/UnfollowIndexRequest.ts#L23-L39" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "ccr/unfollow/UnfollowIndexRequest.ts#L24-L47" }, { "kind": "response", @@ -107557,9 +107764,22 @@ "namespace": "_builtins" } } + }, + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } } ], - "specLocation": "cluster/allocation_explain/ClusterAllocationExplainRequest.ts#L24-L66" + "specLocation": "cluster/allocation_explain/ClusterAllocationExplainRequest.ts#L25-L72" }, { "kind": "interface", @@ -108192,6 +108412,19 @@ }, "path": [], "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, { "description": "Specifies whether to wait for all excluded nodes to be removed from the\ncluster before clearing the voting configuration exclusions list.\nDefaults to true, meaning that all excluded nodes must be removed from\nthe cluster before this API takes any action. If set to false then the\nvoting configuration exclusions list is cleared even if some excluded\nnodes are still in the cluster.", "name": "wait_for_removal", @@ -108206,7 +108439,7 @@ } } ], - "specLocation": "cluster/delete_voting_config_exclusions/ClusterDeleteVotingConfigExclusionsRequest.ts#L22-L43" + "specLocation": "cluster/delete_voting_config_exclusions/ClusterDeleteVotingConfigExclusionsRequest.ts#L23-L49" }, { "kind": "response", @@ -109574,6 +109807,19 @@ } } }, + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, { "description": "When adding a voting configuration exclusion, the API waits for the\nspecified nodes to be excluded from the voting configuration before\nreturning. If the timeout expires before the appropriate condition\nis satisfied, the request fails and returns an error.", "name": "timeout", @@ -109588,7 +109834,7 @@ } } ], - "specLocation": "cluster/post_voting_config_exclusions/ClusterPostVotingConfigExclusionsRequest.ts#L24-L69" + "specLocation": "cluster/post_voting_config_exclusions/ClusterPostVotingConfigExclusionsRequest.ts#L24-L74" }, { "kind": "response", @@ -118391,8 +118637,22 @@ } } ], - "query": [], - "specLocation": "enrich/delete_policy/DeleteEnrichPolicyRequest.ts#L23-L37" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "enrich/delete_policy/DeleteEnrichPolicyRequest.ts#L24-L45" }, { "kind": "response", @@ -118489,6 +118749,19 @@ } ], "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, { "description": "If `true`, the request blocks other enrich policy execution requests until complete.", "name": "wait_for_completion", @@ -118503,7 +118776,7 @@ } } ], - "specLocation": "enrich/execute_policy/ExecuteEnrichPolicyRequest.ts#L23-L45" + "specLocation": "enrich/execute_policy/ExecuteEnrichPolicyRequest.ts#L24-L51" }, { "kind": "response", @@ -118573,8 +118846,22 @@ } } ], - "query": [], - "specLocation": "enrich/get_policy/GetEnrichPolicyRequest.ts#L23-L38" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "enrich/get_policy/GetEnrichPolicyRequest.ts#L24-L46" }, { "kind": "response", @@ -118674,8 +118961,22 @@ } } ], - "query": [], - "specLocation": "enrich/put_policy/PutEnrichPolicyRequest.ts#L24-L53" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "enrich/put_policy/PutEnrichPolicyRequest.ts#L25-L61" }, { "kind": "response", @@ -118928,8 +119229,22 @@ "namespace": "enrich.stats" }, "path": [], - "query": [], - "specLocation": "enrich/stats/EnrichStatsRequest.ts#L22-L29" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "enrich/stats/EnrichStatsRequest.ts#L23-L38" }, { "kind": "response", @@ -120520,8 +120835,22 @@ "namespace": "features.get_features" }, "path": [], - "query": [], - "specLocation": "features/get_features/GetFeaturesRequest.ts#L22-L37" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "features/get_features/GetFeaturesRequest.ts#L23-L46" }, { "kind": "response", @@ -120570,8 +120899,22 @@ "namespace": "features.reset_features" }, "path": [], - "query": [], - "specLocation": "features/reset_features/ResetFeaturesRequest.ts#L22-L44" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "features/reset_features/ResetFeaturesRequest.ts#L23-L53" }, { "kind": "response", @@ -124144,22 +124487,9 @@ "namespace": "_types" } } - }, - { - "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", - "name": "timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } } ], - "specLocation": "ilm/explain_lifecycle/ExplainLifecycleRequest.ts#L24-L62" + "specLocation": "ilm/explain_lifecycle/ExplainLifecycleRequest.ts#L24-L57" }, { "kind": "response", @@ -124918,9 +125248,10 @@ "path": [], "query": [ { - "description": "Explicit operation timeout for connection to master node", + "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", "name": "master_timeout", "required": false, + "serverDefault": "30s", "type": { "kind": "instance_of", "type": { @@ -124930,9 +125261,10 @@ } }, { - "description": "Explicit operation timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", "name": "timeout", "required": false, + "serverDefault": "30s", "type": { "kind": "instance_of", "type": { @@ -124942,7 +125274,7 @@ } } ], - "specLocation": "ilm/start/StartIlmRequest.ts#L23-L37" + "specLocation": "ilm/start/StartIlmRequest.ts#L23-L45" }, { "kind": "response", @@ -124984,9 +125316,10 @@ "path": [], "query": [ { - "description": "Explicit operation timeout for connection to master node", + "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", "name": "master_timeout", "required": false, + "serverDefault": "30s", "type": { "kind": "instance_of", "type": { @@ -124996,9 +125329,10 @@ } }, { - "description": "Explicit operation timeout", + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", "name": "timeout", "required": false, + "serverDefault": "30s", "type": { "kind": "instance_of", "type": { @@ -125008,7 +125342,7 @@ } } ], - "specLocation": "ilm/stop/StopIlmRequest.ts#L23-L39" + "specLocation": "ilm/stop/StopIlmRequest.ts#L23-L47" }, { "kind": "response", @@ -133001,32 +133335,6 @@ } } }, - { - "description": "Period to wait for a connection to the master node.\nIf no response is received before the timeout expires, the request fails and returns an error.", - "name": "master_timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - }, - { - "description": "Period to wait for a response.\nIf no response is received before the timeout expires, the request fails and returns an error.", - "name": "timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - }, { "description": "The number of shard copies that must be active before proceeding with the operation.\nSet to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`).", "name": "wait_for_active_shards", @@ -133041,7 +133349,7 @@ } } ], - "specLocation": "indices/field_usage_stats/IndicesFieldUsageStatsRequest.ts#L29-L91" + "specLocation": "indices/field_usage_stats/IndicesFieldUsageStatsRequest.ts#L28-L78" }, { "kind": "response", @@ -149535,22 +149843,8 @@ } } ], - "query": [ - { - "description": "Period to wait for a connection to the master node.\nIf no response is received before the timeout expires, the request fails and returns an error.", - "name": "master_timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - } - ], - "specLocation": "ingest/get_geoip_database/GetGeoipDatabaseRequest.ts#L24-L47" + "query": [], + "specLocation": "ingest/get_geoip_database/GetGeoipDatabaseRequest.ts#L23-L39" }, { "kind": "response", @@ -150602,8 +150896,35 @@ "namespace": "license.delete" }, "path": [], - "query": [], - "specLocation": "license/delete/DeleteLicenseRequest.ts#L22-L32" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "license/delete/DeleteLicenseRequest.ts#L23-L46" }, { "kind": "response", @@ -151084,9 +151405,35 @@ "namespace": "_builtins" } } + }, + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } } ], - "specLocation": "license/post/PostLicenseRequest.ts#L23-L51" + "specLocation": "license/post/PostLicenseRequest.ts#L24-L62" }, { "kind": "response", @@ -151166,9 +151513,35 @@ "namespace": "_builtins" } } + }, + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + }, + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } } ], - "specLocation": "license/post_start_basic/StartBasicLicenseRequest.ts#L22-L40" + "specLocation": "license/post_start_basic/StartBasicLicenseRequest.ts#L23-L51" }, { "kind": "response", @@ -151307,9 +151680,22 @@ "namespace": "_builtins" } } + }, + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } } ], - "specLocation": "license/post_start_trial/StartTrialLicenseRequest.ts#L22-L40" + "specLocation": "license/post_start_trial/StartTrialLicenseRequest.ts#L23-L46" }, { "kind": "response", @@ -165801,9 +166187,22 @@ "namespace": "_builtins" } } + }, + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } } ], - "specLocation": "ml/delete_trained_model/MlDeleteTrainedModelRequest.ts#L23-L43" + "specLocation": "ml/delete_trained_model/MlDeleteTrainedModelRequest.ts#L24-L49" }, { "kind": "response", @@ -169364,18 +169763,6 @@ } ], "query": [ - { - "description": "Specify this query parameter to include the fields with units in the response. Otherwise only\nthe `_in_bytes` sizes are returned in the response.", - "name": "human", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "boolean", - "namespace": "_builtins" - } - } - }, { "description": "Period to wait for a connection to the master node. If no response is received before the timeout\nexpires, the request fails and returns an error.", "name": "master_timeout", @@ -169403,7 +169790,7 @@ } } ], - "specLocation": "ml/get_memory_stats/MlGetMemoryStatsRequest.ts#L24-L60" + "specLocation": "ml/get_memory_stats/MlGetMemoryStatsRequest.ts#L24-L55" }, { "kind": "response", @@ -182747,19 +183134,6 @@ } } }, - { - "description": "Period to wait for a connection to the master node. If no response\nis received before the timeout expires, the request fails and\nreturns an error.", - "name": "master_timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - }, { "description": "Specifies the number of hot threads to provide information for.", "name": "threads", @@ -182812,7 +183186,7 @@ } } ], - "specLocation": "nodes/hot_threads/NodesHotThreadsRequest.ts#L25-L85" + "specLocation": "nodes/hot_threads/NodesHotThreadsRequest.ts#L25-L78" }, { "kind": "response", @@ -185856,19 +186230,6 @@ } } }, - { - "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", - "name": "master_timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - }, { "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", "name": "timeout", @@ -185883,7 +186244,7 @@ } } ], - "specLocation": "nodes/info/NodesInfoRequest.ts#L24-L57" + "specLocation": "nodes/info/NodesInfoRequest.ts#L24-L52" }, { "kind": "response", @@ -186214,19 +186575,6 @@ } } }, - { - "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", - "name": "master_timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - }, { "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", "name": "timeout", @@ -186269,7 +186617,7 @@ } } ], - "specLocation": "nodes/stats/NodesStatsRequest.ts#L24-L78" + "specLocation": "nodes/stats/NodesStatsRequest.ts#L24-L73" }, { "kind": "response", @@ -190601,31 +190949,13 @@ "namespace": "_builtins" } } - }, - { - "name": "pretty", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "boolean", - "namespace": "_builtins" - } - } - }, - { - "name": "human", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "boolean", - "namespace": "_builtins" - } - } } ], +<<<<<<< HEAD "specLocation": "searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts#L23-L48" +======= + "specLocation": "searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts#L23-L40" +>>>>>>> be1386ab9 (Fix common query parameters (#3297)) }, { "kind": "response", @@ -203909,22 +204239,9 @@ "namespace": "_types" } } - }, - { - "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", - "name": "timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "TimeUnit", - "namespace": "_types" - } - } } ], - "specLocation": "shutdown/get_node/ShutdownGetNodeRequest.ts#L24-L54" + "specLocation": "shutdown/get_node/ShutdownGetNodeRequest.ts#L24-L49" }, { "kind": "response", @@ -207760,20 +208077,13 @@ "namespace": "_types" } } - }, - { - "name": "timeout", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } } ], +<<<<<<< HEAD "specLocation": "snapshot/clone/SnapshotCloneRequest.ts#L24-L46" +======= + "specLocation": "snapshot/clone/SnapshotCloneRequest.ts#L24-L44" +>>>>>>> be1386ab9 (Fix common query parameters (#3297)) }, { "kind": "response", @@ -212099,19 +212409,6 @@ } } }, - { - "description": "Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error.", - "name": "master_timeout", - "required": false, - "serverDefault": "30s", - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - }, { "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", "name": "timeout", @@ -212139,7 +212436,7 @@ } } ], - "specLocation": "tasks/list/ListTasksRequest.ts#L25-L74" + "specLocation": "tasks/list/ListTasksRequest.ts#L25-L69" }, { "kind": "response", @@ -215813,9 +216110,22 @@ "namespace": "_builtins" } } + }, + { + "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", + "name": "timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } } ], - "specLocation": "transform/reset_transform/ResetTransformRequest.ts#L23-L49" + "specLocation": "transform/reset_transform/ResetTransformRequest.ts#L24-L55" }, { "kind": "response", @@ -222158,8 +222468,27 @@ "namespace": "watcher.start" }, "path": [], +<<<<<<< HEAD "query": [], "specLocation": "watcher/start/WatcherStartRequest.ts#L22-L30" +======= + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "watcher/start/WatcherStartRequest.ts#L23-L38" +>>>>>>> b6a68ae73 (Fix common query parameters (#3297)) }, { "kind": "response", @@ -222586,7 +222915,11 @@ "path": [], "query": [ { +<<<<<<< HEAD "description": "The period to wait for the master node.\nIf the master node is not available before the timeout expires, the request fails and returns an error.\nTo indicate that the request should never timeout, set it to `-1`.", +======= + "description": "Period to wait for a connection to the master node.", +>>>>>>> b6a68ae73 (Fix common query parameters (#3297)) "name": "master_timeout", "required": false, "serverDefault": "30s", @@ -222599,7 +222932,11 @@ } } ], +<<<<<<< HEAD "specLocation": "watcher/stop/WatcherStopRequest.ts#L23-L41" +======= + "specLocation": "watcher/stop/WatcherStopRequest.ts#L23-L38" +>>>>>>> b6a68ae73 (Fix common query parameters (#3297)) }, { "kind": "response", diff --git a/output/schema/validation-errors.json b/output/schema/validation-errors.json index 074837e4b6..19682fd3e7 100644 --- a/output/schema/validation-errors.json +++ b/output/schema/validation-errors.json @@ -222,109 +222,12 @@ ], "response": [] }, - "ccr.delete_auto_follow_pattern": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.follow": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.follow_info": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.follow_stats": { - "request": [ - "Request: missing json spec query parameter 'timeout'" - ], - "response": [] - }, - "ccr.forget_follower": { - "request": [ - "Request: missing json spec query parameter 'timeout'" - ], - "response": [] - }, - "ccr.get_auto_follow_pattern": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.pause_auto_follow_pattern": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.pause_follow": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.put_auto_follow_pattern": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.resume_auto_follow_pattern": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.resume_follow": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.stats": { - "request": [ - "Request: missing json spec query parameter 'timeout'", - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "ccr.unfollow": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "cluster.allocation_explain": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "cluster.delete_voting_config_exclusions": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, "cluster.get_component_template": { "request": [ "Request: query parameter 'flat_settings' does not exist in the json spec" ], "response": [] }, - "cluster.post_voting_config_exclusions": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, "cluster.put_component_template": { "request": [ "Request: missing json spec query parameter 'timeout'" @@ -355,36 +258,6 @@ ], "response": [] }, - "enrich.delete_policy": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "enrich.execute_policy": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "enrich.get_policy": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "enrich.put_policy": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "enrich.stats": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, "eql.search": { "request": [ "Request: query parameter 'allow_no_indices' does not exist in the json spec", @@ -405,18 +278,6 @@ ], "response": [] }, - "features.get_features": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, - "features.reset_features": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, "fleet.delete_secret": { "request": [ "Missing request & response" @@ -441,12 +302,6 @@ ], "response": [] }, - "ilm.explain_lifecycle": { - "request": [ - "Request: query parameter 'timeout' does not exist in the json spec" - ], - "response": [] - }, "index": { "request": [ "Request: missing json spec query parameter 'require_data_stream'" @@ -474,8 +329,6 @@ }, "indices.field_usage_stats": { "request": [ - "Request: query parameter 'master_timeout' does not exist in the json spec", - "Request: query parameter 'timeout' does not exist in the json spec", "Request: query parameter 'wait_for_active_shards' does not exist in the json spec" ], "response": [] @@ -524,61 +377,20 @@ ], "response": [] }, - "ingest.get_geoip_database": { - "request": [ - "Request: query parameter 'master_timeout' does not exist in the json spec" - ], - "response": [] - }, "ingest.get_ip_location_database": { "request": [ "Request: query parameter 'master_timeout' does not exist in the json spec" ], "response": [] }, - "license.delete": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'", - "Request: missing json spec query parameter 'timeout'" - ], - "response": [] - }, - "license.post": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'", - "Request: missing json spec query parameter 'timeout'" - ], - "response": [] - }, - "license.post_start_basic": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'", - "Request: missing json spec query parameter 'timeout'" - ], - "response": [] - }, "license.post_start_trial": { "request": [ "Request: query parameter 'type_query_string' does not exist in the json spec", "Request: missing json spec query parameter 'type'", - "Request: missing json spec query parameter 'master_timeout'", - "Request: missing json spec query parameter 'timeout'" - ], - "response": [] - }, - "ml.delete_trained_model": { - "request": [ "Request: missing json spec query parameter 'timeout'" ], "response": [] }, - "ml.get_memory_stats": { - "request": [ - "Request: query parameter 'human' does not exist in the json spec", - "request definition ml.get_memory_stats:Request / query - Property 'human' is already defined in an ancestor class" - ], - "response": [] - }, "ml.stop_datafeed": { "request": [ "Request: missing json spec query parameter 'allow_no_datafeeds'" @@ -596,24 +408,6 @@ ], "response": [] }, - "nodes.hot_threads": { - "request": [ - "Request: query parameter 'master_timeout' does not exist in the json spec" - ], - "response": [] - }, - "nodes.info": { - "request": [ - "Request: query parameter 'master_timeout' does not exist in the json spec" - ], - "response": [] - }, - "nodes.stats": { - "request": [ - "Request: query parameter 'master_timeout' does not exist in the json spec" - ], - "response": [] - }, "profiling.flamegraph": { "request": [ "Missing request & response" @@ -664,19 +458,9 @@ ], "response": [] }, - "search_shards": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" - ], - "response": [] - }, "searchable_snapshots.clear_cache": { "request": [ - "Request: query parameter 'pretty' does not exist in the json spec", - "Request: query parameter 'human' does not exist in the json spec", - "Request: missing json spec query parameter 'index'", - "request definition searchable_snapshots.clear_cache:Request / query - Property 'pretty' is already defined in an ancestor class", - "request definition searchable_snapshots.clear_cache:Request / query - Property 'human' is already defined in an ancestor class" + "Request: missing json spec query parameter 'index'" ], "response": [] }, @@ -701,12 +485,6 @@ ], "response": [] }, - "shutdown.get_node": { - "request": [ - "Request: query parameter 'timeout' does not exist in the json spec" - ], - "response": [] - }, "shutdown.put_node": { "request": [ "Request: query parameter 'master_timeout' does not exist in the json spec", @@ -714,9 +492,15 @@ ], "response": [] }, +<<<<<<< HEAD "snapshot.clone": { "request": [ "Request: query parameter 'timeout' does not exist in the json spec" +======= + "simulate.ingest": { + "request": [ + "Missing request & response" +>>>>>>> be1386ab9 (Fix common query parameters (#3297)) ], "response": [] }, @@ -732,12 +516,6 @@ ], "response": [] }, - "tasks.list": { - "request": [ - "Request: query parameter 'master_timeout' does not exist in the json spec" - ], - "response": [] - }, "transform.get_node_stats": { "request": [ "Missing request & response" @@ -751,12 +529,6 @@ "interface definition transform._types:SyncContainer - Property time is a single-variant and must be required" ] }, - "transform.reset_transform": { - "request": [ - "Request: missing json spec query parameter 'timeout'" - ], - "response": [] - }, "watcher.execute_watch": { "request": [ "interface definition watcher._types:TriggerContainer - Property schedule is a single-variant and must be required" @@ -765,9 +537,21 @@ "interface definition watcher._types:TriggerEventContainer - Property schedule is a single-variant and must be required" ] }, +<<<<<<< HEAD "watcher.start": { "request": [ "Request: missing json spec query parameter 'master_timeout'" +======= + "watcher.get_settings": { + "request": [ + "Missing request & response" + ], + "response": [] + }, + "watcher.update_settings": { + "request": [ + "Missing request & response" +>>>>>>> b6a68ae73 (Fix common query parameters (#3297)) ], "response": [] }, diff --git a/output/typescript/types.ts b/output/typescript/types.ts index 4e0b635ec9..a17b9c1324 100644 --- a/output/typescript/types.ts +++ b/output/typescript/types.ts @@ -1887,6 +1887,7 @@ export interface SearchShardsRequest extends RequestBase { expand_wildcards?: ExpandWildcards ignore_unavailable?: boolean local?: boolean + master_timeout?: Duration preference?: string routing?: Routing } @@ -8794,12 +8795,14 @@ export interface CcrShardStats { export interface CcrDeleteAutoFollowPatternRequest extends RequestBase { name: Name + master_timeout?: Duration } export type CcrDeleteAutoFollowPatternResponse = AcknowledgedResponseBase export interface CcrFollowRequest extends RequestBase { index: IndexName + master_timeout?: Duration wait_for_active_shards?: WaitForActiveShards body?: { data_stream_name?: string @@ -8850,6 +8853,7 @@ export type CcrFollowInfoFollowerIndexStatus = 'active' | 'paused' export interface CcrFollowInfoRequest extends RequestBase { index: Indices + master_timeout?: Duration } export interface CcrFollowInfoResponse { @@ -8858,6 +8862,7 @@ export interface CcrFollowInfoResponse { export interface CcrFollowStatsRequest extends RequestBase { index: Indices + timeout?: Duration } export interface CcrFollowStatsResponse { @@ -8866,6 +8871,7 @@ export interface CcrFollowStatsResponse { export interface CcrForgetFollowerRequest extends RequestBase { index: IndexName + timeout?: Duration body?: { follower_cluster?: string follower_index?: IndexName @@ -8894,6 +8900,7 @@ export interface CcrGetAutoFollowPatternAutoFollowPatternSummary { export interface CcrGetAutoFollowPatternRequest extends RequestBase { name?: Name + master_timeout?: Duration } export interface CcrGetAutoFollowPatternResponse { @@ -8902,18 +8909,21 @@ export interface CcrGetAutoFollowPatternResponse { export interface CcrPauseAutoFollowPatternRequest extends RequestBase { name: Name + master_timeout?: Duration } export type CcrPauseAutoFollowPatternResponse = AcknowledgedResponseBase export interface CcrPauseFollowRequest extends RequestBase { index: IndexName + master_timeout?: Duration } export type CcrPauseFollowResponse = AcknowledgedResponseBase export interface CcrPutAutoFollowPatternRequest extends RequestBase { name: Name + master_timeout?: Duration body?: { remote_cluster: string follow_index_pattern?: IndexPattern @@ -8937,12 +8947,14 @@ export type CcrPutAutoFollowPatternResponse = AcknowledgedResponseBase export interface CcrResumeAutoFollowPatternRequest extends RequestBase { name: Name + master_timeout?: Duration } export type CcrResumeAutoFollowPatternResponse = AcknowledgedResponseBase export interface CcrResumeFollowRequest extends RequestBase { index: IndexName + master_timeout?: Duration body?: { max_outstanding_read_requests?: long max_outstanding_write_requests?: long @@ -8978,6 +8990,8 @@ export interface CcrStatsFollowStats { } export interface CcrStatsRequest extends RequestBase { + master_timeout?: Duration + timeout?: Duration } export interface CcrStatsResponse { @@ -8987,6 +9001,7 @@ export interface CcrStatsResponse { export interface CcrUnfollowRequest extends RequestBase { index: IndexName + master_timeout?: Duration } export type CcrUnfollowResponse = AcknowledgedResponseBase @@ -9077,6 +9092,7 @@ export interface ClusterAllocationExplainNodeDiskUsage { export interface ClusterAllocationExplainRequest extends RequestBase { include_disk_info?: boolean include_yes_decisions?: boolean + master_timeout?: Duration body?: { current_node?: string index?: IndexName @@ -9141,6 +9157,7 @@ export interface ClusterDeleteComponentTemplateRequest extends RequestBase { export type ClusterDeleteComponentTemplateResponse = AcknowledgedResponseBase export interface ClusterDeleteVotingConfigExclusionsRequest extends RequestBase { + master_timeout?: Duration wait_for_removal?: boolean } @@ -9273,6 +9290,7 @@ export interface ClusterPendingTasksResponse { export interface ClusterPostVotingConfigExclusionsRequest extends RequestBase { node_names?: Names node_ids?: Ids + master_timeout?: Duration timeout?: Duration } @@ -10296,6 +10314,7 @@ export interface EnrichSummary { export interface EnrichDeletePolicyRequest extends RequestBase { name: Name + master_timeout?: Duration } export type EnrichDeletePolicyResponse = AcknowledgedResponseBase @@ -10308,6 +10327,7 @@ export interface EnrichExecutePolicyExecuteEnrichPolicyStatus { export interface EnrichExecutePolicyRequest extends RequestBase { name: Name + master_timeout?: Duration wait_for_completion?: boolean } @@ -10318,6 +10338,7 @@ export interface EnrichExecutePolicyResponse { export interface EnrichGetPolicyRequest extends RequestBase { name?: Names + master_timeout?: Duration } export interface EnrichGetPolicyResponse { @@ -10326,6 +10347,7 @@ export interface EnrichGetPolicyResponse { export interface EnrichPutPolicyRequest extends RequestBase { name: Name + master_timeout?: Duration body?: { geo_match?: EnrichPolicy match?: EnrichPolicy @@ -10360,6 +10382,7 @@ export interface EnrichStatsExecutingPolicy { } export interface EnrichStatsRequest extends RequestBase { + master_timeout?: Duration } export interface EnrichStatsResponse { @@ -10499,6 +10522,7 @@ export interface FeaturesFeature { } export interface FeaturesGetFeaturesRequest extends RequestBase { + master_timeout?: Duration } export interface FeaturesGetFeaturesResponse { @@ -10506,6 +10530,7 @@ export interface FeaturesGetFeaturesResponse { } export interface FeaturesResetFeaturesRequest extends RequestBase { + master_timeout?: Duration } export interface FeaturesResetFeaturesResponse { @@ -10858,7 +10883,6 @@ export interface IlmExplainLifecycleRequest extends RequestBase { only_errors?: boolean only_managed?: boolean master_timeout?: Duration - timeout?: Duration } export interface IlmExplainLifecycleResponse { @@ -11813,8 +11837,6 @@ export interface IndicesFieldUsageStatsRequest extends RequestBase { expand_wildcards?: ExpandWildcards ignore_unavailable?: boolean fields?: Fields - master_timeout?: Duration - timeout?: Duration wait_for_active_shards?: WaitForActiveShards } @@ -13489,7 +13511,6 @@ export interface IngestGetGeoipDatabaseDatabaseConfigurationMetadata { export interface IngestGetGeoipDatabaseRequest extends RequestBase { id?: Ids - master_timeout?: Duration } export interface IngestGetGeoipDatabaseResponse { @@ -13597,6 +13618,8 @@ export type LicenseLicenseStatus = 'active' | 'valid' | 'invalid' | 'expired' export type LicenseLicenseType = 'missing' | 'trial' | 'basic' | 'standard' | 'dev' | 'silver' | 'gold' | 'platinum' | 'enterprise' export interface LicenseDeleteRequest extends RequestBase { + master_timeout?: Duration + timeout?: Duration } export type LicenseDeleteResponse = AcknowledgedResponseBase @@ -13646,6 +13669,8 @@ export interface LicensePostAcknowledgement { export interface LicensePostRequest extends RequestBase { acknowledge?: boolean + master_timeout?: Duration + timeout?: Duration body?: { license?: LicenseLicense licenses?: LicenseLicense[] @@ -13660,6 +13685,8 @@ export interface LicensePostResponse { export interface LicensePostStartBasicRequest extends RequestBase { acknowledge?: boolean + master_timeout?: Duration + timeout?: Duration } export interface LicensePostStartBasicResponse { @@ -13673,6 +13700,7 @@ export interface LicensePostStartBasicResponse { export interface LicensePostStartTrialRequest extends RequestBase { acknowledge?: boolean type_query_string?: string + master_timeout?: Duration } export interface LicensePostStartTrialResponse { @@ -15186,6 +15214,7 @@ export type MlDeleteModelSnapshotResponse = AcknowledgedResponseBase export interface MlDeleteTrainedModelRequest extends RequestBase { model_id: Id force?: boolean + timeout?: Duration } export type MlDeleteTrainedModelResponse = AcknowledgedResponseBase @@ -15579,7 +15608,6 @@ export interface MlGetMemoryStatsMemory { export interface MlGetMemoryStatsRequest extends RequestBase { node_id?: Id - human?: boolean master_timeout?: Duration timeout?: Duration } @@ -16964,7 +16992,6 @@ export interface NodesHotThreadsRequest extends RequestBase { ignore_idle_threads?: boolean interval?: Duration snapshots?: long - master_timeout?: Duration threads?: long timeout?: Duration type?: ThreadType @@ -17326,7 +17353,6 @@ export interface NodesInfoRequest extends RequestBase { node_id?: NodeIds metric?: Metrics flat_settings?: boolean - master_timeout?: Duration timeout?: Duration } @@ -17362,7 +17388,6 @@ export interface NodesStatsRequest extends RequestBase { groups?: boolean include_segment_file_sizes?: boolean level?: Level - master_timeout?: Duration timeout?: Duration types?: string[] include_unloaded_segments?: boolean @@ -17842,8 +17867,6 @@ export interface SearchableSnapshotsClearCacheRequest extends RequestBase { expand_wildcards?: ExpandWildcards allow_no_indices?: boolean ignore_unavailable?: boolean - pretty?: boolean - human?: boolean } export type SearchableSnapshotsClearCacheResponse = any @@ -19182,7 +19205,6 @@ export interface ShutdownGetNodePluginsStatus { export interface ShutdownGetNodeRequest extends RequestBase { node_id?: NodeIds master_timeout?: TimeUnit - timeout?: TimeUnit } export interface ShutdownGetNodeResponse { @@ -19597,7 +19619,6 @@ export interface SnapshotCloneRequest extends RequestBase { snapshot: Name target_snapshot: Name master_timeout?: Duration - timeout?: Duration body?: { indices: string } @@ -20035,7 +20056,6 @@ export interface TasksListRequest extends RequestBase { group_by?: TasksGroupBy nodes?: NodeIds parent_task_id?: Id - master_timeout?: Duration timeout?: Duration wait_for_completion?: boolean } @@ -20412,6 +20432,7 @@ export type TransformPutTransformResponse = AcknowledgedResponseBase export interface TransformResetTransformRequest extends RequestBase { transform_id: Id force?: boolean + timeout?: Duration } export type TransformResetTransformResponse = AcknowledgedResponseBase @@ -21136,6 +21157,7 @@ export interface WatcherQueryWatchesResponse { } export interface WatcherStartRequest extends RequestBase { + master_timeout?: Duration } export type WatcherStartResponse = AcknowledgedResponseBase diff --git a/specification/_global/search_shards/SearchShardsRequest.ts b/specification/_global/search_shards/SearchShardsRequest.ts index 55cfecbf64..64b6cb31ab 100644 --- a/specification/_global/search_shards/SearchShardsRequest.ts +++ b/specification/_global/search_shards/SearchShardsRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { ExpandWildcards, Indices, Routing } from '@_types/common' +import { Duration } from '@_types/Time' /** * Get the search shards. @@ -63,6 +64,11 @@ export interface Request extends RequestBase { * @server_default false */ local?: boolean + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration /** * Specifies the node or shard the operation should be performed on. * Random by default. diff --git a/specification/ccr/delete_auto_follow_pattern/DeleteAutoFollowPatternRequest.ts b/specification/ccr/delete_auto_follow_pattern/DeleteAutoFollowPatternRequest.ts index 1453c767bc..38ef021cae 100644 --- a/specification/ccr/delete_auto_follow_pattern/DeleteAutoFollowPatternRequest.ts +++ b/specification/ccr/delete_auto_follow_pattern/DeleteAutoFollowPatternRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Name } from '@_types/common' +import { Duration } from '@_types/Time' /** * Delete auto-follow patterns. @@ -32,4 +33,11 @@ export interface Request extends RequestBase { path_parts: { name: Name } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/ccr/follow/CreateFollowIndexRequest.ts b/specification/ccr/follow/CreateFollowIndexRequest.ts index 263774f597..ba97e71c56 100644 --- a/specification/ccr/follow/CreateFollowIndexRequest.ts +++ b/specification/ccr/follow/CreateFollowIndexRequest.ts @@ -39,6 +39,11 @@ export interface Request extends RequestBase { index: IndexName } query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration /** * Specifies the number of shards to wait on being active before responding. This defaults to waiting on none of the shards to be * active. diff --git a/specification/ccr/follow_info/FollowInfoRequest.ts b/specification/ccr/follow_info/FollowInfoRequest.ts index 3ebca0f259..27c0aef895 100644 --- a/specification/ccr/follow_info/FollowInfoRequest.ts +++ b/specification/ccr/follow_info/FollowInfoRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Indices } from '@_types/common' +import { Duration } from '@_types/Time' /** * Get follower information. @@ -33,4 +34,11 @@ export interface Request extends RequestBase { path_parts: { index: Indices } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/ccr/follow_stats/FollowIndexStatsRequest.ts b/specification/ccr/follow_stats/FollowIndexStatsRequest.ts index 7009b5f220..676487c7fa 100644 --- a/specification/ccr/follow_stats/FollowIndexStatsRequest.ts +++ b/specification/ccr/follow_stats/FollowIndexStatsRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Indices } from '@_types/common' +import { Duration } from '@_types/Time' /** * Get follower stats. @@ -33,4 +34,11 @@ export interface Request extends RequestBase { path_parts: { index: Indices } + query_parameters: { + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ + timeout?: Duration + } } diff --git a/specification/ccr/forget_follower/ForgetFollowerIndexRequest.ts b/specification/ccr/forget_follower/ForgetFollowerIndexRequest.ts index 2293381615..88a71b994d 100644 --- a/specification/ccr/forget_follower/ForgetFollowerIndexRequest.ts +++ b/specification/ccr/forget_follower/ForgetFollowerIndexRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { IndexName, Uuid } from '@_types/common' +import { Duration } from '@_types/Time' /** * Forget a follower. @@ -42,6 +43,13 @@ export interface Request extends RequestBase { path_parts: { index: IndexName } + query_parameters: { + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ + timeout?: Duration + } body: { follower_cluster?: string follower_index?: IndexName diff --git a/specification/ccr/get_auto_follow_pattern/GetAutoFollowPatternRequest.ts b/specification/ccr/get_auto_follow_pattern/GetAutoFollowPatternRequest.ts index 433e27f425..50ba1ce62e 100644 --- a/specification/ccr/get_auto_follow_pattern/GetAutoFollowPatternRequest.ts +++ b/specification/ccr/get_auto_follow_pattern/GetAutoFollowPatternRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Name } from '@_types/common' +import { Duration } from '@_types/Time' /** * Get auto-follow patterns. @@ -33,4 +34,11 @@ export interface Request extends RequestBase { /** Specifies the auto-follow pattern collection that you want to retrieve. If you do not specify a name, the API returns information for all collections. */ name?: Name } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/ccr/pause_auto_follow_pattern/PauseAutoFollowPatternRequest.ts b/specification/ccr/pause_auto_follow_pattern/PauseAutoFollowPatternRequest.ts index e670093d4a..69ae39cec0 100644 --- a/specification/ccr/pause_auto_follow_pattern/PauseAutoFollowPatternRequest.ts +++ b/specification/ccr/pause_auto_follow_pattern/PauseAutoFollowPatternRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Name } from '@_types/common' +import { Duration } from '@_types/Time' /** * Pause an auto-follow pattern. @@ -38,4 +39,11 @@ export interface Request extends RequestBase { path_parts: { name: Name } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/ccr/pause_follow/PauseFollowIndexRequest.ts b/specification/ccr/pause_follow/PauseFollowIndexRequest.ts index 6a8e642959..91f2a54d03 100644 --- a/specification/ccr/pause_follow/PauseFollowIndexRequest.ts +++ b/specification/ccr/pause_follow/PauseFollowIndexRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { IndexName } from '@_types/common' +import { Duration } from '@_types/Time' /** * Pause a follower. @@ -34,4 +35,11 @@ export interface Request extends RequestBase { path_parts: { index: IndexName } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/ccr/put_auto_follow_pattern/PutAutoFollowPatternRequest.ts b/specification/ccr/put_auto_follow_pattern/PutAutoFollowPatternRequest.ts index d61bbf73be..ac4319645b 100644 --- a/specification/ccr/put_auto_follow_pattern/PutAutoFollowPatternRequest.ts +++ b/specification/ccr/put_auto_follow_pattern/PutAutoFollowPatternRequest.ts @@ -44,6 +44,13 @@ export interface Request extends RequestBase { */ name: Name } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } body: { /** * The remote cluster containing the leader indices to match against. diff --git a/specification/ccr/resume_auto_follow_pattern/ResumeAutoFollowPatternRequest.ts b/specification/ccr/resume_auto_follow_pattern/ResumeAutoFollowPatternRequest.ts index 2fb24358f1..02ae33846b 100644 --- a/specification/ccr/resume_auto_follow_pattern/ResumeAutoFollowPatternRequest.ts +++ b/specification/ccr/resume_auto_follow_pattern/ResumeAutoFollowPatternRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Name } from '@_types/common' +import { Duration } from '@_types/Time' /** * Resume an auto-follow pattern. @@ -34,4 +35,11 @@ export interface Request extends RequestBase { path_parts: { name: Name } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts b/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts index adc86c0798..46ba0b9757 100644 --- a/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts +++ b/specification/ccr/resume_follow/ResumeFollowIndexRequest.ts @@ -37,6 +37,13 @@ export interface Request extends RequestBase { path_parts: { index: IndexName } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } body: { max_outstanding_read_requests?: long max_outstanding_write_requests?: long diff --git a/specification/ccr/stats/CcrStatsRequest.ts b/specification/ccr/stats/CcrStatsRequest.ts index 280205ff97..e0a10215a8 100644 --- a/specification/ccr/stats/CcrStatsRequest.ts +++ b/specification/ccr/stats/CcrStatsRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Get cross-cluster replication stats. @@ -26,4 +27,17 @@ import { RequestBase } from '@_types/Base' * @availability stack since=6.5.0 stability=stable * @doc_id ccr-get-stats */ -export interface Request extends RequestBase {} +export interface Request extends RequestBase { + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ + timeout?: Duration + } +} diff --git a/specification/ccr/unfollow/UnfollowIndexRequest.ts b/specification/ccr/unfollow/UnfollowIndexRequest.ts index 6913918463..d0e979f7b1 100644 --- a/specification/ccr/unfollow/UnfollowIndexRequest.ts +++ b/specification/ccr/unfollow/UnfollowIndexRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { IndexName } from '@_types/common' +import { Duration } from '@_types/Time' /** * Unfollow an index. @@ -36,4 +37,11 @@ export interface Request extends RequestBase { path_parts: { index: IndexName } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/cluster/allocation_explain/ClusterAllocationExplainRequest.ts b/specification/cluster/allocation_explain/ClusterAllocationExplainRequest.ts index f38a39db22..f79f4538bc 100644 --- a/specification/cluster/allocation_explain/ClusterAllocationExplainRequest.ts +++ b/specification/cluster/allocation_explain/ClusterAllocationExplainRequest.ts @@ -20,6 +20,7 @@ import { RequestBase } from '@_types/Base' import { IndexName } from '@_types/common' import { integer } from '@_types/Numeric' +import { Duration } from '@_types/Time' /** * Explain the shard allocations. @@ -44,6 +45,11 @@ export interface Request extends RequestBase { * @server_default false */ include_yes_decisions?: boolean + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration } body: { /** diff --git a/specification/cluster/delete_voting_config_exclusions/ClusterDeleteVotingConfigExclusionsRequest.ts b/specification/cluster/delete_voting_config_exclusions/ClusterDeleteVotingConfigExclusionsRequest.ts index 3f181de67e..50c7a8d66e 100644 --- a/specification/cluster/delete_voting_config_exclusions/ClusterDeleteVotingConfigExclusionsRequest.ts +++ b/specification/cluster/delete_voting_config_exclusions/ClusterDeleteVotingConfigExclusionsRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Clear cluster voting config exclusions. @@ -29,6 +30,11 @@ import { RequestBase } from '@_types/Base' */ export interface Request extends RequestBase { query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration /** * Specifies whether to wait for all excluded nodes to be removed from the * cluster before clearing the voting configuration exclusions list. diff --git a/specification/cluster/post_voting_config_exclusions/ClusterPostVotingConfigExclusionsRequest.ts b/specification/cluster/post_voting_config_exclusions/ClusterPostVotingConfigExclusionsRequest.ts index 67421889c0..959c4af8ba 100644 --- a/specification/cluster/post_voting_config_exclusions/ClusterPostVotingConfigExclusionsRequest.ts +++ b/specification/cluster/post_voting_config_exclusions/ClusterPostVotingConfigExclusionsRequest.ts @@ -57,6 +57,11 @@ export interface Request extends RequestBase { * from the voting configuration. If specified, you may not also specify node_names. */ node_ids?: Ids + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration /** * When adding a voting configuration exclusion, the API waits for the * specified nodes to be excluded from the voting configuration before diff --git a/specification/enrich/delete_policy/DeleteEnrichPolicyRequest.ts b/specification/enrich/delete_policy/DeleteEnrichPolicyRequest.ts index 1f46679bf0..8ccb249d8d 100644 --- a/specification/enrich/delete_policy/DeleteEnrichPolicyRequest.ts +++ b/specification/enrich/delete_policy/DeleteEnrichPolicyRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Name } from '@_types/common' +import { Duration } from '@_types/Time' /** * Delete an enrich policy. @@ -34,4 +35,11 @@ export interface Request extends RequestBase { */ name: Name } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/enrich/execute_policy/ExecuteEnrichPolicyRequest.ts b/specification/enrich/execute_policy/ExecuteEnrichPolicyRequest.ts index 32095c8f3e..2be0d48a63 100644 --- a/specification/enrich/execute_policy/ExecuteEnrichPolicyRequest.ts +++ b/specification/enrich/execute_policy/ExecuteEnrichPolicyRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Name } from '@_types/common' +import { Duration } from '@_types/Time' /** * Run an enrich policy. @@ -36,6 +37,11 @@ export interface Request extends RequestBase { name: Name } query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration /** * If `true`, the request blocks other enrich policy execution requests until complete. * @server_default true diff --git a/specification/enrich/get_policy/GetEnrichPolicyRequest.ts b/specification/enrich/get_policy/GetEnrichPolicyRequest.ts index bee0b8bbf8..df025b1416 100644 --- a/specification/enrich/get_policy/GetEnrichPolicyRequest.ts +++ b/specification/enrich/get_policy/GetEnrichPolicyRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Names } from '@_types/common' +import { Duration } from '@_types/Time' /** * Get an enrich policy. @@ -35,4 +36,11 @@ export interface Request extends RequestBase { */ name?: Names } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } } diff --git a/specification/enrich/put_policy/PutEnrichPolicyRequest.ts b/specification/enrich/put_policy/PutEnrichPolicyRequest.ts index 0aee24f900..8fa742b2ee 100644 --- a/specification/enrich/put_policy/PutEnrichPolicyRequest.ts +++ b/specification/enrich/put_policy/PutEnrichPolicyRequest.ts @@ -20,6 +20,7 @@ import { Policy } from '@enrich/_types/Policy' import { RequestBase } from '@_types/Base' import { Name } from '@_types/common' +import { Duration } from '@_types/Time' /** * Create an enrich policy. @@ -36,6 +37,13 @@ export interface Request extends RequestBase { */ name: Name } + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } body: { /** * Matches enrich data to incoming documents based on a `geo_shape` query. diff --git a/specification/enrich/stats/EnrichStatsRequest.ts b/specification/enrich/stats/EnrichStatsRequest.ts index 803dadb3d6..bc847a9f5a 100644 --- a/specification/enrich/stats/EnrichStatsRequest.ts +++ b/specification/enrich/stats/EnrichStatsRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Get enrich stats. @@ -26,4 +27,12 @@ import { RequestBase } from '@_types/Base' * @availability stack since=7.5.0 stability=stable * @availability serverless stability=stable visibility=public */ -export interface Request extends RequestBase {} +export interface Request extends RequestBase { + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } +} diff --git a/specification/features/get_features/GetFeaturesRequest.ts b/specification/features/get_features/GetFeaturesRequest.ts index 533c11229b..509992db73 100644 --- a/specification/features/get_features/GetFeaturesRequest.ts +++ b/specification/features/get_features/GetFeaturesRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Get the features. @@ -34,4 +35,12 @@ import { RequestBase } from '@_types/Base' * @availability stack since=7.12.0 stability=stable * @ext_doc_id snapshot-create */ -export interface Request extends RequestBase {} +export interface Request extends RequestBase { + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } +} diff --git a/specification/features/reset_features/ResetFeaturesRequest.ts b/specification/features/reset_features/ResetFeaturesRequest.ts index 4364a55ccf..a0eef89a73 100644 --- a/specification/features/reset_features/ResetFeaturesRequest.ts +++ b/specification/features/reset_features/ResetFeaturesRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Reset the features. @@ -41,4 +42,12 @@ import { RequestBase } from '@_types/Base' * @availability stack since=7.12.0 stability=experimental * @availability serverless stability=experimental visibility=private */ -export interface Request extends RequestBase {} +export interface Request extends RequestBase { + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } +} diff --git a/specification/ilm/explain_lifecycle/ExplainLifecycleRequest.ts b/specification/ilm/explain_lifecycle/ExplainLifecycleRequest.ts index 7eacbdaf41..dcba3620bd 100644 --- a/specification/ilm/explain_lifecycle/ExplainLifecycleRequest.ts +++ b/specification/ilm/explain_lifecycle/ExplainLifecycleRequest.ts @@ -53,10 +53,5 @@ export interface Request extends RequestBase { * @server_default 30s */ master_timeout?: Duration - /** - * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. - * @server_default 30s - */ - timeout?: Duration } } diff --git a/specification/ilm/start/StartIlmRequest.ts b/specification/ilm/start/StartIlmRequest.ts index aaa44be924..12a27e3aef 100644 --- a/specification/ilm/start/StartIlmRequest.ts +++ b/specification/ilm/start/StartIlmRequest.ts @@ -31,7 +31,15 @@ import { Duration } from '@_types/Time' */ export interface Request extends RequestBase { query_parameters: { + /** + * Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ master_timeout?: Duration + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ timeout?: Duration } } diff --git a/specification/ilm/stop/StopIlmRequest.ts b/specification/ilm/stop/StopIlmRequest.ts index 3f20ae5795..2761540986 100644 --- a/specification/ilm/stop/StopIlmRequest.ts +++ b/specification/ilm/stop/StopIlmRequest.ts @@ -33,7 +33,15 @@ import { Duration } from '@_types/Time' */ export interface Request extends RequestBase { query_parameters: { + /** + * Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ master_timeout?: Duration + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ timeout?: Duration } } diff --git a/specification/indices/field_usage_stats/IndicesFieldUsageStatsRequest.ts b/specification/indices/field_usage_stats/IndicesFieldUsageStatsRequest.ts index 139723d57f..e7bbe76741 100644 --- a/specification/indices/field_usage_stats/IndicesFieldUsageStatsRequest.ts +++ b/specification/indices/field_usage_stats/IndicesFieldUsageStatsRequest.ts @@ -24,7 +24,6 @@ import { Indices, WaitForActiveShards } from '@_types/common' -import { Duration } from '@_types/Time' /** * Get field usage stats. @@ -69,18 +68,6 @@ export interface Request extends RequestBase { * Comma-separated list or wildcard expressions of fields to include in the statistics. */ fields?: Fields - /** - * Period to wait for a connection to the master node. - * If no response is received before the timeout expires, the request fails and returns an error. - * @server_default 30s - */ - master_timeout?: Duration - /** - * Period to wait for a response. - * If no response is received before the timeout expires, the request fails and returns an error. - * @server_default 30s - */ - timeout?: Duration /** * The number of shard copies that must be active before proceeding with the operation. * Set to all or any positive integer up to the total number of shards in the index (`number_of_replicas+1`). diff --git a/specification/ingest/get_geoip_database/GetGeoipDatabaseRequest.ts b/specification/ingest/get_geoip_database/GetGeoipDatabaseRequest.ts index a3780949ae..5854167ffd 100644 --- a/specification/ingest/get_geoip_database/GetGeoipDatabaseRequest.ts +++ b/specification/ingest/get_geoip_database/GetGeoipDatabaseRequest.ts @@ -19,7 +19,6 @@ import { RequestBase } from '@_types/Base' import { Ids } from '@_types/common' -import { Duration } from '@_types/Time' /** * Get GeoIP database configurations. @@ -37,11 +36,4 @@ export interface Request extends RequestBase { */ id?: Ids } - query_parameters: { - /** - * Period to wait for a connection to the master node. - * If no response is received before the timeout expires, the request fails and returns an error. - * @server_default 30s */ - master_timeout?: Duration - } } diff --git a/specification/license/delete/DeleteLicenseRequest.ts b/specification/license/delete/DeleteLicenseRequest.ts index 2f432fecda..1f1ba63989 100644 --- a/specification/license/delete/DeleteLicenseRequest.ts +++ b/specification/license/delete/DeleteLicenseRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Delete the license. @@ -29,4 +30,17 @@ import { RequestBase } from '@_types/Base' * @cluster_privileges manage * @ext_doc_id license-management */ -export interface Request extends RequestBase {} +export interface Request extends RequestBase { + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ + timeout?: Duration + } +} diff --git a/specification/license/post/PostLicenseRequest.ts b/specification/license/post/PostLicenseRequest.ts index bc7d0e89ca..8672884a54 100644 --- a/specification/license/post/PostLicenseRequest.ts +++ b/specification/license/post/PostLicenseRequest.ts @@ -19,6 +19,7 @@ import { License } from '@license/_types/License' import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Update the license. @@ -40,6 +41,16 @@ export interface Request extends RequestBase { * @server_default false */ acknowledge?: boolean + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ + timeout?: Duration } body: { license?: License diff --git a/specification/license/post_start_basic/StartBasicLicenseRequest.ts b/specification/license/post_start_basic/StartBasicLicenseRequest.ts index 63339ddafb..210e92bfe8 100644 --- a/specification/license/post_start_basic/StartBasicLicenseRequest.ts +++ b/specification/license/post_start_basic/StartBasicLicenseRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Start a basic license. @@ -36,5 +37,15 @@ import { RequestBase } from '@_types/Base' export interface Request extends RequestBase { query_parameters: { acknowledge?: boolean + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ + timeout?: Duration } } diff --git a/specification/license/post_start_trial/StartTrialLicenseRequest.ts b/specification/license/post_start_trial/StartTrialLicenseRequest.ts index 989ae9f846..31fb7a8886 100644 --- a/specification/license/post_start_trial/StartTrialLicenseRequest.ts +++ b/specification/license/post_start_trial/StartTrialLicenseRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Start a trial. @@ -36,5 +37,10 @@ export interface Request extends RequestBase { query_parameters: { acknowledge?: boolean type_query_string?: string + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration } } diff --git a/specification/ml/delete_trained_model/MlDeleteTrainedModelRequest.ts b/specification/ml/delete_trained_model/MlDeleteTrainedModelRequest.ts index 4fe1de2ce7..d3036608cd 100644 --- a/specification/ml/delete_trained_model/MlDeleteTrainedModelRequest.ts +++ b/specification/ml/delete_trained_model/MlDeleteTrainedModelRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' +import { Duration } from '@_types/Time' /** * Delete an unreferenced trained model. @@ -39,5 +40,10 @@ export interface Request extends RequestBase { query_parameters: { /** Forcefully deletes a trained model that is referenced by ingest pipelines or has a started deployment. **/ force?: boolean + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ + timeout?: Duration } } diff --git a/specification/ml/get_memory_stats/MlGetMemoryStatsRequest.ts b/specification/ml/get_memory_stats/MlGetMemoryStatsRequest.ts index 100cba2f87..cc50332460 100644 --- a/specification/ml/get_memory_stats/MlGetMemoryStatsRequest.ts +++ b/specification/ml/get_memory_stats/MlGetMemoryStatsRequest.ts @@ -39,11 +39,6 @@ export interface Request extends RequestBase { node_id?: Id } query_parameters: { - /** - * Specify this query parameter to include the fields with units in the response. Otherwise only - * the `_in_bytes` sizes are returned in the response. - */ - human?: boolean /** * Period to wait for a connection to the master node. If no response is received before the timeout * expires, the request fails and returns an error. diff --git a/specification/nodes/hot_threads/NodesHotThreadsRequest.ts b/specification/nodes/hot_threads/NodesHotThreadsRequest.ts index 46ef45bb17..b8b3c8e5ea 100644 --- a/specification/nodes/hot_threads/NodesHotThreadsRequest.ts +++ b/specification/nodes/hot_threads/NodesHotThreadsRequest.ts @@ -57,13 +57,6 @@ export interface Request extends RequestBase { * @server_default 10 */ snapshots?: long - /** - * Period to wait for a connection to the master node. If no response - * is received before the timeout expires, the request fails and - * returns an error. - * @server_default 30s - */ - master_timeout?: Duration /** * Specifies the number of hot threads to provide information for. * @server_default 3 diff --git a/specification/nodes/info/NodesInfoRequest.ts b/specification/nodes/info/NodesInfoRequest.ts index 88c20e3b5e..b3ff497a24 100644 --- a/specification/nodes/info/NodesInfoRequest.ts +++ b/specification/nodes/info/NodesInfoRequest.ts @@ -43,11 +43,6 @@ export interface Request extends RequestBase { * @server_default false */ flat_settings?: boolean - /** - * Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. - * @server_default 30s - */ - master_timeout?: Duration /** * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. * @server_default 30s diff --git a/specification/nodes/stats/NodesStatsRequest.ts b/specification/nodes/stats/NodesStatsRequest.ts index d349a4df7d..c64e9a3b1c 100644 --- a/specification/nodes/stats/NodesStatsRequest.ts +++ b/specification/nodes/stats/NodesStatsRequest.ts @@ -57,11 +57,6 @@ export interface Request extends RequestBase { include_segment_file_sizes?: boolean /** Indicates whether statistics are aggregated at the cluster, index, or shard level. */ level?: Level - /** - * Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. - * @server_default 30s - */ - master_timeout?: Duration /** * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. * @server_default 30s diff --git a/specification/searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts b/specification/searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts index d014ca76d5..21f8c3e751 100644 --- a/specification/searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts +++ b/specification/searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts @@ -42,7 +42,5 @@ export interface Request extends RequestBase { expand_wildcards?: ExpandWildcards allow_no_indices?: boolean ignore_unavailable?: boolean - pretty?: boolean - human?: boolean } } diff --git a/specification/shutdown/get_node/ShutdownGetNodeRequest.ts b/specification/shutdown/get_node/ShutdownGetNodeRequest.ts index 0cea4eb47b..fb381bcd9a 100644 --- a/specification/shutdown/get_node/ShutdownGetNodeRequest.ts +++ b/specification/shutdown/get_node/ShutdownGetNodeRequest.ts @@ -45,10 +45,5 @@ export interface Request extends RequestBase { * @server_default 30s */ master_timeout?: TimeUnit - /** - * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. - * @server_default 30s - */ - timeout?: TimeUnit } } diff --git a/specification/snapshot/clone/SnapshotCloneRequest.ts b/specification/snapshot/clone/SnapshotCloneRequest.ts index ebb1b9772e..16125ac4bb 100644 --- a/specification/snapshot/clone/SnapshotCloneRequest.ts +++ b/specification/snapshot/clone/SnapshotCloneRequest.ts @@ -38,7 +38,6 @@ export interface Request extends RequestBase { } query_parameters: { master_timeout?: Duration - timeout?: Duration } body: { indices: string diff --git a/specification/tasks/list/ListTasksRequest.ts b/specification/tasks/list/ListTasksRequest.ts index 63fb774595..9f49d26d0a 100644 --- a/specification/tasks/list/ListTasksRequest.ts +++ b/specification/tasks/list/ListTasksRequest.ts @@ -55,11 +55,6 @@ export interface Request extends RequestBase { * Parent task ID used to limit returned information. To return all tasks, omit this parameter or use a value of `-1`. */ parent_task_id?: Id - /** - * Period to wait for a connection to the master node. If no response is received before the timeout expires, the request fails and returns an error. - * @server_default 30s - */ - master_timeout?: Duration /** * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. * @server_default 30s diff --git a/specification/transform/reset_transform/ResetTransformRequest.ts b/specification/transform/reset_transform/ResetTransformRequest.ts index 5dc089b75b..4b1f026825 100644 --- a/specification/transform/reset_transform/ResetTransformRequest.ts +++ b/specification/transform/reset_transform/ResetTransformRequest.ts @@ -19,6 +19,7 @@ import { RequestBase } from '@_types/Base' import { Id } from '@_types/common' +import { Duration } from '@_types/Time' /** * Reset a transform. @@ -45,5 +46,10 @@ export interface Request extends RequestBase { * @server_default false */ force?: boolean + /** + * Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error. + * @server_default 30s + */ + timeout?: Duration } } diff --git a/specification/watcher/start/WatcherStartRequest.ts b/specification/watcher/start/WatcherStartRequest.ts index e15a88b3be..bd488ef055 100644 --- a/specification/watcher/start/WatcherStartRequest.ts +++ b/specification/watcher/start/WatcherStartRequest.ts @@ -18,6 +18,7 @@ */ import { RequestBase } from '@_types/Base' +import { Duration } from '@_types/Time' /** * Start the watch service. @@ -27,4 +28,12 @@ import { RequestBase } from '@_types/Base' * @cluster_privileges manage_watcher * @doc_id watcher-api-start */ -export interface Request extends RequestBase {} +export interface Request extends RequestBase { + query_parameters: { + /** + * Period to wait for a connection to the master node. + * @server_default 30s + */ + master_timeout?: Duration + } +} From bb37d04284c35cda5add98ca153f749a02ed29bd Mon Sep 17 00:00:00 2001 From: Laura Trotta Date: Mon, 13 Jan 2025 12:40:12 +0100 Subject: [PATCH 2/3] correct rebase --- output/openapi/elasticsearch-openapi.json | 13 - .../elasticsearch-serverless-openapi.json | 12 + output/schema/schema-serverless.json | 859 ++++++++++-------- output/schema/schema.json | 12 +- output/schema/validation-errors.json | 12 - 5 files changed, 505 insertions(+), 403 deletions(-) diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index 5f054712e4..62a1e15a0f 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -104901,17 +104901,6 @@ }, "style": "form" }, -<<<<<<< HEAD - "shutdown.get_node#timeout": { - "in": "query", - "name": "timeout", - "description": "Period to wait for a response. If no response is received before the timeout expires, the request fails and returns an error.", - "deprecated": false, - "schema": { - "$ref": "#/components/schemas/_types:TimeUnit" - }, - "style": "form" - }, "simulate.ingest#index": { "in": "path", "name": "index", @@ -104933,8 +104922,6 @@ }, "style": "form" }, -======= ->>>>>>> be1386ab9 (Fix common query parameters (#3297)) "slm.get_lifecycle#policy_id": { "in": "path", "name": "policy_id", diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index 4a061fa3fa..d95a7463ed 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -4838,6 +4838,18 @@ "summary": "Get enrich stats", "description": "Returns enrich coordinator statistics and information about enrich policies that are currently executing.", "operationId": "enrich-stats", + "parameters": [ + { + "in": "query", + "name": "master_timeout", + "description": "Period to wait for a connection to the master node.", + "deprecated": false, + "schema": { + "$ref": "#/components/schemas/_types:Duration" + }, + "style": "form" + } + ], "responses": { "200": { "description": "", diff --git a/output/schema/schema-serverless.json b/output/schema/schema-serverless.json index 20e3066fec..993af93afb 100644 --- a/output/schema/schema-serverless.json +++ b/output/schema/schema-serverless.json @@ -778,7 +778,7 @@ "stability": "stable" } }, - "description": "Delete component templates.\nDeletes component templates.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.", + "description": "Delete component templates.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.", "docId": "indices-component-template", "docTag": "indices", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-component-template.html", @@ -857,7 +857,7 @@ "stability": "stable" } }, - "description": "Get component templates.\nRetrieves information about component templates.", + "description": "Get component templates.\nGet information about component templates.", "docId": "indices-component-template", "docTag": "indices", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-component-template.html", @@ -941,7 +941,7 @@ "stability": "stable" } }, - "description": "Create or update a component template.\nCreates or updates a component template.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nAn index template can be composed of multiple component templates.\nTo use a component template, specify it in an index template’s `composed_of` list.\nComponent templates are only applied to new data streams and indices as part of a matching index template.\n\nSettings and mappings specified directly in the index template or the create index request override any settings or mappings specified in a component template.\n\nComponent templates are only used during index creation.\nFor data streams, this includes data stream creation and the creation of a stream’s backing indices.\nChanges to component templates do not affect existing indices, including a stream’s backing indices.\n\nYou can use C-style `/* *\\/` block comments in component templates.\nYou can include comments anywhere in the request body except before the opening curly bracket.", + "description": "Create or update a component template.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nAn index template can be composed of multiple component templates.\nTo use a component template, specify it in an index template’s `composed_of` list.\nComponent templates are only applied to new data streams and indices as part of a matching index template.\n\nSettings and mappings specified directly in the index template or the create index request override any settings or mappings specified in a component template.\n\nComponent templates are only used during index creation.\nFor data streams, this includes data stream creation and the creation of a stream’s backing indices.\nChanges to component templates do not affect existing indices, including a stream’s backing indices.\n\nYou can use C-style `/* *\\/` block comments in component templates.\nYou can include comments anywhere in the request body except before the opening curly bracket.\n\n**Applying component templates**\n\nYou cannot directly apply a component template to a data stream or index.\nTo be applied, a component template must be included in an index template's `composed_of` list.", "docId": "indices-component-template", "docTag": "indices", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-component-template.html", @@ -2588,8 +2588,7 @@ "privileges": { "index": [ "view_index_metadata", - "read", - "manage" + "read" ] }, "request": { @@ -2860,10 +2859,17 @@ "stability": "stable" } }, - "description": "Get tokens from text analysis.\nThe analyze API performs [analysis](https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis.html) on a text string and returns the resulting tokens.", + "description": "Get tokens from text analysis.\nThe analyze API performs analysis on a text string and returns the resulting tokens.\n\nGenerating excessive amount of tokens may cause a node to run out of memory.\nThe `index.analyze.max_token_count` setting enables you to limit the number of tokens that can be produced.\nIf more than this limit of tokens gets generated, an error occurs.\nThe `_analyze` endpoint without a specified index will always use `10000` as its limit.", "docId": "indices-analyze", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-analyze.html", + "extDocId": "analysis", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/analysis.html", "name": "indices.analyze", + "privileges": { + "index": [ + "index" + ] + }, "request": { "name": "Request", "namespace": "indices.analyze" @@ -2906,7 +2912,7 @@ "stability": "stable" } }, - "description": "Create an index.\nCreates a new index.", + "description": "Create an index.\nYou can use the create index API to add a new index to an Elasticsearch cluster.\nWhen creating an index, you can specify the following:\n\n* Settings for the index.\n* Mappings for fields in the index.\n* Index aliases\n\n**Wait for active shards**\n\nBy default, index creation will only return a response to the client when the primary copies of each shard have been started, or the request times out.\nThe index creation response will indicate what happened.\nFor example, `acknowledged` indicates whether the index was successfully created in the cluster, `while shards_acknowledged` indicates whether the requisite number of shard copies were started for each shard in the index before timing out.\nNote that it is still possible for either `acknowledged` or `shards_acknowledged` to be `false`, but for the index creation to be successful.\nThese values simply indicate whether the operation completed before the timeout.\nIf `acknowledged` is false, the request timed out before the cluster state was updated with the newly created index, but it probably will be created sometime soon.\nIf `shards_acknowledged` is false, then the request timed out before the requisite number of shards were started (by default just the primaries), even if the cluster state was successfully updated to reflect the newly created index (that is to say, `acknowledged` is `true`).\n\nYou can change the default of only waiting for the primary shards to start through the index setting `index.write.wait_for_active_shards`.\nNote that changing this setting will also affect the `wait_for_active_shards` value on all subsequent write operations.", "docId": "indices-create-index", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-create-index.html", "name": "indices.create", @@ -3038,9 +3044,15 @@ "stability": "stable" } }, - "description": "Delete indices.\nDeletes one or more indices.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-delete-index.html", + "description": "Delete indices.\nDeleting an index deletes its documents, shards, and metadata.\nIt does not delete related Kibana components, such as data views, visualizations, or dashboards.\n\nYou cannot delete the current write index of a data stream.\nTo delete the index, you must roll over the data stream so a new write index is created.\nYou can then use the delete index API to delete the previous write index.", + "docId": "indices-delete-index", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-delete-index.html", "name": "indices.delete", + "privileges": { + "index": [ + "delete_index" + ] + }, "request": { "name": "Request", "namespace": "indices.delete" @@ -3073,8 +3085,14 @@ } }, "description": "Delete an alias.\nRemoves a data stream or index from an alias.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html", + "docId": "indices-delete-alias", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-delete-alias.html", "name": "indices.delete_alias", + "privileges": { + "index": [ + "manage" + ] + }, "request": { "name": "Request", "namespace": "indices.delete_alias" @@ -3190,12 +3208,12 @@ } }, "description": "Delete an index template.\nThe provided may contain multiple template names separated by a comma. If multiple template\nnames are specified then there is no wildcard support and the provided names should match completely with\nexisting templates.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-delete-template.html", + "docId": "indices-delete-template", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-delete-template.html", "name": "indices.delete_index_template", "privileges": { "cluster": [ - "manage_index_templates", - "manage" + "manage_index_templates" ] }, "request": { @@ -3229,8 +3247,9 @@ "stability": "stable" } }, - "description": "Check indices.\nChecks if one or more indices, index aliases, or data streams exist.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-exists.html", + "description": "Check indices.\nCheck if one or more indices, index aliases, or data streams exist.", + "docId": "indices-exists", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-exists.html", "name": "indices.exists", "request": { "name": "Request", @@ -3373,8 +3392,9 @@ "stability": "stable" } }, - "description": "Get index information.\nReturns information about one or more indices. For data streams, the API returns information about the\nstream’s backing indices.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-index.html", + "description": "Get index information.\nGet information about one or more indices. For data streams, the API returns information about the\nstream’s backing indices.", + "docId": "indices-get-index", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-get-index.html", "name": "indices.get", "privileges": { "index": [ @@ -3414,8 +3434,14 @@ } }, "description": "Get aliases.\nRetrieves information for one or more data stream or index aliases.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-aliases.html", + "docId": "indices-get-alias", + "docUrl": "", "name": "indices.get_alias", + "privileges": { + "index": [ + "view_index_metadata" + ] + }, "request": { "name": "Request", "namespace": "indices.get_alias" @@ -3549,13 +3575,13 @@ "stability": "stable" } }, - "description": "Get index templates.\nReturns information about one or more index templates.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-template.html", + "description": "Get index templates.\nGet information about one or more index templates.", + "docId": "indices-get-template", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-get-template.html", "name": "indices.get_index_template", "privileges": { "cluster": [ - "manage_index_templates", - "manage" + "manage_index_templates" ] }, "request": { @@ -3595,9 +3621,15 @@ "stability": "stable" } }, - "description": "Get mapping definitions.\nRetrieves mapping definitions for one or more indices.\nFor data streams, the API retrieves mappings for the stream’s backing indices.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-mapping.html", + "description": "Get mapping definitions.\nFor data streams, the API retrieves mappings for the stream’s backing indices.", + "docId": "indices-get-mapping", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-get-mapping.html", "name": "indices.get_mapping", + "privileges": { + "index": [ + "view_index_metadata" + ] + }, "request": { "name": "Request", "namespace": "indices.get_mapping" @@ -3635,14 +3667,13 @@ "stability": "stable" } }, - "description": "Get index settings.\nReturns setting information for one or more indices. For data streams,\nreturns setting information for the stream’s backing indices.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-get-settings.html", + "description": "Get index settings.\nGet setting information for one or more indices.\nFor data streams, it returns setting information for the stream's backing indices.", + "docId": "indices-get-settings", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-get-settings.html", "name": "indices.get_settings", "privileges": { "index": [ - "view_index_metadata", - "monitor", - "manage" + "view_index_metadata" ] }, "request": { @@ -3828,7 +3859,7 @@ "name": "Request", "namespace": "indices.put_data_lifecycle" }, - "requestBodyRequired": false, + "requestBodyRequired": true, "requestMediaType": [ "application/json" ], @@ -3859,9 +3890,14 @@ "stability": "stable" } }, - "description": "Create or update an index template.\nIndex templates define settings, mappings, and aliases that can be applied automatically to new indices.", + "description": "Create or update an index template.\nIndex templates define settings, mappings, and aliases that can be applied automatically to new indices.\n\nElasticsearch applies templates to new indices based on an wildcard pattern that matches the index name.\nIndex templates are applied during data stream or index creation.\nFor data streams, these settings and mappings are applied when the stream's backing indices are created.\nSettings and mappings specified in a create index API request override any settings or mappings specified in an index template.\nChanges to index templates do not affect existing indices, including the existing backing indices of a data stream.\n\nYou can use C-style `/* *\\/` block comments in index templates.\nYou can include comments anywhere in the request body, except before the opening curly bracket.\n\n**Multiple matching templates**\n\nIf multiple index templates match the name of a new index or data stream, the template with the highest priority is used.\n\nMultiple templates with overlapping index patterns at the same priority are not allowed and an error will be thrown when attempting to create a template matching an existing index template at identical priorities.\n\n**Composing aliases, mappings, and settings**\n\nWhen multiple component templates are specified in the `composed_of` field for an index template, they are merged in the order specified, meaning that later component templates override earlier component templates.\nAny mappings, settings, or aliases from the parent index template are merged in next.\nFinally, any configuration on the index request itself is merged.\nMapping definitions are merged recursively, which means that later mapping components can introduce new field mappings and update the mapping configuration.\nIf a field mapping is already contained in an earlier component, its definition will be completely overwritten by the later one.\nThis recursive merging strategy applies not only to field mappings, but also root options like `dynamic_templates` and `meta`.\nIf an earlier component contains a `dynamic_templates` block, then by default new `dynamic_templates` entries are appended onto the end.\nIf an entry already exists with the same key, then it is overwritten by the new definition.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-put-template.html", "name": "indices.put_index_template", + "privileges": { + "cluster": [ + "manage_index_templates" + ] + }, "request": { "name": "Request", "namespace": "indices.put_index_template" @@ -3897,9 +3933,17 @@ "stability": "stable" } }, - "description": "Update field mappings.\nAdds new fields to an existing data stream or index.\nYou can also use this API to change the search settings of existing fields.\nFor data streams, these changes are applied to all backing indices by default.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-put-mapping.html", + "description": "Update field mappings.\nAdd new fields to an existing data stream or index.\nYou can also use this API to change the search settings of existing fields and add new properties to existing object fields.\nFor data streams, these changes are applied to all backing indices by default.\n\n**Add multi-fields to an existing field**\n\nMulti-fields let you index the same field in different ways.\nYou can use this API to update the fields mapping parameter and enable multi-fields for an existing field.\nWARNING: If an index (or data stream) contains documents when you add a multi-field, those documents will not have values for the new multi-field.\nYou can populate the new multi-field with the update by query API.\n\n**Change supported mapping parameters for an existing field**\n\nThe documentation for each mapping parameter indicates whether you can update it for an existing field using this API.\nFor example, you can use the update mapping API to update the `ignore_above` parameter.\n\n**Change the mapping of an existing field**\n\nExcept for supported mapping parameters, you can't change the mapping or field type of an existing field.\nChanging an existing field could invalidate data that's already indexed.\n\nIf you need to change the mapping of a field in a data stream's backing indices, refer to documentation about modifying data streams.\nIf you need to change the mapping of a field in other indices, create a new index with the correct mapping and reindex your data into that index.\n\n**Rename a field**\n\nRenaming a field would invalidate data already indexed under the old field name.\nInstead, add an alias field to create an alternate field name.", + "docId": "indices-put-mapping", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-put-mapping.html", + "extDocId": "mapping-params", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/mapping-params.html", "name": "indices.put_mapping", + "privileges": { + "index": [ + "manage" + ] + }, "request": { "name": "Request", "namespace": "indices.put_mapping" @@ -3935,8 +3979,11 @@ "stability": "stable" } }, - "description": "Update index settings.\nChanges dynamic index settings in real time. For data streams, index setting\nchanges are applied to all backing indices by default.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-update-settings.html", + "description": "Update index settings.\nChanges dynamic index settings in real time.\nFor data streams, index setting changes are applied to all backing indices by default.\n\nTo revert a setting to the default value, use a null value.\nThe list of per-index settings that can be updated dynamically on live indices can be found in index module documentation.\nTo preserve existing settings from being updated, set the `preserve_existing` parameter to `true`.\n\nNOTE: You can only define new analyzers on closed indices.\nTo add an analyzer, you must close the index, define the analyzer, and reopen the index.\nYou cannot close the write index of a data stream.\nTo update the analyzer for a data stream's write index and future backing indices, update the analyzer in the index template used by the stream.\nThen roll over the data stream to apply the new analyzer to the stream's write index and future backing indices.\nThis affects searches and any new data added to the stream after the rollover.\nHowever, it does not affect the data stream's backing indices or their existing data.\nTo change the analyzer for existing backing indices, you must create a new data stream and reindex your data into it.", + "docId": "indices-update-settings", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-update-settings.html", + "extDocId": "index-modules", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/index-modules.html", "name": "indices.put_settings", "privileges": { "index": [ @@ -3983,8 +4030,9 @@ "stability": "stable" } }, - "description": "Create or update an index template.\nIndex templates define settings, mappings, and aliases that can be applied automatically to new indices.\nElasticsearch applies templates to new indices based on an index pattern that matches the index name.\n\nIMPORTANT: This documentation is about legacy index templates, which are deprecated and will be replaced by the composable templates introduced in Elasticsearch 7.8.\n\nComposable templates always take precedence over legacy templates.\nIf no composable template matches a new index, matching legacy templates are applied according to their order.\n\nIndex templates are only applied during index creation.\nChanges to index templates do not affect existing indices.\nSettings and mappings specified in create index API requests override any settings or mappings specified in an index template.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-templates-v1.html", + "description": "Create or update an index template.\nIndex templates define settings, mappings, and aliases that can be applied automatically to new indices.\nElasticsearch applies templates to new indices based on an index pattern that matches the index name.\n\nIMPORTANT: This documentation is about legacy index templates, which are deprecated and will be replaced by the composable templates introduced in Elasticsearch 7.8.\n\nComposable templates always take precedence over legacy templates.\nIf no composable template matches a new index, matching legacy templates are applied according to their order.\n\nIndex templates are only applied during index creation.\nChanges to index templates do not affect existing indices.\nSettings and mappings specified in create index API requests override any settings or mappings specified in an index template.\n\nYou can use C-style `/* *\\/` block comments in index templates.\nYou can include comments anywhere in the request body, except before the opening curly bracket.\n\n**Indices matching multiple templates**\n\nMultiple index templates can potentially match an index, in this case, both the settings and mappings are merged into the final configuration of the index.\nThe order of the merging can be controlled using the order parameter, with lower order being applied first, and higher orders overriding them.\nNOTE: Multiple matching templates with the same order value will result in a non-deterministic merging order.", + "docId": "index-templates-v1", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-templates-v1.html", "extDocId": "index-templates", "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/index-templates.html", "name": "indices.put_template", @@ -4029,9 +4077,15 @@ "stability": "stable" } }, - "description": "Refresh an index.\nA refresh makes recent operations performed on one or more indices available for search.\nFor data streams, the API runs the refresh operation on the stream’s backing indices.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-refresh.html", + "description": "Refresh an index.\nA refresh makes recent operations performed on one or more indices available for search.\nFor data streams, the API runs the refresh operation on the stream’s backing indices.\n\nBy default, Elasticsearch periodically refreshes indices every second, but only on indices that have received one search request or more in the last 30 seconds.\nYou can change this default interval with the `index.refresh_interval` setting.\n\nRefresh requests are synchronous and do not return a response until the refresh operation completes.\n\nRefreshes are resource-intensive.\nTo ensure good cluster performance, it's recommended to wait for Elasticsearch's periodic refresh rather than performing an explicit refresh when possible.\n\nIf your application workflow indexes documents and then runs a search to retrieve the indexed document, it's recommended to use the index API's `refresh=wait_for` query parameter option.\nThis option ensures the indexing operation waits for a periodic refresh before running the search.", + "docId": "indices-refresh", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-refresh.html", "name": "indices.refresh", + "privileges": { + "index": [ + "maintenance" + ] + }, "request": { "name": "Request", "namespace": "indices.refresh" @@ -4073,8 +4127,14 @@ } }, "description": "Resolve indices.\nResolve the names and/or index patterns for indices, aliases, and data streams.\nMultiple patterns and remote clusters are supported.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-resolve-index-api.html", + "docId": "indices-resolve-index-api", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-resolve-index-api.html", "name": "indices.resolve_index", + "privileges": { + "index": [ + "view_index_metadata" + ] + }, "request": { "name": "Request", "namespace": "indices.resolve_index" @@ -4107,10 +4167,15 @@ "stability": "stable" } }, - "description": "Roll over to a new index.\nCreates a new index for a data stream or index alias.", + "description": "Roll over to a new index.\nTIP: It is recommended to use the index lifecycle rollover action to automate rollovers.\n\nThe rollover API creates a new index for a data stream or index alias.\nThe API behavior depends on the rollover target.\n\n**Roll over a data stream**\n\nIf you roll over a data stream, the API creates a new write index for the stream.\nThe stream's previous write index becomes a regular backing index.\nA rollover also increments the data stream's generation.\n\n**Roll over an index alias with a write index**\n\nTIP: Prior to Elasticsearch 7.9, you'd typically use an index alias with a write index to manage time series data.\nData streams replace this functionality, require less maintenance, and automatically integrate with data tiers.\n\nIf an index alias points to multiple indices, one of the indices must be a write index.\nThe rollover API creates a new write index for the alias with `is_write_index` set to `true`.\nThe API also `sets is_write_index` to `false` for the previous write index.\n\n**Roll over an index alias with one index**\n\nIf you roll over an index alias that points to only one index, the API creates a new index for the alias and removes the original index from the alias.\n\nNOTE: A rollover creates a new index and is subject to the `wait_for_active_shards` setting.\n\n**Increment index names for an alias**\n\nWhen you roll over an index alias, you can specify a name for the new index.\nIf you don't specify a name and the current index ends with `-` and a number, such as `my-index-000001` or `my-index-3`, the new index name increments that number.\nFor example, if you roll over an alias with a current index of `my-index-000001`, the rollover creates a new index named `my-index-000002`.\nThis number is always six characters and zero-padded, regardless of the previous index's name.\n\nIf you use an index alias for time series data, you can use date math in the index name to track the rollover date.\nFor example, you can create an alias that points to an index named ``.\nIf you create the index on May 6, 2099, the index's name is `my-index-2099.05.06-000001`.\nIf you roll over the alias on May 7, 2099, the new index's name is `my-index-2099.05.07-000002`.", "docId": "indices-rollover-index", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-rollover-index.html", "name": "indices.rollover", + "privileges": { + "index": [ + "manage" + ] + }, "request": { "name": "Request", "namespace": "indices.rollover" @@ -4152,9 +4217,15 @@ "stability": "stable" } }, - "description": "Simulate an index.\nReturns the index configuration that would be applied to the specified index from an existing index template.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-simulate-index.html", + "description": "Simulate an index.\nGet the index configuration that would be applied to the specified index from an existing index template.", + "docId": "indices-simulate", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{master}/indices-simulate-index.html", "name": "indices.simulate_index_template", + "privileges": { + "cluster": [ + "manage_index_templates" + ] + }, "request": { "name": "Request", "namespace": "indices.simulate_index_template" @@ -4189,13 +4260,13 @@ "stability": "stable" } }, - "description": "Simulate an index template.\nReturns the index configuration that would be applied by a particular index template.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/indices-simulate-template.html", + "description": "Simulate an index template.\nGet the index configuration that would be applied by a particular index template.", + "docId": "indices-simulate-template", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-simulate-template.html", "name": "indices.simulate_template", "privileges": { "cluster": [ - "manage_index_templates", - "manage" + "manage_index_templates" ] }, "request": { @@ -4507,9 +4578,15 @@ "stability": "stable" } }, - "description": "Get cluster info.\nReturns basic information about the cluster.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/index.html", + "description": "Get cluster info.\nGet basic build, version, and cluster information.", + "docId": "api-root", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/rest-api-root.html", "name": "info", + "privileges": { + "cluster": [ + "monitor" + ] + }, "request": { "name": "Request", "namespace": "_global.info" @@ -4781,8 +4858,9 @@ "stability": "stable" } }, - "description": "Delete a Logstash pipeline.\n\nDelete a pipeline that is used for Logstash Central Management.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/logstash-api-delete-pipeline.html", + "description": "Delete a Logstash pipeline.\nDelete a pipeline that is used for Logstash Central Management.\nIf the request succeeds, you receive an empty response with an appropriate status code.", + "docId": "logstash-api-delete-pipeline", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/logstash-api-delete-pipeline.html", "extDocId": "logstash-centralized-pipeline-management", "extDocUrl": "https://www.elastic.co/guide/en/logstash/{branch}/logstash-centralized-pipeline-management.html", "name": "logstash.delete_pipeline", @@ -4823,8 +4901,9 @@ "stability": "stable" } }, - "description": "Get Logstash pipelines.\n\nGet pipelines that are used for Logstash Central Management.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/logstash-api-get-pipeline.html", + "description": "Get Logstash pipelines.\nGet pipelines that are used for Logstash Central Management.", + "docId": "logstash-api-get-pipeline", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/logstash-api-get-pipeline.html", "extDocId": "logstash-centralized-pipeline-management", "extDocUrl": "https://www.elastic.co/guide/en/logstash/{branch}/logstash-centralized-pipeline-management.html", "name": "logstash.get_pipeline", @@ -4872,7 +4951,8 @@ } }, "description": "Create or update a Logstash pipeline.\n\nCreate a pipeline that is used for Logstash Central Management.\nIf the specified pipeline exists, it is replaced.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/logstash-api-put-pipeline.html", + "docId": "logstash-api-put-pipeline", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/logstash-api-put-pipeline.html", "extDocId": "logstash-centralized-pipeline-management", "extDocUrl": "https://www.elastic.co/guide/en/logstash/{branch}/logstash-centralized-pipeline-management.html", "name": "logstash.put_pipeline", @@ -6407,7 +6487,7 @@ "stability": "stable" } }, - "description": "Create a data frame analytics job.\nThis API creates a data frame analytics job that performs an analysis on the\nsource indices and stores the outcome in a destination index.", + "description": "Create a data frame analytics job.\nThis API creates a data frame analytics job that performs an analysis on the\nsource indices and stores the outcome in a destination index.\nBy default, the query used in the source configuration is `{\"match_all\": {}}`.\n\nIf the destination index does not exist, it is created automatically when you start the job.\n\nIf you supply only a subset of the regression or classification parameters, hyperparameter optimization occurs. It determines a value for each of the undefined parameters.", "docId": "put-dfanalytics", "docTag": "ml data frame", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/put-dfanalytics.html", @@ -6459,7 +6539,7 @@ "stability": "stable" } }, - "description": "Create a datafeed.\nDatafeeds retrieve data from Elasticsearch for analysis by an anomaly detection job.\nYou can associate only one datafeed with each anomaly detection job.\nThe datafeed contains a query that runs at a defined interval (`frequency`).\nIf you are concerned about delayed data, you can add a delay (`query_delay') at each interval.\nWhen Elasticsearch security features are enabled, your datafeed remembers which roles the user who created it had\nat the time of creation and runs the query using those same roles. If you provide secondary authorization headers,\nthose credentials are used instead.\nYou must use Kibana, this API, or the create anomaly detection jobs API to create a datafeed. Do not add a datafeed\ndirectly to the `.ml-config` index. Do not give users `write` privileges on the `.ml-config` index.", + "description": "Create a datafeed.\nDatafeeds retrieve data from Elasticsearch for analysis by an anomaly detection job.\nYou can associate only one datafeed with each anomaly detection job.\nThe datafeed contains a query that runs at a defined interval (`frequency`).\nIf you are concerned about delayed data, you can add a delay (`query_delay') at each interval.\nBy default, the datafeed uses the following query: `{\"match_all\": {\"boost\": 1}}`.\n\nWhen Elasticsearch security features are enabled, your datafeed remembers which roles the user who created it had\nat the time of creation and runs the query using those same roles. If you provide secondary authorization headers,\nthose credentials are used instead.\nYou must use Kibana, this API, or the create anomaly detection jobs API to create a datafeed. Do not add a datafeed\ndirectly to the `.ml-config` index. Do not give users `write` privileges on the `.ml-config` index.", "docTag": "ml anomaly", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-put-datafeed.html", "name": "ml.put_datafeed", @@ -6550,7 +6630,7 @@ "stability": "stable" } }, - "description": "Create an anomaly detection job.\nIf you include a `datafeed_config`, you must have read index privileges on the source index.", + "description": "Create an anomaly detection job.\nIf you include a `datafeed_config`, you must have read index privileges on the source index.\nIf you include a `datafeed_config` but do not provide a query, the datafeed uses `{\"match_all\": {\"boost\": 1}}`.", "docTag": "ml anomaly", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/ml-put-job.html", "name": "ml.put_job", @@ -7590,9 +7670,15 @@ "stability": "stable" } }, - "description": "Delete a query rule.\nDelete a query rule within a query ruleset.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-query-rule.html", + "description": "Delete a query rule.\nDelete a query rule within a query ruleset.\nThis is a destructive action that is only recoverable by re-adding the same rule with the create or update query rule API.", + "docId": "query-rule-delete", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-query-rule.html", "name": "query_rules.delete_rule", + "privileges": { + "cluster": [ + "manage_search_query_rules" + ] + }, "request": { "name": "Request", "namespace": "query_rules.delete_rule" @@ -7625,9 +7711,15 @@ "stability": "stable" } }, - "description": "Delete a query ruleset.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-query-ruleset.html", + "description": "Delete a query ruleset.\nRemove a query ruleset and its associated data.\nThis is a destructive action that is not recoverable.", + "docId": "query-ruleset-delete", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-query-ruleset.html", "name": "query_rules.delete_ruleset", + "privileges": { + "cluster": [ + "manage_search_query_rules" + ] + }, "request": { "name": "Request", "namespace": "query_rules.delete_ruleset" @@ -7661,10 +7753,16 @@ } }, "description": "Get a query rule.\nGet details about a query rule within a query ruleset.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-query-rule.html", + "docId": "query-rule-get", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-query-rule.html", "extDocId": "query-rule", "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-using-query-rules.html", "name": "query_rules.get_rule", + "privileges": { + "cluster": [ + "manage_search_query_rules" + ] + }, "request": { "name": "Request", "namespace": "query_rules.get_rule" @@ -7698,8 +7796,14 @@ } }, "description": "Get a query ruleset.\nGet details about a query ruleset.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-query-ruleset.html", + "docId": "query-ruleset-get", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-query-ruleset.html", "name": "query_rules.get_ruleset", + "privileges": { + "cluster": [ + "manage_search_query_rules" + ] + }, "request": { "name": "Request", "namespace": "query_rules.get_ruleset" @@ -7733,8 +7837,14 @@ } }, "description": "Get all query rulesets.\nGet summarized information about the query rulesets.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/list-query-rulesets.html", + "docId": "query-ruleset-list", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/list-query-rulesets.html", "name": "query_rules.list_rulesets", + "privileges": { + "cluster": [ + "manage_search_query_rules" + ] + }, "request": { "name": "Request", "namespace": "query_rules.list_rulesets" @@ -7767,9 +7877,15 @@ "stability": "stable" } }, - "description": "Create or update a query rule.\nCreate or update a query rule within a query ruleset.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/put-query-rule.html", + "description": "Create or update a query rule.\nCreate or update a query rule within a query ruleset.\n\nIMPORTANT: Due to limitations within pinned queries, you can only pin documents using ids or docs, but cannot use both in single rule.\nIt is advised to use one or the other in query rulesets, to avoid errors.\nAdditionally, pinned queries have a maximum limit of 100 pinned hits.\nIf multiple matching rules pin more than 100 documents, only the first 100 documents are pinned in the order they are specified in the ruleset.", + "docId": "query-rule-put", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/put-query-rule.html", "name": "query_rules.put_rule", + "privileges": { + "cluster": [ + "manage_search_query_rules" + ] + }, "request": { "name": "Request", "namespace": "query_rules.put_rule" @@ -7805,11 +7921,17 @@ "stability": "stable" } }, - "description": "Create or update a query ruleset.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/put-query-ruleset.html", + "description": "Create or update a query ruleset.\nThere is a limit of 100 rules per ruleset.\nThis limit can be increased by using the `xpack.applications.rules.max_rules_per_ruleset` cluster setting.\n\nIMPORTANT: Due to limitations within pinned queries, you can only select documents using `ids` or `docs`, but cannot use both in single rule.\nIt is advised to use one or the other in query rulesets, to avoid errors.\nAdditionally, pinned queries have a maximum limit of 100 pinned hits.\nIf multiple matching rules pin more than 100 documents, only the first 100 documents are pinned in the order they are specified in the ruleset.", + "docId": "query-ruleset-put", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/put-query-ruleset.html", "extDocId": "query-rule", "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/search-using-query-rules.html", "name": "query_rules.put_ruleset", + "privileges": { + "cluster": [ + "manage_search_query_rules" + ] + }, "request": { "name": "Request", "namespace": "query_rules.put_ruleset" @@ -7846,8 +7968,14 @@ } }, "description": "Test a query ruleset.\nEvaluate match criteria against a query ruleset to identify the rules that would match that criteria.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/test-query-ruleset.html", + "docId": "query-ruleset-test", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/test-query-ruleset.html", "name": "query_rules.test", + "privileges": { + "cluster": [ + "manage_search_query_rules" + ] + }, "request": { "name": "Request", "namespace": "query_rules.test" @@ -8165,6 +8293,14 @@ "description": "Delete a search application.\nRemove a search application and its associated alias. Indices attached to the search application are not removed.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-search-application.html", "name": "search_application.delete", + "privileges": { + "cluster": [ + "manage_search_application" + ], + "index": [ + "manage" + ] + }, "request": { "name": "Request", "namespace": "search_application.delete" @@ -8236,6 +8372,11 @@ "description": "Get search application details.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-search-application.html", "name": "search_application.get", + "privileges": { + "cluster": [ + "manage_search_application" + ] + }, "request": { "name": "Request", "namespace": "search_application.get" @@ -8310,9 +8451,14 @@ "stability": "beta" } }, - "description": "Returns the existing search applications.", + "description": "Get search applications.\nGet information about search applications.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/list-search-applications.html", "name": "search_application.list", + "privileges": { + "cluster": [ + "manage_search_application" + ] + }, "request": { "name": "Request", "namespace": "search_application.list" @@ -8348,6 +8494,14 @@ "description": "Create or update a search application.", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/put-search-application.html", "name": "search_application.put", + "privileges": { + "cluster": [ + "manage_search_application" + ], + "index": [ + "manage" + ] + }, "request": { "name": "Request", "namespace": "search_application.put" @@ -12850,7 +13004,7 @@ "body": { "kind": "no_body" }, - "description": "Delete component templates.\nDeletes component templates.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.", + "description": "Delete component templates.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.", "inherits": { "type": { "name": "RequestBase", @@ -12904,7 +13058,7 @@ } } ], - "specLocation": "cluster/delete_component_template/ClusterDeleteComponentTemplateRequest.ts#L24-L56" + "specLocation": "cluster/delete_component_template/ClusterDeleteComponentTemplateRequest.ts#L24-L55" }, { "body": { @@ -13005,7 +13159,7 @@ "body": { "kind": "no_body" }, - "description": "Get component templates.\nRetrieves information about component templates.", + "description": "Get component templates.\nGet information about component templates.", "inherits": { "type": { "name": "RequestBase", @@ -13270,7 +13424,7 @@ } }, { - "description": "Optional user metadata about the component template.\nMay have any contents. This map is not automatically generated by Elasticsearch.\nThis information is stored in the cluster state, so keeping it short is preferable.\nTo unset `_meta`, replace the template without specifying this information.", + "description": "Optional user metadata about the component template.\nIt may have any contents. This map is not automatically generated by Elasticsearch.\nThis information is stored in the cluster state, so keeping it short is preferable.\nTo unset `_meta`, replace the template without specifying this information.", "name": "_meta", "required": false, "type": { @@ -13295,7 +13449,7 @@ } ] }, - "description": "Create or update a component template.\nCreates or updates a component template.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nAn index template can be composed of multiple component templates.\nTo use a component template, specify it in an index template’s `composed_of` list.\nComponent templates are only applied to new data streams and indices as part of a matching index template.\n\nSettings and mappings specified directly in the index template or the create index request override any settings or mappings specified in a component template.\n\nComponent templates are only used during index creation.\nFor data streams, this includes data stream creation and the creation of a stream’s backing indices.\nChanges to component templates do not affect existing indices, including a stream’s backing indices.\n\nYou can use C-style `/* *\\/` block comments in component templates.\nYou can include comments anywhere in the request body except before the opening curly bracket.", + "description": "Create or update a component template.\nComponent templates are building blocks for constructing index templates that specify index mappings, settings, and aliases.\n\nAn index template can be composed of multiple component templates.\nTo use a component template, specify it in an index template’s `composed_of` list.\nComponent templates are only applied to new data streams and indices as part of a matching index template.\n\nSettings and mappings specified directly in the index template or the create index request override any settings or mappings specified in a component template.\n\nComponent templates are only used during index creation.\nFor data streams, this includes data stream creation and the creation of a stream’s backing indices.\nChanges to component templates do not affect existing indices, including a stream’s backing indices.\n\nYou can use C-style `/* *\\/` block comments in component templates.\nYou can include comments anywhere in the request body except before the opening curly bracket.\n\n**Applying component templates**\n\nYou cannot directly apply a component template to a data stream or index.\nTo be applied, a component template must be included in an index template's `composed_of` list.", "inherits": { "type": { "name": "RequestBase", @@ -13349,7 +13503,7 @@ } } ], - "specLocation": "cluster/put_component_template/ClusterPutComponentTemplateRequest.ts#L25-L95" + "specLocation": "cluster/put_component_template/ClusterPutComponentTemplateRequest.ts#L25-L99" }, { "body": { @@ -17094,8 +17248,22 @@ "namespace": "enrich.stats" }, "path": [], - "query": [], - "specLocation": "enrich/stats/EnrichStatsRequest.ts#L22-L29" + "query": [ + { + "description": "Period to wait for a connection to the master node.", + "name": "master_timeout", + "required": false, + "serverDefault": "30s", + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" + } + } + } + ], + "specLocation": "enrich/stats/EnrichStatsRequest.ts#L23-L38" }, { "body": { @@ -20215,7 +20383,7 @@ } ] }, - "description": "Get tokens from text analysis.\nThe analyze API performs [analysis](https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis.html) on a text string and returns the resulting tokens.", + "description": "Get tokens from text analysis.\nThe analyze API performs analysis on a text string and returns the resulting tokens.\n\nGenerating excessive amount of tokens may cause a node to run out of memory.\nThe `index.analyze.max_token_count` setting enables you to limit the number of tokens that can be produced.\nIf more than this limit of tokens gets generated, an error occurs.\nThe `_analyze` endpoint without a specified index will always use `10000` as its limit.", "inherits": { "type": { "name": "RequestBase", @@ -20244,7 +20412,7 @@ } ], "query": [], - "specLocation": "indices/analyze/IndicesAnalyzeRequest.ts#L27-L93" + "specLocation": "indices/analyze/IndicesAnalyzeRequest.ts#L27-L100" }, { "body": { @@ -20342,7 +20510,7 @@ } ] }, - "description": "Create an index.\nCreates a new index.", + "description": "Create an index.\nYou can use the create index API to add a new index to an Elasticsearch cluster.\nWhen creating an index, you can specify the following:\n\n* Settings for the index.\n* Mappings for fields in the index.\n* Index aliases\n\n**Wait for active shards**\n\nBy default, index creation will only return a response to the client when the primary copies of each shard have been started, or the request times out.\nThe index creation response will indicate what happened.\nFor example, `acknowledged` indicates whether the index was successfully created in the cluster, `while shards_acknowledged` indicates whether the requisite number of shard copies were started for each shard in the index before timing out.\nNote that it is still possible for either `acknowledged` or `shards_acknowledged` to be `false`, but for the index creation to be successful.\nThese values simply indicate whether the operation completed before the timeout.\nIf `acknowledged` is false, the request timed out before the cluster state was updated with the newly created index, but it probably will be created sometime soon.\nIf `shards_acknowledged` is false, then the request timed out before the requisite number of shards were started (by default just the primaries), even if the cluster state was successfully updated to reflect the newly created index (that is to say, `acknowledged` is `true`).\n\nYou can change the default of only waiting for the primary shards to start through the index setting `index.write.wait_for_active_shards`.\nNote that changing this setting will also affect the `wait_for_active_shards` value on all subsequent write operations.", "inherits": { "type": { "name": "RequestBase", @@ -20409,7 +20577,7 @@ } } ], - "specLocation": "indices/create/IndicesCreateRequest.ts#L28-L82" + "specLocation": "indices/create/IndicesCreateRequest.ts#L28-L102" }, { "body": { @@ -20683,7 +20851,7 @@ "body": { "kind": "no_body" }, - "description": "Delete indices.\nDeletes one or more indices.", + "description": "Delete indices.\nDeleting an index deletes its documents, shards, and metadata.\nIt does not delete related Kibana components, such as data views, visualizations, or dashboards.\n\nYou cannot delete the current write index of a data stream.\nTo delete the index, you must roll over the data stream so a new write index is created.\nYou can then use the delete index API to delete the previous write index.", "inherits": { "type": { "name": "RequestBase", @@ -20776,7 +20944,7 @@ } } ], - "specLocation": "indices/delete/IndicesDeleteRequest.ts#L24-L74" + "specLocation": "indices/delete/IndicesDeleteRequest.ts#L24-L81" }, { "body": { @@ -20869,7 +21037,7 @@ } } ], - "specLocation": "indices/delete_alias/IndicesDeleteAliasRequest.ts#L24-L58" + "specLocation": "indices/delete_alias/IndicesDeleteAliasRequest.ts#L24-L60" }, { "body": { @@ -21122,7 +21290,7 @@ } } ], - "specLocation": "indices/delete_index_template/IndicesDeleteIndexTemplateRequest.ts#L24-L53" + "specLocation": "indices/delete_index_template/IndicesDeleteIndexTemplateRequest.ts#L24-L54" }, { "body": { @@ -21149,7 +21317,7 @@ "body": { "kind": "no_body" }, - "description": "Check indices.\nChecks if one or more indices, index aliases, or data streams exist.", + "description": "Check indices.\nCheck if one or more indices, index aliases, or data streams exist.", "inherits": { "type": { "name": "RequestBase", @@ -21255,7 +21423,7 @@ } } ], - "specLocation": "indices/exists/IndicesExistsRequest.ts#L23-L73" + "specLocation": "indices/exists/IndicesExistsRequest.ts#L23-L74" }, { "body": { @@ -21548,7 +21716,7 @@ "body": { "kind": "no_body" }, - "description": "Get index information.\nReturns information about one or more indices. For data streams, the API returns information about the\nstream’s backing indices.", + "description": "Get index information.\nGet information about one or more indices. For data streams, the API returns information about the\nstream’s backing indices.", "inherits": { "type": { "name": "RequestBase", @@ -21686,7 +21854,7 @@ } } ], - "specLocation": "indices/get/IndicesGetRequest.ts#L24-L89" + "specLocation": "indices/get/IndicesGetRequest.ts#L24-L90" }, { "body": { @@ -21820,7 +21988,7 @@ } } ], - "specLocation": "indices/get_alias/IndicesGetAliasRequest.ts#L23-L72" + "specLocation": "indices/get_alias/IndicesGetAliasRequest.ts#L23-L74" }, { "body": { @@ -22115,7 +22283,7 @@ "body": { "kind": "no_body" }, - "description": "Get index templates.\nReturns information about one or more index templates.", + "description": "Get index templates.\nGet information about one or more index templates.", "inherits": { "type": { "name": "RequestBase", @@ -22204,7 +22372,7 @@ } } ], - "specLocation": "indices/get_index_template/IndicesGetIndexTemplateRequest.ts#L24-L61" + "specLocation": "indices/get_index_template/IndicesGetIndexTemplateRequest.ts#L24-L62" }, { "body": { @@ -22240,7 +22408,7 @@ "body": { "kind": "no_body" }, - "description": "Get mapping definitions.\nRetrieves mapping definitions for one or more indices.\nFor data streams, the API retrieves mappings for the stream’s backing indices.", + "description": "Get mapping definitions.\nFor data streams, the API retrieves mappings for the stream’s backing indices.", "inherits": { "type": { "name": "RequestBase", @@ -22333,7 +22501,7 @@ } } ], - "specLocation": "indices/get_mapping/IndicesGetMappingRequest.ts#L24-L73" + "specLocation": "indices/get_mapping/IndicesGetMappingRequest.ts#L24-L74" }, { "body": { @@ -22371,7 +22539,7 @@ "body": { "kind": "no_body" }, - "description": "Get index settings.\nReturns setting information for one or more indices. For data streams,\nreturns setting information for the stream’s backing indices.", + "description": "Get index settings.\nGet setting information for one or more indices.\nFor data streams, it returns setting information for the stream's backing indices.", "inherits": { "type": { "name": "RequestBase", @@ -22502,7 +22670,7 @@ } } ], - "specLocation": "indices/get_settings/IndicesGetSettingsRequest.ts#L24-L92" + "specLocation": "indices/get_settings/IndicesGetSettingsRequest.ts#L24-L93" }, { "body": { @@ -22834,33 +23002,15 @@ "CommonQueryParameters" ], "body": { - "kind": "properties", - "properties": [ - { - "description": "If defined, every document added to this data stream will be stored at least for this time frame.\nAny time after this duration the document could be deleted.\nWhen empty, every document in this data stream will be stored indefinitely.", - "name": "data_retention", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - }, - { - "description": "If defined, every backing index will execute the configured downsampling configuration after the backing\nindex is not the data stream write index anymore.", - "name": "downsampling", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "DataStreamLifecycleDownsampling", - "namespace": "indices._types" - } - } + "codegenName": "lifecycle", + "kind": "value", + "value": { + "kind": "instance_of", + "type": { + "name": "DataStreamLifecycle", + "namespace": "indices._types" } - ] + } }, "description": "Update data stream lifecycles.\nUpdate the data stream lifecycle of the specified data streams.", "inherits": { @@ -22929,7 +23079,7 @@ } } ], - "specLocation": "indices/put_data_lifecycle/IndicesPutDataLifecycleRequest.ts#L25-L77" + "specLocation": "indices/put_data_lifecycle/IndicesPutDataLifecycleRequest.ts#L25-L68" }, { "body": { @@ -23020,7 +23170,7 @@ } }, { - "description": "Version number used to manage index templates externally.\nThis number is not automatically generated by Elasticsearch.", + "description": "Version number used to manage index templates externally.\nThis number is not automatically generated by Elasticsearch.\nExternal systems can use these version numbers to simplify template management.\nTo unset a version, replace the template without specifying one.", "name": "version", "required": false, "type": { @@ -23032,7 +23182,7 @@ } }, { - "description": "Optional user metadata about the index template.\nMay have any contents.\nThis map is not automatically generated by Elasticsearch.", + "description": "Optional user metadata about the index template.\nIt may have any contents.\nIt is not automatically generated or used by Elasticsearch.\nThis user-defined object is stored in the cluster state, so keeping it short is preferable\nTo unset the metadata, replace the template without specifying it.", "docId": "mapping-meta-field", "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/mapping-meta-field.html", "name": "_meta", @@ -23086,7 +23236,7 @@ } ] }, - "description": "Create or update an index template.\nIndex templates define settings, mappings, and aliases that can be applied automatically to new indices.", + "description": "Create or update an index template.\nIndex templates define settings, mappings, and aliases that can be applied automatically to new indices.\n\nElasticsearch applies templates to new indices based on an wildcard pattern that matches the index name.\nIndex templates are applied during data stream or index creation.\nFor data streams, these settings and mappings are applied when the stream's backing indices are created.\nSettings and mappings specified in a create index API request override any settings or mappings specified in an index template.\nChanges to index templates do not affect existing indices, including the existing backing indices of a data stream.\n\nYou can use C-style `/* *\\/` block comments in index templates.\nYou can include comments anywhere in the request body, except before the opening curly bracket.\n\n**Multiple matching templates**\n\nIf multiple index templates match the name of a new index or data stream, the template with the highest priority is used.\n\nMultiple templates with overlapping index patterns at the same priority are not allowed and an error will be thrown when attempting to create a template matching an existing index template at identical priorities.\n\n**Composing aliases, mappings, and settings**\n\nWhen multiple component templates are specified in the `composed_of` field for an index template, they are merged in the order specified, meaning that later component templates override earlier component templates.\nAny mappings, settings, or aliases from the parent index template are merged in next.\nFinally, any configuration on the index request itself is merged.\nMapping definitions are merged recursively, which means that later mapping components can introduce new field mappings and update the mapping configuration.\nIf a field mapping is already contained in an earlier component, its definition will be completely overwritten by the later one.\nThis recursive merging strategy applies not only to field mappings, but also root options like `dynamic_templates` and `meta`.\nIf an earlier component contains a `dynamic_templates` block, then by default new `dynamic_templates` entries are appended onto the end.\nIf an entry already exists with the same key, then it is overwritten by the new definition.", "inherits": { "type": { "name": "RequestBase", @@ -23152,7 +23302,7 @@ } } ], - "specLocation": "indices/put_index_template/IndicesPutIndexTemplateRequest.ts#L37-L119" + "specLocation": "indices/put_index_template/IndicesPutIndexTemplateRequest.ts#L37-L150" }, { "body": { @@ -23365,7 +23515,7 @@ } ] }, - "description": "Update field mappings.\nAdds new fields to an existing data stream or index.\nYou can also use this API to change the search settings of existing fields.\nFor data streams, these changes are applied to all backing indices by default.", + "description": "Update field mappings.\nAdd new fields to an existing data stream or index.\nYou can also use this API to change the search settings of existing fields and add new properties to existing object fields.\nFor data streams, these changes are applied to all backing indices by default.\n\n**Add multi-fields to an existing field**\n\nMulti-fields let you index the same field in different ways.\nYou can use this API to update the fields mapping parameter and enable multi-fields for an existing field.\nWARNING: If an index (or data stream) contains documents when you add a multi-field, those documents will not have values for the new multi-field.\nYou can populate the new multi-field with the update by query API.\n\n**Change supported mapping parameters for an existing field**\n\nThe documentation for each mapping parameter indicates whether you can update it for an existing field using this API.\nFor example, you can use the update mapping API to update the `ignore_above` parameter.\n\n**Change the mapping of an existing field**\n\nExcept for supported mapping parameters, you can't change the mapping or field type of an existing field.\nChanging an existing field could invalidate data that's already indexed.\n\nIf you need to change the mapping of a field in a data stream's backing indices, refer to documentation about modifying data streams.\nIf you need to change the mapping of a field in other indices, create a new index with the correct mapping and reindex your data into that index.\n\n**Rename a field**\n\nRenaming a field would invalidate data already indexed under the old field name.\nInstead, add an alias field to create an alternate field name.", "inherits": { "type": { "name": "RequestBase", @@ -23471,7 +23621,7 @@ } } ], - "specLocation": "indices/put_mapping/IndicesPutMappingRequest.ts#L41-L149" + "specLocation": "indices/put_mapping/IndicesPutMappingRequest.ts#L41-L177" }, { "body": { @@ -23506,7 +23656,7 @@ } } }, - "description": "Update index settings.\nChanges dynamic index settings in real time. For data streams, index setting\nchanges are applied to all backing indices by default.", + "description": "Update index settings.\nChanges dynamic index settings in real time.\nFor data streams, index setting changes are applied to all backing indices by default.\n\nTo revert a setting to the default value, use a null value.\nThe list of per-index settings that can be updated dynamically on live indices can be found in index module documentation.\nTo preserve existing settings from being updated, set the `preserve_existing` parameter to `true`.\n\nNOTE: You can only define new analyzers on closed indices.\nTo add an analyzer, you must close the index, define the analyzer, and reopen the index.\nYou cannot close the write index of a data stream.\nTo update the analyzer for a data stream's write index and future backing indices, update the analyzer in the index template used by the stream.\nThen roll over the data stream to apply the new analyzer to the stream's write index and future backing indices.\nThis affects searches and any new data added to the stream after the rollover.\nHowever, it does not affect the data stream's backing indices or their existing data.\nTo change the analyzer for existing backing indices, you must create a new data stream and reindex your data into it.", "inherits": { "type": { "name": "RequestBase", @@ -23625,7 +23775,7 @@ } } ], - "specLocation": "indices/put_settings/IndicesPutSettingsRequest.ts#L25-L93" + "specLocation": "indices/put_settings/IndicesPutSettingsRequest.ts#L25-L108" }, { "body": { @@ -23739,7 +23889,7 @@ } }, { - "description": "Version number used to manage index templates externally. This number\nis not automatically generated by Elasticsearch.", + "description": "Version number used to manage index templates externally. This number\nis not automatically generated by Elasticsearch.\nTo unset a version, replace the template without specifying one.", "name": "version", "required": false, "type": { @@ -23752,7 +23902,7 @@ } ] }, - "description": "Create or update an index template.\nIndex templates define settings, mappings, and aliases that can be applied automatically to new indices.\nElasticsearch applies templates to new indices based on an index pattern that matches the index name.\n\nIMPORTANT: This documentation is about legacy index templates, which are deprecated and will be replaced by the composable templates introduced in Elasticsearch 7.8.\n\nComposable templates always take precedence over legacy templates.\nIf no composable template matches a new index, matching legacy templates are applied according to their order.\n\nIndex templates are only applied during index creation.\nChanges to index templates do not affect existing indices.\nSettings and mappings specified in create index API requests override any settings or mappings specified in an index template.", + "description": "Create or update an index template.\nIndex templates define settings, mappings, and aliases that can be applied automatically to new indices.\nElasticsearch applies templates to new indices based on an index pattern that matches the index name.\n\nIMPORTANT: This documentation is about legacy index templates, which are deprecated and will be replaced by the composable templates introduced in Elasticsearch 7.8.\n\nComposable templates always take precedence over legacy templates.\nIf no composable template matches a new index, matching legacy templates are applied according to their order.\n\nIndex templates are only applied during index creation.\nChanges to index templates do not affect existing indices.\nSettings and mappings specified in create index API requests override any settings or mappings specified in an index template.\n\nYou can use C-style `/* *\\/` block comments in index templates.\nYou can include comments anywhere in the request body, except before the opening curly bracket.\n\n**Indices matching multiple templates**\n\nMultiple index templates can potentially match an index, in this case, both the settings and mappings are merged into the final configuration of the index.\nThe order of the merging can be controlled using the order parameter, with lower order being applied first, and higher orders overriding them.\nNOTE: Multiple matching templates with the same order value will result in a non-deterministic merging order.", "inherits": { "type": { "name": "RequestBase", @@ -23829,7 +23979,7 @@ } } ], - "specLocation": "indices/put_template/IndicesPutTemplateRequest.ts#L29-L107" + "specLocation": "indices/put_template/IndicesPutTemplateRequest.ts#L29-L118" }, { "body": { @@ -23856,7 +24006,7 @@ "body": { "kind": "no_body" }, - "description": "Refresh an index.\nA refresh makes recent operations performed on one or more indices available for search.\nFor data streams, the API runs the refresh operation on the stream’s backing indices.", + "description": "Refresh an index.\nA refresh makes recent operations performed on one or more indices available for search.\nFor data streams, the API runs the refresh operation on the stream’s backing indices.\n\nBy default, Elasticsearch periodically refreshes indices every second, but only on indices that have received one search request or more in the last 30 seconds.\nYou can change this default interval with the `index.refresh_interval` setting.\n\nRefresh requests are synchronous and do not return a response until the refresh operation completes.\n\nRefreshes are resource-intensive.\nTo ensure good cluster performance, it's recommended to wait for Elasticsearch's periodic refresh rather than performing an explicit refresh when possible.\n\nIf your application workflow indexes documents and then runs a search to retrieve the indexed document, it's recommended to use the index API's `refresh=wait_for` query parameter option.\nThis option ensures the indexing operation waits for a periodic refresh before running the search.", "inherits": { "type": { "name": "RequestBase", @@ -23923,7 +24073,7 @@ } } ], - "specLocation": "indices/refresh/IndicesRefreshRequest.ts#L23-L61" + "specLocation": "indices/refresh/IndicesRefreshRequest.ts#L23-L74" }, { "body": { @@ -24017,7 +24167,7 @@ } } ], - "specLocation": "indices/resolve_index/ResolveIndexRequest.ts#L23-L61" + "specLocation": "indices/resolve_index/ResolveIndexRequest.ts#L23-L63" }, { "body": { @@ -24149,7 +24299,7 @@ } ] }, - "description": "Roll over to a new index.\nCreates a new index for a data stream or index alias.", + "description": "Roll over to a new index.\nTIP: It is recommended to use the index lifecycle rollover action to automate rollovers.\n\nThe rollover API creates a new index for a data stream or index alias.\nThe API behavior depends on the rollover target.\n\n**Roll over a data stream**\n\nIf you roll over a data stream, the API creates a new write index for the stream.\nThe stream's previous write index becomes a regular backing index.\nA rollover also increments the data stream's generation.\n\n**Roll over an index alias with a write index**\n\nTIP: Prior to Elasticsearch 7.9, you'd typically use an index alias with a write index to manage time series data.\nData streams replace this functionality, require less maintenance, and automatically integrate with data tiers.\n\nIf an index alias points to multiple indices, one of the indices must be a write index.\nThe rollover API creates a new write index for the alias with `is_write_index` set to `true`.\nThe API also `sets is_write_index` to `false` for the previous write index.\n\n**Roll over an index alias with one index**\n\nIf you roll over an index alias that points to only one index, the API creates a new index for the alias and removes the original index from the alias.\n\nNOTE: A rollover creates a new index and is subject to the `wait_for_active_shards` setting.\n\n**Increment index names for an alias**\n\nWhen you roll over an index alias, you can specify a name for the new index.\nIf you don't specify a name and the current index ends with `-` and a number, such as `my-index-000001` or `my-index-3`, the new index name increments that number.\nFor example, if you roll over an alias with a current index of `my-index-000001`, the rollover creates a new index named `my-index-000002`.\nThis number is always six characters and zero-padded, regardless of the previous index's name.\n\nIf you use an index alias for time series data, you can use date math in the index name to track the rollover date.\nFor example, you can create an alias that points to an index named ``.\nIf you create the index on May 6, 2099, the index's name is `my-index-2099.05.06-000001`.\nIf you roll over the alias on May 7, 2099, the new index's name is `my-index-2099.05.07-000002`.", "inherits": { "type": { "name": "RequestBase", @@ -24241,7 +24391,7 @@ } } ], - "specLocation": "indices/rollover/IndicesRolloverRequest.ts#L29-L100" + "specLocation": "indices/rollover/IndicesRolloverRequest.ts#L29-L137" }, { "body": { @@ -24351,7 +24501,7 @@ "body": { "kind": "no_body" }, - "description": "Simulate an index.\nReturns the index configuration that would be applied to the specified index from an existing index template.", + "description": "Simulate an index.\nGet the index configuration that would be applied to the specified index from an existing index template.", "inherits": { "type": { "name": "RequestBase", @@ -24414,7 +24564,7 @@ } } ], - "specLocation": "indices/simulate_index_template/IndicesSimulateIndexTemplateRequest.ts#L24-L50" + "specLocation": "indices/simulate_index_template/IndicesSimulateIndexTemplateRequest.ts#L24-L52" }, { "body": { @@ -24593,7 +24743,7 @@ } ] }, - "description": "Simulate an index template.\nReturns the index configuration that would be applied by a particular index template.", + "description": "Simulate an index template.\nGet the index configuration that would be applied by a particular index template.", "inherits": { "type": { "name": "RequestBase", @@ -24669,7 +24819,7 @@ } } ], - "specLocation": "indices/simulate_template/IndicesSimulateTemplateRequest.ts#L27-L120" + "specLocation": "indices/simulate_template/IndicesSimulateTemplateRequest.ts#L27-L121" }, { "body": { @@ -25440,7 +25590,7 @@ "body": { "kind": "no_body" }, - "description": "Get cluster info.\nReturns basic information about the cluster.", + "description": "Get cluster info.\nGet basic build, version, and cluster information.", "inherits": { "type": { "name": "RequestBase", @@ -25454,13 +25604,14 @@ }, "path": [], "query": [], - "specLocation": "_global/info/RootNodeInfoRequest.ts#L22-L29" + "specLocation": "_global/info/RootNodeInfoRequest.ts#L22-L31" }, { "body": { "kind": "properties", "properties": [ { + "description": "The responding cluster's name.", "name": "cluster_name", "required": true, "type": { @@ -25483,6 +25634,7 @@ } }, { + "description": "The responding node's name.", "name": "name", "required": true, "type": { @@ -25505,6 +25657,7 @@ } }, { + "description": "The running version of Elasticsearch.", "name": "version", "required": true, "type": { @@ -25522,7 +25675,7 @@ "name": "Response", "namespace": "_global.info" }, - "specLocation": "_global/info/RootNodeInfoResponse.ts#L23-L31" + "specLocation": "_global/info/RootNodeInfoResponse.ts#L23-L40" }, { "attachedBehaviors": [ @@ -25946,7 +26099,7 @@ "kind": "instance_of", "type": { "name": "Document", - "namespace": "ingest.simulate" + "namespace": "ingest._types" } } } @@ -26020,7 +26173,7 @@ "kind": "instance_of", "type": { "name": "SimulateDocumentResult", - "namespace": "ingest.simulate" + "namespace": "ingest._types" } } } @@ -26119,7 +26272,7 @@ "body": { "kind": "no_body" }, - "description": "Delete a Logstash pipeline.\n\nDelete a pipeline that is used for Logstash Central Management.", + "description": "Delete a Logstash pipeline.\nDelete a pipeline that is used for Logstash Central Management.\nIf the request succeeds, you receive an empty response with an appropriate status code.", "inherits": { "type": { "name": "RequestBase", @@ -26146,7 +26299,7 @@ } ], "query": [], - "specLocation": "logstash/delete_pipeline/LogstashDeletePipelineRequest.ts#L23-L40" + "specLocation": "logstash/delete_pipeline/LogstashDeletePipelineRequest.ts#L23-L41" }, { "body": { @@ -26166,7 +26319,7 @@ "body": { "kind": "no_body" }, - "description": "Get Logstash pipelines.\n\nGet pipelines that are used for Logstash Central Management.", + "description": "Get Logstash pipelines.\nGet pipelines that are used for Logstash Central Management.", "inherits": { "type": { "name": "RequestBase", @@ -26266,7 +26419,7 @@ } ], "query": [], - "specLocation": "logstash/put_pipeline/LogstashPutPipelineRequest.ts#L24-L44" + "specLocation": "logstash/put_pipeline/LogstashPutPipelineRequest.ts#L24-L45" }, { "body": { @@ -27466,6 +27619,7 @@ "kind": "properties", "properties": [ { + "description": "Evaluation results for a classification analysis.\nIt outputs a prediction that identifies to which of the classes each document belongs.", "name": "classification", "required": false, "type": { @@ -27477,6 +27631,7 @@ } }, { + "description": "Evaluation results for an outlier detection analysis.\nIt outputs the probability that each document is an outlier.", "name": "outlier_detection", "required": false, "type": { @@ -27488,6 +27643,7 @@ } }, { + "description": "Evaluation results for a regression analysis which outputs a prediction of values.", "name": "regression", "required": false, "type": { @@ -27505,7 +27661,7 @@ "name": "Response", "namespace": "ml.evaluate_data_frame" }, - "specLocation": "ml/evaluate_data_frame/MlEvaluateDataFrameResponse.ts#L26-L33" + "specLocation": "ml/evaluate_data_frame/MlEvaluateDataFrameResponse.ts#L26-L44" }, { "attachedBehaviors": [ @@ -30140,7 +30296,7 @@ } ] }, - "description": "Create a data frame analytics job.\nThis API creates a data frame analytics job that performs an analysis on the\nsource indices and stores the outcome in a destination index.", + "description": "Create a data frame analytics job.\nThis API creates a data frame analytics job that performs an analysis on the\nsource indices and stores the outcome in a destination index.\nBy default, the query used in the source configuration is `{\"match_all\": {}}`.\n\nIf the destination index does not exist, it is created automatically when you start the job.\n\nIf you supply only a subset of the regression or classification parameters, hyperparameter optimization occurs. It determines a value for each of the undefined parameters.", "inherits": { "type": { "name": "RequestBase", @@ -30167,7 +30323,7 @@ } ], "query": [], - "specLocation": "ml/put_data_frame_analytics/MlPutDataFrameAnalyticsRequest.ts#L30-L144" + "specLocation": "ml/put_data_frame_analytics/MlPutDataFrameAnalyticsRequest.ts#L30-L149" }, { "body": { @@ -30546,7 +30702,7 @@ } ] }, - "description": "Create a datafeed.\nDatafeeds retrieve data from Elasticsearch for analysis by an anomaly detection job.\nYou can associate only one datafeed with each anomaly detection job.\nThe datafeed contains a query that runs at a defined interval (`frequency`).\nIf you are concerned about delayed data, you can add a delay (`query_delay') at each interval.\nWhen Elasticsearch security features are enabled, your datafeed remembers which roles the user who created it had\nat the time of creation and runs the query using those same roles. If you provide secondary authorization headers,\nthose credentials are used instead.\nYou must use Kibana, this API, or the create anomaly detection jobs API to create a datafeed. Do not add a datafeed\ndirectly to the `.ml-config` index. Do not give users `write` privileges on the `.ml-config` index.", + "description": "Create a datafeed.\nDatafeeds retrieve data from Elasticsearch for analysis by an anomaly detection job.\nYou can associate only one datafeed with each anomaly detection job.\nThe datafeed contains a query that runs at a defined interval (`frequency`).\nIf you are concerned about delayed data, you can add a delay (`query_delay') at each interval.\nBy default, the datafeed uses the following query: `{\"match_all\": {\"boost\": 1}}`.\n\nWhen Elasticsearch security features are enabled, your datafeed remembers which roles the user who created it had\nat the time of creation and runs the query using those same roles. If you provide secondary authorization headers,\nthose credentials are used instead.\nYou must use Kibana, this API, or the create anomaly detection jobs API to create a datafeed. Do not add a datafeed\ndirectly to the `.ml-config` index. Do not give users `write` privileges on the `.ml-config` index.", "inherits": { "type": { "name": "RequestBase", @@ -30630,7 +30786,7 @@ } } ], - "specLocation": "ml/put_datafeed/MlPutDatafeedRequest.ts#L37-L175" + "specLocation": "ml/put_datafeed/MlPutDatafeedRequest.ts#L37-L177" }, { "body": { @@ -31157,7 +31313,7 @@ } ] }, - "description": "Create an anomaly detection job.\nIf you include a `datafeed_config`, you must have read index privileges on the source index.", + "description": "Create an anomaly detection job.\nIf you include a `datafeed_config`, you must have read index privileges on the source index.\nIf you include a `datafeed_config` but do not provide a query, the datafeed uses `{\"match_all\": {\"boost\": 1}}`.", "inherits": { "type": { "name": "RequestBase", @@ -31241,7 +31397,7 @@ } } ], - "specLocation": "ml/put_job/MlPutJobRequest.ts#L30-L148" + "specLocation": "ml/put_job/MlPutJobRequest.ts#L30-L149" }, { "body": { @@ -35207,7 +35363,7 @@ "body": { "kind": "no_body" }, - "description": "Delete a query rule.\nDelete a query rule within a query ruleset.", + "description": "Delete a query rule.\nDelete a query rule within a query ruleset.\nThis is a destructive action that is only recoverable by re-adding the same rule with the create or update query rule API.", "inherits": { "type": { "name": "RequestBase", @@ -35246,7 +35402,7 @@ } ], "query": [], - "specLocation": "query_rules/delete_rule/QueryRuleDeleteRequest.ts#L22-L41" + "specLocation": "query_rules/delete_rule/QueryRuleDeleteRequest.ts#L22-L44" }, { "body": { @@ -35273,7 +35429,7 @@ "body": { "kind": "no_body" }, - "description": "Delete a query ruleset.", + "description": "Delete a query ruleset.\nRemove a query ruleset and its associated data.\nThis is a destructive action that is not recoverable.", "inherits": { "type": { "name": "RequestBase", @@ -35300,7 +35456,7 @@ } ], "query": [], - "specLocation": "query_rules/delete_ruleset/QueryRulesetDeleteRequest.ts#L22-L35" + "specLocation": "query_rules/delete_ruleset/QueryRulesetDeleteRequest.ts#L22-L39" }, { "body": { @@ -35366,7 +35522,7 @@ } ], "query": [], - "specLocation": "query_rules/get_rule/QueryRuleGetRequest.ts#L22-L42" + "specLocation": "query_rules/get_rule/QueryRuleGetRequest.ts#L22-L44" }, { "body": { @@ -35420,7 +35576,7 @@ } ], "query": [], - "specLocation": "query_rules/get_ruleset/QueryRulesetGetRequest.ts#L22-L36" + "specLocation": "query_rules/get_ruleset/QueryRulesetGetRequest.ts#L22-L38" }, { "body": { @@ -35462,9 +35618,10 @@ "path": [], "query": [ { - "description": "Starting offset (default: 0)", + "description": "The offset from the first result to fetch.", "name": "from", "required": false, + "serverDefault": 0, "type": { "kind": "instance_of", "type": { @@ -35474,7 +35631,7 @@ } }, { - "description": "specifies a max number of results to get", + "description": "The maximum number of results to retrieve.", "name": "size", "required": false, "type": { @@ -35486,7 +35643,7 @@ } } ], - "specLocation": "query_rules/list_rulesets/QueryRulesetListRequest.ts#L22-L40" + "specLocation": "query_rules/list_rulesets/QueryRulesetListRequest.ts#L22-L43" }, { "body": { @@ -35534,6 +35691,7 @@ "kind": "properties", "properties": [ { + "description": "The type of rule.", "name": "type", "required": true, "type": { @@ -35545,6 +35703,7 @@ } }, { + "description": "The criteria that must be met for the rule to be applied.\nIf multiple criteria are specified for a rule, all criteria must be met for the rule to be applied.", "name": "criteria", "required": true, "type": { @@ -35571,6 +35730,7 @@ } }, { + "description": "The actions to take when the rule is matched.\nThe format of this action depends on the rule type.", "name": "actions", "required": true, "type": { @@ -35594,7 +35754,7 @@ } ] }, - "description": "Create or update a query rule.\nCreate or update a query rule within a query ruleset.", + "description": "Create or update a query rule.\nCreate or update a query rule within a query ruleset.\n\nIMPORTANT: Due to limitations within pinned queries, you can only pin documents using ids or docs, but cannot use both in single rule.\nIt is advised to use one or the other in query rulesets, to avoid errors.\nAdditionally, pinned queries have a maximum limit of 100 pinned hits.\nIf multiple matching rules pin more than 100 documents, only the first 100 documents are pinned in the order they are specified in the ruleset.", "inherits": { "type": { "name": "RequestBase", @@ -35608,7 +35768,7 @@ }, "path": [ { - "description": "The unique identifier of the query ruleset containing the rule to be created or updated", + "description": "The unique identifier of the query ruleset containing the rule to be created or updated.", "name": "ruleset_id", "required": true, "type": { @@ -35620,7 +35780,7 @@ } }, { - "description": "The unique identifier of the query rule within the specified ruleset to be created or updated", + "description": "The unique identifier of the query rule within the specified ruleset to be created or updated.", "name": "rule_id", "required": true, "type": { @@ -35633,7 +35793,7 @@ } ], "query": [], - "specLocation": "query_rules/put_rule/QueryRulePutRequest.ts#L28-L57" + "specLocation": "query_rules/put_rule/QueryRulePutRequest.ts#L28-L73" }, { "body": { @@ -35694,7 +35854,7 @@ } ] }, - "description": "Create or update a query ruleset.", + "description": "Create or update a query ruleset.\nThere is a limit of 100 rules per ruleset.\nThis limit can be increased by using the `xpack.applications.rules.max_rules_per_ruleset` cluster setting.\n\nIMPORTANT: Due to limitations within pinned queries, you can only select documents using `ids` or `docs`, but cannot use both in single rule.\nIt is advised to use one or the other in query rulesets, to avoid errors.\nAdditionally, pinned queries have a maximum limit of 100 pinned hits.\nIf multiple matching rules pin more than 100 documents, only the first 100 documents are pinned in the order they are specified in the ruleset.", "inherits": { "type": { "name": "RequestBase", @@ -35708,7 +35868,7 @@ }, "path": [ { - "description": "The unique identifier of the query ruleset to be created or updated", + "description": "The unique identifier of the query ruleset to be created or updated.", "name": "ruleset_id", "required": true, "type": { @@ -35721,7 +35881,7 @@ } ], "query": [], - "specLocation": "query_rules/put_ruleset/QueryRulesetPutRequest.ts#L23-L44" + "specLocation": "query_rules/put_ruleset/QueryRulesetPutRequest.ts#L23-L53" }, { "body": { @@ -35755,6 +35915,7 @@ "kind": "properties", "properties": [ { + "description": "The match criteria to apply to rules in the given query ruleset.\nMatch criteria should match the keys defined in the `criteria.metadata` field of the rule.", "name": "match_criteria", "required": true, "type": { @@ -35801,7 +35962,7 @@ } ], "query": [], - "specLocation": "query_rules/test/QueryRulesetTestRequest.ts#L24-L45" + "specLocation": "query_rules/test/QueryRulesetTestRequest.ts#L24-L51" }, { "body": { @@ -37979,7 +38140,7 @@ } ], "query": [], - "specLocation": "search_application/delete/SearchApplicationsDeleteRequest.ts#L22-L36" + "specLocation": "search_application/delete/SearchApplicationsDeleteRequest.ts#L22-L38" }, { "body": { @@ -38087,7 +38248,7 @@ } ], "query": [], - "specLocation": "search_application/get/SearchApplicationsGetRequest.ts#L22-L35" + "specLocation": "search_application/get/SearchApplicationsGetRequest.ts#L22-L36" }, { "body": { @@ -38182,7 +38343,7 @@ "body": { "kind": "no_body" }, - "description": "Returns the existing search applications.", + "description": "Get search applications.\nGet information about search applications.", "inherits": { "type": { "name": "RequestBase", @@ -38234,7 +38395,7 @@ } } ], - "specLocation": "search_application/list/SearchApplicationsListRequest.ts#L22-L44" + "specLocation": "search_application/list/SearchApplicationsListRequest.ts#L22-L46" }, { "body": { @@ -38259,8 +38420,8 @@ "value": { "kind": "instance_of", "type": { - "name": "SearchApplicationListItem", - "namespace": "search_application.list" + "name": "SearchApplication", + "namespace": "search_application._types" } } } @@ -38272,7 +38433,7 @@ "name": "Response", "namespace": "search_application.list" }, - "specLocation": "search_application/list/SearchApplicationsListResponse.ts#L24-L29" + "specLocation": "search_application/list/SearchApplicationsListResponse.ts#L23-L28" }, { "attachedBehaviors": [ @@ -38284,7 +38445,7 @@ "value": { "kind": "instance_of", "type": { - "name": "SearchApplication", + "name": "SearchApplicationParameters", "namespace": "search_application._types" } } @@ -38330,7 +38491,7 @@ } } ], - "specLocation": "search_application/put/SearchApplicationsPutRequest.ts#L23-L48" + "specLocation": "search_application/put/SearchApplicationsPutRequest.ts#L23-L50" }, { "body": { @@ -47766,6 +47927,7 @@ "specLocation": "_types/aggregations/Aggregation.ts#L20-L20" }, { + "description": "An Elasticsearch Query DSL (Domain Specific Language) object that defines a query.", "extDocId": "query-dsl", "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/query-dsl.html", "kind": "interface", @@ -48827,7 +48989,7 @@ } } ], - "specLocation": "_types/query_dsl/abstractions.ts#L102-L427", + "specLocation": "_types/query_dsl/abstractions.ts#L102-L428", "variants": { "kind": "container", "nonExhaustive": true @@ -49006,7 +49168,7 @@ } } ], - "specLocation": "_types/query_dsl/abstractions.ts#L452-L463" + "specLocation": "_types/query_dsl/abstractions.ts#L453-L464" }, { "kind": "type_alias", @@ -49352,7 +49514,7 @@ } } ], - "specLocation": "_types/query_dsl/abstractions.ts#L465-L499" + "specLocation": "_types/query_dsl/abstractions.ts#L466-L500" }, { "kind": "enum", @@ -49368,7 +49530,7 @@ "name": "CombinedFieldsOperator", "namespace": "_types.query_dsl" }, - "specLocation": "_types/query_dsl/abstractions.ts#L512-L515" + "specLocation": "_types/query_dsl/abstractions.ts#L513-L516" }, { "kind": "enum", @@ -49386,7 +49548,7 @@ "name": "CombinedFieldsZeroTerms", "namespace": "_types.query_dsl" }, - "specLocation": "_types/query_dsl/abstractions.ts#L517-L526" + "specLocation": "_types/query_dsl/abstractions.ts#L518-L527" }, { "extDocId": "query-dsl-constant-score-query", @@ -51642,7 +51804,7 @@ } } ], - "specLocation": "_types/query_dsl/abstractions.ts#L429-L446" + "specLocation": "_types/query_dsl/abstractions.ts#L430-L447" }, { "kind": "enum", @@ -52117,7 +52279,7 @@ } ], "shortcutProperty": "field", - "specLocation": "_types/query_dsl/abstractions.ts#L528-L542" + "specLocation": "_types/query_dsl/abstractions.ts#L529-L543" }, { "inherits": { @@ -59163,7 +59325,7 @@ } } ], - "specLocation": "_types/query_dsl/abstractions.ts#L501-L510" + "specLocation": "_types/query_dsl/abstractions.ts#L502-L511" }, { "inherits": { @@ -76552,7 +76714,7 @@ } } ], - "specLocation": "_types/Base.ts#L76-L85" + "specLocation": "_types/Base.ts#L105-L114" }, { "codegenNames": [ @@ -94921,7 +95083,7 @@ "name": "Feature", "namespace": "indices.get" }, - "specLocation": "indices/get/IndicesGetRequest.ts#L91-L95" + "specLocation": "indices/get/IndicesGetRequest.ts#L92-L96" }, { "kind": "type_alias", @@ -94929,7 +95091,7 @@ "name": "Features", "namespace": "indices.get" }, - "specLocation": "indices/get/IndicesGetRequest.ts#L96-L96", + "specLocation": "indices/get/IndicesGetRequest.ts#L97-L97", "type": { "items": [ { @@ -103557,7 +103719,7 @@ "name": "QueryRuleCriteriaType", "namespace": "query_rules._types" }, - "specLocation": "query_rules/_types/QueryRuleset.ts#L55-L68" + "specLocation": "query_rules/_types/QueryRuleset.ts#L95-L108" }, { "kind": "enum", @@ -103573,7 +103735,7 @@ "name": "QueryRuleType", "namespace": "query_rules._types" }, - "specLocation": "query_rules/_types/QueryRuleset.ts#L44-L47" + "specLocation": "query_rules/_types/QueryRuleset.ts#L60-L63" }, { "kind": "enum", @@ -103623,7 +103785,7 @@ "name": "IndexingJobState", "namespace": "rollup.get_jobs" }, - "specLocation": "rollup/get_jobs/types.ts#L66-L72" + "specLocation": "rollup/get_jobs/types.ts#L77-L83" }, { "kind": "enum", @@ -103849,7 +104011,7 @@ "name": "IndexPrivilege", "namespace": "security._types" }, - "specLocation": "security/_types/Privileges.ts#L362-L404" + "specLocation": "security/_types/Privileges.ts#L361-L403" }, { "codegenNames": [ @@ -103863,7 +104025,7 @@ "name": "IndicesPrivilegesQuery", "namespace": "security._types" }, - "specLocation": "security/_types/Privileges.ts#L317-L325", + "specLocation": "security/_types/Privileges.ts#L316-L324", "type": { "items": [ { @@ -103913,7 +104075,7 @@ } } ], - "specLocation": "security/_types/Privileges.ts#L327-L337" + "specLocation": "security/_types/Privileges.ts#L326-L336" }, { "kind": "interface", @@ -104001,7 +104163,7 @@ } ], "shortcutProperty": "source", - "specLocation": "security/_types/Privileges.ts#L339-L357" + "specLocation": "security/_types/Privileges.ts#L338-L356" }, { "codegenNames": [ @@ -104013,7 +104175,7 @@ "name": "RoleTemplateInlineQuery", "namespace": "security._types" }, - "specLocation": "security/_types/Privileges.ts#L359-L360", + "specLocation": "security/_types/Privileges.ts#L358-L359", "type": { "items": [ { @@ -104041,7 +104203,7 @@ "name": "RemoteClusterPrivilege", "namespace": "security._types" }, - "specLocation": "security/_types/Privileges.ts#L201-L214" + "specLocation": "security/_types/Privileges.ts#L201-L213" }, { "isOpen": true, @@ -115913,11 +116075,40 @@ }, { "description": "Data stream lifecycle with rollover can be used to display the configuration including the default rollover conditions,\nif asked.", + "inherits": { + "type": { + "name": "DataStreamLifecycle", + "namespace": "indices._types" + } + }, "kind": "interface", "name": { "name": "DataStreamLifecycleWithRollover", "namespace": "indices._types" }, + "properties": [ + { + "description": "The conditions which will trigger the rollover of a backing index as configured by the cluster setting `cluster.lifecycle.default.rollover`.\nThis property is an implementation detail and it will only be retrieved when the query param `include_defaults` is set to true.\nThe contents of this field are subject to change.", + "name": "rollover", + "required": false, + "type": { + "kind": "instance_of", + "type": { + "name": "DataStreamLifecycleRolloverConditions", + "namespace": "indices._types" + } + } + } + ], + "specLocation": "indices/_types/DataStreamLifecycle.ts#L47-L58" + }, + { + "description": "Data stream lifecycle denotes that a data stream is managed by the data stream lifecycle and contains the configuration.", + "kind": "interface", + "name": { + "name": "DataStreamLifecycle", + "namespace": "indices._types" + }, "properties": [ { "description": "If defined, every document added to this data stream will be stored at least for this time frame.\nAny time after this duration the document could be deleted.\nWhen empty, every document in this data stream will be stored indefinitely.", @@ -115944,19 +116135,20 @@ } }, { - "description": "The conditions which will trigger the rollover of a backing index as configured by the cluster setting `cluster.lifecycle.default.rollover`.\nThis property is an implementation detail and it will only be retrieved when the query param `include_defaults` is set to true.\nThe contents of this field are subject to change.", - "name": "rollover", + "description": "If defined, it turns data stream lifecycle on/off (`true`/`false`) for this data stream. A data stream lifecycle\nthat's disabled (enabled: `false`) will have no effect on the data stream.", + "name": "enabled", "required": false, + "serverDefault": true, "type": { "kind": "instance_of", "type": { - "name": "DataStreamLifecycleRolloverConditions", - "namespace": "indices._types" + "name": "boolean", + "namespace": "_builtins" } } } ], - "specLocation": "indices/_types/DataStreamLifecycle.ts#L33-L55" + "specLocation": "indices/_types/DataStreamLifecycle.ts#L25-L45" }, { "kind": "interface", @@ -116157,7 +116349,7 @@ } } ], - "specLocation": "indices/_types/DataStreamLifecycle.ts#L57-L69" + "specLocation": "indices/_types/DataStreamLifecycle.ts#L60-L72" }, { "kind": "interface", @@ -116341,39 +116533,6 @@ ], "specLocation": "indices/_types/Alias.ts#L23-L53" }, - { - "description": "Data stream lifecycle denotes that a data stream is managed by the data stream lifecycle and contains the configuration.", - "kind": "interface", - "name": { - "name": "DataStreamLifecycle", - "namespace": "indices._types" - }, - "properties": [ - { - "name": "data_retention", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "Duration", - "namespace": "_types" - } - } - }, - { - "name": "downsampling", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "DataStreamLifecycleDownsampling", - "namespace": "indices._types" - } - } - } - ], - "specLocation": "indices/_types/DataStreamLifecycle.ts#L25-L31" - }, { "kind": "interface", "name": { @@ -119682,7 +119841,7 @@ } } ], - "specLocation": "_types/Base.ts#L87-L89" + "specLocation": "_types/Base.ts#L116-L118" }, { "kind": "interface", @@ -119867,7 +120026,7 @@ "type": { "kind": "instance_of", "type": { - "name": "DataStreamLifecycle", + "name": "DataStreamLifecycleWithRollover", "namespace": "indices._types" } } @@ -120716,7 +120875,7 @@ } } ], - "specLocation": "indices/put_index_template/IndicesPutIndexTemplateRequest.ts#L121-L143" + "specLocation": "indices/put_index_template/IndicesPutIndexTemplateRequest.ts#L152-L174" }, { "kind": "interface", @@ -120769,7 +120928,7 @@ } } ], - "specLocation": "_types/Base.ts#L91-L94" + "specLocation": "_types/Base.ts#L120-L123" }, { "kind": "interface", @@ -121916,6 +122075,7 @@ }, "properties": [ { + "description": "The Elasticsearch Git commit's date.", "name": "build_date", "required": true, "type": { @@ -121927,6 +122087,7 @@ } }, { + "description": "The build flavor. For example, `default`.", "name": "build_flavor", "required": true, "type": { @@ -121938,6 +122099,7 @@ } }, { + "description": "The Elasticsearch Git commit's SHA hash.", "name": "build_hash", "required": true, "type": { @@ -121949,6 +122111,7 @@ } }, { + "description": "Indicates whether the Elasticsearch build was a snapshot.", "name": "build_snapshot", "required": true, "type": { @@ -121960,6 +122123,7 @@ } }, { + "description": "The build type that corresponds to how Elasticsearch was installed.\nFor example, `docker`, `rpm`, or `tar`.", "name": "build_type", "required": true, "type": { @@ -121971,6 +122135,7 @@ } }, { + "description": "The version number of Elasticsearch's underlying Lucene software.", "name": "lucene_version", "required": true, "type": { @@ -121982,6 +122147,7 @@ } }, { + "description": "The minimum index version with which the responding node can read from disk.", "name": "minimum_index_compatibility_version", "required": true, "type": { @@ -121993,6 +122159,7 @@ } }, { + "description": "The minimum node version with which the responding node can communicate.\nAlso the minimum version from which you can perform a rolling upgrade.", "name": "minimum_wire_compatibility_version", "required": true, "type": { @@ -122004,6 +122171,7 @@ } }, { + "description": "The Elasticsearch version number.", "name": "number", "required": true, "type": { @@ -122015,7 +122183,7 @@ } } ], - "specLocation": "_types/Base.ts#L54-L64" + "specLocation": "_types/Base.ts#L54-L93" }, { "kind": "interface", @@ -126412,7 +126580,7 @@ "kind": "interface", "name": { "name": "Document", - "namespace": "ingest.simulate" + "namespace": "ingest._types" }, "properties": [ { @@ -126448,13 +126616,13 @@ } } ], - "specLocation": "ingest/simulate/types.ts#L62-L76" + "specLocation": "ingest/_types/Simulation.ts#L62-L76" }, { "kind": "interface", "name": { "name": "SimulateDocumentResult", - "namespace": "ingest.simulate" + "namespace": "ingest._types" }, "properties": [ { @@ -126464,7 +126632,7 @@ "kind": "instance_of", "type": { "name": "DocumentSimulation", - "namespace": "ingest.simulate" + "namespace": "ingest._types" } } }, @@ -126488,13 +126656,13 @@ "kind": "instance_of", "type": { "name": "PipelineSimulation", - "namespace": "ingest.simulate" + "namespace": "ingest._types" } } } } ], - "specLocation": "ingest/simulate/types.ts#L46-L50" + "specLocation": "ingest/_types/Simulation.ts#L46-L50" }, { "attachedBehaviors": [ @@ -126532,7 +126700,7 @@ "kind": "interface", "name": { "name": "DocumentSimulation", - "namespace": "ingest.simulate" + "namespace": "ingest._types" }, "properties": [ { @@ -126566,7 +126734,7 @@ "kind": "instance_of", "type": { "name": "Ingest", - "namespace": "ingest.simulate" + "namespace": "ingest._types" } } }, @@ -126634,13 +126802,13 @@ } } ], - "specLocation": "ingest/simulate/types.ts#L78-L108" + "specLocation": "ingest/_types/Simulation.ts#L78-L108" }, { "kind": "interface", "name": { "name": "Ingest", - "namespace": "ingest.simulate" + "namespace": "ingest._types" }, "properties": [ { @@ -126656,7 +126824,7 @@ "kind": "instance_of", "type": { "name": "Redact", - "namespace": "ingest.simulate" + "namespace": "ingest._types" } } }, @@ -126683,13 +126851,13 @@ } } ], - "specLocation": "ingest/simulate/types.ts#L29-L37" + "specLocation": "ingest/_types/Simulation.ts#L29-L37" }, { "kind": "interface", "name": { "name": "Redact", - "namespace": "ingest.simulate" + "namespace": "ingest._types" }, "properties": [ { @@ -126705,13 +126873,13 @@ } } ], - "specLocation": "ingest/simulate/types.ts#L39-L44" + "specLocation": "ingest/_types/Simulation.ts#L39-L44" }, { "kind": "interface", "name": { "name": "PipelineSimulation", - "namespace": "ingest.simulate" + "namespace": "ingest._types" }, "properties": [ { @@ -126721,7 +126889,7 @@ "kind": "instance_of", "type": { "name": "DocumentSimulation", - "namespace": "ingest.simulate" + "namespace": "ingest._types" } } }, @@ -126792,7 +126960,7 @@ } } ], - "specLocation": "ingest/simulate/types.ts#L52-L60" + "specLocation": "ingest/_types/Simulation.ts#L52-L60" }, { "kind": "interface", @@ -139182,6 +139350,7 @@ }, "properties": [ { + "description": "A unique identifier for the rule.", "name": "rule_id", "required": true, "type": { @@ -139193,6 +139362,7 @@ } }, { + "description": "The type of rule.\n`pinned` will identify and pin specific documents to the top of search results.\n`exclude` will exclude specific documents from search results.", "name": "type", "required": true, "type": { @@ -139204,6 +139374,7 @@ } }, { + "description": "The criteria that must be met for the rule to be applied.\nIf multiple criteria are specified for a rule, all criteria must be met for the rule to be applied.", "name": "criteria", "required": true, "type": { @@ -139230,6 +139401,7 @@ } }, { + "description": "The actions to take when the rule is matched.\nThe format of this action depends on the rule type.", "name": "actions", "required": true, "type": { @@ -139252,7 +139424,7 @@ } } ], - "specLocation": "query_rules/_types/QueryRuleset.ts#L36-L42" + "specLocation": "query_rules/_types/QueryRuleset.ts#L36-L58" }, { "kind": "interface", @@ -139262,6 +139434,7 @@ }, "properties": [ { + "description": "The type of criteria. The following criteria types are supported:\n\n* `always`: Matches all queries, regardless of input.\n* `contains`: Matches that contain this value anywhere in the field meet the criteria defined by the rule. Only applicable for string values.\n* `exact`: Only exact matches meet the criteria defined by the rule. Applicable for string or numerical values.\n* `fuzzy`: Exact matches or matches within the allowed Levenshtein Edit Distance meet the criteria defined by the rule. Only applicable for string values.\n* `gt`: Matches with a value greater than this value meet the criteria defined by the rule. Only applicable for numerical values.\n* `gte`: Matches with a value greater than or equal to this value meet the criteria defined by the rule. Only applicable for numerical values.\n* `lt`: Matches with a value less than this value meet the criteria defined by the rule. Only applicable for numerical values.\n* `lte`: Matches with a value less than or equal to this value meet the criteria defined by the rule. Only applicable for numerical values.\n* `prefix`: Matches that start with this value meet the criteria defined by the rule. Only applicable for string values.\n* `suffix`: Matches that end with this value meet the criteria defined by the rule. Only applicable for string values.", "name": "type", "required": true, "type": { @@ -139273,6 +139446,7 @@ } }, { + "description": "The metadata field to match against.\nThis metadata will be used to match against `match_criteria` sent in the rule.\nIt is required for all criteria types except `always`.", "name": "metadata", "required": false, "type": { @@ -139284,6 +139458,7 @@ } }, { + "description": "The values to match against the `metadata` field.\nOnly one value must match for the criteria to be met.\nIt is required for all criteria types except `always`.", "name": "values", "required": false, "type": { @@ -139294,7 +139469,7 @@ } } ], - "specLocation": "query_rules/_types/QueryRuleset.ts#L49-L53" + "specLocation": "query_rules/_types/QueryRuleset.ts#L65-L93" }, { "kind": "interface", @@ -139304,6 +139479,7 @@ }, "properties": [ { + "description": "The unique document IDs of the documents to apply the rule to.\nOnly one of `ids` or `docs` may be specified and at least one must be specified.", "name": "ids", "required": false, "type": { @@ -139318,6 +139494,7 @@ } }, { + "description": "The documents to apply the rule to.\nOnly one of `ids` or `docs` may be specified and at least one must be specified.\nThere is a maximum value of 100 documents in a rule.\nYou can specify the following attributes for each document:\n\n* `_index`: The index of the document to pin.\n* `_id`: The unique document ID.", "name": "docs", "required": false, "type": { @@ -139332,7 +139509,7 @@ } } ], - "specLocation": "query_rules/_types/QueryRuleset.ts#L70-L73" + "specLocation": "query_rules/_types/QueryRuleset.ts#L110-L126" }, { "kind": "interface", @@ -139342,7 +139519,7 @@ }, "properties": [ { - "description": "Query Ruleset unique identifier", + "description": "A unique identifier for the ruleset.", "name": "ruleset_id", "required": true, "type": { @@ -139354,7 +139531,7 @@ } }, { - "description": "Rules associated with the query ruleset", + "description": "Rules associated with the query ruleset.", "name": "rules", "required": true, "type": { @@ -139379,7 +139556,7 @@ }, "properties": [ { - "description": "Ruleset unique identifier", + "description": "A unique identifier for the ruleset.", "name": "ruleset_id", "required": true, "type": { @@ -139391,7 +139568,7 @@ } }, { - "description": "The number of rules associated with this ruleset", + "description": "The number of rules associated with the ruleset.", "name": "rule_total_count", "required": true, "type": { @@ -139403,7 +139580,7 @@ } }, { - "description": "A map of criteria type (e.g. exact) to the number of rules of that type", + "description": "A map of criteria type (for example, `exact`) to the number of rules of that type.\n\nNOTE: The counts in `rule_criteria_types_counts` may be larger than the value of `rule_total_count` because a rule may have multiple criteria.", "name": "rule_criteria_types_counts", "required": true, "type": { @@ -139426,7 +139603,7 @@ } }, { - "description": "A map of rule type (e.g. pinned) to the number of rules of that type", + "description": "A map of rule type (for example, `pinned`) to the number of rules of that type.", "name": "rule_type_counts", "required": true, "type": { @@ -139449,7 +139626,7 @@ } } ], - "specLocation": "query_rules/list_rulesets/types.ts#L23-L42" + "specLocation": "query_rules/list_rulesets/types.ts#L23-L44" }, { "kind": "interface", @@ -140888,6 +141065,12 @@ "specLocation": "_types/Retriever.ts#L101-L110" }, { + "inherits": { + "type": { + "name": "SearchApplicationParameters", + "namespace": "search_application._types" + } + }, "kind": "interface", "name": { "name": "SearchApplication", @@ -140895,7 +141078,7 @@ }, "properties": [ { - "description": "Search Application name.", + "description": "Search Application name", "name": "name", "required": true, "type": { @@ -140906,21 +141089,6 @@ } } }, - { - "description": "Indices that are part of the Search Application.", - "name": "indices", - "required": true, - "type": { - "kind": "array_of", - "value": { - "kind": "instance_of", - "type": { - "name": "IndexName", - "namespace": "_types" - } - } - } - }, { "description": "Last time the Search Application was updated.", "name": "updated_at_millis", @@ -140941,6 +141109,31 @@ "namespace": "_types" } } + } + ], + "specLocation": "search_application/_types/SearchApplication.ts#L24-L33" + }, + { + "kind": "interface", + "name": { + "name": "SearchApplicationParameters", + "namespace": "search_application._types" + }, + "properties": [ + { + "description": "Indices that are part of the Search Application.", + "name": "indices", + "required": true, + "type": { + "kind": "array_of", + "value": { + "kind": "instance_of", + "type": { + "name": "IndexName", + "namespace": "_types" + } + } + } }, { "description": "Analytics collection associated to the Search Application.", @@ -140967,7 +141160,7 @@ } } ], - "specLocation": "search_application/_types/SearchApplication.ts#L24-L45" + "specLocation": "search_application/_types/SearchApplicationParameters.ts#L23-L36" }, { "kind": "interface", @@ -140989,7 +141182,7 @@ } } ], - "specLocation": "search_application/_types/SearchApplication.ts#L47-L52" + "specLocation": "search_application/_types/SearchApplicationTemplate.ts#L22-L27" }, { "kind": "interface", @@ -141034,76 +141227,6 @@ ], "specLocation": "search_application/_types/BehavioralAnalytics.ts#L29-L31" }, - { - "kind": "interface", - "name": { - "name": "SearchApplicationListItem", - "namespace": "search_application.list" - }, - "properties": [ - { - "description": "Search Application name", - "name": "name", - "required": true, - "type": { - "kind": "instance_of", - "type": { - "name": "Name", - "namespace": "_types" - } - } - }, - { - "description": "Indices that are part of the Search Application", - "name": "indices", - "required": true, - "type": { - "kind": "array_of", - "value": { - "kind": "instance_of", - "type": { - "name": "IndexName", - "namespace": "_types" - } - } - } - }, - { - "description": "Last time the Search Application was updated", - "name": "updated_at_millis", - "required": true, - "type": { - "generics": [ - { - "kind": "instance_of", - "type": { - "name": "UnitMillis", - "namespace": "_types" - } - } - ], - "kind": "instance_of", - "type": { - "name": "EpochTime", - "namespace": "_types" - } - } - }, - { - "description": "Analytics collection associated to the Search Application", - "name": "analytics_collection_name", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "Name", - "namespace": "_types" - } - } - } - ], - "specLocation": "search_application/list/SearchApplicationsListResponse.ts#L31-L48" - }, { "inherits": { "type": { @@ -141427,7 +141550,7 @@ } } ], - "specLocation": "security/_types/Privileges.ts#L217-L243" + "specLocation": "security/_types/Privileges.ts#L216-L242" }, { "kind": "interface", @@ -141921,7 +142044,7 @@ } } ], - "specLocation": "security/_types/Privileges.ts#L418-L428" + "specLocation": "security/_types/Privileges.ts#L417-L427" }, { "kind": "interface", @@ -141984,7 +142107,7 @@ } } ], - "specLocation": "security/_types/Privileges.ts#L430-L450" + "specLocation": "security/_types/Privileges.ts#L429-L449" }, { "kind": "interface", diff --git a/output/schema/schema.json b/output/schema/schema.json index 571dbb18d9..b736c6a952 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -190951,11 +190951,7 @@ } } ], -<<<<<<< HEAD - "specLocation": "searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts#L23-L48" -======= - "specLocation": "searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts#L23-L40" ->>>>>>> be1386ab9 (Fix common query parameters (#3297)) + "specLocation": "searchable_snapshots/clear_cache/SearchableSnapshotsClearCacheRequest.ts#L23-L46" }, { "kind": "response", @@ -208079,11 +208075,7 @@ } } ], -<<<<<<< HEAD - "specLocation": "snapshot/clone/SnapshotCloneRequest.ts#L24-L46" -======= - "specLocation": "snapshot/clone/SnapshotCloneRequest.ts#L24-L44" ->>>>>>> be1386ab9 (Fix common query parameters (#3297)) + "specLocation": "snapshot/clone/SnapshotCloneRequest.ts#L24-L45" }, { "kind": "response", diff --git a/output/schema/validation-errors.json b/output/schema/validation-errors.json index 19682fd3e7..cea5dcdd99 100644 --- a/output/schema/validation-errors.json +++ b/output/schema/validation-errors.json @@ -492,18 +492,6 @@ ], "response": [] }, -<<<<<<< HEAD - "snapshot.clone": { - "request": [ - "Request: query parameter 'timeout' does not exist in the json spec" -======= - "simulate.ingest": { - "request": [ - "Missing request & response" ->>>>>>> be1386ab9 (Fix common query parameters (#3297)) - ], - "response": [] - }, "snapshot.delete": { "request": [ "Request: missing json spec query parameter 'wait_for_completion'" From 38b8580bde172ece1407148b5ac939d01e720c75 Mon Sep 17 00:00:00 2001 From: Laura Trotta Date: Mon, 13 Jan 2025 12:51:50 +0100 Subject: [PATCH 3/3] this time correct rebase --- output/openapi/elasticsearch-openapi.json | 6 +- .../elasticsearch-serverless-openapi.json | 2 +- output/schema/schema-serverless.json | 506 +++++++++++------- output/schema/schema.json | 17 +- output/schema/validation-errors.json | 18 - 5 files changed, 306 insertions(+), 243 deletions(-) diff --git a/output/openapi/elasticsearch-openapi.json b/output/openapi/elasticsearch-openapi.json index 62a1e15a0f..dc56693d47 100644 --- a/output/openapi/elasticsearch-openapi.json +++ b/output/openapi/elasticsearch-openapi.json @@ -38708,11 +38708,7 @@ { "in": "query", "name": "master_timeout", -<<<<<<< HEAD "description": "The period to wait for the master node.\nIf the master node is not available before the timeout expires, the request fails and returns an error.\nTo indicate that the request should never timeout, set it to `-1`.", -======= - "description": "Period to wait for a connection to the master node.", ->>>>>>> b6a68ae73 (Fix common query parameters (#3297)) "deprecated": false, "schema": { "$ref": "#/components/schemas/_types:Duration" @@ -108301,7 +108297,7 @@ "type": "number" }, "field_multi_value_leniency": { - "description": "If `false`, the API returns an exception when encountering multiple values for a field.\nIf `true`, the API is lenient and returns the API returns the first value from the array with no guarantee of consistent results.", + "description": "If `false`, the API returns an exception when encountering multiple values for a field.\nIf `true`, the API is lenient and returns the first value from the array with no guarantee of consistent results.", "type": "boolean" }, "filter": { diff --git a/output/openapi/elasticsearch-serverless-openapi.json b/output/openapi/elasticsearch-serverless-openapi.json index d95a7463ed..4be94c0d93 100644 --- a/output/openapi/elasticsearch-serverless-openapi.json +++ b/output/openapi/elasticsearch-serverless-openapi.json @@ -64310,7 +64310,7 @@ "type": "number" }, "field_multi_value_leniency": { - "description": "If `false`, the API returns an exception when encountering multiple values for a field.\nIf `true`, the API is lenient and returns the API returns the first value from the array with no guarantee of consistent results.", + "description": "If `false`, the API returns an exception when encountering multiple values for a field.\nIf `true`, the API is lenient and returns the first value from the array with no guarantee of consistent results.", "type": "boolean" }, "filter": { diff --git a/output/schema/schema-serverless.json b/output/schema/schema-serverless.json index 993af93afb..e11aa94265 100644 --- a/output/schema/schema-serverless.json +++ b/output/schema/schema-serverless.json @@ -4219,7 +4219,7 @@ }, "description": "Simulate an index.\nGet the index configuration that would be applied to the specified index from an existing index template.", "docId": "indices-simulate", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{master}/indices-simulate-index.html", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/indices-simulate-index.html", "name": "indices.simulate_index_template", "privileges": { "cluster": [ @@ -9002,7 +9002,8 @@ } }, "description": "Clear an SQL search cursor.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/clear-sql-cursor-api.html", + "docId": "sql-clear-cursor-api", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/clear-sql-cursor-api.html", "name": "sql.clear_cursor", "request": { "name": "Request", @@ -9039,9 +9040,15 @@ "stability": "stable" } }, - "description": "Delete an async SQL search.\nDelete an async SQL search or a stored synchronous SQL search.\nIf the search is still running, the API cancels it.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-async-sql-search-api.html", + "description": "Delete an async SQL search.\nDelete an async SQL search or a stored synchronous SQL search.\nIf the search is still running, the API cancels it.\n\nIf the Elasticsearch security features are enabled, only the following users can use this API to delete a search:\n\n* Users with the `cancel_task` cluster privilege.\n* The user who first submitted the search.", + "docId": "sql-delete-async-api", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-async-sql-search-api.html", "name": "sql.delete_async", + "privileges": { + "cluster": [ + "cancel_task" + ] + }, "request": { "name": "Request", "namespace": "sql.delete_async" @@ -9074,8 +9081,9 @@ "stability": "stable" } }, - "description": "Get async SQL search results.\nGet the current status and available results for an async SQL search or stored synchronous SQL search.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-async-sql-search-api.html", + "description": "Get async SQL search results.\nGet the current status and available results for an async SQL search or stored synchronous SQL search.\n\nIf the Elasticsearch security features are enabled, only the user who first submitted the SQL search can retrieve the search using this API.", + "docId": "sql-async-search-api", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-async-sql-search-api.html", "name": "sql.get_async", "request": { "name": "Request", @@ -9110,8 +9118,14 @@ } }, "description": "Get the async SQL search status.\nGet the current status of an async SQL search or a stored synchronous SQL search.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-async-sql-search-status-api.html", + "docId": "sql-async-status-api", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-async-sql-search-status-api.html", "name": "sql.get_async_status", + "privileges": { + "cluster": [ + "monitor" + ] + }, "request": { "name": "Request", "namespace": "sql.get_async_status" @@ -9145,8 +9159,14 @@ } }, "description": "Get SQL search results.\nRun an SQL request.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/sql-search-api.html", + "docId": "sql-search-api", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-search-api.html", "name": "sql.query", + "privileges": { + "index": [ + "read" + ] + }, "request": { "name": "Request", "namespace": "sql.query" @@ -9183,9 +9203,15 @@ "stability": "stable" } }, - "description": "Translate SQL into Elasticsearch queries.\nTranslate an SQL search into a search API request containing Query DSL.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/current/sql-translate-api.html", + "description": "Translate SQL into Elasticsearch queries.\nTranslate an SQL search into a search API request containing Query DSL.\nIt accepts the same request body parameters as the SQL search API, excluding `cursor`.", + "docId": "sql-translate-api", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-translate-api.html", "name": "sql.translate", + "privileges": { + "index": [ + "read" + ] + }, "request": { "name": "Request", "namespace": "sql.translate" @@ -9222,9 +9248,15 @@ "stability": "stable" } }, - "description": "Delete a synonym set.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-synonyms-set.html", + "description": "Delete a synonym set.\n\nYou can only delete a synonyms set that is not in use by any index analyzer.\n\nSynonyms sets can be used in synonym graph token filters and synonym token filters.\nThese synonym filters can be used as part of search analyzers.\n\nAnalyzers need to be loaded when an index is restored (such as when a node starts, or the index becomes open).\nEven if the analyzer is not used on any field mapping, it still needs to be loaded on the index recovery phase.\n\nIf any analyzers cannot be loaded, the index becomes unavailable and the cluster status becomes red or yellow as index shards are not available.\nTo prevent that, synonyms sets that are used in analyzers can't be deleted.\nA delete request in this case will return a 400 response code.\n\nTo remove a synonyms set, you must first remove all indices that contain analyzers using it.\nYou can migrate an index by creating a new index that does not contain the token filter with the synonyms set, and use the reindex API in order to copy over the index data.\nOnce finished, you can delete the index.\nWhen the synonyms set is not used in analyzers, you will be able to delete it.", + "docId": "synonym-set-delete", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-synonyms-set.html", "name": "synonyms.delete_synonym", + "privileges": { + "cluster": [ + "manage_search_synonyms" + ] + }, "request": { "name": "Request", "namespace": "synonyms.delete_synonym" @@ -9258,8 +9290,14 @@ } }, "description": "Delete a synonym rule.\nDelete a synonym rule from a synonym set.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/delete-synonym-rule.html", + "docId": "synonym-rule-delete", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/delete-synonym-rule.html", "name": "synonyms.delete_synonym_rule", + "privileges": { + "cluster": [ + "manage_search_synonyms" + ] + }, "request": { "name": "Request", "namespace": "synonyms.delete_synonym_rule" @@ -9296,8 +9334,14 @@ } }, "description": "Get a synonym set.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-synonyms-set.html", + "docId": "synonym-set-get", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-synonyms-set.html", "name": "synonyms.get_synonym", + "privileges": { + "cluster": [ + "manage_search_synonyms" + ] + }, "request": { "name": "Request", "namespace": "synonyms.get_synonym" @@ -9331,8 +9375,14 @@ } }, "description": "Get a synonym rule.\nGet a synonym rule from a synonym set.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/get-synonym-rule.html", + "docId": "synonym-rule-get", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-synonym-rule.html", "name": "synonyms.get_synonym_rule", + "privileges": { + "cluster": [ + "manage_search_synonyms" + ] + }, "request": { "name": "Request", "namespace": "synonyms.get_synonym_rule" @@ -9369,8 +9419,14 @@ } }, "description": "Get all synonym sets.\nGet a summary of all defined synonym sets.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/list-synonyms-sets.html", + "docId": "synonym-set-list", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/get-synonyms-set.html", "name": "synonyms.get_synonyms_sets", + "privileges": { + "cluster": [ + "manage_search_synonyms" + ] + }, "request": { "name": "Request", "namespace": "synonyms.get_synonyms_sets" @@ -9403,9 +9459,15 @@ "stability": "stable" } }, - "description": "Create or update a synonym set.\nSynonyms sets are limited to a maximum of 10,000 synonym rules per set.\nIf you need to manage more synonym rules, you can create multiple synonym sets.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/put-synonyms-set.html", + "description": "Create or update a synonym set.\nSynonyms sets are limited to a maximum of 10,000 synonym rules per set.\nIf you need to manage more synonym rules, you can create multiple synonym sets.\n\nWhen an existing synonyms set is updated, the search analyzers that use the synonyms set are reloaded automatically for all indices.\nThis is equivalent to invoking the reload search analyzers API for all indices that use the synonyms set.", + "docId": "synonym-set-create", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/put-synonyms-set.html", "name": "synonyms.put_synonym", + "privileges": { + "cluster": [ + "manage_search_synonyms" + ] + }, "request": { "name": "Request", "namespace": "synonyms.put_synonym" @@ -9441,9 +9503,15 @@ "stability": "stable" } }, - "description": "Create or update a synonym rule.\nCreate or update a synonym rule in a synonym set.", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/master/put-synonym-rule.html", + "description": "Create or update a synonym rule.\nCreate or update a synonym rule in a synonym set.\n\nIf any of the synonym rules included is invalid, the API returns an error.\n\nWhen you update a synonym rule, all analyzers using the synonyms set will be reloaded automatically to reflect the new rule.", + "docId": "synonym-rule-create", + "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/put-synonym-rule.html", "name": "synonyms.put_synonym_rule", + "privileges": { + "cluster": [ + "manage_search_synonyms" + ] + }, "request": { "name": "Request", "namespace": "synonyms.put_synonym_rule" @@ -40836,7 +40904,7 @@ }, "path": [], "query": [], - "specLocation": "sql/clear_cursor/ClearSqlCursorRequest.ts#L22-L35" + "specLocation": "sql/clear_cursor/ClearSqlCursorRequest.ts#L22-L36" }, { "body": { @@ -40869,7 +40937,7 @@ "body": { "kind": "no_body" }, - "description": "Delete an async SQL search.\nDelete an async SQL search or a stored synchronous SQL search.\nIf the search is still running, the API cancels it.", + "description": "Delete an async SQL search.\nDelete an async SQL search or a stored synchronous SQL search.\nIf the search is still running, the API cancels it.\n\nIf the Elasticsearch security features are enabled, only the following users can use this API to delete a search:\n\n* Users with the `cancel_task` cluster privilege.\n* The user who first submitted the search.", "inherits": { "type": { "name": "RequestBase", @@ -40883,7 +40951,7 @@ }, "path": [ { - "description": "Identifier for the search.", + "description": "The identifier for the search.", "name": "id", "required": true, "type": { @@ -40896,7 +40964,7 @@ } ], "query": [], - "specLocation": "sql/delete_async/SqlDeleteAsyncRequest.ts#L23-L38" + "specLocation": "sql/delete_async/SqlDeleteAsyncRequest.ts#L23-L45" }, { "body": { @@ -40923,7 +40991,7 @@ "body": { "kind": "no_body" }, - "description": "Get async SQL search results.\nGet the current status and available results for an async SQL search or stored synchronous SQL search.", + "description": "Get async SQL search results.\nGet the current status and available results for an async SQL search or stored synchronous SQL search.\n\nIf the Elasticsearch security features are enabled, only the user who first submitted the SQL search can retrieve the search using this API.", "inherits": { "type": { "name": "RequestBase", @@ -40937,7 +41005,7 @@ }, "path": [ { - "description": "Identifier for the search.", + "description": "The identifier for the search.", "name": "id", "required": true, "type": { @@ -40951,7 +41019,7 @@ ], "query": [ { - "description": "Separator for CSV results. The API only supports this parameter for CSV responses.", + "description": "The separator for CSV results.\nThe API supports this parameter only for CSV responses.", "name": "delimiter", "required": false, "serverDefault": ",", @@ -40964,7 +41032,7 @@ } }, { - "description": "Format for the response. You must specify a format using this parameter or the\nAccept HTTP header. If you specify both, the API uses this parameter.", + "description": "The format for the response.\nYou must specify a format using this parameter or the `Accept` HTTP header.\nIf you specify both, the API uses this parameter.", "name": "format", "required": false, "type": { @@ -40976,7 +41044,7 @@ } }, { - "description": "Retention period for the search and its results. Defaults\nto the `keep_alive` period for the original SQL search.", + "description": "The retention period for the search and its results.\nIt defaults to the `keep_alive` period for the original SQL search.", "name": "keep_alive", "required": false, "type": { @@ -40988,7 +41056,7 @@ } }, { - "description": "Period to wait for complete results. Defaults to no timeout,\nmeaning the request waits for complete search results.", + "description": "The period to wait for complete results.\nIt defaults to no timeout, meaning the request waits for complete search results.", "name": "wait_for_completion_timeout", "required": false, "type": { @@ -41000,14 +41068,14 @@ } } ], - "specLocation": "sql/get_async/SqlGetAsyncRequest.ts#L24-L60" + "specLocation": "sql/get_async/SqlGetAsyncRequest.ts#L24-L65" }, { "body": { "kind": "properties", "properties": [ { - "description": "Identifier for the search. This value is only returned for async and saved\nsynchronous searches. For CSV, TSV, and TXT responses, this value is returned\nin the `Async-ID` HTTP header.", + "description": "Identifier for the search.\nThis value is returned only for async and saved synchronous searches.\nFor CSV, TSV, and TXT responses, this value is returned in the `Async-ID` HTTP header.", "name": "id", "required": true, "type": { @@ -41019,7 +41087,7 @@ } }, { - "description": "If `true`, the search is still running. If false, the search has finished.\nThis value is only returned for async and saved synchronous searches. For\nCSV, TSV, and TXT responses, this value is returned in the `Async-partial`\nHTTP header.", + "description": "If `true`, the search is still running.\nIf `false`, the search has finished.\nThis value is returned only for async and saved synchronous searches.\nFor CSV, TSV, and TXT responses, this value is returned in the `Async-partial` HTTP header.", "name": "is_running", "required": true, "type": { @@ -41031,7 +41099,7 @@ } }, { - "description": "If `true`, the response does not contain complete search results. If `is_partial`\nis `true` and `is_running` is `true`, the search is still running. If `is_partial`\nis `true` but `is_running` is `false`, the results are partial due to a failure or\ntimeout. This value is only returned for async and saved synchronous searches.\nFor CSV, TSV, and TXT responses, this value is returned in the `Async-partial` HTTP header.", + "description": "If `true`, the response does not contain complete search results.\nIf `is_partial` is `true` and `is_running` is `true`, the search is still running.\nIf `is_partial` is `true` but `is_running` is `false`, the results are partial due to a failure or timeout.\nThis value is returned only for async and saved synchronous searches.\nFor CSV, TSV, and TXT responses, this value is returned in the `Async-partial` HTTP header.", "name": "is_partial", "required": true, "type": { @@ -41058,7 +41126,7 @@ } }, { - "description": "Cursor for the next set of paginated results. For CSV, TSV, and\nTXT responses, this value is returned in the `Cursor` HTTP header.", + "description": "The cursor for the next set of paginated results.\nFor CSV, TSV, and TXT responses, this value is returned in the `Cursor` HTTP header.", "name": "cursor", "required": false, "type": { @@ -41070,7 +41138,7 @@ } }, { - "description": "Values for the search results.", + "description": "The values for the search results.", "name": "rows", "required": true, "type": { @@ -41114,7 +41182,7 @@ }, "path": [ { - "description": "Identifier for the search.", + "description": "The identifier for the search.", "name": "id", "required": true, "type": { @@ -41127,39 +41195,48 @@ } ], "query": [], - "specLocation": "sql/get_async_status/SqlGetAsyncStatusRequest.ts#L23-L37" + "specLocation": "sql/get_async_status/SqlGetAsyncStatusRequest.ts#L23-L39" }, { "body": { "kind": "properties", "properties": [ { - "description": "Identifier for the search.", - "name": "id", + "description": "The timestamp, in milliseconds since the Unix epoch, when Elasticsearch will delete the search and its results, even if the search is still running.", + "name": "expiration_time_in_millis", "required": true, "type": { + "generics": [ + { + "kind": "instance_of", + "type": { + "name": "UnitMillis", + "namespace": "_types" + } + } + ], "kind": "instance_of", "type": { - "name": "string", - "namespace": "_builtins" + "name": "EpochTime", + "namespace": "_types" } } }, { - "description": "If `true`, the search is still running. If `false`, the search has finished.", - "name": "is_running", + "description": "The identifier for the search.", + "name": "id", "required": true, "type": { "kind": "instance_of", "type": { - "name": "boolean", + "name": "string", "namespace": "_builtins" } } }, { - "description": "If `true`, the response does not contain complete search results. If `is_partial`\nis `true` and `is_running` is `true`, the search is still running. If `is_partial`\nis `true` but `is_running` is `false`, the results are partial due to a failure or\ntimeout.", - "name": "is_partial", + "description": "If `true`, the search is still running.\nIf `false`, the search has finished.", + "name": "is_running", "required": true, "type": { "kind": "instance_of", @@ -41170,29 +41247,20 @@ } }, { - "description": "Timestamp, in milliseconds since the Unix epoch, when the search started.\nThe API only returns this property for running searches.", - "name": "start_time_in_millis", + "description": "If `true`, the response does not contain complete search results.\nIf `is_partial` is `true` and `is_running` is `true`, the search is still running.\nIf `is_partial` is `true` but `is_running` is `false`, the results are partial due to a failure or timeout.", + "name": "is_partial", "required": true, "type": { - "generics": [ - { - "kind": "instance_of", - "type": { - "name": "UnitMillis", - "namespace": "_types" - } - } - ], "kind": "instance_of", "type": { - "name": "EpochTime", - "namespace": "_types" + "name": "boolean", + "namespace": "_builtins" } } }, { - "description": "Timestamp, in milliseconds since the Unix epoch, when Elasticsearch will delete\nthe search and its results, even if the search is still running.", - "name": "expiration_time_in_millis", + "description": "The timestamp, in milliseconds since the Unix epoch, when the search started.\nThe API returns this property only for running searches.", + "name": "start_time_in_millis", "required": true, "type": { "generics": [ @@ -41212,7 +41280,7 @@ } }, { - "description": "HTTP status code for the search. The API only returns this property for completed searches.", + "description": "The HTTP status code for the search.\nThe API returns this property only for completed searches.", "name": "completion_status", "required": false, "type": { @@ -41240,7 +41308,20 @@ "kind": "properties", "properties": [ { - "description": "Default catalog (cluster) for queries. If unspecified, the queries execute on the data in the local cluster only.", + "description": "If `true`, the response has partial results when there are shard request timeouts or shard failures.\nIf `false`, the API returns an error with no partial results.", + "name": "allow_partial_search_results", + "required": false, + "serverDefault": false, + "type": { + "kind": "instance_of", + "type": { + "name": "boolean", + "namespace": "_builtins" + } + } + }, + { + "description": "The default catalog (cluster) for queries.\nIf unspecified, the queries execute on the data in the local cluster only.", "name": "catalog", "required": false, "type": { @@ -41252,7 +41333,9 @@ } }, { - "description": "If true, the results in a columnar fashion: one row represents all the values of a certain column from the current page of results.", + "description": "If `true`, the results are in a columnar fashion: one row represents all the values of a certain column from the current page of results.\nThe API supports this parameter only for CBOR, JSON, SMILE, and YAML responses.", + "extDocId": "sql-rest-columnar", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-rest-columnar.html", "name": "columnar", "required": false, "serverDefault": false, @@ -41265,7 +41348,7 @@ } }, { - "description": "Cursor used to retrieve a set of paginated results.\nIf you specify a cursor, the API only uses the `columnar` and `time_zone` request body parameters.\nIt ignores other request body parameters.", + "description": "The cursor used to retrieve a set of paginated results.\nIf you specify a cursor, the API only uses the `columnar` and `time_zone` request body parameters.\nIt ignores other request body parameters.", "name": "cursor", "required": false, "type": { @@ -41277,7 +41360,7 @@ } }, { - "description": "The maximum number of rows (or entries) to return in one response", + "description": "The maximum number of rows (or entries) to return in one response.", "name": "fetch_size", "required": false, "serverDefault": 1000, @@ -41290,75 +41373,62 @@ } }, { - "description": "Elasticsearch query DSL for additional filtering.", - "docId": "sql-rest-filtering", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-rest-filtering.html", - "name": "filter", - "required": false, - "serverDefault": "none", - "type": { - "kind": "instance_of", - "type": { - "name": "QueryContainer", - "namespace": "_types.query_dsl" - } - } - }, - { - "description": "SQL query to run.", - "name": "query", + "description": "If `false`, the API returns an exception when encountering multiple values for a field.\nIf `true`, the API is lenient and returns the first value from the array with no guarantee of consistent results.", + "name": "field_multi_value_leniency", "required": false, + "serverDefault": false, "type": { "kind": "instance_of", "type": { - "name": "string", + "name": "boolean", "namespace": "_builtins" } } }, { - "description": "The timeout before the request fails.", - "name": "request_timeout", + "description": "The Elasticsearch query DSL for additional filtering.", + "extDocId": "sql-rest-filtering", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-rest-filtering.html", + "name": "filter", "required": false, - "serverDefault": "90s", + "serverDefault": "none", "type": { "kind": "instance_of", "type": { - "name": "Duration", - "namespace": "_types" + "name": "QueryContainer", + "namespace": "_types.query_dsl" } } }, { - "description": "The timeout before a pagination request fails.", - "name": "page_timeout", + "description": "If `true`, the search can run on frozen indices.", + "name": "index_using_frozen", "required": false, - "serverDefault": "45s", + "serverDefault": false, "type": { "kind": "instance_of", "type": { - "name": "Duration", - "namespace": "_types" + "name": "boolean", + "namespace": "_builtins" } } }, { - "description": "ISO-8601 time zone ID for the search.", - "docUrl": "https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html", - "name": "time_zone", + "description": "The retention period for an async or saved synchronous search.", + "name": "keep_alive", "required": false, - "serverDefault": "Z", + "serverDefault": "5d", "type": { "kind": "instance_of", "type": { - "name": "TimeZone", + "name": "Duration", "namespace": "_types" } } }, { - "description": "Throw an exception when encountering multiple values for a field (default) or be lenient and return the first value from the list (without any guarantees of what that will be - typically the first in natural ascending order).", - "name": "field_multi_value_leniency", + "description": "If `true`, Elasticsearch stores synchronous searches if you also specify the `wait_for_completion_timeout` parameter.\nIf `false`, Elasticsearch only stores async searches that don't finish before the `wait_for_completion_timeout`.", + "name": "keep_on_completion", "required": false, "serverDefault": false, "type": { @@ -41370,21 +41440,10 @@ } }, { - "description": "Defines one or more runtime fields in the search request. These fields take\nprecedence over mapped fields with the same name.", - "name": "runtime_mappings", - "required": false, - "type": { - "kind": "instance_of", - "type": { - "name": "RuntimeFields", - "namespace": "_types.mapping" - } - } - }, - { - "description": "Period to wait for complete results. Defaults to no timeout, meaning the request waits for complete search results. If the search doesn’t finish within this period, the search becomes async.", - "name": "wait_for_completion_timeout", + "description": "The minimum retention period for the scroll cursor.\nAfter this time period, a pagination request might fail because the scroll cursor is no longer available.\nSubsequent scroll requests prolong the lifetime of the scroll cursor by the duration of `page_timeout` in the scroll request.", + "name": "page_timeout", "required": false, + "serverDefault": "45s", "type": { "kind": "instance_of", "type": { @@ -41394,7 +41453,7 @@ } }, { - "description": "Values for parameters in the query.", + "description": "The values for parameters in the query.", "name": "params", "required": false, "type": { @@ -41413,10 +41472,24 @@ } }, { - "description": "Retention period for an async or saved synchronous search.", - "name": "keep_alive", + "description": "The SQL query to run.", + "extDocId": "sql-spec", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-spec.html", + "name": "query", "required": false, - "serverDefault": "5d", + "type": { + "kind": "instance_of", + "type": { + "name": "string", + "namespace": "_builtins" + } + } + }, + { + "description": "The timeout before the request fails.", + "name": "request_timeout", + "required": false, + "serverDefault": "90s", "type": { "kind": "instance_of", "type": { @@ -41426,28 +41499,41 @@ } }, { - "description": "If true, Elasticsearch stores synchronous searches if you also specify the wait_for_completion_timeout parameter. If false, Elasticsearch only stores async searches that don’t finish before the wait_for_completion_timeout.", - "name": "keep_on_completion", + "description": "One or more runtime fields for the search request.\nThese fields take precedence over mapped fields with the same name.", + "name": "runtime_mappings", "required": false, - "serverDefault": false, "type": { "kind": "instance_of", "type": { - "name": "boolean", - "namespace": "_builtins" + "name": "RuntimeFields", + "namespace": "_types.mapping" } } }, { - "description": "If true, the search can run on frozen indices. Defaults to false.", - "name": "index_using_frozen", + "description": "The ISO-8601 time zone ID for the search.", + "extDocId": "time-zone-id", + "extDocUrl": "https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html", + "name": "time_zone", "required": false, - "serverDefault": false, + "serverDefault": "Z", "type": { "kind": "instance_of", "type": { - "name": "boolean", - "namespace": "_builtins" + "name": "TimeZone", + "namespace": "_types" + } + } + }, + { + "description": "The period to wait for complete results.\nIt defaults to no timeout, meaning the request waits for complete search results.\nIf the search doesn't finish within this period, the search becomes async.\n\nTo save a synchronous search, you must specify this parameter and the `keep_on_completion` parameter.", + "name": "wait_for_completion_timeout", + "required": false, + "type": { + "kind": "instance_of", + "type": { + "name": "Duration", + "namespace": "_types" } } } @@ -41468,9 +41554,9 @@ "path": [], "query": [ { - "description": "Format for the response.", - "docId": "sql-rest-format", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-rest-format.html", + "description": "The format for the response.\nYou can also specify a format using the `Accept` HTTP header.\nIf you specify both this parameter and the `Accept` HTTP header, this parameter takes precedence.", + "extDocId": "sql-rest-format", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-rest-format.html", "name": "format", "required": false, "type": { @@ -41482,77 +41568,77 @@ } } ], - "specLocation": "sql/query/QuerySqlRequest.ts#L28-L124" + "specLocation": "sql/query/QuerySqlRequest.ts#L28-L146" }, { "body": { "kind": "properties", "properties": [ { - "description": "Identifier for the search. This value is only returned for async and saved\nsynchronous searches. For CSV, TSV, and TXT responses, this value is returned\nin the `Async-ID` HTTP header.", - "name": "id", + "description": "Column headings for the search results. Each object is a column.", + "name": "columns", "required": false, "type": { - "kind": "instance_of", - "type": { - "name": "Id", - "namespace": "_types" + "kind": "array_of", + "value": { + "kind": "instance_of", + "type": { + "name": "Column", + "namespace": "sql" + } } } }, { - "description": "If `true`, the search is still running. If false, the search has finished.\nThis value is only returned for async and saved synchronous searches. For\nCSV, TSV, and TXT responses, this value is returned in the `Async-partial`\nHTTP header.", - "name": "is_running", + "description": "The cursor for the next set of paginated results.\nFor CSV, TSV, and TXT responses, this value is returned in the `Cursor` HTTP header.", + "name": "cursor", "required": false, "type": { "kind": "instance_of", "type": { - "name": "boolean", + "name": "string", "namespace": "_builtins" } } }, { - "description": "If `true`, the response does not contain complete search results. If `is_partial`\nis `true` and `is_running` is `true`, the search is still running. If `is_partial`\nis `true` but `is_running` is `false`, the results are partial due to a failure or\ntimeout. This value is only returned for async and saved synchronous searches.\nFor CSV, TSV, and TXT responses, this value is returned in the `Async-partial` HTTP header.", - "name": "is_partial", + "description": "The identifier for the search.\nThis value is returned only for async and saved synchronous searches.\nFor CSV, TSV, and TXT responses, this value is returned in the `Async-ID` HTTP header.", + "name": "id", "required": false, "type": { "kind": "instance_of", "type": { - "name": "boolean", - "namespace": "_builtins" + "name": "Id", + "namespace": "_types" } } }, { - "description": "Column headings for the search results. Each object is a column.", - "name": "columns", + "description": "If `true`, the search is still running.\nIf `false`, the search has finished.\nThis value is returned only for async and saved synchronous searches.\nFor CSV, TSV, and TXT responses, this value is returned in the `Async-partial` HTTP header.", + "name": "is_running", "required": false, "type": { - "kind": "array_of", - "value": { - "kind": "instance_of", - "type": { - "name": "Column", - "namespace": "sql" - } + "kind": "instance_of", + "type": { + "name": "boolean", + "namespace": "_builtins" } } }, { - "description": "Cursor for the next set of paginated results. For CSV, TSV, and\nTXT responses, this value is returned in the `Cursor` HTTP header.", - "name": "cursor", + "description": "If `true`, the response does not contain complete search results.\nIf `is_partial` is `true` and `is_running` is `true`, the search is still running.\nIf `is_partial` is `true` but `is_running` is `false`, the results are partial due to a failure or timeout.\nThis value is returned only for async and saved synchronous searches.\nFor CSV, TSV, and TXT responses, this value is returned in the `Async-partial` HTTP header.", + "name": "is_partial", "required": false, "type": { "kind": "instance_of", "type": { - "name": "string", + "name": "boolean", "namespace": "_builtins" } } }, { - "description": "Values for the search results.", + "description": "The values for the search results.", "name": "rows", "required": true, "type": { @@ -41596,9 +41682,9 @@ } }, { - "description": "Elasticsearch query DSL for additional filtering.", - "docId": "sql-rest-filtering", - "docUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-rest-filtering.html", + "description": "The Elasticsearch query DSL for additional filtering.", + "extDocId": "sql-rest-filtering", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/sql-rest-filtering.html", "name": "filter", "required": false, "serverDefault": "none", @@ -41611,7 +41697,7 @@ } }, { - "description": "SQL query to run.", + "description": "The SQL query to run.", "name": "query", "required": true, "type": { @@ -41623,8 +41709,9 @@ } }, { - "description": "ISO-8601 time zone ID for the search.", - "docUrl": "https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html", + "description": "The ISO-8601 time zone ID for the search.", + "extDocId": "time-zone-id", + "extDocUrl": "https://docs.oracle.com/javase/8/docs/api/java/time/ZoneId.html", "name": "time_zone", "required": false, "serverDefault": "Z", @@ -41638,7 +41725,7 @@ } ] }, - "description": "Translate SQL into Elasticsearch queries.\nTranslate an SQL search into a search API request containing Query DSL.", + "description": "Translate SQL into Elasticsearch queries.\nTranslate an SQL search into a search API request containing Query DSL.\nIt accepts the same request body parameters as the SQL search API, excluding `cursor`.", "inherits": { "type": { "name": "RequestBase", @@ -41652,7 +41739,7 @@ }, "path": [], "query": [], - "specLocation": "sql/translate/TranslateSqlRequest.ts#L25-L56" + "specLocation": "sql/translate/TranslateSqlRequest.ts#L25-L59" }, { "body": { @@ -41754,7 +41841,7 @@ "body": { "kind": "no_body" }, - "description": "Delete a synonym set.", + "description": "Delete a synonym set.\n\nYou can only delete a synonyms set that is not in use by any index analyzer.\n\nSynonyms sets can be used in synonym graph token filters and synonym token filters.\nThese synonym filters can be used as part of search analyzers.\n\nAnalyzers need to be loaded when an index is restored (such as when a node starts, or the index becomes open).\nEven if the analyzer is not used on any field mapping, it still needs to be loaded on the index recovery phase.\n\nIf any analyzers cannot be loaded, the index becomes unavailable and the cluster status becomes red or yellow as index shards are not available.\nTo prevent that, synonyms sets that are used in analyzers can't be deleted.\nA delete request in this case will return a 400 response code.\n\nTo remove a synonyms set, you must first remove all indices that contain analyzers using it.\nYou can migrate an index by creating a new index that does not contain the token filter with the synonyms set, and use the reindex API in order to copy over the index data.\nOnce finished, you can delete the index.\nWhen the synonyms set is not used in analyzers, you will be able to delete it.", "inherits": { "type": { "name": "RequestBase", @@ -41768,7 +41855,7 @@ }, "path": [ { - "description": "The id of the synonyms set to be deleted", + "description": "The synonyms set identifier to delete.", "name": "id", "required": true, "type": { @@ -41781,7 +41868,7 @@ } ], "query": [], - "specLocation": "synonyms/delete_synonym/SynonymsDeleteRequest.ts#L22-L35" + "specLocation": "synonyms/delete_synonym/SynonymsDeleteRequest.ts#L22-L54" }, { "body": { @@ -41822,7 +41909,7 @@ }, "path": [ { - "description": "The id of the synonym set to be updated", + "description": "The ID of the synonym set to update.", "name": "set_id", "required": true, "type": { @@ -41834,7 +41921,7 @@ } }, { - "description": "The id of the synonym rule to be deleted", + "description": "The ID of the synonym rule to delete.", "name": "rule_id", "required": true, "type": { @@ -41847,7 +41934,7 @@ } ], "query": [], - "specLocation": "synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts#L22-L41" + "specLocation": "synonyms/delete_synonym_rule/SynonymRuleDeleteRequest.ts#L22-L42" }, { "body": { @@ -41888,7 +41975,7 @@ }, "path": [ { - "description": "\"The id of the synonyms set to be retrieved", + "description": "The synonyms set identifier to retrieve.", "name": "id", "required": true, "type": { @@ -41902,7 +41989,7 @@ ], "query": [ { - "description": "Starting offset for query rules to be retrieved", + "description": "The starting offset for query rules to retrieve.", "name": "from", "required": false, "serverDefault": 0, @@ -41915,7 +42002,7 @@ } }, { - "description": "specifies a max number of query rules to retrieve", + "description": "The max number of query rules to retrieve.", "name": "size", "required": false, "serverDefault": 10, @@ -41928,13 +42015,14 @@ } } ], - "specLocation": "synonyms/get_synonym/SynonymsGetRequest.ts#L23-L48" + "specLocation": "synonyms/get_synonym/SynonymsGetRequest.ts#L23-L50" }, { "body": { "kind": "properties", "properties": [ { + "description": "The total number of synonyms rules that the synonyms set contains.", "name": "count", "required": true, "type": { @@ -41946,6 +42034,7 @@ } }, { + "description": "Synonym rule details.", "name": "synonyms_set", "required": true, "type": { @@ -41966,7 +42055,7 @@ "name": "Response", "namespace": "synonyms.get_synonym" }, - "specLocation": "synonyms/get_synonym/SynonymsGetResponse.ts#L23-L28" + "specLocation": "synonyms/get_synonym/SynonymsGetResponse.ts#L23-L34" }, { "attachedBehaviors": [ @@ -41989,7 +42078,7 @@ }, "path": [ { - "description": "The id of the synonym set to retrieve the synonym rule from", + "description": "The ID of the synonym set to retrieve the synonym rule from.", "name": "set_id", "required": true, "type": { @@ -42001,7 +42090,7 @@ } }, { - "description": "The id of the synonym rule to retrieve", + "description": "The ID of the synonym rule to retrieve.", "name": "rule_id", "required": true, "type": { @@ -42014,7 +42103,7 @@ } ], "query": [], - "specLocation": "synonyms/get_synonym_rule/SynonymRuleGetRequest.ts#L22-L41" + "specLocation": "synonyms/get_synonym_rule/SynonymRuleGetRequest.ts#L22-L42" }, { "body": { @@ -42056,7 +42145,7 @@ "path": [], "query": [ { - "description": "Starting offset", + "description": "The starting offset for synonyms sets to retrieve.", "name": "from", "required": false, "serverDefault": 0, @@ -42069,7 +42158,7 @@ } }, { - "description": "specifies a max number of results to get", + "description": "The maximum number of synonyms sets to retrieve.", "name": "size", "required": false, "serverDefault": 10, @@ -42082,13 +42171,14 @@ } } ], - "specLocation": "synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts#L22-L42" + "specLocation": "synonyms/get_synonyms_sets/SynonymsSetsGetRequest.ts#L22-L44" }, { "body": { "kind": "properties", "properties": [ { + "description": "The total number of synonyms sets defined.", "name": "count", "required": true, "type": { @@ -42100,6 +42190,7 @@ } }, { + "description": "The identifier and total number of defined synonym rules for each synonyms set.", "name": "results", "required": true, "type": { @@ -42120,7 +42211,7 @@ "name": "Response", "namespace": "synonyms.get_synonyms_sets" }, - "specLocation": "synonyms/get_synonyms_sets/SynonymsSetsGetResponse.ts#L23-L28" + "specLocation": "synonyms/get_synonyms_sets/SynonymsSetsGetResponse.ts#L23-L34" }, { "attachedBehaviors": [ @@ -42130,7 +42221,7 @@ "kind": "properties", "properties": [ { - "description": "The synonym set information to update", + "description": "The synonym rules definitions for the synonyms set.", "name": "synonyms_set", "required": true, "type": { @@ -42158,7 +42249,7 @@ } ] }, - "description": "Create or update a synonym set.\nSynonyms sets are limited to a maximum of 10,000 synonym rules per set.\nIf you need to manage more synonym rules, you can create multiple synonym sets.", + "description": "Create or update a synonym set.\nSynonyms sets are limited to a maximum of 10,000 synonym rules per set.\nIf you need to manage more synonym rules, you can create multiple synonym sets.\n\nWhen an existing synonyms set is updated, the search analyzers that use the synonyms set are reloaded automatically for all indices.\nThis is equivalent to invoking the reload search analyzers API for all indices that use the synonyms set.", "inherits": { "type": { "name": "RequestBase", @@ -42172,7 +42263,7 @@ }, "path": [ { - "description": "The id of the synonyms set to be created or updated", + "description": "The ID of the synonyms set to be created or updated.", "name": "id", "required": true, "type": { @@ -42185,7 +42276,7 @@ } ], "query": [], - "specLocation": "synonyms/put_synonym/SynonymsPutRequest.ts#L23-L44" + "specLocation": "synonyms/put_synonym/SynonymsPutRequest.ts#L23-L49" }, { "body": { @@ -42230,6 +42321,9 @@ "kind": "properties", "properties": [ { + "description": "The synonym rule information definition, which must be in Solr format.", + "extDocId": "synonym-set-define", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/analysis-synonym-graph-tokenfilter.html#analysis-synonym-graph-define-synonyms", "name": "synonyms", "required": true, "type": { @@ -42242,7 +42336,7 @@ } ] }, - "description": "Create or update a synonym rule.\nCreate or update a synonym rule in a synonym set.", + "description": "Create or update a synonym rule.\nCreate or update a synonym rule in a synonym set.\n\nIf any of the synonym rules included is invalid, the API returns an error.\n\nWhen you update a synonym rule, all analyzers using the synonyms set will be reloaded automatically to reflect the new rule.", "inherits": { "type": { "name": "RequestBase", @@ -42256,7 +42350,7 @@ }, "path": [ { - "description": "The id of the synonym set to be updated with the synonym rule", + "description": "The ID of the synonym set.", "name": "set_id", "required": true, "type": { @@ -42268,7 +42362,7 @@ } }, { - "description": "The id of the synonym rule to be updated or created", + "description": "The ID of the synonym rule to be updated or created.", "name": "rule_id", "required": true, "type": { @@ -42281,7 +42375,7 @@ } ], "query": [], - "specLocation": "synonyms/put_synonym_rule/SynonymRulePutRequest.ts#L23-L48" + "specLocation": "synonyms/put_synonym_rule/SynonymRulePutRequest.ts#L23-L54" }, { "body": { @@ -105405,7 +105499,7 @@ "name": "SqlFormat", "namespace": "sql.query" }, - "specLocation": "sql/query/QuerySqlRequest.ts#L126-L134" + "specLocation": "sql/query/QuerySqlRequest.ts#L148-L156" }, { "kind": "type_alias", @@ -106502,7 +106596,7 @@ "name": "WatcherMetric", "namespace": "watcher.stats" }, - "specLocation": "watcher/stats/types.ts#L42-L48" + "specLocation": "watcher/stats/types.ts#L63-L69" }, { "kind": "enum", @@ -106543,7 +106637,7 @@ "name": "XPackCategory", "namespace": "xpack.info" }, - "specLocation": "xpack/info/XPackInfoRequest.ts#L49-L53" + "specLocation": "xpack/info/XPackInfoRequest.ts#L52-L56" }, { "attachedBehaviors": [ @@ -142722,7 +142816,7 @@ }, "properties": [ { - "description": "Update operation result", + "description": "The update operation result.", "name": "result", "required": true, "type": { @@ -142734,7 +142828,7 @@ } }, { - "description": "Updating synonyms in a synonym set reloads the associated analyzers.\nThis is the analyzers reloading result", + "description": "Updating synonyms in a synonym set reloads the associated analyzers.\nThis information is the analyzers reloading result.", "name": "reload_analyzers_details", "required": true, "type": { @@ -142873,6 +142967,8 @@ }, { "description": "Synonyms, in Solr format, that conform the synonym rule. See https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-synonym-graph-tokenfilter.html#_solr_synonyms_2", + "extDocId": "synonym-set-define", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/analysis-synonym-graph-tokenfilter.html#analysis-synonym-graph-define-synonyms", "name": "synonyms", "required": true, "type": { @@ -142884,7 +142980,7 @@ } } ], - "specLocation": "synonyms/_types/SynonymRule.ts#L38-L47" + "specLocation": "synonyms/_types/SynonymRule.ts#L40-L49" }, { "kind": "interface", @@ -142894,7 +142990,7 @@ }, "properties": [ { - "description": "Synonym Rule identifier", + "description": "The identifier for the synonym rule.\nIf you do not specify a synonym rule ID when you create a rule, an identifier is created automatically by Elasticsearch.", "name": "id", "required": false, "type": { @@ -142906,7 +143002,9 @@ } }, { - "description": "Synonyms, in Solr format, that conform the synonym rule. See https://www.elastic.co/guide/en/elasticsearch/reference/current/analysis-synonym-graph-tokenfilter.html#_solr_synonyms_2", + "description": "The synonyms that conform the synonym rule in Solr format.", + "extDocId": "synonym-set-define", + "extDocUrl": "https://www.elastic.co/guide/en/elasticsearch/reference/{branch}/analysis-synonym-graph-tokenfilter.html#analysis-synonym-graph-define-synonyms", "name": "synonyms", "required": true, "type": { @@ -142918,7 +143016,7 @@ } } ], - "specLocation": "synonyms/_types/SynonymRule.ts#L26-L35" + "specLocation": "synonyms/_types/SynonymRule.ts#L26-L37" }, { "kind": "interface", @@ -142952,7 +143050,7 @@ } } ], - "specLocation": "synonyms/get_synonyms_sets/SynonymsSetsGetResponse.ts#L30-L39" + "specLocation": "synonyms/get_synonyms_sets/SynonymsSetsGetResponse.ts#L36-L45" }, { "kind": "interface", diff --git a/output/schema/schema.json b/output/schema/schema.json index b736c6a952..6f99848a08 100644 --- a/output/schema/schema.json +++ b/output/schema/schema.json @@ -210224,7 +210224,7 @@ } }, { - "description": "If `false`, the API returns an exception when encountering multiple values for a field.\nIf `true`, the API is lenient and returns the API returns the first value from the array with no guarantee of consistent results.", + "description": "If `false`, the API returns an exception when encountering multiple values for a field.\nIf `true`, the API is lenient and returns the first value from the array with no guarantee of consistent results.", "name": "field_multi_value_leniency", "required": false, "serverDefault": false, @@ -222460,10 +222460,6 @@ "namespace": "watcher.start" }, "path": [], -<<<<<<< HEAD - "query": [], - "specLocation": "watcher/start/WatcherStartRequest.ts#L22-L30" -======= "query": [ { "description": "Period to wait for a connection to the master node.", @@ -222479,8 +222475,7 @@ } } ], - "specLocation": "watcher/start/WatcherStartRequest.ts#L23-L38" ->>>>>>> b6a68ae73 (Fix common query parameters (#3297)) + "specLocation": "watcher/start/WatcherStartRequest.ts#L23-L39" }, { "kind": "response", @@ -222907,11 +222902,7 @@ "path": [], "query": [ { -<<<<<<< HEAD "description": "The period to wait for the master node.\nIf the master node is not available before the timeout expires, the request fails and returns an error.\nTo indicate that the request should never timeout, set it to `-1`.", -======= - "description": "Period to wait for a connection to the master node.", ->>>>>>> b6a68ae73 (Fix common query parameters (#3297)) "name": "master_timeout", "required": false, "serverDefault": "30s", @@ -222924,11 +222915,7 @@ } } ], -<<<<<<< HEAD "specLocation": "watcher/stop/WatcherStopRequest.ts#L23-L41" -======= - "specLocation": "watcher/stop/WatcherStopRequest.ts#L23-L38" ->>>>>>> b6a68ae73 (Fix common query parameters (#3297)) }, { "kind": "response", diff --git a/output/schema/validation-errors.json b/output/schema/validation-errors.json index cea5dcdd99..812768b77e 100644 --- a/output/schema/validation-errors.json +++ b/output/schema/validation-errors.json @@ -525,24 +525,6 @@ "interface definition watcher._types:TriggerEventContainer - Property schedule is a single-variant and must be required" ] }, -<<<<<<< HEAD - "watcher.start": { - "request": [ - "Request: missing json spec query parameter 'master_timeout'" -======= - "watcher.get_settings": { - "request": [ - "Missing request & response" - ], - "response": [] - }, - "watcher.update_settings": { - "request": [ - "Missing request & response" ->>>>>>> b6a68ae73 (Fix common query parameters (#3297)) - ], - "response": [] - }, "xpack.info": { "request": [ "Request: query parameter 'human' does not exist in the json spec",