From 4815fe8903ef6ff6a75529e51a542e98346be5a0 Mon Sep 17 00:00:00 2001 From: Xtansia <1222964+Xtansia@users.noreply.github.com> Date: Mon, 6 Jan 2025 00:28:28 +0000 Subject: [PATCH] Re-generate client code using latest OpenSearch API specification (2025-01-06) Signed-off-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com> --- src/ApiGenerator/opensearch-openapi.yaml | 9240 +++++++++++------ .../_Generated/Descriptors.Cat.cs | 340 +- .../_Generated/Descriptors.Cluster.cs | 4 + .../_Generated/Requests.Cat.cs | 338 +- .../_Generated/Requests.Cluster.cs | 7 + src/OpenSearch.Net/_Generated/Api/Enums.cs | 43 +- .../RequestParameters.AsynchronousSearch.cs | 16 +- .../RequestParameters.Cat.cs | 360 +- .../RequestParameters.Cluster.cs | 7 + .../RequestParameters.Indices.cs | 22 +- .../RequestParameters/RequestParameters.Ml.cs | 62 + .../RequestParameters.NoNamespace.cs | 2 +- .../RequestParameters/RequestParameters.Sm.cs | 166 + .../_Generated/IOpenSearchLowLevelClient.cs | 24 +- .../OpenSearchLowLevelClient.Cat.cs | 16 +- .../OpenSearchLowLevelClient.Indices.cs | 8 + .../_Generated/OpenSearchLowLevelClient.Ml.cs | 298 + .../OpenSearchLowLevelClient.Observability.cs | 4 +- .../_Generated/OpenSearchLowLevelClient.Sm.cs | 356 + .../_Generated/OpenSearchLowLevelClient.cs | 31 +- 20 files changed, 7382 insertions(+), 3962 deletions(-) create mode 100644 src/OpenSearch.Net/_Generated/Api/RequestParameters/RequestParameters.Sm.cs create mode 100644 src/OpenSearch.Net/_Generated/OpenSearchLowLevelClient.Sm.cs diff --git a/src/ApiGenerator/opensearch-openapi.yaml b/src/ApiGenerator/opensearch-openapi.yaml index e7a7660fbc..88aade3443 100644 --- a/src/ApiGenerator/opensearch-openapi.yaml +++ b/src/ApiGenerator/opensearch-openapi.yaml @@ -449,7 +449,7 @@ paths: operationId: cat.aliases.0 x-operation-group: cat.aliases x-version-added: '1.0' - description: Shows information about currently configured aliases to indexes including filter and routing info. + description: Shows information about aliases currently configured to indexes, including filter and routing information. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-aliases/ parameters: @@ -473,7 +473,7 @@ paths: operationId: cat.aliases.1 x-operation-group: cat.aliases x-version-added: '1.0' - description: Shows information about currently configured aliases to indexes including filter and routing info. + description: Shows information about aliases currently configured to indexes, including filter and routing information. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-aliases/ parameters: @@ -576,7 +576,7 @@ paths: operationId: cat.count.0 x-operation-group: cat.count x-version-added: '1.0' - description: Provides quick access to the document count of the entire cluster, or individual indexes. + description: Provides quick access to the document count of the entire cluster or of an individual index. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-count/ parameters: @@ -598,7 +598,7 @@ paths: operationId: cat.count.1 x-operation-group: cat.count x-version-added: '1.0' - description: Provides quick access to the document count of the entire cluster, or individual indexes. + description: Provides quick access to the document count of the entire cluster or of an individual index. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-count/ parameters: @@ -694,7 +694,7 @@ paths: operationId: cat.indices.0 x-operation-group: cat.indices x-version-added: '1.0' - description: 'Returns information about indexes: number of primaries and replicas, document counts, disk size, ...' + description: Lists information related to indexes, that is, how much disk space they are using, how many shards they have, their health status, and so on. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-indices/ parameters: @@ -725,7 +725,7 @@ paths: operationId: cat.indices.1 x-operation-group: cat.indices x-version-added: '1.0' - description: 'Returns information about indexes: number of primaries and replicas, document counts, disk size, ...' + description: Lists information related to indexes, that is, how much disk space they are using, how many shards they have, their health status, and so on. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-indices/ parameters: @@ -813,7 +813,7 @@ paths: operationId: cat.nodes.0 x-operation-group: cat.nodes x-version-added: '1.0' - description: Returns basic statistics about performance of cluster nodes. + description: Returns basic statistics about the performance of cluster nodes. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-nodes/ parameters: @@ -841,7 +841,7 @@ paths: operationId: cat.pending_tasks.0 x-operation-group: cat.pending_tasks x-version-added: '1.0' - description: Returns a concise representation of the cluster pending tasks. + description: Returns a concise representation of the cluster's pending tasks. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-pending-tasks/ parameters: @@ -867,7 +867,7 @@ paths: operationId: cat.pit_segments.0 x-operation-group: cat.pit_segments x-version-added: '2.4' - description: List segments for one or several PITs. + description: Lists one or several CAT point-in-time segments. externalDocs: url: https://opensearch.org/docs/latest/search-plugins/point-in-time-api/ parameters: @@ -892,7 +892,7 @@ paths: operationId: cat.all_pit_segments.0 x-operation-group: cat.all_pit_segments x-version-added: '2.4' - description: Lists all active point-in-time segments. + description: Lists all active CAT point-in-time segments. externalDocs: url: https://opensearch.org/docs/latest/search-plugins/point-in-time-api/ parameters: @@ -915,7 +915,7 @@ paths: operationId: cat.plugins.0 x-operation-group: cat.plugins x-version-added: '1.0' - description: Returns information about installed plugins across nodes node. + description: Returns information about the names, components, and versions of the installed plugins. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-plugins/ parameters: @@ -940,7 +940,7 @@ paths: operationId: cat.recovery.0 x-operation-group: cat.recovery x-version-added: '1.0' - description: Returns information about index shard recoveries, both on-going completed. + description: Returns all completed and ongoing index and shard recoveries. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-plugins/ parameters: @@ -967,7 +967,7 @@ paths: operationId: cat.recovery.1 x-operation-group: cat.recovery x-version-added: '1.0' - description: Returns information about index shard recoveries, both on-going completed. + description: Returns all completed and ongoing index and shard recoveries. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-plugins/ parameters: @@ -995,7 +995,7 @@ paths: operationId: cat.repositories.0 x-operation-group: cat.repositories x-version-added: '1.0' - description: Returns information about snapshot repositories registered in the cluster. + description: Returns information about all snapshot repositories for a cluster. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-repositories/ parameters: @@ -1020,7 +1020,9 @@ paths: operationId: cat.segment_replication.0 x-operation-group: cat.segment_replication x-version-added: '2.6' - description: Returns information about both on-going and latest completed Segment Replication events. + description: |- + Returns information about active and last-completed segment replication events on each replica shard, including related shard-level metrics. + These metrics provide information about how far behind the primary shard the replicas are lagging. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-segment-replication/ parameters: @@ -1054,7 +1056,9 @@ paths: operationId: cat.segment_replication.1 x-operation-group: cat.segment_replication x-version-added: '2.6' - description: Returns information about both on-going and latest completed Segment Replication events. + description: |- + Returns information about active and last-completed segment replication events on each replica shard, including related shard-level metrics. + These metrics provide information about how far behind the primary shard the replicas are lagging. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-segment-replication/ parameters: @@ -1140,7 +1144,7 @@ paths: operationId: cat.shards.0 x-operation-group: cat.shards x-version-added: '1.0' - description: Provides a detailed view of shard allocation on nodes. + description: Lists the states of all primary and replica shards and how they are distributed. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-shards/ parameters: @@ -1167,7 +1171,7 @@ paths: operationId: cat.shards.1 x-operation-group: cat.shards x-version-added: '1.0' - description: Provides a detailed view of shard allocation on nodes. + description: Lists the states of all primary and replica shards and how they are distributed. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-shards/ parameters: @@ -1195,7 +1199,7 @@ paths: operationId: cat.snapshots.0 x-operation-group: cat.snapshots x-version-added: '1.0' - description: Returns all snapshots in a specific repository. + description: Lists all of the snapshots stored in a specific repository. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-snapshots/ parameters: @@ -1205,6 +1209,7 @@ paths: - $ref: '#/components/parameters/cat.snapshots___query.help' - $ref: '#/components/parameters/cat.snapshots___query.ignore_unavailable' - $ref: '#/components/parameters/cat.snapshots___query.master_timeout' + - $ref: '#/components/parameters/cat.snapshots___query.repository' - $ref: '#/components/parameters/cat.snapshots___query.s' - $ref: '#/components/parameters/cat.snapshots___query.time' - $ref: '#/components/parameters/cat.snapshots___query.v' @@ -1221,7 +1226,7 @@ paths: operationId: cat.snapshots.1 x-operation-group: cat.snapshots x-version-added: '1.0' - description: Returns all snapshots in a specific repository. + description: Lists all of the snapshots stored in a specific repository. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-snapshots/ parameters: @@ -1232,6 +1237,7 @@ paths: - $ref: '#/components/parameters/cat.snapshots___query.help' - $ref: '#/components/parameters/cat.snapshots___query.ignore_unavailable' - $ref: '#/components/parameters/cat.snapshots___query.master_timeout' + - $ref: '#/components/parameters/cat.snapshots___query.repository' - $ref: '#/components/parameters/cat.snapshots___query.s' - $ref: '#/components/parameters/cat.snapshots___query.time' - $ref: '#/components/parameters/cat.snapshots___query.v' @@ -1248,7 +1254,7 @@ paths: operationId: cat.tasks.0 x-operation-group: cat.tasks x-version-added: '1.0' - description: Returns information about the tasks currently executing on one or more nodes in the cluster. + description: Lists the progress of all tasks currently running on the cluster. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-tasks/ parameters: @@ -1275,7 +1281,7 @@ paths: operationId: cat.templates.0 x-operation-group: cat.templates x-version-added: '1.0' - description: Returns information about existing templates. + description: Lists the names, patterns, order numbers, and version numbers of index templates. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-templates/ parameters: @@ -1300,7 +1306,7 @@ paths: operationId: cat.templates.1 x-operation-group: cat.templates x-version-added: '1.0' - description: Returns information about existing templates. + description: Lists the names, patterns, order numbers, and version numbers of index templates. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-templates/ parameters: @@ -1328,7 +1334,7 @@ paths: x-version-added: '1.0' description: |- Returns cluster-wide thread pool statistics per node. - By default the active, queue and rejected statistics are returned for all thread pools. + By default the active, queued, and rejected statistics are returned for all thread pools. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-thread-pool/ parameters: @@ -1356,7 +1362,7 @@ paths: x-version-added: '1.0' description: |- Returns cluster-wide thread pool statistics per node. - By default the active, queue and rejected statistics are returned for all thread pools. + By default the active, queued, and rejected statistics are returned for all thread pools. externalDocs: url: https://opensearch.org/docs/latest/api-reference/cat/cat-thread-pool/ parameters: @@ -1947,6 +1953,7 @@ paths: url: https://opensearch.org/docs/latest parameters: - $ref: '#/components/parameters/cluster.get_component_template___query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.get_component_template___query.flat_settings' - $ref: '#/components/parameters/cluster.get_component_template___query.local' - $ref: '#/components/parameters/cluster.get_component_template___query.master_timeout' - $ref: '#/components/parameters/_global___query.pretty' @@ -1988,6 +1995,7 @@ paths: parameters: - $ref: '#/components/parameters/cluster.get_component_template___path.name' - $ref: '#/components/parameters/cluster.get_component_template___query.cluster_manager_timeout' + - $ref: '#/components/parameters/cluster.get_component_template___query.flat_settings' - $ref: '#/components/parameters/cluster.get_component_template___query.local' - $ref: '#/components/parameters/cluster.get_component_template___query.master_timeout' - $ref: '#/components/parameters/_global___query.pretty' @@ -2486,9 +2494,7 @@ paths: url: https://opensearch.org/docs/latest parameters: - $ref: '#/components/parameters/indices.simulate_index_template___path.name' - - $ref: '#/components/parameters/indices.simulate_index_template___query.cause' - $ref: '#/components/parameters/indices.simulate_index_template___query.cluster_manager_timeout' - - $ref: '#/components/parameters/indices.simulate_index_template___query.create' - $ref: '#/components/parameters/indices.simulate_index_template___query.master_timeout' - $ref: '#/components/parameters/_global___query.pretty' - $ref: '#/components/parameters/_global___query.human' @@ -4629,6 +4635,58 @@ paths: responses: '200': $ref: '#/components/responses/knn.warmup___200' + /_plugins/_ml/_predict/{algorithm_name}/{model_id}: + post: + operationId: ml.predict.0 + x-operation-group: ml.predict + description: Predicts new data with trained model. + parameters: + - $ref: '#/components/parameters/ml.predict___path.algorithm_name' + - $ref: '#/components/parameters/ml.predict___path.model_id' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/ml.predict' + responses: + '200': + $ref: '#/components/responses/ml.predict___200' + /_plugins/_ml/_train_predict/{algorithm_name}: + post: + operationId: ml.train_predict.0 + x-operation-group: ml.train_predict + description: Trains a model and predicts against the same training dataset. + parameters: + - $ref: '#/components/parameters/ml.train_predict___path.algorithm_name' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/ml.train_predict' + responses: + '200': + $ref: '#/components/responses/ml.train_predict___200' + /_plugins/_ml/_train/{algorithm_name}: + post: + operationId: ml.train.0 + x-operation-group: ml.train + description: Trains a model synchronously. + parameters: + - $ref: '#/components/parameters/ml.train___path.algorithm_name' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/ml.train' + responses: + '200': + $ref: '#/components/responses/ml.train___200' /_plugins/_ml/agents/_register: post: operationId: ml.register_agents.0 @@ -4676,6 +4734,39 @@ paths: - $ref: '#/components/parameters/_global___query.error_trace' - $ref: '#/components/parameters/_global___query.source' - $ref: '#/components/parameters/_global___query.filter_path' + /_plugins/_ml/connectors/_search: + get: + operationId: ml.search_connectors.0 + x-operation-group: ml.search_connectors + x-version-added: '2.11' + description: Searches for standalone connectors. + requestBody: + $ref: '#/components/requestBodies/ml.search_connectors' + responses: + '200': + $ref: '#/components/responses/ml.search_connectors___200' + parameters: + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + post: + operationId: ml.search_connectors.1 + x-operation-group: ml.search_connectors + x-version-added: '2.11' + description: Searches for standalone connectors. + requestBody: + $ref: '#/components/requestBodies/ml.search_connectors' + responses: + '200': + $ref: '#/components/responses/ml.search_connectors___200' + parameters: + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' /_plugins/_ml/connectors/{connector_id}: delete: operationId: ml.delete_connector.0 @@ -4691,6 +4782,38 @@ paths: responses: '200': $ref: '#/components/responses/ml.delete_connector___200' + get: + operationId: ml.get_connector.0 + x-operation-group: ml.get_connector + x-version-added: '2.11' + description: Retrieves a standalone connector. + parameters: + - $ref: '#/components/parameters/ml.get_connector___path.connector_id' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + responses: + '200': + $ref: '#/components/responses/ml.get_connector___200' + put: + operationId: ml.update_connector.0 + x-operation-group: ml.update_connector + x-version-added: '2.12' + description: Updates a standalone connector. + parameters: + - $ref: '#/components/parameters/ml.update_connector___path.connector_id' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/ml.update_connector' + responses: + '200': + $ref: '#/components/responses/ml.update_connector___200' /_plugins/_ml/model_groups/_register: post: operationId: ml.register_model_group.0 @@ -4707,6 +4830,39 @@ paths: - $ref: '#/components/parameters/_global___query.error_trace' - $ref: '#/components/parameters/_global___query.source' - $ref: '#/components/parameters/_global___query.filter_path' + /_plugins/_ml/model_groups/_search: + get: + operationId: ml.search_model_group.0 + x-operation-group: ml.search_model_group + x-version-added: '2.9' + description: Searches for model groups. + requestBody: + $ref: '#/components/requestBodies/ml.search_model_group' + responses: + '200': + $ref: '#/components/responses/ml.search_model_group___200' + parameters: + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + post: + operationId: ml.search_model_group.1 + x-operation-group: ml.search_model_group + x-version-added: '2.9' + description: Searches for model groups. + requestBody: + $ref: '#/components/requestBodies/ml.search_model_group' + responses: + '200': + $ref: '#/components/responses/ml.search_model_group___200' + parameters: + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' /_plugins/_ml/model_groups/{model_group_id}: delete: operationId: ml.delete_model_group.0 @@ -4736,6 +4892,23 @@ paths: responses: '200': $ref: '#/components/responses/ml.get_model_group___200' + put: + operationId: ml.update_model_group.0 + x-operation-group: ml.update_model_group + x-version-added: '2.9' + description: Updates a model group. + parameters: + - $ref: '#/components/parameters/ml.update_model_group___path.model_group_id' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/ml.update_model_group' + responses: + '200': + $ref: '#/components/responses/ml.update_model_group___200' /_plugins/_ml/models/_register: post: operationId: ml.register_model.0 @@ -5065,8 +5238,8 @@ paths: get: operationId: observability.get_localstats.0 x-operation-group: observability.get_localstats - x-version-added: '1.1' - description: Retrieves Local Stats of all observability objects. + x-version-added: '2.5' + description: Retrieves local stats of all observability objects. responses: '200': $ref: '#/components/responses/observability.get_localstats___200' @@ -5630,8 +5803,8 @@ paths: externalDocs: url: https://opensearch.org/docs/latest/im-plugin/index-rollups/rollup-api/#create-or-update-an-index-rollup-job responses: - '200': - $ref: '#/components/responses/rollups.put___200' + '201': + $ref: '#/components/responses/rollups.put___201' parameters: - $ref: '#/components/parameters/rollups.put___path.id' - $ref: '#/components/parameters/rollups.put___query.if_primary_term' @@ -6521,6 +6694,8 @@ paths: responses: '200': $ref: '#/components/responses/security.update_distinguished_name___200' + '201': + $ref: '#/components/responses/security.update_distinguished_name___201' '400': $ref: '#/components/responses/security.update_distinguished_name___400' '403': @@ -7473,6 +7648,149 @@ paths: - $ref: '#/components/parameters/_global___query.error_trace' - $ref: '#/components/parameters/_global___query.source' - $ref: '#/components/parameters/_global___query.filter_path' + /_plugins/_sm/policies: + get: + operationId: sm.get_policies.0 + x-operation-group: sm.get_policies + x-version-added: '2.1' + description: Retrieves all snapshot management policies with optional pagination and filtering. + parameters: + - $ref: '#/components/parameters/sm.get_policies___query.from' + - $ref: '#/components/parameters/sm.get_policies___query.queryString' + - $ref: '#/components/parameters/sm.get_policies___query.size' + - $ref: '#/components/parameters/sm.get_policies___query.sortField' + - $ref: '#/components/parameters/sm.get_policies___query.sortOrder' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + responses: + '200': + $ref: '#/components/responses/sm.get_policies___200' + /_plugins/_sm/policies/{policy_name}: + delete: + operationId: sm.delete_policy.0 + x-operation-group: sm.delete_policy + x-version-added: '2.1' + description: Deletes a snapshot management policy. + parameters: + - $ref: '#/components/parameters/sm.delete_policy___path.policy_name' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + responses: + '200': + $ref: '#/components/responses/sm.delete_policy___200' + '404': + $ref: '#/components/responses/sm.delete_policy___404' + get: + operationId: sm.get_policy.0 + x-operation-group: sm.get_policy + x-version-added: '2.1' + description: Retrieves a specific snapshot management policy by name. + parameters: + - $ref: '#/components/parameters/sm.get_policy___path.policy_name' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + responses: + '200': + $ref: '#/components/responses/sm.get_policy___200' + '404': + $ref: '#/components/responses/sm.get_policy___404' + post: + operationId: sm.create_policy.0 + x-operation-group: sm.create_policy + x-version-added: '2.1' + description: Creates a snapshot management policy. + parameters: + - $ref: '#/components/parameters/sm.create_policy___path.policy_name' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/sm.create_policy' + responses: + '201': + $ref: '#/components/responses/sm.create_policy___201' + '400': + $ref: '#/components/responses/sm.create_policy___400' + put: + operationId: sm.update_policy.0 + x-operation-group: sm.update_policy + x-version-added: '2.1' + description: Updates an existing snapshot management policy. Requires `if_seq_no` and `if_primary_term`. + parameters: + - $ref: '#/components/parameters/sm.update_policy___path.policy_name' + - $ref: '#/components/parameters/sm.update_policy___query.if_primary_term' + - $ref: '#/components/parameters/sm.update_policy___query.if_seq_no' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/sm.update_policy' + responses: + '200': + $ref: '#/components/responses/sm.update_policy___200' + '404': + $ref: '#/components/responses/sm.update_policy___404' + /_plugins/_sm/policies/{policy_name}/_explain: + get: + operationId: sm.explain_policy.0 + x-operation-group: sm.explain_policy + x-version-added: '2.1' + description: Explains the state of the snapshot management policy. + parameters: + - $ref: '#/components/parameters/sm.explain_policy___path.policy_name' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + responses: + '200': + $ref: '#/components/responses/sm.explain_policy___200' + /_plugins/_sm/policies/{policy_name}/_start: + post: + operationId: sm.start_policy.0 + x-operation-group: sm.start_policy + x-version-added: '2.1' + description: Starts a snapshot management policy. + parameters: + - $ref: '#/components/parameters/sm.start_policy___path.policy_name' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + responses: + '200': + $ref: '#/components/responses/sm.start_policy___200' + /_plugins/_sm/policies/{policy_name}/_stop: + post: + operationId: sm.stop_policy.0 + x-operation-group: sm.stop_policy + x-version-added: '2.1' + description: Stops a snapshot management policy. + parameters: + - $ref: '#/components/parameters/sm.stop_policy___path.policy_name' + - $ref: '#/components/parameters/_global___query.pretty' + - $ref: '#/components/parameters/_global___query.human' + - $ref: '#/components/parameters/_global___query.error_trace' + - $ref: '#/components/parameters/_global___query.source' + - $ref: '#/components/parameters/_global___query.filter_path' + responses: + '200': + $ref: '#/components/responses/sm.stop_policy___200' /_plugins/_sql: post: operationId: sql.query.0 @@ -7672,6 +7990,8 @@ paths: responses: '200': $ref: '#/components/responses/transforms.put___200' + '201': + $ref: '#/components/responses/transforms.put___201' /_plugins/_transform/{id}/_explain: get: operationId: transforms.explain.0 @@ -7864,7 +8184,7 @@ paths: operationId: reindex_rethrottle.0 x-operation-group: reindex_rethrottle x-version-added: '1.0' - description: Changes the number of requests per second for a particular Reindex operation. + description: Changes the number of requests per second for a particular reindex operation. externalDocs: url: https://opensearch.org/docs/latest parameters: @@ -8374,6 +8694,8 @@ paths: - $ref: '#/components/parameters/_global___query.error_trace' - $ref: '#/components/parameters/_global___query.source' - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/search_shards' responses: '200': $ref: '#/components/responses/search_shards___200' @@ -8396,6 +8718,8 @@ paths: - $ref: '#/components/parameters/_global___query.error_trace' - $ref: '#/components/parameters/_global___query.source' - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/search_shards' responses: '200': $ref: '#/components/responses/search_shards___200' @@ -8541,6 +8865,8 @@ paths: responses: '200': $ref: '#/components/responses/clear_scroll___200' + '404': + $ref: '#/components/responses/clear_scroll___404' get: operationId: scroll.0 x-operation-group: scroll @@ -8606,6 +8932,8 @@ paths: responses: '200': $ref: '#/components/responses/clear_scroll___200' + '404': + $ref: '#/components/responses/clear_scroll___404' get: operationId: scroll.2 x-operation-group: scroll @@ -9487,6 +9815,7 @@ paths: operationId: indices.get_upgrade.0 x-operation-group: indices.get_upgrade x-version-added: '1.0' + x-version-deprecated: '1.0' description: The `_upgrade` API is no longer useful and will be removed. externalDocs: url: https://opensearch.org/docs/latest @@ -9506,6 +9835,7 @@ paths: operationId: indices.upgrade.0 x-operation-group: indices.upgrade x-version-added: '1.0' + x-version-deprecated: '1.0' description: The `_upgrade` API is no longer useful and will be removed. externalDocs: url: https://opensearch.org/docs/latest @@ -11534,6 +11864,8 @@ paths: - $ref: '#/components/parameters/_global___query.error_trace' - $ref: '#/components/parameters/_global___query.source' - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/search_shards' responses: '200': $ref: '#/components/responses/search_shards___200' @@ -11557,6 +11889,8 @@ paths: - $ref: '#/components/parameters/_global___query.error_trace' - $ref: '#/components/parameters/_global___query.source' - $ref: '#/components/parameters/_global___query.filter_path' + requestBody: + $ref: '#/components/requestBodies/search_shards' responses: '200': $ref: '#/components/responses/search_shards___200' @@ -12217,6 +12551,7 @@ paths: operationId: indices.get_upgrade.1 x-operation-group: indices.get_upgrade x-version-added: '1.0' + x-version-deprecated: '1.0' description: The `_upgrade` API is no longer useful and will be removed. externalDocs: url: https://opensearch.org/docs/latest @@ -12237,6 +12572,7 @@ paths: operationId: indices.upgrade.1 x-operation-group: indices.upgrade x-version-added: '1.0' + x-version-deprecated: '1.0' description: The `_upgrade` API is no longer useful and will be removed. externalDocs: url: https://opensearch.org/docs/latest @@ -12969,8 +13305,8 @@ paths: externalDocs: url: https://opensearch.org/docs/latest/im-plugin/index-rollups/rollup-api/#create-or-update-an-index-rollup-job responses: - '200': - $ref: '#/components/responses/rollups.put___200' + '201': + $ref: '#/components/responses/rollups.put___201' parameters: - $ref: '#/components/parameters/rollups.put___path.id' - $ref: '#/components/parameters/rollups.put___query.if_primary_term' @@ -13883,6 +14219,8 @@ paths: responses: '200': $ref: '#/components/responses/security.update_distinguished_name___200' + '201': + $ref: '#/components/responses/security.update_distinguished_name___201' '400': $ref: '#/components/responses/security.update_distinguished_name___400' '403': @@ -14803,11 +15141,7 @@ components: in: query description: Used to reduce the response. This parameter takes a comma-separated list of filters. It supports using wildcards to match any field or part of a field’s name. You can also exclude fields with "-". schema: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' x-global: true asynchronous_search.delete___path.id: name: id @@ -14824,13 +15158,13 @@ components: asynchronous_search.search___query.index: name: index in: query - description: The name of the index to be searched. + description: The name of the index to be searched. Can be an individual name, a comma-separated list of indexes, or a wildcard expression of index names. schema: type: string asynchronous_search.search___query.keep_alive: name: keep_alive in: query - description: The amount of time that the result is saved in the cluster. + description: The amount of time that the result is saved in the cluster. For example, `2d` means that the results are stored in the cluster for 48 hours. The saved search results are deleted after this period or if the search is canceled. Note that this includes the query execution time. If the query overruns this time, the process cancels this query automatically. schema: type: string asynchronous_search.search___query.keep_on_completion: @@ -14842,7 +15176,7 @@ components: asynchronous_search.search___query.wait_for_completion_timeout: name: wait_for_completion_timeout in: query - description: The amount of time that you plan to wait for the results. + description: The amount of time that you plan to wait for the results. You can poll the remaining results based on an ID. The maximum value is `300s`. Default is `1s`. schema: type: string bulk_stream___path.index: @@ -15045,86 +15379,86 @@ components: cat.aliases___query.expand_wildcards: in: query name: expand_wildcards - description: Whether to expand wildcard expression to concrete indexes that are open, closed or both. + description: Expands wildcard expressions to concrete indexes. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. schema: $ref: '#/components/schemas/_common___ExpandWildcards' style: form cat.aliases___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.aliases___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.aliases___query.help: name: help in: query - description: Return help information. + description: Returns help information. schema: - description: Return help information. + description: Returns help information. type: boolean default: false cat.aliases___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Whether to return information from the local node only instead of from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Whether to return information from the local node only instead of from the cluster manager node. cat.aliases___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.aliases___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.all_pit_segments___query.bytes: name: bytes in: query - description: The unit in which to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' cat.all_pit_segments___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.all_pit_segments___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.all_pit_segments___query.help: name: help @@ -15137,26 +15471,26 @@ components: cat.all_pit_segments___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.all_pit_segments___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.allocation___path.node_id: in: path name: node_id - description: Comma-separated list of node identifiers or names used to limit the returned information. + description: A comma-separated list of node IDs or names used to limit the returned information. required: true schema: $ref: '#/components/schemas/_common___NodeIds' @@ -15164,55 +15498,55 @@ components: cat.allocation___query.bytes: in: query name: bytes - description: The unit used to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' style: form cat.allocation___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: A timeout for connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.allocation___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the HTTP `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the HTTP `Accept` header, such as `json` or `yaml`. cat.allocation___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.allocation___query.help: name: help in: query - description: Return help information. + description: Returns help information. schema: type: boolean default: false - description: Return help information. + description: Returns help information. cat.allocation___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from cluster-manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from cluster-manager node. cat.allocation___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: A timeout for connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -15221,46 +15555,46 @@ components: cat.allocation___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.allocation___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.cluster_manager___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: A timeout for connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.cluster_manager___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the HTTP `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the HTTP `Accept` header, such as `json` or `yaml`. cat.cluster_manager___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.cluster_manager___query.help: name: help @@ -15273,15 +15607,15 @@ components: cat.cluster_manager___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.cluster_manager___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: A timeout for connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -15290,22 +15624,22 @@ components: cat.cluster_manager___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.cluster_manager___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.count___path.index: in: path name: index @@ -15319,20 +15653,20 @@ components: cat.count___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.count___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.count___query.help: name: help @@ -15345,27 +15679,27 @@ components: cat.count___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.count___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.fielddata___path.fields: in: path name: fields description: |- - Comma-separated list of fields used to limit returned information. + A comma-separated list of fields used to limit the amount of returned information. To retrieve all fields, omit this parameter. required: true schema: @@ -15374,34 +15708,34 @@ components: cat.fielddata___query.bytes: in: query name: bytes - description: The unit used to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' style: form cat.fielddata___query.fields: in: query name: fields - description: Comma-separated list of fields used to limit returned information. + description: A comma-separated list of fields used to limit the amount of returned information. schema: $ref: '#/components/schemas/_common___Fields' style: form cat.fielddata___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.fielddata___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.fielddata___query.help: name: help @@ -15414,39 +15748,39 @@ components: cat.fielddata___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.fielddata___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.health___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.health___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.health___query.help: name: help @@ -15459,13 +15793,13 @@ components: cat.health___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.health___query.time: in: query @@ -15477,7 +15811,7 @@ components: cat.health___query.ts: in: query name: ts - description: If `true`, returns `HH:MM:SS` and Unix epoch timestamps. + description: When `true`, returns `HH:MM:SS` and Unix epoch timestamps. schema: type: boolean default: true @@ -15485,16 +15819,16 @@ components: cat.health___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.indices___path.index: in: path name: index description: |- - Comma-separated list of data streams, indexes, and aliases used to limit the request. + A comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. required: true schema: @@ -15503,14 +15837,14 @@ components: cat.indices___query.bytes: in: query name: bytes - description: The unit used to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' style: form cat.indices___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' @@ -15524,25 +15858,25 @@ components: cat.indices___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.indices___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.indices___query.health: in: query name: health - description: The health status used to limit returned indexes. By default, the response includes indexes of any health status. + description: Limits indexes based on their health status. Supported values are `green`, `yellow`, and `red`. schema: $ref: '#/components/schemas/_common___HealthStatus' style: form @@ -15557,7 +15891,7 @@ components: cat.indices___query.include_unloaded_segments: in: query name: include_unloaded_segments - description: If `true`, the response includes information from segments that are not loaded into memory. + description: Whether to include information from segments not loaded into memory. schema: type: boolean default: false @@ -15565,15 +15899,15 @@ components: cat.indices___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.indices___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -15582,7 +15916,7 @@ components: cat.indices___query.pri: in: query name: pri - description: If `true`, the response only includes information from primary shards. + description: When `true`, returns information only from the primary shards. schema: type: boolean default: false @@ -15590,53 +15924,53 @@ components: cat.indices___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.indices___query.time: in: query name: time - description: The unit used to display time values. + description: Specifies the time units. schema: $ref: '#/components/schemas/_common___TimeUnit' style: form cat.indices___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.master___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.master___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.master___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.master___query.help: name: help @@ -15649,15 +15983,15 @@ components: cat.master___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.master___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -15666,46 +16000,46 @@ components: cat.master___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.master___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.nodeattrs___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.nodeattrs___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.nodeattrs___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.nodeattrs___query.help: name: help @@ -15718,15 +16052,15 @@ components: cat.nodeattrs___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.nodeattrs___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -15735,47 +16069,47 @@ components: cat.nodeattrs___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.nodeattrs___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.nodes___query.bytes: in: query name: bytes - description: The unit used to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' style: form cat.nodes___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.nodes___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.nodes___query.full_id: in: query name: full_id - description: If `true`, return the full node ID. If `false`, return the shortened node ID. + description: When `true`, returns the full node ID. When `false`, returns the shortened node ID. schema: anyOf: - type: boolean @@ -15785,13 +16119,13 @@ components: cat.nodes___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.nodes___query.help: name: help @@ -15804,18 +16138,18 @@ components: cat.nodes___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. deprecated: true x-version-deprecated: '1.0' x-deprecation-message: This parameter does not cause this API to act locally. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.nodes___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -15824,52 +16158,52 @@ components: cat.nodes___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.nodes___query.time: name: time in: query - description: The unit in which to display time values. + description: Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/). schema: $ref: '#/components/schemas/_common___TimeUnit' cat.nodes___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.pending_tasks___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.pending_tasks___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.pending_tasks___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.pending_tasks___query.help: name: help @@ -15882,15 +16216,15 @@ components: cat.pending_tasks___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.pending_tasks___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -15899,51 +16233,51 @@ components: cat.pending_tasks___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.pending_tasks___query.time: name: time in: query - description: The unit in which to display time values. + description: Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/). schema: $ref: '#/components/schemas/_common___TimeUnit' cat.pending_tasks___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.pit_segments___query.bytes: name: bytes in: query - description: The unit in which to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' cat.pit_segments___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.pit_segments___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.pit_segments___query.help: name: help @@ -15956,46 +16290,46 @@ components: cat.pit_segments___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.pit_segments___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.plugins___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.plugins___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.plugins___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.plugins___query.help: name: help @@ -16008,15 +16342,15 @@ components: cat.plugins___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.plugins___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -16025,22 +16359,22 @@ components: cat.plugins___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.plugins___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.recovery___path.index: in: path name: index @@ -16062,14 +16396,14 @@ components: cat.recovery___query.bytes: in: query name: bytes - description: The unit used to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' style: form cat.recovery___query.detailed: in: query name: detailed - description: If `true`, the response includes detailed information about shard recoveries. + description: When `true`, includes detailed information about shard recoveries. schema: type: boolean default: false @@ -16077,20 +16411,20 @@ components: cat.recovery___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.recovery___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.recovery___query.help: name: help @@ -16103,63 +16437,67 @@ components: cat.recovery___query.index: name: index in: query - description: Comma-separated list or wildcard expression of index names to limit the returned information. + description: |- + A comma-separated list of data streams, indexes, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. style: form schema: type: array items: type: string - description: Comma-separated list or wildcard expression of index names to limit the returned information. + description: |- + A comma-separated list of data streams, indexes, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. explode: true cat.recovery___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.recovery___query.time: name: time in: query - description: The unit in which to display time values. + description: Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/). schema: $ref: '#/components/schemas/_common___TimeUnit' cat.recovery___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.repositories___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.repositories___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.repositories___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.repositories___query.help: name: help @@ -16172,15 +16510,15 @@ components: cat.repositories___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.repositories___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -16189,92 +16527,96 @@ components: cat.repositories___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.repositories___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.segment_replication___path.index: name: index in: path - description: Comma-separated list or wildcard expression of index names to limit the returned information. + description: |- + A comma-separated list of data streams, indexes, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. schema: type: array - description: Comma-separated list or wildcard expression of index names to limit the returned information. + description: |- + A comma-separated list of data streams, indexes, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. items: type: string required: true cat.segment_replication___query.active_only: name: active_only in: query - description: If `true`, the response only includes ongoing segment replication events. + description: When `true`, the response only includes ongoing segment replication events. schema: type: boolean default: false - description: If `true`, the response only includes ongoing segment replication events. + description: When `true`, the response only includes ongoing segment replication events. cat.segment_replication___query.allow_no_indices: name: allow_no_indices in: query - description: Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have been specified). + description: Whether to ignore the index if a wildcard index expression resolves to no concrete indexes. This includes the `_all` string or when no indexes have been specified. schema: type: boolean - description: Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have been specified). + description: Whether to ignore the index if a wildcard index expression resolves to no concrete indexes. This includes the `_all` string or when no indexes have been specified. cat.segment_replication___query.bytes: name: bytes in: query - description: The unit in which to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' cat.segment_replication___query.completed_only: name: completed_only in: query - description: If `true`, the response only includes latest completed segment replication events. + description: When `true`, the response only includes the last-completed segment replication events. schema: type: boolean default: false - description: If `true`, the response only includes latest completed segment replication events. + description: When `true`, the response only includes the last-completed segment replication events. cat.segment_replication___query.detailed: name: detailed in: query - description: If `true`, the response includes detailed information about segment replications. + description: When `true`, the response includes additional metrics for each stage of a segment replication event. schema: type: boolean default: false - description: If `true`, the response includes detailed information about segment replications. + description: When `true`, the response includes additional metrics for each stage of a segment replication event. cat.segment_replication___query.expand_wildcards: name: expand_wildcards in: query - description: Whether to expand wildcard expression to concrete indexes that are open, closed or both. + description: Whether to expand the wildcard expression to include concrete indexes that are open, closed, or both. schema: $ref: '#/components/schemas/_common___ExpandWildcards' cat.segment_replication___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.segment_replication___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.segment_replication___query.help: name: help @@ -16287,70 +16629,74 @@ components: cat.segment_replication___query.ignore_throttled: name: ignore_throttled in: query - description: Whether specified concrete, expanded or aliased indexes should be ignored when throttled. + description: Whether specified concrete, expanded, or aliased indexes should be ignored when throttled. schema: type: boolean - description: Whether specified concrete, expanded or aliased indexes should be ignored when throttled. + description: Whether specified concrete, expanded, or aliased indexes should be ignored when throttled. cat.segment_replication___query.ignore_unavailable: name: ignore_unavailable in: query - description: Whether specified concrete indexes should be ignored when unavailable (missing or closed). + description: Whether the specified concrete indexes should be ignored when missing or closed. schema: type: boolean - description: Whether specified concrete indexes should be ignored when unavailable (missing or closed). + description: Whether the specified concrete indexes should be ignored when missing or closed. cat.segment_replication___query.index: name: index in: query - description: Comma-separated list or wildcard expression of index names to limit the returned information. + description: |- + A comma-separated list of data streams, indexes, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. style: form schema: type: array items: type: string - description: Comma-separated list or wildcard expression of index names to limit the returned information. + description: |- + A comma-separated list of data streams, indexes, and aliases used to limit the request. + Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. explode: true cat.segment_replication___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.segment_replication___query.shards: name: shards in: query - description: Comma-separated list of shards to display. + description: A comma-separated list of shards to display. style: form schema: type: array items: type: string - description: Comma-separated list of shards to display. + description: A comma-separated list of shards to display. explode: true cat.segment_replication___query.time: name: time in: query - description: The unit in which to display time values. + description: Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/). schema: $ref: '#/components/schemas/_common___TimeUnit' cat.segment_replication___query.timeout: name: timeout in: query - description: Operation timeout. + description: The operation timeout. schema: $ref: '#/components/schemas/_common___Duration' cat.segment_replication___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.segments___path.index: in: path name: index @@ -16365,47 +16711,47 @@ components: cat.segments___query.bytes: in: query name: bytes - description: The unit used to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' style: form cat.segments___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.segments___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.segments___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.segments___query.help: name: help in: query - description: Return help information. + description: Returns help information. schema: type: boolean default: false - description: Return help information. + description: Returns help information. cat.segments___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -16414,22 +16760,22 @@ components: cat.segments___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.segments___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.shards___path.index: in: path name: index @@ -16444,34 +16790,34 @@ components: cat.shards___query.bytes: in: query name: bytes - description: The unit used to display byte values. + description: The units used to display byte values. schema: $ref: '#/components/schemas/_common___ByteUnit' style: form cat.shards___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.shards___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.shards___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.shards___query.help: name: help @@ -16484,15 +16830,15 @@ components: cat.shards___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.shards___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -16501,28 +16847,28 @@ components: cat.shards___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.shards___query.time: name: time in: query - description: The unit in which to display time values. + description: Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/). schema: $ref: '#/components/schemas/_common___TimeUnit' cat.shards___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.snapshots___path.repository: in: path name: repository @@ -16538,27 +16884,27 @@ components: cat.snapshots___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.snapshots___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.snapshots___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.snapshots___query.help: name: help @@ -16571,7 +16917,7 @@ components: cat.snapshots___query.ignore_unavailable: in: query name: ignore_unavailable - description: If `true`, the response does not include information from unavailable snapshots. + description: When `true`, the response does not include information from unavailable snapshots. schema: type: boolean default: false @@ -16579,41 +16925,52 @@ components: cat.snapshots___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' x-deprecation-message: To promote inclusive language, use `cluster_manager_timeout` instead. deprecated: true + cat.snapshots___query.repository: + in: query + name: repository + description: |- + A comma-separated list of snapshot repositories used to limit the request. + Accepts wildcard expressions. + `_all` returns all repositories. + If any repository fails during the request, OpenSearch returns an error. + required: true + schema: + $ref: '#/components/schemas/_common___Names' cat.snapshots___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.snapshots___query.time: name: time in: query - description: The unit in which to display time values. + description: Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/). schema: $ref: '#/components/schemas/_common___TimeUnit' cat.snapshots___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.tasks___query.actions: in: query name: actions - description: The task action names, which are used to limit the response. + description: The task action names used to limit the response. schema: type: array items: @@ -16630,20 +16987,20 @@ components: cat.tasks___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.tasks___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.tasks___query.help: name: help @@ -16656,14 +17013,17 @@ components: cat.tasks___query.nodes: name: nodes in: query - description: Comma-separated list of node IDs or names to limit the returned information; use `_local` to return information from the node you're connecting to, leave empty to get information from all nodes. + description: |- + A comma-separated list of node IDs or names used to limit the returned information. + Use `_local` to return information from the node to which you're connecting, specify a specific node from which to get information, or keep the parameter empty to get information from all nodes. style: form schema: type: array items: type: string - description: Comma-separated list of node IDs or names to limit the returned information; use `_local` to return information from the node you're connecting to, leave empty to get information from all nodes. - explode: true + description: |- + A comma-separated list of node IDs or names used to limit the returned information. + Use `_local` to return information from the node to which you're connecting, specify a specific node from which to get information, or keep the parameter empty to get information from all nodes. cat.tasks___query.parent_task_id: in: query name: parent_task_id @@ -16674,28 +17034,28 @@ components: cat.tasks___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.tasks___query.time: name: time in: query - description: The unit in which to display time values. + description: Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/). schema: $ref: '#/components/schemas/_common___TimeUnit' cat.tasks___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.templates___path.name: in: path name: name @@ -16709,27 +17069,27 @@ components: cat.templates___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.templates___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.templates___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.templates___query.help: name: help @@ -16742,15 +17102,15 @@ components: cat.templates___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.templates___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -16759,22 +17119,22 @@ components: cat.templates___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.templates___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. cat.thread_pool___path.thread_pool_patterns: in: path name: thread_pool_patterns @@ -16788,27 +17148,27 @@ components: cat.thread_pool___query.cluster_manager_timeout: name: cluster_manager_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: A timeout for connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' cat.thread_pool___query.format: name: format in: query - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. schema: type: string - description: A short version of the Accept header (for example, `json`, `yaml`). + description: A short version of the `Accept` header, such as `json` or `yaml`. cat.thread_pool___query.h: name: h in: query - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. style: form schema: type: array items: type: string - description: Comma-separated list of column names to display. + description: A comma-separated list of column names to display. explode: true cat.thread_pool___query.help: name: help @@ -16821,15 +17181,15 @@ components: cat.thread_pool___query.local: name: local in: query - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. schema: type: boolean default: false - description: Return local information, do not retrieve the state from cluster-manager node. + description: Returns local information but does not retrieve the state from the cluster manager node. cat.thread_pool___query.master_timeout: name: master_timeout in: query - description: Operation timeout for connection to cluster-manager node. + description: The amount of time allowed to establish a connection to the cluster manager node. schema: $ref: '#/components/schemas/_common___Duration' x-version-deprecated: '2.0' @@ -16838,13 +17198,13 @@ components: cat.thread_pool___query.s: name: s in: query - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. style: form schema: type: array items: type: string - description: Comma-separated list of column names or column aliases to sort by. + description: A comma-separated list of column names or column aliases to sort by. explode: true cat.thread_pool___query.size: name: size @@ -16857,11 +17217,11 @@ components: cat.thread_pool___query.v: name: v in: query - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. schema: type: boolean default: false - description: Verbose mode. Display column headers. + description: Enables verbose mode, which displays column headers. clear_scroll___path.scroll_id: in: path name: scroll_id @@ -16998,6 +17358,14 @@ components: schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' + cluster.get_component_template___query.flat_settings: + in: query + name: flat_settings + description: If `true`, returns settings in flat format. + schema: + type: boolean + default: false + style: form cluster.get_component_template___query.local: in: query name: local @@ -19931,7 +20299,8 @@ components: Set this parameter to 1 to merge all segments into one segment. The default behavior is to perform the merge as necessary. schema: - type: number + type: integer + format: int64 style: form indices.forcemerge___query.only_expunge_deletes: in: query @@ -20836,7 +21205,8 @@ components: Templates with lower 'order' values are merged first. Templates with higher 'order' values are merged later, overriding templates with lower values. schema: - type: number + type: integer + format: int32 style: form indices.recovery___path.index: in: path @@ -21074,10 +21444,10 @@ components: description: List of shard health statuses used to limit the request. schema: oneOf: - - $ref: '#/components/schemas/indices.shard_stores___Status' + - $ref: '#/components/schemas/indices.shard_stores___ShardStoreStatus' - type: array items: - $ref: '#/components/schemas/indices.shard_stores___Status' + $ref: '#/components/schemas/indices.shard_stores___ShardStoreStatus' style: form indices.shrink___path.index: in: path @@ -21163,14 +21533,6 @@ components: schema: $ref: '#/components/schemas/_common___Name' style: simple - indices.simulate_index_template___query.cause: - name: cause - in: query - description: User defined reason for dry-run creating the new template for simulation purposes. - schema: - type: string - default: 'false' - description: User defined reason for dry-run creating the new template for simulation purposes. indices.simulate_index_template___query.cluster_manager_timeout: name: cluster_manager_timeout in: query @@ -21178,19 +21540,6 @@ components: schema: $ref: '#/components/schemas/_common___Duration' x-version-added: '2.0' - indices.simulate_index_template___query.create: - in: query - name: create - description: |- - If `true`, the template passed in the body is only used if no existing - templates match the same index patterns. If `false`, the simulation uses - the template with the highest priority. Note that the template is not - permanently added or updated in either case; it is only used for the - simulation. - schema: - type: boolean - default: false - style: form indices.simulate_index_template___query.master_timeout: in: query name: master_timeout @@ -21386,11 +21735,7 @@ components: name: groups description: Comma-separated list of search groups to include in the search statistics. schema: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' style: form indices.stats___query.include_segment_file_sizes: in: query @@ -22265,12 +22610,19 @@ components: - graph_memory_usage_percentage - graph_query_errors - graph_query_requests + - graph_stats - hit_count - indexing_from_model_degraded - indices_in_cache - knn_query_requests + - knn_query_with_filter_requests - load_exception_count - load_success_count + - lucene_initialized + - max_distance_query_requests + - max_distance_query_with_filter_requests + - min_score_query_requests + - min_score_query_with_filter_requests - miss_count - model_index_status - nmslib_initialized @@ -22687,6 +23039,12 @@ components: required: true schema: type: string + ml.get_connector___path.connector_id: + name: connector_id + in: path + required: true + schema: + type: string ml.get_model_group___path.model_group_id: name: model_group_id in: path @@ -22699,12 +23057,48 @@ components: required: true schema: type: string + ml.predict___path.algorithm_name: + name: algorithm_name + in: path + required: true + schema: + type: string + ml.predict___path.model_id: + name: model_id + in: path + required: true + schema: + type: string + ml.train_predict___path.algorithm_name: + name: algorithm_name + in: path + required: true + schema: + type: string + ml.train___path.algorithm_name: + name: algorithm_name + in: path + required: true + schema: + type: string ml.undeploy_model___path.model_id: name: model_id in: path required: true schema: type: string + ml.update_connector___path.connector_id: + name: connector_id + in: path + required: true + schema: + type: string + ml.update_model_group___path.model_group_id: + name: model_group_id + in: path + required: true + schema: + type: string msearch_template___path.index: in: path name: index @@ -24417,11 +24811,7 @@ components: name: sort description: A comma-separated list of : pairs. schema: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' style: form search___query.stats: in: query @@ -24821,6 +25211,103 @@ components: schema: type: boolean required: false + sm.create_policy___path.policy_name: + name: policy_name + in: path + description: The name of the snapshot management policy. + required: true + schema: + type: string + sm.delete_policy___path.policy_name: + name: policy_name + in: path + description: The name of the snapshot management policy. + required: true + schema: + type: string + sm.explain_policy___path.policy_name: + name: policy_name + in: path + description: The name of the snapshot management policy. + required: true + schema: + type: string + sm.get_policies___query.from: + name: from + in: query + description: 'The starting index (default: 0)' + schema: + type: integer + sm.get_policies___query.queryString: + name: queryString + in: query + description: A query string to filter policies. + schema: + type: string + sm.get_policies___query.size: + name: size + in: query + description: The number of policies to return. + schema: + type: integer + sm.get_policies___query.sortField: + name: sortField + in: query + description: The field to sort on. + schema: + type: string + sm.get_policies___query.sortOrder: + name: sortOrder + in: query + description: The order of sorting. + schema: + type: string + enum: + - asc + - desc + default: asc + sm.get_policy___path.policy_name: + name: policy_name + in: path + description: The name of the snapshot management policy. + required: true + schema: + type: string + sm.start_policy___path.policy_name: + name: policy_name + in: path + description: The name of the snapshot management policy. + required: true + schema: + type: string + sm.stop_policy___path.policy_name: + name: policy_name + in: path + description: The name of the snapshot management policy. + required: true + schema: + type: string + sm.update_policy___path.policy_name: + name: policy_name + in: path + description: The name of the snapshot management policy. + required: true + schema: + type: string + sm.update_policy___query.if_primary_term: + name: if_primary_term + in: query + description: The primary term of the policy to update. + required: true + schema: + type: integer + sm.update_policy___query.if_seq_no: + name: if_seq_no + in: query + description: The sequence number of the policy to update. + required: true + schema: + type: integer snapshot.cleanup_repository___path.repository: in: path name: repository @@ -25321,11 +25808,7 @@ components: name: actions description: Comma-separated list or wildcard expression of actions used to limit the request. schema: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' style: form tasks.cancel___query.nodes: in: query @@ -25381,11 +25864,7 @@ components: name: actions description: Comma-separated list or wildcard expression of actions used to limit the request. schema: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' style: form tasks.list___query.detailed: in: query @@ -26167,7 +26646,8 @@ components: type: boolean shard: description: Specifies the ID of the shard that you would like an explanation for. - type: number + type: integer + format: int32 description: The index, shard, and primary flag to explain. Empty means 'explain the first unassigned shard' cluster.delete_weighted_routing: content: @@ -26381,8 +26861,7 @@ components: settings: description: Configuration options for the target index. type: object - additionalProperties: - type: object + additionalProperties: true description: The configuration for the target index (`settings` and `aliases`) indices.create: content: @@ -26526,6 +27005,7 @@ components: content: application/json: schema: + title: settings $ref: '#/components/schemas/indices._common___IndexSettings' required: true indices.put_template: @@ -26543,11 +27023,7 @@ components: description: |- Array of wildcard expressions used to match the names of indexes during creation. - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' mappings: $ref: '#/components/schemas/_common.mapping___TypeMapping' order: @@ -26557,12 +27033,12 @@ components: Templates with lower 'order' values are merged first. Templates with higher 'order' values are merged later, overriding templates with lower values. - type: number + type: integer + format: int32 settings: description: Configuration options for the index. type: object - additionalProperties: - type: object + additionalProperties: true version: $ref: '#/components/schemas/_common___VersionNumber' description: The template definition @@ -26589,8 +27065,7 @@ components: Configuration options for the index. Data streams do not support this parameter. type: object - additionalProperties: - type: object + additionalProperties: true description: The conditions that needs to be met for executing rollover indices.shrink: content: @@ -26608,8 +27083,7 @@ components: settings: description: Configuration options for the target index. type: object - additionalProperties: - type: object + additionalProperties: true description: The configuration for the target index (`settings` and `aliases`) indices.simulate_index_template: content: @@ -26652,6 +27126,7 @@ components: content: application/json: schema: + title: template $ref: '#/components/schemas/indices._common___IndexTemplate' indices.split: content: @@ -26769,36 +27244,7 @@ components: content: application/json: schema: - type: object - properties: - training_index: - type: string - training_field: - type: string - dimension: - type: integer - format: int32 - max_training_vector_count: - type: integer - format: int32 - search_size: - type: integer - format: int32 - description: - type: string - mode: - type: string - compression_level: - type: string - method: - type: string - spaceType: - type: string - required: - - dimension - - training_field - - training_index - required: true + $ref: '#/components/schemas/knn._common___TrainedModel' mget: content: application/json: @@ -26818,12 +27264,90 @@ components: content: application/json: schema: - $ref: '#/components/schemas/ml._common___CreateConnectorRequest' + type: object + properties: + name: + type: string + description: + type: string + version: + type: integer + protocol: + type: string + enum: + - aws_sigv4 + - http + credential: + $ref: '#/components/schemas/ml._common___Credential' + parameters: + $ref: '#/components/schemas/ml._common___Parameters' + client_config: + $ref: '#/components/schemas/ml._common___ClientConfig' + actions: + type: array + items: + $ref: '#/components/schemas/ml._common___Action' + required: + - actions + - credential + - description + - name + - parameters + - protocol + - version + ml.predict: + content: + application/json: + schema: + type: object + properties: + input_query: + $ref: '#/components/schemas/ml._common___InputQuery' + input_index: + type: array + items: + type: string + description: The input index. + text_docs: + type: array + items: + type: string + description: The text documents. + return_number: + type: boolean + description: Whether to return bytes in model output. + target_response: + type: array + items: + type: string + description: The target response. ml.register_agents: content: application/json: schema: - $ref: '#/components/schemas/ml._common___RegisterAgentsRequest' + type: object + properties: + name: + type: string + type: + type: string + description: + type: string + tools: + type: array + items: + $ref: '#/components/schemas/ml._common___ToolItems' + parameters: + $ref: '#/components/schemas/ml._common___Parameters' + app_type: + type: string + memory: + $ref: '#/components/schemas/ml._common___Memory' + llm: + $ref: '#/components/schemas/ml._common___LLM' + required: + - name + - type ml.register_model: content: application/json: @@ -26881,11 +27405,159 @@ components: description: The add all backend roles. required: - name + ml.search_connectors: + content: + application/json: + schema: + type: object + properties: + query: + $ref: '#/components/schemas/ml._common___Query' + size: + type: integer + description: The number of connectors to return. + sort: + type: array + items: + type: string + description: The sort order. + ml.search_model_group: + content: + application/json: + schema: + type: object + properties: + query: + $ref: '#/components/schemas/ml._common___Query' + size: + type: integer + format: int64 + description: The number of model groups to return. + sort: + type: array + items: + $ref: '#/components/schemas/ml._common___Sort' + description: The sort order. ml.search_models: content: application/json: schema: - $ref: '#/components/schemas/ml._common___SearchModelsQuery' + type: object + properties: + query: + type: object + $ref: '#/components/schemas/ml._common___Query' + size: + type: integer + format: int64 + description: The number of models to return. + sort: + type: array + items: + $ref: '#/components/schemas/ml._common___Sort' + description: The sort order. + ml.train: + content: + application/json: + schema: + type: object + properties: + parameters: + $ref: '#/components/schemas/ml._common___TrainParameters' + input_query: + $ref: '#/components/schemas/ml._common___InputQuery' + input_index: + type: array + description: The input index. + items: + type: string + ml.train_predict: + content: + application/json: + schema: + type: object + properties: + parameters: + $ref: '#/components/schemas/ml._common___TrainParameters' + input_query: + $ref: '#/components/schemas/ml._common___InputQuery' + input_index: + type: array + description: The input index. + items: + type: string + input_data: + $ref: '#/components/schemas/ml._common___PredictionResult' + ml.update_connector: + content: + application/json: + schema: + type: object + properties: + name: + $ref: '#/components/schemas/_common___Name' + description: + type: string + description: The connector description. + version: + $ref: '#/components/schemas/_common___VersionNumber' + protocol: + type: string + description: The connector protocol. + enum: + - aws_sigv4 + - http + parameters: + $ref: '#/components/schemas/ml._common___Parameters' + credential: + $ref: '#/components/schemas/ml._common___Credential' + actions: + type: array + items: + $ref: '#/components/schemas/ml._common___Action' + backend_roles: + type: array + items: + type: string + description: The backend roles. + access_mode: + type: string + description: The model group access mode. + enum: + - private + - public + - restricted + parameters.skip_validating_missing_parameters: + type: boolean + description: Whether to skip validating missing parameters. + ml.update_model_group: + content: + application/json: + schema: + type: object + properties: + name: + type: string + description: The model group name. + description: + type: string + description: The model group description. + add_all_backend_roles: + type: boolean + description: Whether to include all backend roles. + model_access_name: + type: string + description: The model access name + backend_roles: + type: array + items: + type: string + description: The backend roles. + add_backend_roles: + type: array + items: + type: string + description: The backend roles to add. msearch: content: application/x-ndjson: @@ -27081,16 +27753,15 @@ components: schema: type: object properties: - file: - type: string + id: + $ref: '#/components/schemas/_common___Id' params: description: |- Key-value pairs used to replace Mustache variables in the template. The key is the variable name. The value is the variable value. type: object - additionalProperties: - type: object + additionalProperties: true source: description: |- An inline search template. @@ -27170,9 +27841,6 @@ components: $ref: '#/components/schemas/_common___Duration' scroll_id: $ref: '#/components/schemas/_common___ScrollId' - required: - - scroll_id - description: The scroll ID if not passed by URL or query parameter. search: content: application/json: @@ -27320,6 +27988,46 @@ components: schema: $ref: '#/components/schemas/search_pipeline._common___SearchPipelineStructure' required: true + search_shards: + content: + application/json: + schema: + type: object + properties: + query: + description: Defines the search query to filter shards. Supports any query that is valid for the `_search` endpoint. + type: object + additionalProperties: + type: object + indices_boost: + description: Allows increasing the relevance of specific indexes in the search. + type: object + additionalProperties: + type: number + allow_partial_search_results: + description: Indicates whether partial search results are allowed if some shards are unavailable. + type: boolean + _source: + description: Specifies which fields to include in the `_source` response or excludes specific fields. + oneOf: + - type: boolean + - type: array + items: + type: string + from: + description: The starting offset (default 0) for paginated results. + type: integer + size: + description: The maximum number of results to return (default 10). + type: integer + sort: + description: A list of fields and directions for sorting the results. + type: array + items: + type: object + additionalProperties: + type: string + description: Defines the parameters that can be used in the `search_shards` endpoint request. See documentation for supported query syntax. search_template: content: application/json: @@ -27459,7 +28167,7 @@ components: content: application/json: schema: - $ref: '#/components/schemas/security._common___PatchOperation' + $ref: '#/components/schemas/security._common___PatchOperations' security.patch_distinguished_names: content: application/json: @@ -27549,6 +28257,16 @@ components: application/json: schema: $ref: '#/components/schemas/security._common___DistinguishedNames' + sm.create_policy: + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___CreateUpdatePolicyRequest' + sm.update_policy: + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___CreateUpdatePolicyRequest' snapshot.clone: content: application/json: @@ -27719,17 +28437,12 @@ components: content: application/json: schema: - type: object - properties: - transform: - $ref: '#/components/schemas/transforms._common___Transform' - required: - - transform + $ref: '#/components/schemas/transforms._common___TransformRequest' transforms.put: content: application/json: schema: - $ref: '#/components/schemas/transforms._common___Transform' + $ref: '#/components/schemas/transforms._common___TransformRequest' update: content: application/json: @@ -28178,6 +28891,21 @@ components: - num_freed - succeeded description: '' + clear_scroll___404: + content: + application/json: + schema: + type: object + properties: + succeeded: + type: boolean + num_freed: + type: integer + format: int32 + required: + - num_freed + - succeeded + description: '' cluster.allocation_explain___200: content: application/json: @@ -28235,7 +28963,8 @@ components: remaining_delay_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' shard: - type: number + type: integer + format: int32 unassigned_info: $ref: '#/components/schemas/cluster.allocation_explain___UnassignedInformation' note: @@ -28388,34 +29117,56 @@ components: content: application/json: schema: - type: object - properties: - acknowledged: - type: boolean - explanations: - type: array - items: - $ref: '#/components/schemas/cluster.reroute___RerouteExplanation' - state: - description: |- - There aren't any guarantees on the output/structure of the raw cluster state. - Here you will find the internal representation of the cluster, which can - differ from the external representation. - type: object - required: - - acknowledged + allOf: + - $ref: '#/components/schemas/_common___AcknowledgedResponseBase' + - type: object + properties: + explanations: + type: array + items: + $ref: '#/components/schemas/cluster.reroute___RerouteExplanation' + state: + description: |- + There aren't any guarantees on the output/structure of the raw cluster state. + Here you will find the internal representation of the cluster, which can + differ from the external representation. description: '' cluster.state___200: content: application/json: - schema: - type: object + schema: {} description: '' cluster.stats___200: content: application/json: schema: - $ref: '#/components/schemas/cluster.stats___StatsResponseBase' + allOf: + - $ref: '#/components/schemas/nodes._common___NodesResponseBase' + - type: object + properties: + cluster_name: + description: Name of the cluster, based on the Cluster name setting setting. + $ref: '#/components/schemas/_common___Name' + cluster_uuid: + description: Unique identifier for the cluster. + $ref: '#/components/schemas/_common___Uuid' + indices: + description: Contains statistics about indexes with shards assigned to selected nodes. + $ref: '#/components/schemas/cluster.stats___ClusterIndices' + nodes: + description: Contains statistics about nodes selected by the request's node filters. + $ref: '#/components/schemas/cluster.stats___ClusterNodes' + status: + description: Health status of the cluster, based on the state of its primary and replica shards. + $ref: '#/components/schemas/_common___HealthStatus' + timestamp: + description: Unix timestamp, in milliseconds, for the last time the cluster statistics were refreshed. + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + required: + - cluster_name + - cluster_uuid + - status + - timestamp description: '' count___200: content: @@ -28926,20 +29677,19 @@ components: content: application/json: schema: - type: object - properties: - acknowledged: - type: boolean - shards_acknowledged: - type: boolean - indices: - type: array - items: - $ref: '#/components/schemas/indices.add_block___IndicesBlockStatus' - required: - - acknowledged - - indices - - shards_acknowledged + allOf: + - $ref: '#/components/schemas/_common___AcknowledgedResponseBase' + - type: object + properties: + shards_acknowledged: + type: boolean + indices: + type: array + items: + $ref: '#/components/schemas/indices.add_block___IndicesBlockStatus' + required: + - indices + - shards_acknowledged description: '' indices.analyze___200: content: @@ -28964,37 +29714,35 @@ components: content: application/json: schema: - type: object - properties: - acknowledged: - type: boolean - index: - $ref: '#/components/schemas/_common___IndexName' - shards_acknowledged: - type: boolean - required: - - acknowledged - - index - - shards_acknowledged + allOf: + - $ref: '#/components/schemas/_common___AcknowledgedResponseBase' + - type: object + properties: + shards_acknowledged: + type: boolean + index: + $ref: '#/components/schemas/_common___IndexName' + required: + - index + - shards_acknowledged description: '' indices.close___200: content: application/json: schema: - type: object - properties: - acknowledged: - type: boolean - indices: - type: object - additionalProperties: - $ref: '#/components/schemas/indices.close___CloseIndexResult' - shards_acknowledged: - type: boolean - required: - - acknowledged - - indices - - shards_acknowledged + allOf: + - $ref: '#/components/schemas/_common___AcknowledgedResponseBase' + - type: object + properties: + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.close___CloseIndexResult' + shards_acknowledged: + type: boolean + required: + - indices + - shards_acknowledged description: '' indices.create_data_stream___200: content: @@ -29029,16 +29777,18 @@ components: $ref: '#/components/schemas/_common___ShardStatistics' backing_indices: description: Total number of backing indexes for the selected data streams. - type: number + type: integer + format: int32 data_stream_count: description: Total number of selected data streams. - type: number + type: integer + format: int32 data_streams: description: Contains statistics for the selected data streams. type: array items: - $ref: '#/components/schemas/indices.data_streams_stats___DataStreamsStatsItem' - total_store_sizes: + $ref: '#/components/schemas/indices._common___DataStreamStats' + total_store_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' total_store_size_bytes: description: Total size, in bytes, of all shards for the selected data streams. @@ -29201,6 +29951,10 @@ components: $ref: '#/components/schemas/indices._common___TemplateMapping' description: '' indices.get_upgrade___200: + content: + application/json: + schema: + $ref: '#/components/schemas/indices._common___IndexGetUpgradeStatus' description: '' indices.get___200: content: @@ -29302,32 +30056,31 @@ components: content: application/json: schema: - type: object - properties: - acknowledged: - type: boolean - conditions: - type: object - additionalProperties: - type: boolean - dry_run: - type: boolean - new_index: - type: string - old_index: - type: string - rolled_over: - type: boolean - shards_acknowledged: - type: boolean - required: - - acknowledged - - conditions - - dry_run - - new_index - - old_index - - rolled_over - - shards_acknowledged + allOf: + - $ref: '#/components/schemas/_common___AcknowledgedResponseBase' + - type: object + properties: + conditions: + type: object + additionalProperties: + type: boolean + dry_run: + type: boolean + new_index: + type: string + old_index: + type: string + rolled_over: + type: boolean + shards_acknowledged: + type: boolean + required: + - conditions + - dry_run + - new_index + - old_index + - rolled_over + - shards_acknowledged description: '' indices.segments___200: content: @@ -29362,18 +30115,17 @@ components: content: application/json: schema: - type: object - properties: - acknowledged: - type: boolean - shards_acknowledged: - type: boolean - index: - $ref: '#/components/schemas/_common___IndexName' - required: - - acknowledged - - index - - shards_acknowledged + allOf: + - $ref: '#/components/schemas/_common___AcknowledgedResponseBase' + - type: object + properties: + shards_acknowledged: + type: boolean + index: + $ref: '#/components/schemas/_common___IndexName' + required: + - index + - shards_acknowledged description: '' indices.simulate_index_template___200: content: @@ -29400,18 +30152,17 @@ components: content: application/json: schema: - type: object - properties: - acknowledged: - type: boolean - shards_acknowledged: - type: boolean - index: - $ref: '#/components/schemas/_common___IndexName' - required: - - acknowledged - - index - - shards_acknowledged + allOf: + - $ref: '#/components/schemas/_common___AcknowledgedResponseBase' + - type: object + properties: + shards_acknowledged: + type: boolean + index: + $ref: '#/components/schemas/_common___IndexName' + required: + - index + - shards_acknowledged description: '' indices.stats___200: content: @@ -29438,6 +30189,17 @@ components: $ref: '#/components/schemas/_common___AcknowledgedResponseBase' description: '' indices.upgrade___200: + content: + application/json: + schema: + allOf: + - $ref: '#/components/schemas/_common___ShardsOperationResponseBase' + - type: object + properties: + upgraded_indices: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common___UpgradeVersionStatus' description: '' indices.validate_query___200: content: @@ -29616,6 +30378,10 @@ components: $ref: '#/components/schemas/ism._common___RetryIndexResponse' description: '' knn.delete_model___200: + content: + application/json: + schema: + $ref: '#/components/schemas/knn._common___DeletedModel' description: '' knn.get_model___200: content: @@ -29624,8 +30390,16 @@ components: type: object description: '' knn.search_models___200: + content: + application/json: + schema: + $ref: '#/components/schemas/_core.search___ResponseBody' description: '' knn.stats___200: + content: + application/json: + schema: + $ref: '#/components/schemas/knn._common___Stats' description: '' knn.train_model___200: content: @@ -29639,6 +30413,10 @@ components: - model_id description: '' knn.warmup___200: + content: + application/json: + schema: + $ref: '#/components/schemas/_common___ShardsOperationResponseBase' description: '' list.help___200: content: @@ -29822,6 +30600,12 @@ components: - status - task_id description: '' + ml.get_connector___200: + content: + application/json: + schema: + $ref: '#/components/schemas/ml._common___GetConnectorResponse' + description: '' ml.get_model_group___200: content: application/json: @@ -29834,6 +30618,12 @@ components: schema: $ref: '#/components/schemas/ml._common___Task' description: '' + ml.predict___200: + content: + application/json: + schema: + $ref: '#/components/schemas/ml._common___PredictResponse' + description: '' ml.register_agents___200: content: application/json: @@ -29863,18 +30653,54 @@ components: - status - task_id description: '' + ml.search_connectors___200: + content: + application/json: + schema: + $ref: '#/components/schemas/ml._common___SearchConnectorsResponse' + description: '' + ml.search_model_group___200: + content: + application/json: + schema: + $ref: '#/components/schemas/ml._common___SearchModelGroupsResponse' + description: '' ml.search_models___200: content: application/json: schema: $ref: '#/components/schemas/ml._common___SearchModelsResponse' description: '' + ml.train_predict___200: + content: + application/json: + schema: + $ref: '#/components/schemas/ml._common___TrainPredictResponse' + description: '' + ml.train___200: + content: + application/json: + schema: + $ref: '#/components/schemas/ml._common___TrainResponse' + description: '' ml.undeploy_model___200: content: application/json: schema: $ref: '#/components/schemas/ml._common___UndeployModelResponse' description: '' + ml.update_connector___200: + content: + application/json: + schema: + $ref: '#/components/schemas/_common___WriteResponseBase' + description: '' + ml.update_model_group___200: + content: + application/json: + schema: + $ref: '#/components/schemas/ml._common___UpdateModelGroupResponse' + description: '' msearch_template___200: content: application/json: @@ -29908,25 +30734,72 @@ components: content: application/json: schema: - $ref: '#/components/schemas/nodes.info___ResponseBase' + allOf: + - $ref: '#/components/schemas/nodes._common___NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common___Name' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.info___NodeInfo' + required: + - cluster_name + - nodes description: '' nodes.reload_secure_settings___200: content: application/json: schema: - $ref: '#/components/schemas/nodes.reload_secure_settings___ResponseBase' + allOf: + - $ref: '#/components/schemas/nodes._common___NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common___Name' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.reload_secure_settings___NodeReloadResult' + required: + - cluster_name + - nodes description: '' nodes.stats___200: content: application/json: schema: - $ref: '#/components/schemas/nodes.stats___ResponseBase' + allOf: + - $ref: '#/components/schemas/nodes._common___NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common___Name' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___Stats' + required: + - nodes description: '' nodes.usage___200: content: application/json: schema: - $ref: '#/components/schemas/nodes.usage___ResponseBase' + allOf: + - $ref: '#/components/schemas/nodes._common___NodesResponseBase' + - type: object + properties: + cluster_name: + $ref: '#/components/schemas/_common___Name' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.usage___NodeUsage' + required: + - cluster_name + - nodes description: '' notifications.create_config___200: content: @@ -30061,7 +30934,7 @@ components: observability.get_localstats___200: description: Retrieves content: - application/json: + text/plain: schema: type: string observability.get_object___200: @@ -30330,6 +31203,10 @@ components: $ref: '#/components/schemas/_common___AcknowledgedResponseBase' description: '' rollups.delete___200: + content: + application/json: + schema: + $ref: '#/components/schemas/_common___WriteResponseBase' description: '' rollups.explain___200: content: @@ -30343,15 +31220,23 @@ components: schema: $ref: '#/components/schemas/rollups._common___RollupEntity' description: '' - rollups.put___200: + rollups.put___201: content: application/json: schema: $ref: '#/components/schemas/rollups._common___RollupEntity' description: '' rollups.start___200: + content: + application/json: + schema: + $ref: '#/components/schemas/_common___AcknowledgedResponseBase' description: '' rollups.stop___200: + content: + application/json: + schema: + $ref: '#/components/schemas/_common___AcknowledgedResponseBase' description: '' scripts_painless_execute___200: content: @@ -30360,7 +31245,10 @@ components: type: object properties: result: - type: object + oneOf: + - type: number + - type: string + - type: boolean required: - result description: '' @@ -30464,6 +31352,8 @@ components: $ref: '#/components/schemas/_core.search___Suggest' terminated_early: type: boolean + status: + type: number required: - _shards - hits @@ -30832,7 +31722,7 @@ components: content: application/json: schema: - $ref: '#/components/schemas/security._common___DistinguishedNames' + $ref: '#/components/schemas/security._common___DistinguishedNamesMap' security.get_distinguished_name___400: content: application/json: @@ -31256,6 +32146,12 @@ components: schema: $ref: '#/components/schemas/security._common___Ok' description: '' + security.update_distinguished_name___201: + content: + application/json: + schema: + $ref: '#/components/schemas/security._common___Ok' + description: '' security.update_distinguished_name___400: content: application/json: @@ -31304,6 +32200,84 @@ components: schema: $ref: '#/components/schemas/security._common___InternalServerError' description: '' + sm.create_policy___201: + description: Successfully created the snapshot management policy. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___PolicyResponse' + sm.create_policy___400: + description: Bad request when creating the snapshot management policy. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___BadRequestResponse' + sm.delete_policy___200: + description: Successfully deleted the snapshot management policy. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___DeletePolicyResponse' + sm.delete_policy___404: + description: Snapshot management policy not found. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___NotFoundResponse' + sm.explain_policy___200: + description: Successfully explained the state of the snapshot management policy. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___PolicyExplanation' + sm.get_policies___200: + description: Successfully retrieved the list of snapshot management policies. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___GetPoliciesResponse' + sm.get_policy___200: + description: Successfully retrieved the snapshot management policy. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___PolicyResponse' + sm.get_policy___404: + description: Snapshot management policy not found. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___NotFoundResponse' + sm.start_policy___200: + description: Successfully started the snapshot management policy. + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + sm.stop_policy___200: + description: Successfully stopped the snapshot management policy. + content: + application/json: + schema: + type: object + properties: + acknowledged: + type: boolean + sm.update_policy___200: + description: Successfully updated the snapshot management policy. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___PolicyResponse' + sm.update_policy___404: + description: Snapshot management policy not found. + content: + application/json: + schema: + $ref: '#/components/schemas/sm._common___NotFoundResponse' snapshot.cleanup_repository___200: content: application/json: @@ -31393,7 +32367,7 @@ components: snapshots: type: array items: - $ref: '#/components/schemas/snapshot._common___Status' + $ref: '#/components/schemas/snapshot._common___SnapshotStatus' required: - snapshots description: '' @@ -31497,14 +32471,19 @@ components: format: int64 _version: $ref: '#/components/schemas/_common___VersionNumber' + _type: + $ref: '#/components/schemas/_common___Type' required: - - _id - _index - _version - found - took description: '' transforms.delete___200: + content: + application/json: + schema: + $ref: '#/components/schemas/transforms._common___DeleteTransformsResponse' description: '' transforms.explain___200: content: @@ -31516,7 +32495,7 @@ components: content: application/json: schema: - $ref: '#/components/schemas/transforms._common___TransformEntity' + $ref: '#/components/schemas/transforms._common___TransformResponse' description: '' transforms.preview___200: content: @@ -31528,7 +32507,13 @@ components: content: application/json: schema: - $ref: '#/components/schemas/transforms._common___TransformEntity' + $ref: '#/components/schemas/transforms._common___TransformResponse' + description: '' + transforms.put___201: + content: + application/json: + schema: + $ref: '#/components/schemas/transforms._common___TransformResponse' description: '' transforms.search___200: content: @@ -31558,6 +32543,10 @@ components: type: object additionalProperties: $ref: '#/components/schemas/_core.update_by_query_rethrottle___UpdateByQueryRethrottleNode' + node_failures: + type: array + items: + $ref: '#/components/schemas/_common___ErrorCause' required: - nodes description: '' @@ -31927,17 +32916,34 @@ components: _common___Distance: type: string _common___DistanceUnit: - type: string - enum: - - cm - - ft - - in - - km - - m - - mi - - mm - - nmi - - yd + oneOf: + - title: centimeters + type: string + const: cm + - title: feet + type: string + const: ft + - title: inches + type: string + const: in + - title: kilometers + type: string + const: km + - title: meters + type: string + const: m + - title: miles + type: string + const: mi + - title: millimeters + type: string + const: mm + - title: nautical miles + type: string + const: nmi + - title: yards + type: string + const: yd _common___DocStats: type: object properties: @@ -31945,13 +32951,15 @@ components: description: |- The total number of non-deleted documents across all primary shards assigned to the selected nodes. This number is based on documents in Lucene segments and may include documents from nested fields. - type: number + type: integer + format: int64 deleted: description: |- The total number of deleted documents across all primary shards assigned to the selected nodes. This number is based on the number of documents stored in Lucene segments. OpenSearch reclaims the disk space previously occupied by the deleted Lucene documents when a segment is merged. - type: number + type: integer + format: int64 required: - count _common___DocStatus: @@ -31982,6 +32990,9 @@ components: _common___DurationLarge: description: 'A date histogram interval, similar to `Duration`, with support for additional units: `w` (week), `M` (month), `q` (quarter), and `y` (year).' type: string + _common___DurationValueUnitMicros: + allOf: + - $ref: '#/components/schemas/_common___UnitMicros' _common___DurationValueUnitMillis: allOf: - $ref: '#/components/schemas/_common___UnitMillis' @@ -32063,7 +33074,8 @@ components: type: object properties: evictions: - type: number + type: integer + format: int64 memory_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' memory_size_in_bytes: @@ -32098,29 +33110,49 @@ components: $ref: '#/components/schemas/_common___ByteCount' required: - size_in_bytes + _common___FieldSort: + oneOf: + - title: order + $ref: '#/components/schemas/_common___SortOrder' + - type: object + properties: + missing: + $ref: '#/components/schemas/_common___FieldValue' + mode: + $ref: '#/components/schemas/_common___SortMode' + nested: + $ref: '#/components/schemas/_common___NestedSortValue' + order: + $ref: '#/components/schemas/_common___SortOrder' + unmapped_type: + $ref: '#/components/schemas/_common.mapping___FieldType' + numeric_type: + $ref: '#/components/schemas/_common___FieldSortNumericType' + format: + type: string + _common___FieldSortNumericType: + type: string + enum: + - date + - date_nanos + - double + - long _common___FieldValue: description: A field value. type: - boolean - 'null' - number - - object - string - _common___FieldWithDirection: - type: object - additionalProperties: - $ref: '#/components/schemas/_common___SortOrder' - _common___FieldWithOrder: - type: object - additionalProperties: - $ref: '#/components/schemas/_common___ScoreSort' _common___FlushStats: type: object properties: periodic: - type: number + type: integer + format: int64 total: - type: number + type: integer + format: int64 total_time: $ref: '#/components/schemas/_common___Duration' total_time_in_millis: @@ -32238,25 +33270,29 @@ components: type: object properties: total: - type: number + type: integer + format: int64 getTime: $ref: '#/components/schemas/_common___Duration' time_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' exists_total: - type: number + type: integer + format: int64 exists_time: $ref: '#/components/schemas/_common___Duration' exists_time_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' missing_total: - type: number + type: integer + format: int64 missing_time: $ref: '#/components/schemas/_common___Duration' missing_time_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' current: - type: number + type: integer + format: int64 required: - current - exists_time_in_millis @@ -32266,17 +33302,27 @@ components: - time_in_millis - total _common___HealthStatus: - type: string - enum: - - green - - red - - yellow - _common___HealthStatusCapitalized: - type: string - enum: - - GREEN - - RED - - YELLOW + oneOf: + - description: All shards are assigned. + type: string + enum: + - green + - GREEN + - description: | + All primary shards are assigned, but one or more replica shards are + unassigned. If a node in the cluster fails, some data could be unavailable + until that node is repaired. + type: string + enum: + - yellow + - YELLOW + - description: | + One or more primary shards are unassigned, so some data is unavailable. This + can occur briefly during cluster startup as primary shards are assigned. + type: string + enum: + - red + - RED _common___Host: type: string _common___HourAndMinute: @@ -32296,11 +33342,7 @@ components: _common___HttpHeaders: type: object additionalProperties: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' _common___HumanReadableByteCount: type: string pattern: (?:(-1)|(0)|\d+(\.\d+)?(b|kb|k|mb|m|gb|g|tb|t|pb|p)) @@ -32328,25 +33370,31 @@ components: type: object properties: index_total: - type: number + type: integer + format: int64 index_time: $ref: '#/components/schemas/_common___Duration' index_time_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' index_current: - type: number + type: integer + format: int64 index_failed: - type: number + type: integer + format: int64 delete_total: - type: number + type: integer + format: int64 delete_time: $ref: '#/components/schemas/_common___Duration' delete_time_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' delete_current: - type: number + type: integer + format: int64 noop_update_total: - type: number + type: integer + format: int64 is_throttled: type: boolean throttle_time: @@ -32447,50 +33495,6 @@ components: - source _common___Ip: type: string - _common___KnnField: - type: object - properties: - vector: - $ref: '#/components/schemas/_common___QueryVector' - k: - description: The total number of nearest neighbors to return as top hits. - type: integer - format: int32 - min_score: - description: The minimum similarity score required in order for a neighbor to be considered a hit. - type: number - format: float - x-version-added: '2.14' - max_distance: - description: The maximum physical vector space distance required in order for a neighbor to be considered a hit. - type: number - format: float - x-version-added: '2.14' - filter: - description: The filters for the k-NN search query. - oneOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryContainer' - - type: array - items: - $ref: '#/components/schemas/_common.query_dsl___QueryContainer' - boost: - description: The boost value applied to k-NN scores. - type: number - format: float - method_parameters: - type: object - x-version-added: '2.16' - additionalProperties: - type: integer - format: int32 - rescore: - type: object - x-version-added: '2.17' - additionalProperties: - type: number - format: float - required: - - vector _common___LatLonGeoLocation: type: object properties: @@ -32515,21 +33519,25 @@ components: type: object properties: current: - type: number + type: integer + format: int64 current_docs: - type: number + type: integer + format: int64 current_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' current_size_in_bytes: $ref: '#/components/schemas/_common___ByteCount' total: - type: number + type: integer + format: int64 total_auto_throttle: $ref: '#/components/schemas/_common___HumanReadableByteCount' total_auto_throttle_in_bytes: $ref: '#/components/schemas/_common___ByteCount' total_docs: - type: number + type: integer + format: int64 total_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' total_size_in_bytes: @@ -32547,7 +33555,8 @@ components: total_time_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' unreferenced_file_cleanups_performed: - type: number + type: integer + format: int64 required: - current - current_docs @@ -32569,14 +33578,14 @@ components: format: int32 - type: string _common___MultiTermQueryRewrite: - type: string - enum: - - constant_score - - constant_score_boolean - - scoring_boolean - - top_terms_N - - top_terms_blended_freqs_N - - top_terms_boost_N + oneOf: + - type: string + enum: + - constant_score + - constant_score_boolean + - scoring_boolean + - type: string + pattern: top_terms(_blended_freqs|_boost)?_\d+ _common___Name: type: string _common___Names: @@ -32790,16 +33799,6 @@ components: - query _common___PipelineName: type: string - _common___PipeSeparatedFlagsSimpleQueryStringFlag: - description: |- - A set of flags represented as a single enum value or a set of values that are encoded - as a pipe-separated string. - - Depending on the target language, code generators can use this hint to generate language specific - flags enum constructs and the corresponding (de-)serialization code. - oneOf: - - $ref: '#/components/schemas/_common.query_dsl___SimpleQueryStringFlag' - - type: string _common___PluginStats: type: object properties: @@ -32843,16 +33842,20 @@ components: description: |- The total number of entries added to the query cache across all shards assigned to the selected nodes. This number includes all current and evicted entries. - type: number + type: integer + format: int64 cache_size: description: The total number of entries currently stored in the query cache across all shards assigned to the selected nodes. - type: number + type: integer + format: int64 evictions: description: The total number of query cache evictions across all shards assigned to the selected nodes. - type: number + type: integer + format: int64 hit_count: description: The total number of query cache hits across all shards assigned to the selected nodes. - type: number + type: integer + format: int64 memory_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' memory_size_in_bytes: @@ -32860,10 +33863,12 @@ components: $ref: '#/components/schemas/_common___ByteCount' miss_count: description: The total number of query cache misses across all shards assigned to the selected nodes. - type: number + type: integer + format: int64 total_count: description: The total number of hits and misses stored in the query cache across all shards assigned to the selected nodes. - type: number + type: integer + format: int64 required: - cache_count - cache_size @@ -32872,11 +33877,6 @@ components: - memory_size_in_bytes - miss_count - total_count - _common___QueryVector: - type: array - items: - type: number - format: float _common___RankBase: type: object _common___RankContainer: @@ -32890,9 +33890,11 @@ components: type: object properties: current_as_source: - type: number + type: integer + format: int64 current_as_target: - type: number + type: integer + format: int64 throttle_time: $ref: '#/components/schemas/_common___Duration' throttle_time_in_millis: @@ -32913,15 +33915,18 @@ components: type: object properties: external_total: - type: number + type: integer + format: int64 external_total_time: $ref: '#/components/schemas/_common___Duration' external_total_time_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' listeners: - type: number + type: integer + format: int64 total: - type: number + type: integer + format: int64 total_time: $ref: '#/components/schemas/_common___Duration' total_time_in_millis: @@ -33018,13 +34023,16 @@ components: properties: failed: description: The number of failed upload syncs to the remote translog store. - type: number + type: integer + format: int64 started: description: The number of upload syncs to the remote translog store that have started. - type: number + type: integer + format: int64 succeeded: description: The number of successful upload syncs to the remote translog store. - type: number + type: integer + format: int64 required: - failed - started @@ -33061,7 +34069,8 @@ components: properties: total_rejections: description: The total number of requests rejected due to segment store upload backpressure. - type: number + type: integer + format: int64 required: - total_rejections _common___RemoteStoreUploadRefreshSizeLagStats: @@ -33107,7 +34116,6 @@ components: $ref: '#/components/schemas/_common___RemoteStoreUploadDownloadStats' required: - max_refresh_time_lag_in_millis - - pressure - refresh_size_lag - total_time_spent_in_millis - total_upload_size @@ -33115,15 +34123,18 @@ components: type: object properties: evictions: - type: number + type: integer + format: int64 hit_count: - type: number + type: integer + format: int64 memory_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' memory_size_in_bytes: $ref: '#/components/schemas/_common___ByteCount' miss_count: - type: number + type: integer + format: int64 required: - evictions - hit_count @@ -33137,9 +34148,40 @@ components: time_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' current: - type: number + type: integer + format: int64 total: - type: number + type: integer + format: int64 + _common___ResourceStat: + type: object + properties: + cpu_time_in_nanos: + $ref: '#/components/schemas/_common___DurationValueUnitNanos' + memory_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + required: + - cpu_time_in_nanos + - memory_in_bytes + _common___ResourceStats: + type: object + properties: + average: + $ref: '#/components/schemas/_common___ResourceStat' + total: + $ref: '#/components/schemas/_common___ResourceStat' + min: + $ref: '#/components/schemas/_common___ResourceStat' + max: + $ref: '#/components/schemas/_common___ResourceStat' + thread_info: + $ref: '#/components/schemas/_common___ThreadInfo' + required: + - average + - max + - min + - thread_info + - total _common___ResourceType: type: string enum: @@ -33167,11 +34209,7 @@ components: _common___Routing: type: string _common___RoutingInQueryString: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' _common___RrfRank: allOf: - $ref: '#/components/schemas/_common___RankBase' @@ -33275,10 +34313,12 @@ components: properties: open_contexts: description: The number of open search contexts. - type: number + type: integer + format: int64 query_current: description: The number of currently running shard query operations. - type: number + type: integer + format: int64 query_time: description: The total amount of time taken to complete all shard query operations. $ref: '#/components/schemas/_common___Duration' @@ -33287,10 +34327,12 @@ components: $ref: '#/components/schemas/_common___DurationValueUnitMillis' query_total: description: The total number of shard query operations. - type: number + type: integer + format: int64 concurrent_query_total: description: The total number of query operations using concurrent segment search. - type: number + type: integer + format: int64 concurrent_query_time: $ref: '#/components/schemas/_common___Duration' concurrent_query_time_in_millis: @@ -33298,13 +34340,16 @@ components: $ref: '#/components/schemas/_common___DurationValueUnitMillis' concurrent_query_current: description: The number of currently running query operations using concurrent segment search. - type: number + type: integer + format: int64 concurrent_avg_slice_count: description: The average slice count of all search requests. This is computed as the total slice count divided by the total number of concurrent search requests. - type: number + type: integer + format: int64 fetch_current: description: The number of currently running shard fetch operations. - type: number + type: integer + format: int64 fetch_time: description: The total amount of time taken to complete all shard fetch operations. $ref: '#/components/schemas/_common___Duration' @@ -33313,10 +34358,12 @@ components: $ref: '#/components/schemas/_common___DurationValueUnitMillis' fetch_total: description: The total number of shard fetch operations. - type: number + type: integer + format: int64 scroll_current: description: The number of shard scroll operations that are currently running. - type: number + type: integer + format: int64 scroll_time: description: The total amount of time taken to complete all shard scroll operations. $ref: '#/components/schemas/_common___Duration' @@ -33325,10 +34372,12 @@ components: $ref: '#/components/schemas/_common___DurationValueUnitMillis' scroll_total: description: The total number of shard scroll operations. - type: number + type: integer + format: int64 point_in_time_total: description: The total number of shard Point in Time (PIT) contexts created (completed and active) since the node last restarted. - type: number + type: integer + format: int64 point_in_time_time: $ref: '#/components/schemas/_common___Duration' point_in_time_time_in_millis: @@ -33336,10 +34385,12 @@ components: $ref: '#/components/schemas/_common___DurationValueUnitMillis' point_in_time_current: description: The number of currently open shard PIT contexts. - type: number + type: integer + format: int64 suggest_current: description: The number of currently running shard suggest operations. - type: number + type: integer + format: int64 suggest_time: description: The total amount of time take to complete all shard suggest operations. $ref: '#/components/schemas/_common___Duration' @@ -33348,9 +34399,11 @@ components: $ref: '#/components/schemas/_common___DurationValueUnitMillis' suggest_total: description: The total number of shard suggest operations. - type: number + type: integer + format: int64 search_idle_reactivate_count_total: - type: number + type: integer + format: int64 request: type: object description: Statistics related to coordinator search operations for the node. @@ -33379,24 +34432,42 @@ components: - dfs_query_then_fetch - query_then_fetch _common___SegmentReplicationStats: - type: object - properties: - max_bytes_behind: - $ref: '#/components/schemas/_common___ByteCount' - max_replication_lag: - $ref: '#/components/schemas/_common___ByteCount' - total_bytes_behind: - $ref: '#/components/schemas/_common___ByteCount' - required: - - max_bytes_behind - - max_replication_lag - - total_bytes_behind + x-version-added: 2.10.0 + oneOf: + - x-version-added: 2.10.0 + x-version-removed: 2.12.0 + type: object + properties: + max_bytes_behind: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + max_replication_lag: + $ref: '#/components/schemas/_common___Duration' + total_bytes_behind: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + required: + - max_bytes_behind + - max_replication_lag + - total_bytes_behind + - x-version-added: 2.12.0 + type: object + properties: + max_bytes_behind: + $ref: '#/components/schemas/_common___ByteCount' + max_replication_lag: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + total_bytes_behind: + $ref: '#/components/schemas/_common___ByteCount' + required: + - max_bytes_behind + - max_replication_lag + - total_bytes_behind _common___SegmentsStats: type: object properties: count: description: The total number of segments across all shards assigned to the selected nodes. - type: number + type: integer + format: int32 doc_values_memory: $ref: '#/components/schemas/_common___HumanReadableByteCount' doc_values_memory_in_bytes: @@ -33423,7 +34494,7 @@ components: $ref: '#/components/schemas/_common___ByteCount' max_unsafe_auto_id_timestamp: description: The Unix timestamp, in milliseconds, of the most recently retried indexing request. - type: number + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' memory: description: The total amount of memory used for segments across all shards assigned to the selected nodes. $ref: '#/components/schemas/_common___HumanReadableByteCount' @@ -33469,6 +34540,7 @@ components: remote_store: $ref: '#/components/schemas/_common___RemoteStoreStats' segment_replication: + x-version-added: 2.10.0 $ref: '#/components/schemas/_common___SegmentReplicationStats' required: - count @@ -33555,20 +34627,10 @@ components: - auto _common___Sort: oneOf: - - $ref: '#/components/schemas/_common___SortCombinations' + - $ref: '#/components/schemas/_common___SortOptions' - type: array items: - $ref: '#/components/schemas/_common___SortCombinations' - _common___SortCombinations: - oneOf: - - title: field - $ref: '#/components/schemas/_common___Field' - - title: field_with_direction - $ref: '#/components/schemas/_common___FieldWithDirection' - - title: field_with_order - $ref: '#/components/schemas/_common___FieldWithOrder' - - title: options - $ref: '#/components/schemas/_common___SortOptions' + $ref: '#/components/schemas/_common___SortOptions' _common___SortMode: type: string enum: @@ -33578,18 +34640,44 @@ components: - min - sum _common___SortOptions: - type: object - properties: - _score: - $ref: '#/components/schemas/_common___ScoreSort' - _doc: - $ref: '#/components/schemas/_common___ScoreSort' - _geo_distance: - $ref: '#/components/schemas/_common___GeoDistanceSort' - _script: - $ref: '#/components/schemas/_common___ScriptSort' - minProperties: 1 - maxProperties: 1 + oneOf: + - type: string + const: _score + - type: string + const: _doc + - type: string + not: + type: string + enum: + - _doc + - _score + - type: object + properties: + _score: + $ref: '#/components/schemas/_common___ScoreSort' + _doc: + $ref: '#/components/schemas/_common___ScoreSort' + _geo_distance: + $ref: '#/components/schemas/_common___GeoDistanceSort' + _script: + $ref: '#/components/schemas/_common___ScriptSort' + minProperties: 1 + maxProperties: 1 + - type: object + propertyNames: + allOf: + - $ref: '#/components/schemas/_common___Field' + - not: + type: string + enum: + - _doc + - _geo_distance + - _score + - _script + additionalProperties: + $ref: '#/components/schemas/_common___FieldSort' + minProperties: 1 + maxProperties: 1 _common___SortOrder: type: string enum: @@ -33699,6 +34787,12 @@ components: oneOf: - $ref: '#/components/schemas/_common___VersionNumber' - type: string + _common___StringOrStringArray: + oneOf: + - type: string + - type: array + items: + type: string _common___SuggestMode: type: string enum: @@ -33733,6 +34827,16 @@ components: - h3 - 'no' - z + _common___ThreadInfo: + type: object + properties: + thread_executions: + type: number + active_threads: + type: number + required: + - active_threads + - thread_executions _common___TimeOfDay: description: Time of day, expressed as HH:MM:SS. type: string @@ -33772,9 +34876,11 @@ components: type: object properties: earliest_last_modified_age: - type: number + type: integer + format: int64 operations: - type: number + type: integer + format: int32 remote_store: $ref: '#/components/schemas/_common___RemoteStoreTranslogStats' size: @@ -33782,7 +34888,8 @@ components: size_in_bytes: $ref: '#/components/schemas/_common___ByteCount' uncommitted_operations: - type: number + type: integer + format: int32 uncommitted_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' uncommitted_size_in_bytes: @@ -33802,6 +34909,10 @@ components: type: integer _common___ulong: type: number + _common___UnitMicros: + description: Time unit for microseconds. + type: integer + format: int64 _common___UnitMillis: description: The time unit for milliseconds. type: integer @@ -33863,9 +34974,11 @@ components: type: object properties: current: - type: number + type: integer + format: int64 total: - type: number + type: integer + format: int64 total_time: $ref: '#/components/schemas/_common___Duration' total_time_in_millis: @@ -39039,11 +40152,7 @@ components: Language value, such as `arabic` or `thai`. Defaults to `english`. Each language value corresponds to a predefined list of stop words in Lucene. See Stop words by language for supported language values and their stop words. Also accepts an array of stop words. - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' _common.analysis___SynonymFormat: type: string enum: @@ -39687,6 +40796,55 @@ components: type: boolean required: - enabled + _common.mapping___FieldType: + type: string + enum: + - aggregate_metric_double + - alias + - binary + - boolean + - byte + - completion + - constant_keyword + - date + - date_nanos + - date_range + - double + - double_range + - flat_object + - float + - float_range + - geo_point + - geo_shape + - half_float + - histogram + - icu_collation_keyword + - integer + - integer_range + - ip + - ip_range + - join + - keyword + - knn_vector + - long + - long_range + - match_only_text + - murmur3 + - nested + - object + - percolator + - rank_feature + - rank_features + - scaled_float + - search_as_you_type + - short + - text + - token_count + - unsigned_long + - version + - wildcard + - xy_point + - xy_shape _common.mapping___FlatObjectProperty: allOf: - $ref: '#/components/schemas/_common.mapping___PropertyBase' @@ -40650,25 +41808,28 @@ components: - all - none _common.query_dsl___CommonTermsQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - analyzer: - type: string - cutoff_frequency: - type: number - format: float - high_freq_operator: - $ref: '#/components/schemas/_common.query_dsl___Operator' - low_freq_operator: - $ref: '#/components/schemas/_common.query_dsl___Operator' - minimum_should_match: - $ref: '#/components/schemas/_common___MinimumShouldMatch' - query: - type: string - required: - - query + oneOf: + - title: query + type: string + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + analyzer: + type: string + cutoff_frequency: + type: number + format: float + high_freq_operator: + $ref: '#/components/schemas/_common.query_dsl___Operator' + low_freq_operator: + $ref: '#/components/schemas/_common.query_dsl___Operator' + minimum_should_match: + $ref: '#/components/schemas/_common___MinimumShouldMatch' + query: + type: string + required: + - query _common.query_dsl___ConstantScoreQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -40784,17 +41945,20 @@ components: required: - field _common.query_dsl___FieldAndFormat: - type: object - properties: - field: + oneOf: + - title: field $ref: '#/components/schemas/_common___Field' - format: - description: Format in which the values are returned. - type: string - include_unmapped: - type: boolean - required: - - field + - type: object + properties: + field: + $ref: '#/components/schemas/_common___Field' + format: + description: Format in which the values are returned. + type: string + include_unmapped: + type: boolean + required: + - field _common.query_dsl___FieldValueFactorModifier: type: string enum: @@ -40895,33 +42059,33 @@ components: score_mode: $ref: '#/components/schemas/_common.query_dsl___FunctionScoreMode' _common.query_dsl___FuzzyQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - max_expansions: - description: Maximum number of variations created. - type: integer - format: int32 - prefix_length: - description: Number of beginning characters left unchanged when creating expansions. - type: integer - format: int32 - rewrite: - $ref: '#/components/schemas/_common___MultiTermQueryRewrite' - transpositions: - description: Indicates whether edits include transpositions of two adjacent characters (for example, `ab` to `ba`). - type: boolean - fuzziness: - $ref: '#/components/schemas/_common___Fuzziness' - value: - description: Term you wish to find in the provided field. - oneOf: - - type: string - - type: number - - type: boolean - required: - - value + oneOf: + - title: value + $ref: '#/components/schemas/_common___FieldValue' + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + max_expansions: + description: Maximum number of variations created. + type: integer + format: int32 + prefix_length: + description: Number of beginning characters left unchanged when creating expansions. + type: integer + format: int32 + rewrite: + $ref: '#/components/schemas/_common___MultiTermQueryRewrite' + transpositions: + description: Indicates whether edits include transpositions of two adjacent characters (for example, `ab` to `ba`). + type: boolean + fuzziness: + $ref: '#/components/schemas/_common___Fuzziness' + value: + description: Term you wish to find in the provided field. + $ref: '#/components/schemas/_common___FieldValue' + required: + - value _common.query_dsl___GeoBoundingBoxQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -41061,6 +42225,15 @@ components: required: - parent_type - query + _common.query_dsl___HybridQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + queries: + type: array + items: + $ref: '#/components/schemas/_common.query_dsl___QueryContainer' _common.query_dsl___IdsQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -41241,22 +42414,59 @@ components: required: - pattern _common.query_dsl___KnnQuery: - type: object - additionalProperties: - $ref: '#/components/schemas/_common___KnnField' - minProperties: 1 - maxProperties: 1 + allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + vector: + $ref: '#/components/schemas/_common.query_dsl___QueryVector' + k: + description: The total number of nearest neighbors to return as top hits. + type: integer + format: int32 + min_score: + description: The minimum similarity score required in order for a neighbor to be considered a hit. + type: number + format: float + x-version-added: '2.14' + max_distance: + description: The maximum physical vector space distance required in order for a neighbor to be considered a hit. + type: number + format: float + x-version-added: '2.14' + filter: + description: The filters for the k-NN search query. + oneOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryContainer' + - type: array + items: + $ref: '#/components/schemas/_common.query_dsl___QueryContainer' + method_parameters: + type: object + x-version-added: '2.16' + additionalProperties: + type: integer + format: int32 + rescore: + type: object + x-version-added: '2.17' + additionalProperties: + type: number + format: float + required: + - vector _common.query_dsl___Like: description: Text that we want similar documents for or a lookup to a document's field for the text. oneOf: - - type: string - - $ref: '#/components/schemas/_common.query_dsl___LikeDocument' + - title: text + type: string + - title: document + $ref: '#/components/schemas/_common.query_dsl___LikeDocument' _common.query_dsl___LikeDocument: type: object properties: doc: description: A document not present in the index. - type: object fields: type: array items: @@ -41265,6 +42475,8 @@ components: $ref: '#/components/schemas/_common___Id' _index: $ref: '#/components/schemas/_common___IndexName' + _type: + $ref: '#/components/schemas/_common___Type' per_field_analyzer: type: object additionalProperties: @@ -41276,140 +42488,152 @@ components: version_type: $ref: '#/components/schemas/_common___VersionType' _common.query_dsl___MatchAllQuery: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - _common.query_dsl___MatchBoolPrefixQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - type: object - properties: - analyzer: - description: Analyzer used to convert the text in the query value into tokens. - type: string - fuzziness: - $ref: '#/components/schemas/_common___Fuzziness' - fuzzy_rewrite: - $ref: '#/components/schemas/_common___MultiTermQueryRewrite' - fuzzy_transpositions: - description: |- - If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). - Can be applied to the term subqueries constructed for all terms but the final term. - type: boolean - max_expansions: - description: |- - Maximum number of terms to which the query will expand. - Can be applied to the term subqueries constructed for all terms but the final term. - type: integer - format: int32 - minimum_should_match: - $ref: '#/components/schemas/_common___MinimumShouldMatch' - operator: - $ref: '#/components/schemas/_common.query_dsl___Operator' - prefix_length: - description: |- - Number of beginning characters left unchanged for fuzzy matching. - Can be applied to the term subqueries constructed for all terms but the final term. - type: integer - format: int32 - query: - description: |- - Terms you wish to find in the provided field. - The last term is used in a prefix query. - type: string - required: - - query + properties: {} + _common.query_dsl___MatchBoolPrefixQuery: + oneOf: + - title: query + type: string + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert the text in the query value into tokens. + type: string + fuzziness: + $ref: '#/components/schemas/_common___Fuzziness' + fuzzy_rewrite: + $ref: '#/components/schemas/_common___MultiTermQueryRewrite' + fuzzy_transpositions: + description: |- + If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). + Can be applied to the term subqueries constructed for all terms but the final term. + type: boolean + max_expansions: + description: |- + Maximum number of terms to which the query will expand. + Can be applied to the term subqueries constructed for all terms but the final term. + type: integer + format: int32 + minimum_should_match: + $ref: '#/components/schemas/_common___MinimumShouldMatch' + operator: + $ref: '#/components/schemas/_common.query_dsl___Operator' + prefix_length: + description: |- + Number of beginning characters left unchanged for fuzzy matching. + Can be applied to the term subqueries constructed for all terms but the final term. + type: integer + format: int32 + query: + description: |- + Terms you wish to find in the provided field. + The last term is used in a prefix query. + type: string + required: + - query _common.query_dsl___MatchNoneQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - type: object _common.query_dsl___MatchPhrasePrefixQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - analyzer: - description: Analyzer used to convert text in the query value into tokens. - type: string - max_expansions: - description: Maximum number of terms to which the last provided term of the query value will expand. - type: integer - format: int32 - query: - description: Text you wish to find in the provided field. - type: string - slop: - description: Maximum number of positions allowed between matching tokens. - type: integer - format: int32 - zero_terms_query: - $ref: '#/components/schemas/_common.query_dsl___ZeroTermsQuery' - required: - - query + oneOf: + - title: query + type: string + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert text in the query value into tokens. + type: string + max_expansions: + description: Maximum number of terms to which the last provided term of the query value will expand. + type: integer + format: int32 + query: + description: Text you wish to find in the provided field. + type: string + slop: + description: Maximum number of positions allowed between matching tokens. + type: integer + format: int32 + zero_terms_query: + $ref: '#/components/schemas/_common.query_dsl___ZeroTermsQuery' + required: + - query _common.query_dsl___MatchPhraseQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - analyzer: - description: Analyzer used to convert the text in the query value into tokens. - type: string - query: - description: Query terms that are analyzed and turned into a phrase query. - type: string - slop: - description: Maximum number of positions allowed between matching tokens. - type: integer - format: int32 - zero_terms_query: - $ref: '#/components/schemas/_common.query_dsl___ZeroTermsQuery' - required: - - query + oneOf: + - title: query + type: string + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert the text in the query value into tokens. + type: string + query: + description: Query terms that are analyzed and turned into a phrase query. + type: string + slop: + description: Maximum number of positions allowed between matching tokens. + type: integer + format: int32 + zero_terms_query: + $ref: '#/components/schemas/_common.query_dsl___ZeroTermsQuery' + required: + - query _common.query_dsl___MatchQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - analyzer: - description: Analyzer used to convert the text in the query value into tokens. - type: string - auto_generate_synonyms_phrase_query: - description: If `true`, match phrase queries are automatically created for multi-term synonyms. - type: boolean - cutoff_frequency: - deprecated: true - type: number - format: float - fuzziness: - $ref: '#/components/schemas/_common___Fuzziness' - fuzzy_rewrite: - $ref: '#/components/schemas/_common___MultiTermQueryRewrite' - fuzzy_transpositions: - description: If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). - type: boolean - lenient: - description: If `true`, format-based errors, such as providing a text query value for a numeric field, are ignored. - type: boolean - max_expansions: - description: Maximum number of terms to which the query will expand. - type: integer - format: int32 - minimum_should_match: - $ref: '#/components/schemas/_common___MinimumShouldMatch' - operator: - $ref: '#/components/schemas/_common.query_dsl___Operator' - prefix_length: - description: Number of beginning characters left unchanged for fuzzy matching. - type: integer - format: int32 - query: - description: Text, number, Boolean value or date you wish to find in the provided field. - oneOf: - - type: string - - type: number - - type: boolean - zero_terms_query: - $ref: '#/components/schemas/_common.query_dsl___ZeroTermsQuery' - required: - - query + oneOf: + - title: query + $ref: '#/components/schemas/_common___FieldValue' + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + analyzer: + description: Analyzer used to convert the text in the query value into tokens. + type: string + auto_generate_synonyms_phrase_query: + description: If `true`, match phrase queries are automatically created for multi-term synonyms. + type: boolean + cutoff_frequency: + deprecated: true + type: number + format: float + fuzziness: + $ref: '#/components/schemas/_common___Fuzziness' + fuzzy_rewrite: + $ref: '#/components/schemas/_common___MultiTermQueryRewrite' + fuzzy_transpositions: + description: If `true`, edits for fuzzy matching include transpositions of two adjacent characters (for example, `ab` to `ba`). + type: boolean + lenient: + description: If `true`, format-based errors, such as providing a text query value for a numeric field, are ignored. + type: boolean + max_expansions: + description: Maximum number of terms to which the query will expand. + type: integer + format: int32 + minimum_should_match: + $ref: '#/components/schemas/_common___MinimumShouldMatch' + operator: + $ref: '#/components/schemas/_common.query_dsl___Operator' + prefix_length: + description: Number of beginning characters left unchanged for fuzzy matching. + type: integer + format: int32 + query: + description: Text, number, Boolean value or date you wish to find in the provided field. + $ref: '#/components/schemas/_common___FieldValue' + zero_terms_query: + $ref: '#/components/schemas/_common.query_dsl___ZeroTermsQuery' + required: + - query _common.query_dsl___MoreLikeThisQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -41585,28 +42809,24 @@ components: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - type: object - additionalProperties: - $ref: '#/components/schemas/_common.query_dsl___NeuralQueryVectorField' - _common.query_dsl___NeuralQueryVectorField: - type: object - properties: - query_text: - type: string - query_image: - type: string - contentEncoding: base64 - model_id: - type: string - k: - type: integer - min_score: - type: number - format: float - max_distance: - type: number - format: float - filter: - $ref: '#/components/schemas/_common.query_dsl___QueryContainer' + properties: + query_text: + type: string + query_image: + type: string + contentEncoding: base64 + model_id: + type: string + k: + type: integer + min_score: + type: number + format: float + max_distance: + type: number + format: float + filter: + $ref: '#/components/schemas/_common.query_dsl___QueryContainer' _common.query_dsl___NumberRangeQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___RangeQueryBase' @@ -41642,7 +42862,9 @@ components: type: string enum: - and + - AND - or + - OR _common.query_dsl___ParentIdQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -41662,12 +42884,10 @@ components: properties: document: description: The source of the document being percolated. - type: object documents: description: An array of sources of the documents being percolated. type: array - items: - type: object + items: {} field: $ref: '#/components/schemas/_common___Field' id: @@ -41725,22 +42945,25 @@ components: minProperties: 1 maxProperties: 1 _common.query_dsl___PrefixQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - rewrite: - $ref: '#/components/schemas/_common___MultiTermQueryRewrite' - value: - description: Beginning characters of terms you wish to find in the provided field. - type: string - case_insensitive: - description: |- - Allows ASCII case insensitive matching of the value with the indexed field values when set to `true`. - Default is `false` which means the case sensitivity of matching depends on the underlying field's mapping. - type: boolean - required: - - value + oneOf: + - title: value + type: string + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + rewrite: + $ref: '#/components/schemas/_common___MultiTermQueryRewrite' + value: + description: Beginning characters of terms you wish to find in the provided field. + type: string + case_insensitive: + description: |- + Allows ASCII case insensitive matching of the value with the indexed field values when set to `true`. + Default is `false` which means the case sensitivity of matching depends on the underlying field's mapping. + type: boolean + required: + - value _common.query_dsl___QueryBase: type: object properties: @@ -41764,6 +42987,8 @@ components: common: deprecated: true type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___CommonTermsQuery' minProperties: 1 @@ -41783,6 +43008,8 @@ components: fuzzy: description: Returns documents that contain terms similar to the search term, as measured by a Levenshtein edit distance. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___FuzzyQuery' minProperties: 1 @@ -41799,26 +43026,36 @@ components: $ref: '#/components/schemas/_common.query_dsl___HasChildQuery' has_parent: $ref: '#/components/schemas/_common.query_dsl___HasParentQuery' + hybrid: + $ref: '#/components/schemas/_common.query_dsl___HybridQuery' ids: $ref: '#/components/schemas/_common.query_dsl___IdsQuery' intervals: description: Returns documents based on the order and proximity of matching terms. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___IntervalsQuery' minProperties: 1 maxProperties: 1 knn: - $ref: '#/components/schemas/_common.query_dsl___KnnQuery' + type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl___KnnQuery' + minProperties: 1 + maxProperties: 1 match: description: |- Returns documents that match a provided text, number, date or Boolean value. The provided text is analyzed before matching. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: - anyOf: - - $ref: '#/components/schemas/_common.query_dsl___MatchQuery' - - {} + $ref: '#/components/schemas/_common.query_dsl___MatchQuery' minProperties: 1 maxProperties: 1 match_all: @@ -41829,6 +43066,8 @@ components: Each term except the last is used in a `term` query. The last term is used in a prefix query. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___MatchBoolPrefixQuery' minProperties: 1 @@ -41838,6 +43077,8 @@ components: match_phrase: description: Analyzes the text and creates a phrase query out of the analyzed text. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___MatchPhraseQuery' minProperties: 1 @@ -41847,6 +43088,8 @@ components: Returns documents that contain the words of a provided text, in the same order as provided. The last term of the provided text is treated as a prefix, matching any words that begin with that term. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___MatchPhrasePrefixQuery' minProperties: 1 @@ -41858,7 +43101,13 @@ components: nested: $ref: '#/components/schemas/_common.query_dsl___NestedQuery' neural: - $ref: '#/components/schemas/_common.query_dsl___NeuralQuery' + type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl___NeuralQuery' + minProperties: 1 + maxProperties: 1 parent_id: $ref: '#/components/schemas/_common.query_dsl___ParentIdQuery' percolate: @@ -41868,6 +43117,8 @@ components: prefix: description: Returns documents that contain a specific prefix in a provided field. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___PrefixQuery' minProperties: 1 @@ -41877,6 +43128,8 @@ components: range: description: Returns documents that contain terms within a provided range. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___RangeQuery' minProperties: 1 @@ -41886,12 +43139,12 @@ components: regexp: description: Returns documents that contain terms matching a regular expression. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___RegexpQuery' minProperties: 1 maxProperties: 1 - rule_query: - $ref: '#/components/schemas/_common.query_dsl___RuleQuery' script: $ref: '#/components/schemas/_common.query_dsl___ScriptQuery' script_score: @@ -41915,6 +43168,8 @@ components: span_term: description: Matches spans containing a term. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___SpanTermQuery' minProperties: 1 @@ -41926,43 +43181,33 @@ components: Returns documents that contain an exact term in a provided field. To return a document, the query term must exactly match the queried field's value, including white space and capitalization. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: - anyOf: - - $ref: '#/components/schemas/_common.query_dsl___TermQuery' - - $ref: '#/components/schemas/_common___FieldValue' + $ref: '#/components/schemas/_common.query_dsl___TermQuery' minProperties: 1 maxProperties: 1 terms: description: Returns documents that contain one or more exact terms in a provided field. - $ref: '#/components/schemas/_common.query_dsl___TermsQueryField' + $ref: '#/components/schemas/_common.query_dsl___TermsQuery' terms_set: description: |- Returns documents that contain a minimum number of exact terms in a provided field. To return a document, a required number of terms must exactly match the field values, including white space and capitalization. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___TermsSetQuery' minProperties: 1 maxProperties: 1 - text_expansion: - description: Uses a natural language processing model to convert the query text into a list of token-weight pairs which are then used in a query against a sparse vector or rank features field. - type: object - additionalProperties: - $ref: '#/components/schemas/_common.query_dsl___TextExpansionQuery' - minProperties: 1 - maxProperties: 1 type: $ref: '#/components/schemas/_common.query_dsl___TypeQuery' - weighted_tokens: - description: Supports returning `text_expansion` query results by sending in precomputed tokens with the query. - type: object - additionalProperties: - $ref: '#/components/schemas/_common.query_dsl___WeightedTokensQuery' - minProperties: 1 - maxProperties: 1 wildcard: description: Returns documents that contain terms matching a wildcard pattern. type: object + propertyNames: + $ref: '#/components/schemas/_common___Field' additionalProperties: $ref: '#/components/schemas/_common.query_dsl___WildcardQuery' minProperties: 1 @@ -42057,6 +43302,11 @@ components: $ref: '#/components/schemas/_common.query_dsl___TextQueryType' required: - query + _common.query_dsl___QueryVector: + type: array + items: + type: number + format: float _common.query_dsl___RandomScoreFunction: type: object properties: @@ -42144,44 +43394,32 @@ components: required: - field _common.query_dsl___RegexpQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - case_insensitive: - description: |- - Allows case insensitive matching of the regular expression value with the indexed field values when set to `true`. - When `false`, case sensitivity of matching depends on the underlying field's mapping. - type: boolean - flags: - description: Enables optional operators for the regular expression. - type: string - max_determinized_states: - description: Maximum number of automaton states required for the query. - type: integer - format: int32 - rewrite: - $ref: '#/components/schemas/_common___MultiTermQueryRewrite' - value: - description: Regular expression for terms you wish to find in the provided field. - type: string - required: - - value - _common.query_dsl___RuleQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - organic: - $ref: '#/components/schemas/_common.query_dsl___QueryContainer' - ruleset_id: - $ref: '#/components/schemas/_common___Id' - match_criteria: - type: object - required: - - match_criteria - - organic - - ruleset_id + oneOf: + - title: value + type: string + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + case_insensitive: + description: |- + Allows case insensitive matching of the regular expression value with the indexed field values when set to `true`. + When `false`, case sensitivity of matching depends on the underlying field's mapping. + type: boolean + flags: + description: Enables optional operators for the regular expression. + type: string + max_determinized_states: + description: Maximum number of automaton states required for the query. + type: integer + format: int32 + rewrite: + $ref: '#/components/schemas/_common___MultiTermQueryRewrite' + value: + description: Regular expression for terms you wish to find in the provided field. + type: string + required: + - value _common.query_dsl___ScriptQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -42232,8 +43470,11 @@ components: - WHITESPACE _common.query_dsl___SimpleQueryStringFlags: description: Query flags can be either a single flag or a combination of flags (e.g. `OR|AND|PREFIX`). - allOf: - - $ref: '#/components/schemas/_common___PipeSeparatedFlagsSimpleQueryStringFlag' + oneOf: + - title: single + $ref: '#/components/schemas/_common.query_dsl___SimpleQueryStringFlag' + - title: multiple + type: string _common.query_dsl___SimpleQueryStringQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -42428,14 +43669,17 @@ components: minProperties: 1 maxProperties: 1 _common.query_dsl___SpanTermQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - value: - type: string - required: - - value + oneOf: + - title: value + type: string + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + value: + type: string + required: + - value _common.query_dsl___SpanWithinQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -42449,20 +43693,23 @@ components: - big - little _common.query_dsl___TermQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - value: - $ref: '#/components/schemas/_common___FieldValue' - case_insensitive: - description: |- - Allows ASCII case insensitive matching of the value with the indexed field values when set to `true`. - When `false`, the case sensitivity of matching depends on the underlying field's mapping. - type: boolean - required: - - value - _common.query_dsl___TermsLookupField: + oneOf: + - title: value + $ref: '#/components/schemas/_common___FieldValue' + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + value: + $ref: '#/components/schemas/_common___FieldValue' + case_insensitive: + description: |- + Allows ASCII case insensitive matching of the value with the indexed field values when set to `true`. + When `false`, the case sensitivity of matching depends on the underlying field's mapping. + type: boolean + required: + - value + _common.query_dsl___TermsLookup: type: object properties: index: @@ -42473,22 +43720,24 @@ components: $ref: '#/components/schemas/_common___Field' routing: $ref: '#/components/schemas/_common___Routing' + _common.query_dsl___TermsQuery: + allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + _name: {} + boost: {} + additionalProperties: + $ref: '#/components/schemas/_common.query_dsl___TermsQueryField' + minProperties: 1 _common.query_dsl___TermsQueryField: - type: object - properties: - boost: - description: |- - A floating-point value that specifies the weight of this field toward the relevance score. - Values above 1.0 increase the field’s relevance. Values between 0.0 and 1.0 decrease the field’s relevance. - Default is 1.0. - type: number - format: float - additionalProperties: - oneOf: - - $ref: '#/components/schemas/_common.query_dsl___TermsLookupField' - - type: array - items: - type: string + oneOf: + - title: value + type: array + items: + $ref: '#/components/schemas/_common___FieldValue' + - title: lookup + $ref: '#/components/schemas/_common.query_dsl___TermsLookup' _common.query_dsl___TermsSetQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -42504,22 +43753,6 @@ components: type: string required: - terms - _common.query_dsl___TextExpansionQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - model_id: - description: The text expansion NLP model to use - type: string - model_text: - description: The query text - type: string - pruning_config: - $ref: '#/components/schemas/_common.query_dsl___TokenPruningConfig' - required: - - model_id - - model_text _common.query_dsl___TextQueryType: type: string enum: @@ -42529,18 +43762,6 @@ components: - most_fields - phrase - phrase_prefix - _common.query_dsl___TokenPruningConfig: - type: object - properties: - tokens_freq_ratio_threshold: - description: Tokens whose frequency is more than this threshold times the average frequency of all tokens in the specified field are considered outliers and pruned. - type: number - tokens_weight_threshold: - description: Tokens whose weight is less than this threshold are considered nonsignificant and pruned. - type: number - only_score_pruned_tokens: - description: Whether to only score pruned tokens, vs only scoring kept tokens. - type: boolean _common.query_dsl___TypeQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -42550,36 +43771,25 @@ components: type: string required: - value - _common.query_dsl___WeightedTokensQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - tokens: - description: The tokens representing this query - type: object - additionalProperties: - type: number - pruning_config: - $ref: '#/components/schemas/_common.query_dsl___TokenPruningConfig' - required: - - tokens _common.query_dsl___WildcardQuery: - allOf: - - $ref: '#/components/schemas/_common.query_dsl___QueryBase' - - type: object - properties: - case_insensitive: - description: Allows case insensitive matching of the pattern with the indexed field values when set to `true`. Default is `false` which means the case sensitivity of matching depends on the underlying field's mapping. - type: boolean - rewrite: - $ref: '#/components/schemas/_common___MultiTermQueryRewrite' - value: - description: Wildcard pattern for terms you wish to find in the provided field. Required, when wildcard is not set. - type: string - wildcard: - description: Wildcard pattern for terms you wish to find in the provided field. Required, when value is not set. - type: string + oneOf: + - title: value + type: string + - allOf: + - $ref: '#/components/schemas/_common.query_dsl___QueryBase' + - type: object + properties: + case_insensitive: + description: Allows case insensitive matching of the pattern with the indexed field values when set to `true`. Default is `false` which means the case sensitivity of matching depends on the underlying field's mapping. + type: boolean + rewrite: + $ref: '#/components/schemas/_common___MultiTermQueryRewrite' + value: + description: Wildcard pattern for terms you wish to find in the provided field. Required, when wildcard is not set. + type: string + wildcard: + description: Wildcard pattern for terms you wish to find in the provided field. Required, when value is not set. + type: string _common.query_dsl___WrapperQuery: allOf: - $ref: '#/components/schemas/_common.query_dsl___QueryBase' @@ -43007,7 +44217,9 @@ components: The value is the variable value. type: object additionalProperties: - type: object + oneOf: + - type: string + - type: object profile: description: When `true`, provides a profile for the query execution. type: boolean @@ -43251,6 +44463,8 @@ components: $ref: '#/components/schemas/_core.termvectors___TermVector' error: $ref: '#/components/schemas/_common___ErrorCause' + _type: + $ref: '#/components/schemas/_common___Type' required: - _id - _index @@ -43277,6 +44491,8 @@ components: $ref: '#/components/schemas/_common___IndexName' _score: type: number + _type: + $ref: '#/components/schemas/_common___Type' required: - _id - _index @@ -43334,7 +44550,7 @@ components: additionalProperties: type: object additionalProperties: - type: object + type: number required: - hits - metric_details @@ -43490,12 +44706,16 @@ components: type: string cancellable: type: boolean + cancelled: + type: boolean description: type: string id: type: number node: $ref: '#/components/schemas/_common___Name' + resource_stats: + $ref: '#/components/schemas/_common___ResourceStats' running_time_in_nanos: $ref: '#/components/schemas/_common___DurationValueUnitNanos' start_time_in_millis: @@ -43588,7 +44808,6 @@ components: required: - document - index - - query _core.search_shards___ShardStoreIndex: type: object properties: @@ -43773,11 +44992,14 @@ components: - sentence - word _core.search___BuiltinHighlighterType: - type: string - enum: - - fvh - - plain - - unified + oneOf: + - type: string + const: plain + - title: fast_vector + type: string + const: fvh + - type: string + const: unified _core.search___Collector: type: object properties: @@ -43957,6 +45179,9 @@ components: type: boolean fragmenter: $ref: '#/components/schemas/_core.search___HighlighterFragmenter' + fragment_offset: + type: integer + format: int32 fragment_size: description: The size of the highlighted fragment in characters. type: integer @@ -43968,11 +45193,11 @@ components: max_fragment_length: type: integer format: int32 - max_analyzed_offset: + max_analyzer_offset: description: |- If set to a non-negative value, highlighting stops at this defined maximum limit. The rest of the text is not processed or highlighted, and no error is returned. - The `max_analyzed_offset` query setting does not override the `index.highlight.max_analyzed_offset` setting, which takes precedence when it is set to a lower value than the query setting. + The `max_analyzer_offset` query setting does not override the `index.highlight.max_analyzed_offset` setting, which takes precedence when it is set to a lower value than the query setting. type: integer format: int32 no_match_size: @@ -44052,9 +45277,6 @@ components: - $ref: '#/components/schemas/_core.search___HighlightBase' - type: object properties: - fragment_offset: - type: integer - format: int32 matched_fields: $ref: '#/components/schemas/_common___Fields' analyzer: @@ -44077,8 +45299,7 @@ components: $ref: '#/components/schemas/_core.explain___Explanation' fields: type: object - additionalProperties: - type: object + additionalProperties: true highlight: type: object additionalProperties: @@ -44182,7 +45403,7 @@ components: $ref: '#/components/schemas/_common___Sort' _source: $ref: '#/components/schemas/_core.search___SourceConfig' - stored_field: + stored_fields: $ref: '#/components/schemas/_common___Fields' track_scores: type: boolean @@ -44477,10 +45698,6 @@ components: oneOf: - title: fetch type: boolean - - title: includes - type: array - items: - $ref: '#/components/schemas/_common___Field' - title: filter $ref: '#/components/schemas/_core.search___SourceFilter' _core.search___SourceConfigParam: @@ -44491,12 +45708,15 @@ components: - type: boolean - $ref: '#/components/schemas/_common___Fields' _core.search___SourceFilter: - type: object - properties: - excludes: - $ref: '#/components/schemas/_common___Fields' - includes: + oneOf: + - title: includes $ref: '#/components/schemas/_common___Fields' + - type: object + properties: + excludes: + $ref: '#/components/schemas/_common___Fields' + includes: + $ref: '#/components/schemas/_common___Fields' _core.search___Suggest: oneOf: - $ref: '#/components/schemas/_core.search___CompletionSuggest' @@ -47085,7 +48305,8 @@ components: transport_address: $ref: '#/components/schemas/_common___TransportAddress' weight_ranking: - type: number + type: integer + format: int32 required: - attributes - id @@ -47153,7 +48374,8 @@ components: transport_address: $ref: '#/components/schemas/_common___TransportAddress' weight_ranking: - type: number + type: integer + format: int32 required: - deciders - node_attributes @@ -47182,7 +48404,8 @@ components: path: type: string total: - type: number + type: integer + format: int64 shards: type: array items: @@ -47204,7 +48427,8 @@ components: details: type: string failed_allocation_attempts: - type: number + type: integer + format: int32 delayed: type: boolean allocation_status: @@ -47248,26 +48472,34 @@ components: x-version-added: '2.5' properties: active_shards: - type: number + type: integer + format: int32 initializing_shards: - type: number + type: integer + format: int32 relocating_shards: - type: number + type: integer + format: int32 unassigned_shards: - type: number + type: integer + format: int32 data_nodes: - type: number + type: integer + format: int32 weight: - type: number + type: integer + format: int32 cluster.health___HealthResponseBody: type: object properties: active_primary_shards: description: The number of active primary shards. - type: number + type: integer + format: int32 active_shards: description: The total number of active primary and replica shards. - type: number + type: integer + format: int32 active_shards_percent: $ref: '#/components/schemas/_common___PercentageString' active_shards_percent_as_number: @@ -47282,7 +48514,8 @@ components: $ref: '#/components/schemas/_common___Name' delayed_unassigned_shards: description: The number of shards whose allocation has been delayed by the timeout settings. - type: number + type: integer + format: int32 discovered_master: description: True if the cluster-manager node has been discovered. type: boolean @@ -47297,22 +48530,28 @@ components: $ref: '#/components/schemas/cluster.health___IndexHealthStats' initializing_shards: description: The number of shards that are under initialization. - type: number + type: integer + format: int32 number_of_data_nodes: description: The number of nodes that are dedicated data nodes. - type: number + type: integer + format: int32 number_of_in_flight_fetch: description: The number of unfinished fetches. - type: number + type: integer + format: int32 number_of_nodes: description: The number of nodes within the cluster. - type: number + type: integer + format: int32 number_of_pending_tasks: description: The number of cluster-level changes that have not yet been executed. - type: number + type: integer + format: int32 relocating_shards: description: The number of shards that are under relocation. - type: number + type: integer + format: int32 status: $ref: '#/components/schemas/_common___HealthStatus' task_max_waiting_in_queue: @@ -47324,7 +48563,8 @@ components: type: boolean unassigned_shards: description: The number of shards that are not allocated. - type: number + type: integer + format: int32 required: - active_primary_shards - active_shards @@ -47345,17 +48585,23 @@ components: type: object properties: active_primary_shards: - type: number + type: integer + format: int32 active_shards: - type: number + type: integer + format: int32 initializing_shards: - type: number + type: integer + format: int32 number_of_replicas: - type: number + type: integer + format: int32 number_of_shards: - type: number + type: integer + format: int32 relocating_shards: - type: number + type: integer + format: int32 shards: type: object additionalProperties: @@ -47363,7 +48609,8 @@ components: status: $ref: '#/components/schemas/_common___HealthStatus' unassigned_shards: - type: number + type: integer + format: int32 required: - active_primary_shards - active_shards @@ -47384,17 +48631,21 @@ components: type: object properties: active_shards: - type: number + type: integer + format: int32 initializing_shards: - type: number + type: integer + format: int32 primary_active: type: boolean relocating_shards: - type: number + type: integer + format: int32 status: $ref: '#/components/schemas/_common___HealthStatus' unassigned_shards: - type: number + type: integer + format: int32 required: - active_shards - initializing_shards @@ -47410,7 +48661,8 @@ components: type: boolean insert_order: description: The number that represents when the task has been inserted into the task queue. - type: number + type: integer + format: int32 priority: description: |- The priority of the pending task. @@ -47454,9 +48706,11 @@ components: server_name: type: string num_proxy_sockets_connected: - type: number + type: integer + format: int32 max_proxy_socket_connections: - type: number + type: integer + format: int32 required: - connected - initial_connect_timeout @@ -47476,9 +48730,11 @@ components: connected: type: boolean max_connections_per_cluster: - type: number + type: integer + format: int32 num_nodes_connected: - type: number + type: integer + format: int64 initial_connect_timeout: $ref: '#/components/schemas/_common___Duration' skip_unavailable: @@ -47499,14 +48755,48 @@ components: type: object properties: cancel: + description: |- + Cancel allocation of a shard (or recovery). Accepts `index` and `shard` for index + name and shard number, and `node` for the node to cancel the shard allocation + on. This can be used to force resynchronization of existing replicas from the + primary shard by cancelling them and allowing them to be reinitialized + through the standard recovery process. By default only replica shard + allocations can be cancelled. If it is necessary to cancel the allocation of + a primary shard then the `allow_primary` flag must also be included in the + request. $ref: '#/components/schemas/cluster.reroute___CommandCancelAction' move: + description: |- + Move a started shard from one node to another node. Accepts `index` and `shard` + for index name and shard number, `from_node` for the node to move the shard + from, and `to_node` for the node to move the shard to. $ref: '#/components/schemas/cluster.reroute___CommandMoveAction' allocate_replica: + description: |- + Allocate an unassigned replica shard to a node. Accepts `index` and `shard` for + index name and shard number, and `node` to allocate the shard to. Takes + allocation deciders into account. $ref: '#/components/schemas/cluster.reroute___CommandAllocateReplicaAction' allocate_stale_primary: + description: |- + Allocate a primary shard to a node that holds a stale copy. Accepts `index` + and `shard` for index name and shard number, and `node` to allocate the shard to. + Using this command may lead to data loss for the provided shard id. If a node + which has the good copy of the data rejoins the cluster later on, that data + will be deleted or overwritten with the data of the stale copy that was + forcefully allocated with this command. To ensure that these implications are + well-understood, this command requires the flag `accept_data_loss` to be + explicitly set to true. $ref: '#/components/schemas/cluster.reroute___CommandAllocatePrimaryAction' allocate_empty_primary: + description: |- + Allocate an empty primary shard to a node. Accepts `index` and `shard` for + index name and shard number, and `node` to allocate the shard to. Using this + command leads to a complete loss of all data that was indexed into this + shard, if it was previously started. If a node which has a copy of the data + rejoins the cluster later on, that data will be deleted. To ensure that these + implications are well-understood, this command requires the flag + `accept_data_loss` to be explicitly set to true. $ref: '#/components/schemas/cluster.reroute___CommandAllocatePrimaryAction' cluster.reroute___CommandAllocatePrimaryAction: type: object @@ -47514,7 +48804,8 @@ components: index: $ref: '#/components/schemas/_common___IndexName' shard: - type: number + type: integer + format: int32 node: type: string accept_data_loss: @@ -47531,7 +48822,8 @@ components: index: $ref: '#/components/schemas/_common___IndexName' shard: - type: number + type: integer + format: int32 node: type: string required: @@ -47544,7 +48836,8 @@ components: index: $ref: '#/components/schemas/_common___IndexName' shard: - type: number + type: integer + format: int32 node: type: string allow_primary: @@ -47559,7 +48852,8 @@ components: index: $ref: '#/components/schemas/_common___IndexName' shard: - type: number + type: integer + format: int32 from_node: description: The node to move the shard from type: string @@ -47621,7 +48915,8 @@ components: node: $ref: '#/components/schemas/_common___NodeName' shard: - type: number + type: integer + format: int32 from_node: $ref: '#/components/schemas/_common___NodeName' to_node: @@ -47743,7 +49038,8 @@ components: $ref: '#/components/schemas/_common___CompletionStats' count: description: Total number of indexes with shards assigned to selected nodes. - type: number + type: integer + format: int64 docs: $ref: '#/components/schemas/_common___DocStats' fielddata: @@ -47770,21 +49066,27 @@ components: $ref: '#/components/schemas/cluster.stats___ClusterIndicesShardsIndex' primaries: description: Number of primary shards assigned to selected nodes. - type: number + type: integer + format: int32 replication: description: Ratio of replica shards to primary shards across all selected nodes. - type: number + type: integer + format: int32 total: description: Total number of shards assigned to selected nodes. - type: number + type: integer + format: int32 cluster.stats___ClusterIndicesShardsIndex: type: object properties: primaries: + description: Contains statistics about the number of primary shards assigned to selected nodes. $ref: '#/components/schemas/cluster.stats___ClusterShardMetrics' replication: + description: Contains statistics about the number of replication shards assigned to selected nodes. $ref: '#/components/schemas/cluster.stats___ClusterShardMetrics' shards: + description: Contains statistics about the number of shards assigned to selected nodes. $ref: '#/components/schemas/cluster.stats___ClusterShardMetrics' required: - primaries @@ -47794,7 +49096,8 @@ components: type: object properties: number_of_pipelines: - type: number + type: integer + format: int32 processor_stats: type: object additionalProperties: @@ -47813,7 +49116,8 @@ components: $ref: '#/components/schemas/cluster.stats___ClusterJvmMemory' threads: description: Number of active threads in use by JVM across all selected nodes. - type: number + type: integer + format: int64 versions: description: Contains statistics about the JVM versions used by selected nodes. type: array @@ -47850,7 +49154,8 @@ components: type: boolean count: description: Total number of selected nodes using JVM. - type: number + type: integer + format: int32 using_bundled_jdk: description: If `true`, a bundled JDK is in use by JVM. type: boolean @@ -47879,12 +49184,14 @@ components: description: Contains statistics about the HTTP network types used by selected nodes. type: object additionalProperties: - type: number + type: integer + format: int32 transport_types: description: Contains statistics about the transport network types used by selected nodes. type: object additionalProperties: - type: number + type: integer + format: int32 required: - http_types - transport_types @@ -47892,39 +49199,55 @@ components: type: object properties: coordinating_only: - type: number + type: integer + format: int32 data: - type: number + type: integer + format: int32 data_cold: - type: number + type: integer + format: int32 data_content: - type: number + type: integer + format: int32 data_frozen: - type: number + type: integer + format: int32 data_hot: - type: number + type: integer + format: int32 data_warm: - type: number + type: integer + format: int32 ingest: - type: number + type: integer + format: int32 master: - type: number + type: integer + format: int32 cluster_manager: - type: number + type: integer + format: int32 x-version-added: '2.0' ml: - type: number + type: integer + format: int32 remote_cluster_client: - type: number + type: integer + format: int32 search: - type: number + type: integer + format: int32 x-version-added: '2.4' total: - type: number + type: integer + format: int32 transform: - type: number + type: integer + format: int32 voting_only: - type: number + type: integer + format: int32 required: - coordinating_only - data @@ -47936,23 +49259,29 @@ components: type: object properties: count: + description: Contains counts for nodes selected by the request's node filters. $ref: '#/components/schemas/cluster.stats___ClusterNodeCount' discovery_types: description: Contains statistics about the discovery types used by selected nodes. type: object additionalProperties: - type: number + type: integer + format: int32 fs: + description: Contains statistics about file stores by selected nodes. $ref: '#/components/schemas/cluster.stats___ClusterFileSystem' indexing_pressure: $ref: '#/components/schemas/cluster.stats___IndexingPressure' ingest: $ref: '#/components/schemas/cluster.stats___ClusterIngest' jvm: + description: Contains statistics about the Java Virtual Machines (JVMs) used by selected nodes. $ref: '#/components/schemas/cluster.stats___ClusterJvm' network_types: + description: Contains statistics about the transport and HTTP networks used by selected nodes. $ref: '#/components/schemas/cluster.stats___ClusterNetworkTypes' os: + description: Contains statistics about the operating systems used by selected nodes. $ref: '#/components/schemas/cluster.stats___ClusterOperatingSystem' packaging_types: description: Contains statistics about OpenSearch distributions installed on selected nodes. @@ -47967,6 +49296,7 @@ components: items: $ref: '#/components/schemas/_common___PluginStats' process: + description: Contains statistics about processes used by selected nodes. $ref: '#/components/schemas/cluster.stats___ClusterProcess' versions: description: Array of OpenSearch versions used on selected nodes. @@ -47981,7 +49311,8 @@ components: Number of processors used to calculate thread pool size across all selected nodes. This number can be set with the processors setting of a node and defaults to the number of processors reported by the operating system. In both cases, this number will never be larger than 32. - type: number + type: integer + format: int32 architectures: description: Contains statistics about processor architectures (for example, x86_64 or aarch64) used by selected nodes. type: array @@ -47989,7 +49320,8 @@ components: $ref: '#/components/schemas/cluster.stats___ClusterOperatingSystemArchitecture' available_processors: description: Number of processors available to JVM across all selected nodes. - type: number + type: integer + format: int32 mem: $ref: '#/components/schemas/cluster.stats___OperatingSystemMemoryInfo' names: @@ -48016,7 +49348,8 @@ components: type: string count: description: Number of selected nodes using the architecture. - type: number + type: integer + format: int32 required: - arch - count @@ -48025,7 +49358,8 @@ components: properties: count: description: Number of selected nodes using the operating system. - type: number + type: integer + format: int32 name: $ref: '#/components/schemas/_common___Name' required: @@ -48036,7 +49370,8 @@ components: properties: count: description: Number of selected nodes using the operating system. - type: number + type: integer + format: int32 pretty_name: $ref: '#/components/schemas/_common___Name' required: @@ -48069,17 +49404,20 @@ components: description: |- Average number of concurrently open file descriptors. Returns `-1` if not supported. - type: number + type: integer + format: int64 max: description: |- Maximum number of concurrently open file descriptors allowed across all selected nodes. Returns `-1` if not supported. - type: number + type: integer + format: int64 min: description: |- Minimum number of concurrently open file descriptors across all selected nodes. Returns -1 if not supported. - type: number + type: integer + format: int64 required: - avg - max @@ -48088,11 +49426,14 @@ components: type: object properties: count: - type: number + type: integer + format: int64 current: - type: number + type: integer + format: int64 failed: - type: number + type: integer + format: int64 time: $ref: '#/components/schemas/_common___Duration' time_in_millis: @@ -48108,12 +49449,15 @@ components: avg: description: Mean number of shards in an index, counting only shards assigned to selected nodes. type: number + format: double max: description: Maximum number of shards in an index, counting only shards assigned to selected nodes. type: number + format: double min: description: Minimum number of shards in an index, counting only shards assigned to selected nodes. type: number + format: double required: - avg - max @@ -48125,22 +49469,12 @@ components: $ref: '#/components/schemas/_common___Name' count: description: The number of occurrences of the field type in selected nodes. - type: number + type: integer + format: int32 index_count: description: The number of indexes containing the field type in selected nodes. - type: number - indexed_vector_count: - description: For `dense_vector` field types, number of indexed vector types in selected nodes. - type: number - indexed_vector_dim_max: - description: For `dense_vector` field types, the maximum dimension of all indexed vector types in selected nodes. - type: number - indexed_vector_dim_min: - description: For `dense_vector` field types, the minimum dimension of all indexed vector types in selected nodes. - type: number - script_count: - description: The number of fields that declare a script. - type: number + type: integer + format: int32 required: - count - index_count @@ -48153,17 +49487,6 @@ components: type: array items: $ref: '#/components/schemas/cluster.stats___FieldTypes' - total_field_count: - description: Total number of fields in all non-system indexes. - type: number - total_deduplicated_field_count: - description: Total number of fields in all non-system indexes, accounting for mapping deduplication. - type: number - total_deduplicated_mapping_size: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - total_deduplicated_mapping_size_in_bytes: - description: Total size of all mappings, in bytes, after deduplication and compression. - $ref: '#/components/schemas/_common___ByteCount' required: - field_types cluster.stats___IndexingPressure: @@ -48228,9 +49551,11 @@ components: type: object properties: index_count: - type: number + type: integer + format: int32 primary_shard_count: - type: number + type: integer + format: int32 total_primary_bytes: $ref: '#/components/schemas/_common___ByteCount' version: @@ -48259,7 +49584,8 @@ components: properties: count: description: Number of selected nodes using the distribution flavor and file type. - type: number + type: integer + format: int32 flavor: description: Type of OpenSearch distribution. This is always `default`. type: string @@ -48305,29 +49631,6 @@ components: - total_in_bytes - used_in_bytes - used_percent - cluster.stats___StatsResponseBase: - allOf: - - $ref: '#/components/schemas/nodes._common___NodesResponseBase' - - type: object - properties: - cluster_name: - $ref: '#/components/schemas/_common___Name' - cluster_uuid: - $ref: '#/components/schemas/_common___Uuid' - indices: - $ref: '#/components/schemas/cluster.stats___ClusterIndices' - nodes: - $ref: '#/components/schemas/cluster.stats___ClusterNodes' - status: - $ref: '#/components/schemas/_common___HealthStatus' - timestamp: - description: Unix timestamp, in milliseconds, for the last time the cluster statistics were refreshed. - type: number - required: - - cluster_name - - cluster_uuid - - status - - timestamp cluster.weighted_routing___Weights: allOf: - $ref: '#/components/schemas/cluster.weighted_routing___WeightsBase' @@ -48965,7 +50268,8 @@ components: type: boolean generation: description: Current generation for the data stream. This number acts as a cumulative count of the stream's rollovers, starting at 1. - type: number + type: integer + format: int64 hidden: description: If `true`, the data stream is hidden. type: boolean @@ -48989,7 +50293,7 @@ components: description: If `true`, the data stream is created and managed by cross-cluster replication and the local cluster can not write into this data stream or change its mappings. type: boolean status: - $ref: '#/components/schemas/_common___HealthStatusCapitalized' + $ref: '#/components/schemas/_common___HealthStatus' system: description: If `true`, the data stream is created and managed by an OpenSearch stack component and cannot be modified through normal user interaction. type: boolean @@ -49021,6 +50325,27 @@ components: required: - index_name - index_uuid + indices._common___DataStreamStats: + type: object + properties: + backing_indices: + description: Current number of backing indexes for the data stream. + type: integer + format: int32 + data_stream: + $ref: '#/components/schemas/_common___Name' + maximum_timestamp: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + store_size: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + store_size_bytes: + description: Total size, in bytes, of all shards for the data stream's backing indexes. + $ref: '#/components/schemas/_common___ByteCount' + required: + - backing_indices + - data_stream + - maximum_timestamp + - store_size_bytes indices._common___DataStreamTimestampField: type: object properties: @@ -49082,6 +50407,19 @@ components: additionalProperties: title: metadata description: Additional details about the error. + indices._common___IndexGetUpgradeStatus: + type: object + properties: + size_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + size_to_upgrade_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + size_to_upgrade_ancient_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/indices._common___UpgradeStatus' indices._common___IndexingPressure: type: object properties: @@ -49220,11 +50558,7 @@ components: mode: type: string routing_path: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' soft_deletes: $ref: '#/components/schemas/indices._common___SoftDeletes' soft_deletes.retention_lease.period: @@ -50041,11 +51375,11 @@ components: mappings: $ref: '#/components/schemas/_common.mapping___TypeMapping' order: - type: number + type: integer + format: int32 settings: type: object - additionalProperties: - type: object + additionalProperties: true version: $ref: '#/components/schemas/_common___VersionNumber' required: @@ -50081,6 +51415,22 @@ components: $ref: '#/components/schemas/_common___HumanReadableByteCount' age: $ref: '#/components/schemas/_common___Duration' + indices._common___UpgradeStatus: + type: object + properties: + size_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + size_to_upgrade_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + size_to_upgrade_ancient_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + indices._common___UpgradeVersionStatus: + type: object + properties: + upgrade_version: + $ref: '#/components/schemas/_common___VersionString' + oldest_lucene_segment_version: + $ref: '#/components/schemas/_common___VersionString' indices.add_block___IndicesBlockOptions: type: string enum: @@ -50133,13 +51483,17 @@ components: type: object properties: end_offset: - type: number + type: integer + format: int32 position: - type: number + type: integer + format: int32 positionLength: - type: number + type: integer + format: int32 start_offset: - type: number + type: integer + format: int32 token: type: string type: @@ -50168,17 +51522,22 @@ components: bytes: type: string end_offset: - type: number + type: integer + format: int32 keyword: type: boolean position: - type: number + type: integer + format: int32 positionLength: - type: number + type: integer + format: int32 start_offset: - type: number + type: integer + format: int32 termFrequency: - type: number + type: integer + format: int32 token: type: string type: @@ -50193,11 +51552,7 @@ components: - token - type indices.analyze___TextToAnalyze: - oneOf: - - type: string - - type: array - items: - type: string + $ref: '#/components/schemas/_common___StringOrStringArray' indices.analyze___TokenDetail: type: object properties: @@ -50230,26 +51585,6 @@ components: $ref: '#/components/schemas/_common___ShardFailure' required: - failures - indices.data_streams_stats___DataStreamsStatsItem: - type: object - properties: - backing_indices: - description: Current number of backing indexes for the data stream. - type: number - data_stream: - $ref: '#/components/schemas/_common___Name' - maximum_timestamp: - $ref: '#/components/schemas/_common___EpochTimeUnitMillis' - store_size: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - store_size_bytes: - description: Total size, in bytes, of all shards for the data stream's backing indexes. - $ref: '#/components/schemas/_common___ByteCount' - required: - - backing_indices - - data_stream - - maximum_timestamp - - store_size_bytes indices.get_alias___IndexAliases: type: object properties: @@ -50307,11 +51642,13 @@ components: type: object properties: length: - type: number + type: integer + format: int64 name: type: string recovered: - type: number + type: integer + format: int64 required: - length - name @@ -50352,11 +51689,14 @@ components: percent: $ref: '#/components/schemas/_common___PercentageString' recovered: - type: number + type: integer + format: int64 reused: - type: number + type: integer + format: int64 total: - type: number + type: integer + format: int64 required: - percent - recovered @@ -50455,7 +51795,8 @@ components: type: object properties: id: - type: number + type: integer + format: int32 index: $ref: '#/components/schemas/indices.recovery___RecoveryIndexStatus' primary: @@ -50504,11 +51845,14 @@ components: percent: $ref: '#/components/schemas/_common___PercentageString' recovered: - type: number + type: integer + format: int32 total: - type: number + type: integer + format: int32 total_on_start: - type: number + type: integer + format: int32 total_time: $ref: '#/components/schemas/_common___Duration' total_time_in_millis: @@ -50584,9 +51928,11 @@ components: max_age_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' min_docs: - type: number + type: integer + format: int64 max_docs: - type: number + type: integer + format: int64 max_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' max_size_bytes: @@ -50604,9 +51950,11 @@ components: min_primary_shard_size_bytes: $ref: '#/components/schemas/_common___ByteCount' max_primary_shard_docs: - type: number + type: integer + format: int64 min_primary_shard_docs: - type: number + type: integer + format: int64 indices.segments___IndexSegment: type: object properties: @@ -50676,11 +52024,13 @@ components: type: object properties: num_committed_segments: - type: number + type: integer + format: int32 routing: $ref: '#/components/schemas/indices.segments___ShardSegmentRouting' num_search_segments: - type: number + type: integer + format: int32 segments: type: object additionalProperties: @@ -50708,6 +52058,9 @@ components: $ref: '#/components/schemas/_common___Id' store_exception: $ref: '#/components/schemas/indices.shard_stores___ShardStoreException' + additionalProperties: + title: nodes + $ref: '#/components/schemas/_common___NodeAttributes' required: - allocation indices.shard_stores___ShardStoreAllocation: @@ -50726,6 +52079,20 @@ components: required: - reason - type + indices.shard_stores___ShardStoreStatus: + oneOf: + - type: string + const: all + description: Return all shards, regardless of health status. + - type: string + const: green + description: The primary shard and all replica shards are assigned. + - type: string + const: red + description: The primary shard is unassigned. + - type: string + const: yellow + description: One or more replica shards are unassigned. indices.shard_stores___ShardStoreWrapper: type: object properties: @@ -50735,13 +52102,6 @@ components: $ref: '#/components/schemas/indices.shard_stores___ShardStore' required: - stores - indices.shard_stores___Status: - type: string - enum: - - all - - green - - red - - yellow indices.simulate_template___Overlapping: type: object properties: @@ -50767,7 +52127,6 @@ components: $ref: '#/components/schemas/indices._common___IndexSettings' required: - aliases - - mappings - settings indices.stats___AllIndicesStats: type: object @@ -50780,6 +52139,11 @@ components: - primaries - total indices.stats___IndexShardStats: + allOf: + - $ref: '#/components/schemas/indices.stats___IndexShardStatsBase' + - type: object + properties: {} + indices.stats___IndexShardStatsBase: allOf: - $ref: '#/components/schemas/indices.stats___IndexStatsBase' - type: object @@ -50877,11 +52241,13 @@ components: type: object properties: generation: - type: number + type: integer + format: int32 id: $ref: '#/components/schemas/_common___Id' num_docs: - type: number + type: integer + format: int64 user_data: type: object additionalProperties: @@ -50907,7 +52273,8 @@ components: average_size_in_bytes: $ref: '#/components/schemas/_common___ByteCount' count: - type: number + type: integer + format: int64 required: - description - size_in_bytes @@ -50919,7 +52286,8 @@ components: retaining_seq_no: $ref: '#/components/schemas/_common___SequenceNumber' timestamp: - type: number + type: integer + format: int64 source: type: string required: @@ -50944,7 +52312,8 @@ components: type: object properties: primary_term: - type: number + type: integer + format: int64 version: $ref: '#/components/schemas/_common___VersionNumber' leases: @@ -50983,9 +52352,11 @@ components: type: object properties: global_checkpoint: - type: number + type: integer + format: int64 local_checkpoint: - type: number + type: integer + format: int64 max_seq_no: $ref: '#/components/schemas/_common___SequenceNumber' required: @@ -52665,12 +54036,143 @@ components: enum: - AND - OR + knn._common___DeletedModel: + type: object + properties: + model_id: + type: string + result: + type: string + enum: + - deleted + - error + required: + - model_id + - result + knn._common___GraphMergeStats: + type: object + properties: + current: + type: number + total: + type: number + total_time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + current_docs: + type: number + total_docs: + type: number + total_size_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + current_size_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + knn._common___GraphRefreshStats: + type: object + properties: + total: + type: number + total_time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + knn._common___GraphStats: + type: object + properties: + merge: + $ref: '#/components/schemas/knn._common___GraphMergeStats' + refresh: + $ref: '#/components/schemas/knn._common___GraphRefreshStats' + knn._common___NodeStats: + type: object + properties: + max_distance_query_with_filter_requests: + type: number + graph_memory_usage_percentage: + $ref: '#/components/schemas/_common___PercentageNumber' + graph_query_requests: + type: number + graph_memory_usage: + type: number + cache_capacity_reached: + type: boolean + load_success_count: + type: number + training_memory_usage: + type: number + indices_in_cache: + type: object + additionalProperties: true + script_query_errors: + type: number + hit_count: + type: number + knn_query_requests: + type: number + total_load_time: + type: number + miss_count: + type: number + min_score_query_requests: + type: number + knn_query_with_filter_requests: + type: number + training_memory_usage_percentage: + $ref: '#/components/schemas/_common___PercentageNumber' + max_distance_query_requests: + type: number + lucene_initialized: + type: boolean + graph_index_requests: + type: number + faiss_initialized: + type: boolean + load_exception_count: + type: number + training_errors: + type: number + min_score_query_with_filter_requests: + type: number + eviction_count: + type: number + nmslib_initialized: + type: boolean + script_compilations: + type: number + script_query_requests: + type: number + graph_stats: + $ref: '#/components/schemas/knn._common___GraphStats' + graph_query_errors: + type: number + indexing_from_model_degraded: + type: boolean + graph_index_errors: + type: number + training_requests: + type: number + script_compilation_errors: + type: number knn._common___SearchType: type: string description: Search operation type. enum: - dfs_query_then_fetch - query_then_fetch + knn._common___Stats: + type: object + properties: + _nodes: + $ref: '#/components/schemas/_common___NodeStatistics' + cluster_name: + $ref: '#/components/schemas/_common___Name' + circuit_breaker_triggered: + type: boolean + model_index_status: + oneOf: + - $ref: '#/components/schemas/_common___HealthStatus' + - type: 'null' + nodes: + type: object + additionalProperties: + $ref: '#/components/schemas/knn._common___NodeStats' knn._common___SuggestMode: type: string description: Specify suggest mode. @@ -52678,6 +54180,36 @@ components: - always - missing - popular + knn._common___TrainedModel: + type: object + properties: + training_index: + type: string + training_field: + type: string + dimension: + type: integer + format: int32 + max_training_vector_count: + type: integer + format: int32 + search_size: + type: integer + format: int32 + description: + type: string + mode: + type: string + compression_level: + type: string + method: + type: string + spaceType: + type: string + required: + - dimension + - training_field + - training_index ml._common___Action: type: object properties: @@ -52695,6 +54227,67 @@ components: type: string post_process_function: type: string + ml._common___Algorithm: + type: object + description: The algorithm. + properties: + value: + type: string + description: The function name. + enum: + - AD_LIBSVM + - AGENT + - ANOMALY_LOCALIZATION + - BATCH_RCF + - CONNECTOR + - FIT_RCF + - KMEANS + - LINEAR_REGRESSION + - LOCAL_SAMPLE_CALCULATOR + - LOGISTIC_REGRESSION + - METRICS_CORRELATION + - QUESTION_ANSWERING + - RCF_SUMMARIZE + - REMOTE + - SAMPLE_ALGO + - SPARSE_ENCODING + - SPARSE_TOKENIZE + - TEXT_EMBEDDING + - TEXT_SIMILARITY + ml._common___BoolQuery: + type: object + description: The Boolean query. + properties: + filter: + type: array + description: Filter query that appears in matching documents. + items: + $ref: '#/components/schemas/ml._common___Filter' + must: + type: array + description: Query that must appears in matching documents + items: + $ref: '#/components/schemas/ml._common___Filter' + must_not: + description: Query that must not appears in matching documents. + $ref: '#/components/schemas/ml._common___Filter' + should: + type: array + description: Query that should appear in matching documents. + items: + $ref: '#/components/schemas/ml._common___Filter' + ml._common___ByteBuffer: + type: object + properties: + array: + type: string + description: The byte buffer array. + order: + type: string + description: The byte buffer order. + enum: + - BIG_ENDIAN + - LITTLE_ENDIAN ml._common___ClientConfig: type: object properties: @@ -52712,35 +54305,19 @@ components: type: integer retry_timeout_seconds: type: integer - ml._common___CreateConnectorRequest: + ml._common___ColumnMeta: type: object properties: name: + $ref: '#/components/schemas/_common___Name' + column_type: type: string - description: - type: string - version: - type: integer - protocol: - type: string - credential: - $ref: '#/components/schemas/ml._common___Credential' - parameters: - $ref: '#/components/schemas/ml._common___Parameters' - client_config: - $ref: '#/components/schemas/ml._common___ClientConfig' - actions: - type: array - items: - $ref: '#/components/schemas/ml._common___Action' - required: - - actions - - credential - - description - - name - - parameters - - protocol - - version + description: The column type. + enum: + - BOOLEAN + - DOUBLE + - INTEGER + - STRING ml._common___Credential: type: object properties: @@ -52751,6 +54328,58 @@ components: session_token: type: string additionalProperties: true + ml._common___Exists: + type: object + description: The exists filter. + properties: + field: + $ref: '#/components/schemas/_common___Field' + ml._common___Filter: + type: object + description: The filter element. + properties: + range: + $ref: '#/components/schemas/ml._common___Range' + nested: + $ref: '#/components/schemas/ml._common___Nested' + exists: + $ref: '#/components/schemas/ml._common___Exists' + term: + $ref: '#/components/schemas/ml._common___Term' + terms: + $ref: '#/components/schemas/ml._common___Term' + match: + $ref: '#/components/schemas/ml._common___Match' + ml._common___GetConnectorResponse: + type: object + properties: + name: + $ref: '#/components/schemas/_common___Name' + version: + $ref: '#/components/schemas/_common___VersionString' + description: + type: string + description: The connector description. + protocol: + type: string + description: The connector protocol. + enum: + - aws_sigv4 + - http + parameters: + $ref: '#/components/schemas/ml._common___Parameters' + actions: + type: array + items: + $ref: '#/components/schemas/ml._common___Action' + created_time: + type: integer + format: int64 + description: The created time. + last_updated_time: + type: integer + format: int64 + description: The last updated time. ml._common___Headers: type: object properties: @@ -52770,6 +54399,43 @@ components: required: - relation - value + ml._common___InferenceResults: + type: object + properties: + output: + type: array + items: + $ref: '#/components/schemas/ml._common___Output' + ml._common___InputQuery: + type: object + properties: + _source: + type: array + items: + type: string + description: The source fields + size: + type: integer + format: int64 + description: The size of the query. + query: + $ref: '#/components/schemas/ml._common___Query' + ml._common___Key: + type: object + description: The key. + properties: + gte: + type: number + description: Greater than or equal to. + lte: + type: number + description: Less than or equal to. + gt: + type: number + description: Greater than. + lt: + type: number + description: Less than. ml._common___LLM: type: object properties: @@ -52777,6 +54443,17 @@ components: type: string parameters: $ref: '#/components/schemas/ml._common___Parameters' + ml._common___Match: + type: object + description: Match query. + properties: + description: + type: string + description: The description. + ml._common___MatchAllQuery: + type: object + description: The match all query. + properties: {} ml._common___Memory: type: object properties: @@ -52810,9 +54487,15 @@ components: description: type: string description: The model group description. + owner: + $ref: '#/components/schemas/ml._common___Owner' access: type: string description: The model group access. + enum: + - private + - public + - restricted created_time: type: integer format: int64 @@ -52836,34 +54519,156 @@ components: required: - model_group_id - status - ml._common___Parameters: + ml._common___Nested: type: object - additionalProperties: true - ml._common___RegisterAgentsRequest: + description: The nested filter. + properties: + query: + $ref: '#/components/schemas/ml._common___Query' + path: + $ref: '#/components/schemas/_common___Field' + ignore_unmapped: + type: boolean + description: Whether to ignore unmapped fields. + score_mode: + type: string + description: The score mode. + enum: + - avg + - max + - min + - none + - sum + boost: + type: number + description: Adjust the relevance score of a match. + ml._common___Output: type: object properties: name: type: string - type: - type: string - description: + description: The output name. + data_type: type: string - tools: + description: The output data type. + enum: + - BOOLEAN + - FLOAT16 + - FLOAT32 + - FLOAT64 + - INT32 + - INT64 + - INT8 + - STRING + - UINT8 + - UNKNOWN + shape: type: array items: - $ref: '#/components/schemas/ml._common___ToolItems' - parameters: - $ref: '#/components/schemas/ml._common___Parameters' - app_type: - type: string - memory: - $ref: '#/components/schemas/ml._common___Memory' - llm: - $ref: '#/components/schemas/ml._common___LLM' + type: integer + format: int64 + description: The output shape. + data: + type: array + items: + type: number + format: double + description: The output data. + byte_buffer: + $ref: '#/components/schemas/ml._common___ByteBuffer' + required: + - data + ml._common___Owner: + type: object + properties: + name: + $ref: '#/components/schemas/_common___Name' + backend_roles: + type: array + items: + type: string + description: The backend roles. + roles: + type: array + items: + type: string + description: The roles. + custom_attribute_names: + type: array + items: + type: string + description: The custom attribute names. + user_requested_tenant: + type: + - 'null' + - string + description: The user requested tenant. required: - name - - type - ml._common___SearchModelsHits: + ml._common___OwnerNameKeyword: + type: object + description: The owner name keyword. + properties: + value: + $ref: '#/components/schemas/_common___FieldValue' + boost: + type: number + description: Adjust the relevance score of a match. + ml._common___Parameters: + type: object + additionalProperties: true + ml._common___PredictionResult: + type: object + properties: + column_metas: + type: array + items: + $ref: '#/components/schemas/ml._common___ColumnMeta' + rows: + type: array + items: + $ref: '#/components/schemas/ml._common___Rows' + ml._common___PredictResponse: + type: object + properties: + inference_results: + type: array + items: + $ref: '#/components/schemas/ml._common___InferenceResults' + status: + $ref: '#/components/schemas/ml._common___Status' + prediction_result: + $ref: '#/components/schemas/ml._common___PredictionResult' + ml._common___Query: + type: object + description: The query. + properties: + bool: + $ref: '#/components/schemas/ml._common___BoolQuery' + match_all: + $ref: '#/components/schemas/ml._common___MatchAllQuery' + term: + $ref: '#/components/schemas/ml._common___Term' + ml._common___Range: + type: object + description: The filter range. + properties: + k1: + $ref: '#/components/schemas/ml._common___Key' + k2: + $ref: '#/components/schemas/ml._common___Key' + k3: + $ref: '#/components/schemas/ml._common___Key' + ml._common___Rows: + type: object + properties: + values: + type: array + items: + $ref: '#/components/schemas/ml._common___Values' + ml._common___SearchConnectorsResponse: + $ref: '#/components/schemas/ml._common___SearchResponse' + ml._common___SearchHits: type: object properties: total: @@ -52871,7 +54676,7 @@ components: hits: type: array items: - $ref: '#/components/schemas/ml._common___SearchModelsHitsHit' + $ref: '#/components/schemas/ml._common___SearchHitsHit' max_score: type: number format: float @@ -52879,7 +54684,7 @@ components: required: - hits - total - ml._common___SearchModelsHitsHit: + ml._common___SearchHitsHit: type: object properties: _version: @@ -52903,19 +54708,11 @@ components: $ref: '#/components/schemas/_common___Name' required: - _score - ml._common___SearchModelsQuery: - type: object - properties: - query: - type: object - description: The query. - size: - type: integer - description: The number of models to return. - required: - - query - - size + ml._common___SearchModelGroupsResponse: + $ref: '#/components/schemas/ml._common___SearchResponse' ml._common___SearchModelsResponse: + $ref: '#/components/schemas/ml._common___SearchResponse' + ml._common___SearchResponse: type: object properties: took: @@ -52927,9 +54724,67 @@ components: _shards: $ref: '#/components/schemas/_common___ShardStatistics' hits: - $ref: '#/components/schemas/ml._common___SearchModelsHits' + $ref: '#/components/schemas/ml._common___SearchHits' required: - hits + ml._common___Sort: + type: object + description: Sort query. + properties: + algorithm: + $ref: '#/components/schemas/ml._common___SortOrder' + auto_redeploy_retry_times: + $ref: '#/components/schemas/ml._common___SortOrder' + chunk_number: + $ref: '#/components/schemas/ml._common___SortOrder' + created_time: + $ref: '#/components/schemas/ml._common___SortOrder' + current_worker_node_count: + $ref: '#/components/schemas/ml._common___SortOrder' + deploy_to_all_nodes: + $ref: '#/components/schemas/ml._common___SortOrder' + is_hidden: + $ref: '#/components/schemas/ml._common___SortOrder' + last_registered_time: + $ref: '#/components/schemas/ml._common___SortOrder' + last_updated_time: + $ref: '#/components/schemas/ml._common___SortOrder' + model_content_hash_value: + $ref: '#/components/schemas/ml._common___SortOrder' + model_content_size_in_bytes: + $ref: '#/components/schemas/ml._common___SortOrder' + model_format: + $ref: '#/components/schemas/ml._common___SortOrder' + model_group_id: + $ref: '#/components/schemas/ml._common___SortOrder' + model_state: + $ref: '#/components/schemas/ml._common___SortOrder' + model_version: + $ref: '#/components/schemas/ml._common___SortOrder' + planning_worker_nodes: + $ref: '#/components/schemas/ml._common___SortOrder' + planning_worker_node_count: + $ref: '#/components/schemas/ml._common___SortOrder' + total_chunks: + $ref: '#/components/schemas/ml._common___SortOrder' + _index: + $ref: '#/components/schemas/ml._common___SortOrder' + _id: + $ref: '#/components/schemas/ml._common___SortOrder' + _seq_no: + $ref: '#/components/schemas/ml._common___SortOrder' + _score: + $ref: '#/components/schemas/ml._common___SortOrder' + ml._common___SortOrder: + type: object + description: The order of the sort. + properties: + order: + type: string + description: The order. + enum: + - asc + - desc ml._common___Source: type: object properties: @@ -52971,6 +54826,7 @@ components: - PARTIALLY_DEPLOYED - REGISTERED - REGISTERING + - UNDEPLOYED model_content_size_in_bytes: type: integer format: int64 @@ -53027,6 +54883,45 @@ components: url: type: string description: The model URL. + backend_roles: + type: array + items: + type: string + description: The backend roles. + owner: + $ref: '#/components/schemas/ml._common___Owner' + access: + type: string + description: The model group access. + enum: + - private + - public + - restricted + latest_version: + type: integer + description: The latest version. + protocol: + type: string + description: The connector protocol. + enum: + - aws_sigv4 + - http + parameters: + $ref: '#/components/schemas/ml._common___Parameters' + actions: + type: array + items: + $ref: '#/components/schemas/ml._common___Action' + ml._common___Status: + type: string + description: The status. + enum: + - CANCELLED + - COMPLETED + - COMPLETED_WITH_ERROR + - CREATED + - FAILED + - RUNNING ml._common___Task: type: object properties: @@ -53038,9 +54933,11 @@ components: type: string enum: - CANCELLED + - CANCELLING - COMPLETED - COMPLETED_WITH_ERROR - CREATED + - EXPIRED - FAILED - RUNNING task_type: @@ -53067,6 +54964,20 @@ components: type: string required: - state + ml._common___Term: + type: object + description: Term to match the query. + properties: + algorithm: + $ref: '#/components/schemas/ml._common___Algorithm' + _id: + type: array + items: + $ref: '#/components/schemas/_common___Id' + model_id: + $ref: '#/components/schemas/_common___Name' + owner.name.keyword: + $ref: '#/components/schemas/ml._common___OwnerNameKeyword' ml._common___ToolItems: type: object properties: @@ -53077,6 +54988,42 @@ components: parameters: $ref: '#/components/schemas/ml._common___Parameters' additionalProperties: true + ml._common___TrainParameters: + type: object + properties: + centroids: + type: integer + format: int64 + description: The centroids. + iterations: + type: integer + format: int64 + description: The iterations. + distance_type: + type: string + description: The distance type. + enum: + - COSINE + - EUCLIDEAN + - L1 + ml._common___TrainPredictResponse: + type: object + properties: + status: + $ref: '#/components/schemas/ml._common___Status' + prediction_result: + $ref: '#/components/schemas/ml._common___PredictionResult' + required: + - status + ml._common___TrainResponse: + type: object + properties: + model_id: + $ref: '#/components/schemas/_common___Name' + status: + $ref: '#/components/schemas/ml._common___Status' + required: + - status ml._common___UndeployModelNode: type: object properties: @@ -53090,2090 +55037,2204 @@ components: additionalProperties: title: nodes $ref: '#/components/schemas/ml._common___UndeployModelNode' - nodes._common___AdaptiveSelection: + ml._common___UpdateModelGroupResponse: type: object properties: - avg_queue_size: - description: The exponentially weighted moving average queue size of search requests on the keyed node. - type: number - avg_response_time: - $ref: '#/components/schemas/_common___Duration' - avg_response_time_ns: - description: The exponentially weighted moving average response time, in nanoseconds, of search requests on the keyed node. - type: number - avg_service_time: - $ref: '#/components/schemas/_common___Duration' - avg_service_time_ns: - description: The exponentially weighted moving average service time, in nanoseconds, of search requests on the keyed node. - type: number - outgoing_searches: - description: The number of outstanding search requests to the keyed node from the node these stats are for. - type: number - rank: - description: The rank of this node; used for shard selection when routing search requests. + status: type: string - nodes._common___Breaker: - type: object - properties: - estimated_size: - description: Estimated memory used for the operation. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - estimated_size_in_bytes: - description: Estimated memory used, in bytes, for the operation. - $ref: '#/components/schemas/_common___ByteCount' - limit_size: - description: Memory limit for the circuit breaker. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - limit_size_in_bytes: - description: Memory limit, in bytes, for the circuit breaker. - $ref: '#/components/schemas/_common___ByteCount' - overhead: - description: A constant that all estimates for the circuit breaker are multiplied with to calculate a final estimate. - type: number - tripped: - description: Total number of times the circuit breaker has been triggered and prevented an out of memory error. - type: number - nodes._common___Cgroup: - type: object - properties: - cpuacct: - $ref: '#/components/schemas/nodes._common___CpuAcct' - cpu: - $ref: '#/components/schemas/nodes._common___CgroupCpu' - memory: - $ref: '#/components/schemas/nodes._common___CgroupMemory' - nodes._common___CgroupCpu: + description: The status. + ml._common___Values: type: object properties: - control_group: - description: The `cpu` control group to which the OpenSearch process belongs. + column_type: type: string - cfs_period_micros: - description: The period of time, in microseconds, for how regularly all tasks in the same cgroup as the OpenSearch process should have their access to CPU resources reallocated. - type: number - cfs_quota_micros: - description: The total amount of time, in microseconds, for which all tasks in the same cgroup as the OpenSearch process can run during one period `cfs_period_micros`. + description: The column type. + enum: + - BOOLEAN + - DOUBLE + - INTEGER + - STRING + value: type: number - stat: - $ref: '#/components/schemas/nodes._common___CgroupCpuStat' - nodes._common___CgroupCpuStat: + description: The value. + nodes._common___NodesResponseBase: type: object properties: - number_of_elapsed_periods: - description: The number of reporting periods (as specified by `cfs_period_micros`) that have elapsed. - type: number - number_of_times_throttled: - description: The number of times all tasks in the same cgroup as the OpenSearch process have been throttled. - type: number - time_throttled_nanos: - $ref: '#/components/schemas/_common___DurationValueUnitNanos' - nodes._common___CgroupMemory: + _nodes: + description: Contains statistics about the number of nodes selected by the request's node filters. + $ref: '#/components/schemas/_common___NodeStatistics' + nodes._common___SampleType: + type: string + description: The type to sample. + enum: + - block + - cpu + - wait + nodes.info___Metric: + type: string + enum: + - _all + - aggregations + - http + - indices + - ingest + - jvm + - os + - plugins + - process + - search_pipelines + - settings + - thread_pool + - transport + nodes.info___NodeInfo: type: object properties: - control_group: - description: The `memory` control group to which the OpenSearch process belongs. + attributes: + type: object + additionalProperties: + type: string + build_flavor: type: string - limit_in_bytes: - description: |- - The maximum amount of user memory (including file cache) allowed for all tasks in the same cgroup as the OpenSearch process. - This value can be too big to store in a `long`, so is returned as a string so that the value returned can exactly match what the underlying operating system interface returns. - Any value that is too large to parse into a `long` almost certainly means no limit has been set for the cgroup. + build_hash: + description: Short hash of the last git commit in this release. type: string - usage_in_bytes: - description: |- - The total current memory usage by processes in the cgroup, in bytes, by all tasks in the same cgroup as the OpenSearch process. - This value is stored as a string for consistency with `limit_in_bytes`. + build_type: type: string - nodes._common___Client: + host: + $ref: '#/components/schemas/_common___Host' + http: + $ref: '#/components/schemas/nodes.info___NodeInfoHttp' + ip: + $ref: '#/components/schemas/_common___Ip' + jvm: + $ref: '#/components/schemas/nodes.info___NodeJvmInfo' + name: + $ref: '#/components/schemas/_common___Name' + network: + $ref: '#/components/schemas/nodes.info___NodeInfoNetwork' + os: + $ref: '#/components/schemas/nodes.info___NodeOperatingSystemInfo' + plugins: + type: array + items: + $ref: '#/components/schemas/_common___PluginStats' + process: + $ref: '#/components/schemas/nodes.info___NodeProcessInfo' + roles: + $ref: '#/components/schemas/_common___NodeRoles' + settings: + $ref: '#/components/schemas/nodes.info___NodeInfoSettings' + thread_pool: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.info___NodeThreadPoolInfo' + total_indexing_buffer: + description: Total heap allowed to be used to hold recently indexed documents before they must be written to disk. This size is a shared pool across all shards on this node, and is controlled by Indexing Buffer settings. + $ref: '#/components/schemas/_common___ByteCount' + total_indexing_buffer_in_bytes: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + transport: + $ref: '#/components/schemas/nodes.info___NodeInfoTransport' + transport_address: + $ref: '#/components/schemas/_common___TransportAddress' + version: + $ref: '#/components/schemas/_common___VersionString' + modules: + type: array + items: + $ref: '#/components/schemas/_common___PluginStats' + ingest: + $ref: '#/components/schemas/nodes.info___NodeInfoIngest' + aggregations: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.info___NodeInfoAggregation' + search_pipelines: + $ref: '#/components/schemas/nodes.info___NodeInfoSearchPipelines' + required: + - build_hash + - build_type + - name + - roles + - version + nodes.info___NodeInfoAction: type: object properties: - id: - description: Unique ID for the HTTP client. - type: number - agent: - description: |- - Reported agent for the HTTP client. - If unavailable, this property is not included in the response. - type: string - local_address: - description: Local address for the HTTP connection. - type: string - remote_address: - description: Remote address for the HTTP connection. - type: string - last_uri: - description: The URI of the client's most recent request. - type: string - opened_time_millis: - description: Time at which the client opened the connection. - type: number - closed_time_millis: - description: Time at which the client closed the connection if the connection is closed. - type: number - last_request_time_millis: - description: Time of the most recent request from this client. - type: number - request_count: - description: Number of requests from this client. - type: number - request_size_bytes: - description: Cumulative size in bytes of all requests from this client. - $ref: '#/components/schemas/_common___ByteCount' - x_opaque_id: - description: |- - Value from the client's `x-opaque-id` HTTP header. - If unavailable, this property is not included in the response. + destructive_requires_name: type: string - nodes._common___ClusterAppliedStats: + required: + - destructive_requires_name + nodes.info___NodeInfoAggregation: type: object properties: - recordings: + types: type: array items: - $ref: '#/components/schemas/nodes._common___Recording' - nodes._common___ClusterStateOverallStats: + type: string + required: + - types + nodes.info___NodeInfoBootstrap: type: object properties: - update_count: - type: number - total_time_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - failed_count: - type: number - nodes._common___ClusterStateQueue: + memory_lock: + type: string + required: + - memory_lock + nodes.info___NodeInfoClient: type: object properties: - total: - description: Total number of cluster states in queue. - type: number - pending: - description: Number of pending cluster states in queue. - type: number - committed: - description: Number of committed cluster states in queue. - type: number - nodes._common___ClusterStateStats: + type: + type: string + required: + - type + nodes.info___NodeInfoDiscovery: type: object properties: - overall: - $ref: '#/components/schemas/nodes._common___ClusterStateOverallStats' - nodes._common___ClusterStateUpdate: + type: + type: string + seed_hosts: + type: string + nodes.info___NodeInfoHttp: type: object properties: - count: - description: The number of cluster state update attempts that did not change the cluster state since the node started. - type: number - computation_time: - $ref: '#/components/schemas/_common___Duration' - computation_time_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - publication_time: - $ref: '#/components/schemas/_common___Duration' - publication_time_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - context_construction_time: - $ref: '#/components/schemas/_common___Duration' - context_construction_time_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - commit_time: - $ref: '#/components/schemas/_common___Duration' - commit_time_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - completion_time: - $ref: '#/components/schemas/_common___Duration' - completion_time_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - master_apply_time: - $ref: '#/components/schemas/_common___Duration' - master_apply_time_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - notification_time: - $ref: '#/components/schemas/_common___Duration' - notification_time_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' + bound_address: + type: array + items: + type: string + max_content_length: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + max_content_length_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + publish_address: + type: string required: - - count - nodes._common___Context: + - bound_address + - max_content_length_in_bytes + - publish_address + nodes.info___NodeInfoIngest: type: object properties: - context: + processors: + type: array + items: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestProcessor' + required: + - processors + nodes.info___NodeInfoIngestDownloader: + type: object + properties: + enabled: type: string - compilations: - type: number - cache_evictions: - type: number - compilation_limit_triggered: - type: number - nodes._common___Cpu: + required: + - enabled + nodes.info___NodeInfoIngestInfo: type: object properties: - percent: - $ref: '#/components/schemas/_common___PercentageNumber' - sys: - $ref: '#/components/schemas/_common___Duration' - sys_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - total: - $ref: '#/components/schemas/_common___Duration' - total_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - user: - $ref: '#/components/schemas/_common___Duration' - user_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - load_average: - type: object - additionalProperties: - type: number - nodes._common___CpuAcct: + downloader: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestDownloader' + required: + - downloader + nodes.info___NodeInfoIngestProcessor: type: object properties: - control_group: - description: The `cpuacct` control group to which the OpenSearch process belongs. + type: type: string - usage_nanos: - $ref: '#/components/schemas/_common___DurationValueUnitNanos' - nodes._common___DataPathStats: + required: + - type + nodes.info___NodeInfoJvmMemory: type: object properties: - available: - description: Total amount of disk space available to this Java virtual machine on this file store. + direct_max: $ref: '#/components/schemas/_common___HumanReadableByteCount' - available_in_bytes: - description: Total number of bytes available to this Java virtual machine on this file store. + direct_max_in_bytes: $ref: '#/components/schemas/_common___ByteCount' - cache_reserved: - x-version-added: '2.7' - description: Total number of cache bytes reserved available to this Java virtual machine on this file store. + heap_init: $ref: '#/components/schemas/_common___HumanReadableByteCount' - cache_reserved_in_bytes: - x-version-added: '2.7' - description: Total number of cache bytes reserved available to this Java virtual machine on this file store. + heap_init_in_bytes: $ref: '#/components/schemas/_common___ByteCount' - disk_queue: - type: string - disk_reads: - type: number - disk_read_size: + heap_max: $ref: '#/components/schemas/_common___HumanReadableByteCount' - disk_read_size_in_bytes: + heap_max_in_bytes: $ref: '#/components/schemas/_common___ByteCount' - disk_writes: - type: number - disk_write_size: + non_heap_init: $ref: '#/components/schemas/_common___HumanReadableByteCount' - disk_write_size_in_bytes: + non_heap_init_in_bytes: $ref: '#/components/schemas/_common___ByteCount' - free: - description: Total amount of unallocated disk space in the file store. + non_heap_max: $ref: '#/components/schemas/_common___HumanReadableByteCount' - free_in_bytes: - description: Total number of unallocated bytes in the file store. + non_heap_max_in_bytes: $ref: '#/components/schemas/_common___ByteCount' - mount: - description: 'Mount point of the file store (for example: `/dev/sda2`).' - type: string - path: - description: Path to the file store. - type: string + required: + - direct_max_in_bytes + - heap_init_in_bytes + - heap_max_in_bytes + - non_heap_init_in_bytes + - non_heap_max_in_bytes + nodes.info___NodeInfoMemory: + type: object + properties: total: - description: Total size of the file store. $ref: '#/components/schemas/_common___HumanReadableByteCount' total_in_bytes: - description: Total size of the file store in bytes. $ref: '#/components/schemas/_common___ByteCount' - type: - description: 'Type of the file store (ex: ext4).' - type: string - nodes._common___Discovery: + required: + - total + - total_in_bytes + nodes.info___NodeInfoNetwork: type: object properties: - cluster_state_queue: - $ref: '#/components/schemas/nodes._common___ClusterStateQueue' - cluster_state_stats: - $ref: '#/components/schemas/nodes._common___ClusterStateStats' - published_cluster_states: - $ref: '#/components/schemas/nodes._common___PublishedClusterStates' - cluster_state_update: - description: |- - Contains low-level statistics about how long various activities took during cluster state updates while the node was the elected cluster manager. - Omitted if the node is not cluster-manager-eligible. - Every field whose name ends in `_time` within this object is also represented as a raw number of milliseconds in a field whose name ends in `_time_millis`. - The human-readable fields with a `_time` suffix are only returned if requested with the `?human=true` query parameter. - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___ClusterStateUpdate' - serialized_cluster_states: - $ref: '#/components/schemas/nodes._common___SerializedClusterState' - cluster_applier_stats: - $ref: '#/components/schemas/nodes._common___ClusterAppliedStats' - nodes._common___ExtendedMemoryStats: - allOf: - - $ref: '#/components/schemas/nodes._common___MemoryStats' - - type: object - properties: - free_percent: - description: Percentage of free memory. - $ref: '#/components/schemas/_common___PercentageNumber' - used_percent: - description: Percentage of used memory. - $ref: '#/components/schemas/_common___PercentageNumber' - nodes._common___FileSystem: + primary_interface: + $ref: '#/components/schemas/nodes.info___NodeInfoNetworkInterface' + refresh_interval: + type: integer + format: int32 + required: + - primary_interface + - refresh_interval + nodes.info___NodeInfoNetworkInterface: type: object properties: - data: - description: List of all file stores. - type: array - items: - $ref: '#/components/schemas/nodes._common___DataPathStats' - timestamp: - description: |- - Last time the file stores statistics were refreshed. - Recorded in milliseconds since the Unix Epoch. - type: number - total: - $ref: '#/components/schemas/nodes._common___FileSystemTotal' - io_stats: - $ref: '#/components/schemas/nodes._common___IoStats' - nodes._common___FileSystemTotal: + address: + type: string + mac_address: + type: string + name: + $ref: '#/components/schemas/_common___Name' + required: + - address + - mac_address + - name + nodes.info___NodeInfoOSCPU: type: object properties: - available: - description: |- - Total disk space available to this Java virtual machine on all file stores. - Depending on OS or process level restrictions, this might appear less than `free`. - This is the actual amount of free disk space the OpenSearch node can utilize. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - available_in_bytes: - description: |- - Total number of bytes available to this Java virtual machine on all file stores. - Depending on OS or process level restrictions, this might appear less than `free_in_bytes`. - This is the actual amount of free disk space the OpenSearch node can utilize. - $ref: '#/components/schemas/_common___ByteCount' - free: - description: Total unallocated disk space in all file stores. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - free_in_bytes: - description: Total number of unallocated bytes in all file stores. - $ref: '#/components/schemas/_common___ByteCount' - total: - description: Total size of all file stores. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - total_in_bytes: - description: Total size of all file stores in bytes. - $ref: '#/components/schemas/_common___ByteCount' - cache_reserved: - x-version-added: '2.7' - description: Total size of cache bytes reserved in all file stores. + cache_size: $ref: '#/components/schemas/_common___HumanReadableByteCount' - cache_reserved_in_bytes: - x-version-added: '2.7' - description: Total size of cache bytes reserved in all file stores. + cache_size_in_bytes: $ref: '#/components/schemas/_common___ByteCount' - nodes._common___GarbageCollector: - type: object - properties: - collectors: - description: Contains statistics about JVM garbage collectors for the node. - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___GarbageCollectorTotal' - nodes._common___GarbageCollectorTotal: - type: object - properties: - collection_count: - description: Total number of JVM garbage collectors that collect objects. - type: number - collection_time: - description: Total time spent by JVM collecting objects. + cores_per_socket: + type: integer + format: int32 + mhz: + type: integer + format: int32 + model: type: string - collection_time_in_millis: - description: Total time, in milliseconds, spent by JVM collecting objects. - type: number - nodes._common___Http: + total_cores: + type: integer + format: int32 + total_sockets: + type: integer + format: int32 + vendor: + type: string + required: + - cache_size + - cache_size_in_bytes + - cores_per_socket + - mhz + - model + - total_cores + - total_sockets + - vendor + nodes.info___NodeInfoPath: type: object properties: - current_open: - description: Current number of open HTTP connections for the node. - type: number - total_opened: - description: Total number of HTTP connections opened for the node. - type: number - clients: - description: |- - Information on current and recently-closed HTTP client connections. - Clients that have been closed longer than the `http.client_stats.closed_channels.max_age` setting will not be represented here. + logs: + type: string + home: + type: string + repo: type: array items: - $ref: '#/components/schemas/nodes._common___Client' - nodes._common___IndexingPressure: - type: object - properties: - memory: - $ref: '#/components/schemas/nodes._common___IndexingPressureMemory' - nodes._common___IndexingPressureMemory: + type: string + data: + type: array + items: + type: string + required: + - home + - logs + nodes.info___NodeInfoRepositories: type: object properties: - limit: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - limit_in_bytes: - description: |- - Configured memory limit, in bytes, for the indexing requests. - Replica requests have an automatic limit that is 1.5x this value. - $ref: '#/components/schemas/_common___ByteCount' - current: - $ref: '#/components/schemas/nodes._common___PressureMemory' - total: - $ref: '#/components/schemas/nodes._common___PressureMemory' - nodes._common___Ingest: + url: + $ref: '#/components/schemas/nodes.info___NodeInfoRepositoriesUrl' + required: + - url + nodes.info___NodeInfoRepositoriesUrl: type: object properties: - pipelines: - description: Contains statistics about ingest pipelines for the node. - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___IngestTotal' - total: - $ref: '#/components/schemas/nodes._common___IngestTotal' - nodes._common___IngestTotal: + allowed_urls: + type: string + required: + - allowed_urls + nodes.info___NodeInfoScript: type: object properties: - count: - description: Total number of documents ingested during the lifetime of this node. - type: number - current: - description: Total number of documents currently being ingested. - type: number - failed: - description: Total number of failed ingest operations during the lifetime of this node. - type: number - processors: - description: Total number of ingest processors. - type: array - items: - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___KeyedProcessor' - time: - $ref: '#/components/schemas/_common___Duration' - time_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - nodes._common___IoStatDevice: + allowed_types: + type: string + disable_max_compilations_rate: + type: string + required: + - allowed_types + - disable_max_compilations_rate + nodes.info___NodeInfoSearch: type: object properties: - device_name: - description: The Linux device name. - type: string - operations: - description: The total number of read and write operations for the device completed since starting OpenSearch. - type: number - read_kilobytes: - description: The total number of kilobytes read for the device since starting OpenSearch. - type: number - read_operations: - description: The total number of read operations for the device completed since starting OpenSearch. - type: number - write_kilobytes: - description: The total number of kilobytes written for the device since starting OpenSearch. - type: number - write_operations: - description: The total number of write operations for the device completed since starting OpenSearch. - type: number - read_time: - type: number - write_time: - type: number - queue_size: - type: number - io_time_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - nodes._common___IoStats: + remote: + $ref: '#/components/schemas/nodes.info___NodeInfoSearchRemote' + required: + - remote + nodes.info___NodeInfoSearchPipelines: type: object properties: - devices: - description: |- - Array of disk metrics for each device that is backing an OpenSearch data path. - These disk metrics are probed periodically and averages between the last probe and the current probe are computed. + response_processors: type: array items: - $ref: '#/components/schemas/nodes._common___IoStatDevice' - total: - $ref: '#/components/schemas/nodes._common___IoStatDevice' - nodes._common___Jvm: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestProcessor' + request_processors: + type: array + items: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestProcessor' + required: + - request_processors + - response_processors + nodes.info___NodeInfoSearchRemote: type: object properties: - buffer_pools: - description: Contains statistics about JVM buffer pools for the node. - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___NodeBufferPool' - classes: - $ref: '#/components/schemas/nodes._common___JvmClasses' - gc: - $ref: '#/components/schemas/nodes._common___GarbageCollector' - mem: - $ref: '#/components/schemas/nodes._common___JvmMemoryStats' - threads: - $ref: '#/components/schemas/nodes._common___JvmThreads' - timestamp: - description: Last time JVM statistics were refreshed. - type: number - uptime: - description: |- - Human-readable JVM uptime. - Only returned if the `human` query parameter is `true`. + connect: type: string - uptime_in_millis: - description: JVM uptime in milliseconds. - type: number - nodes._common___JvmClasses: - type: object - properties: - current_loaded_count: - description: Number of classes currently loaded by JVM. - type: number - total_loaded_count: - description: Total number of classes loaded since the JVM started. - type: number - total_unloaded_count: - description: Total number of classes unloaded since the JVM started. - type: number - nodes._common___JvmMemoryStats: + required: + - connect + nodes.info___NodeInfoSettings: type: object properties: - heap_used: - description: Memory currently in use by the heap. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - heap_used_in_bytes: - description: Memory, in bytes, currently in use by the heap. - $ref: '#/components/schemas/_common___ByteCount' - heap_used_percent: - description: Percentage of memory currently in use by the heap. - $ref: '#/components/schemas/_common___PercentageNumber' - heap_committed: - description: Amount of memory available for use by the heap. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - heap_committed_in_bytes: - description: Amount of memory, in bytes, available for use by the heap. - $ref: '#/components/schemas/_common___ByteCount' - heap_max: - description: Maximum amount of memory available for use by the heap. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - heap_max_in_bytes: - description: Maximum amount of memory, in bytes, available for use by the heap. - $ref: '#/components/schemas/_common___ByteCount' - non_heap_used: - description: Non-heap memory used. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - non_heap_used_in_bytes: - description: Non-heap memory used, in bytes. - $ref: '#/components/schemas/_common___ByteCount' - non_heap_committed: - description: Amount of non-heap memory available. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - non_heap_committed_in_bytes: - description: Amount of non-heap memory available, in bytes. - $ref: '#/components/schemas/_common___ByteCount' - pools: - description: Contains statistics about heap memory usage for the node. - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___Pool' - nodes._common___JvmThreads: + cluster: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsCluster' + node: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsNode' + path: + $ref: '#/components/schemas/nodes.info___NodeInfoPath' + repositories: + $ref: '#/components/schemas/nodes.info___NodeInfoRepositories' + discovery: + $ref: '#/components/schemas/nodes.info___NodeInfoDiscovery' + action: + $ref: '#/components/schemas/nodes.info___NodeInfoAction' + client: + $ref: '#/components/schemas/nodes.info___NodeInfoClient' + http: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsHttp' + bootstrap: + $ref: '#/components/schemas/nodes.info___NodeInfoBootstrap' + transport: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsTransport' + network: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsNetwork' + script: + $ref: '#/components/schemas/nodes.info___NodeInfoScript' + search: + $ref: '#/components/schemas/nodes.info___NodeInfoSearch' + ingest: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIngest' + index: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIndex' + plugins: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsPlugins' + required: + - client + - cluster + - http + - node + - path + - transport + nodes.info___NodeInfoSettingsCluster: type: object properties: - count: - description: Number of active threads in use by JVM. - type: number - peak_count: - description: Highest number of threads used by JVM. - type: number - nodes._common___KeyedProcessor: + name: + $ref: '#/components/schemas/_common___Name' + routing: + $ref: '#/components/schemas/indices._common___IndexRouting' + election: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsClusterElection' + initial_cluster_manager_nodes: + $ref: '#/components/schemas/_common___StringOrStringArray' + initial_master_nodes: + $ref: '#/components/schemas/_common___StringOrStringArray' + deprecation_indexing: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsDeprecationIndexing' + required: + - name + nodes.info___NodeInfoSettingsClusterElection: type: object properties: - stats: - $ref: '#/components/schemas/nodes._common___Processor' - type: - type: string - nodes._common___LastGcStats: + strategy: + $ref: '#/components/schemas/_common___Name' + required: + - strategy + nodes.info___NodeInfoSettingsDeprecationIndexing: type: object properties: - used: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - used_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - max: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - max_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - usage_percent: - $ref: '#/components/schemas/_common___PercentageNumber' - nodes._common___MemoryStats: + enabled: + $ref: '#/components/schemas/_common___StringifiedBoolean' + required: + - enabled + nodes.info___NodeInfoSettingsHttp: type: object properties: - adjusted_total_in_bytes: - description: |- - If the amount of physical memory has been overridden using the `es`.`total_memory_bytes` system property then this reports the overridden value in bytes. - Otherwise it reports the same value as `total_in_bytes`. - $ref: '#/components/schemas/_common___ByteCount' - resident: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - resident_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - share: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - share_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - total_virtual: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - total_virtual_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - total: - description: Total amount of physical memory. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - total_in_bytes: - description: Total amount of physical memory in bytes. - $ref: '#/components/schemas/_common___ByteCount' - free: - description: Amount of free physical memory. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - free_in_bytes: - description: Amount of free physical memory in bytes. - $ref: '#/components/schemas/_common___ByteCount' - used: - description: Amount of used physical memory. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - used_in_bytes: - description: Amount of used physical memory in bytes. - $ref: '#/components/schemas/_common___ByteCount' - nodes._common___NodeBufferPool: + type: + type: string + type.default: + type: string + compression: + $ref: '#/components/schemas/_common___StringifiedBoolean' + port: + $ref: '#/components/schemas/_common___StringifiedInteger' + required: + - type + nodes.info___NodeInfoSettingsIndex: type: object properties: - count: - description: Number of buffer pools. - type: number - total_capacity: - description: Total capacity of buffer pools. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - total_capacity_in_bytes: - description: Total capacity of buffer pools in bytes. - $ref: '#/components/schemas/_common___ByteCount' - used: - description: Size of buffer pools. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - used_in_bytes: - description: Size of buffer pools in bytes. - $ref: '#/components/schemas/_common___ByteCount' - nodes._common___NodeReloadError: + store: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIndexStore' + nodes.info___NodeInfoSettingsIndexHybrid: type: object properties: - name: - $ref: '#/components/schemas/_common___Name' - reload_exception: - $ref: '#/components/schemas/_common___ErrorCause' - required: - - name - nodes._common___NodeReloadResult: - oneOf: - - $ref: '#/components/schemas/nodes._common___Stats' - - $ref: '#/components/schemas/nodes._common___NodeReloadError' - nodes._common___NodesResponseBase: + mmap: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIndexStoreMmap' + nodes.info___NodeInfoSettingsIndexStore: type: object properties: - _nodes: - $ref: '#/components/schemas/_common___NodeStatistics' - nodes._common___OperatingSystem: + hybrid: + $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIndexHybrid' + nodes.info___NodeInfoSettingsIndexStoreMmap: type: object properties: - cpu: - $ref: '#/components/schemas/nodes._common___Cpu' - mem: - $ref: '#/components/schemas/nodes._common___ExtendedMemoryStats' - swap: - $ref: '#/components/schemas/nodes._common___MemoryStats' - cgroup: - $ref: '#/components/schemas/nodes._common___Cgroup' - timestamp: - type: number - nodes._common___Pool: + extensions: + type: array + items: + type: string + nodes.info___NodeInfoSettingsIngest: type: object properties: - used: - description: Memory used by the heap. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - used_in_bytes: - description: Memory, in bytes, used by the heap. - $ref: '#/components/schemas/_common___ByteCount' - max: - description: Maximum amount of memory available for use by the heap. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - max_in_bytes: - description: Maximum amount of memory, in bytes, available for use by the heap. - $ref: '#/components/schemas/_common___ByteCount' - peak_used: - description: Largest amount of memory historically used by the heap. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - peak_used_in_bytes: - description: Largest amount of memory, in bytes, historically used by the heap. - $ref: '#/components/schemas/_common___ByteCount' - peak_max: - description: Largest amount of memory historically used by the heap. - $ref: '#/components/schemas/_common___HumanReadableByteCount' - peak_max_in_bytes: - description: Largest amount of memory, in bytes, historically used by the heap. - $ref: '#/components/schemas/_common___ByteCount' - last_gc_stats: - description: Most recent GC cycle stats for a particular memory pool. - $ref: '#/components/schemas/nodes._common___LastGcStats' - nodes._common___PressureMemory: + attachment: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + append: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + csv: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + convert: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + date: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + date_index_name: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + dot_expander: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + enrich: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + fail: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + foreach: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + json: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + user_agent: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + kv: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + geoip: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + grok: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + gsub: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + join: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + lowercase: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + remove: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + rename: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + script: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + set: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + sort: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + split: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + trim: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + uppercase: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + urldecode: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + bytes: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + dissect: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + set_security_user: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + pipeline: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + drop: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + circle: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + inference: + $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' + nodes.info___NodeInfoSettingsNetwork: type: object properties: - all: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - all_in_bytes: - description: Memory consumed, in bytes, by indexing requests in the coordinating, primary, or replica stage. - $ref: '#/components/schemas/_common___ByteCount' - combined_coordinating_and_primary: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - combined_coordinating_and_primary_in_bytes: - description: |- - Memory consumed, in bytes, by indexing requests in the coordinating or primary stage. - This value is not the sum of coordinating and primary as a node can reuse the coordinating memory if the primary stage is executed locally. - $ref: '#/components/schemas/_common___ByteCount' - coordinating: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - coordinating_in_bytes: - description: Memory consumed, in bytes, by indexing requests in the coordinating stage. - $ref: '#/components/schemas/_common___ByteCount' - primary: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - primary_in_bytes: - description: Memory consumed, in bytes, by indexing requests in the primary stage. - $ref: '#/components/schemas/_common___ByteCount' - replica: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - replica_in_bytes: - description: Memory consumed, in bytes, by indexing requests in the replica stage. - $ref: '#/components/schemas/_common___ByteCount' - coordinating_rejections: - description: Number of indexing requests rejected in the coordinating stage. - type: number - primary_rejections: - description: Number of indexing requests rejected in the primary stage. - type: number - replica_rejections: - description: Number of indexing requests rejected in the replica stage. - type: number - nodes._common___Process: + host: + $ref: '#/components/schemas/_common___Host' + required: + - host + nodes.info___NodeInfoSettingsNode: type: object properties: - cpu: - $ref: '#/components/schemas/nodes._common___Cpu' - mem: - $ref: '#/components/schemas/nodes._common___MemoryStats' - open_file_descriptors: - description: Number of opened file descriptors associated with the current or `-1` if not supported. - type: number - max_file_descriptors: - description: Maximum number of file descriptors allowed on the system, or `-1` if not supported. - type: number - timestamp: - description: |- - Last time the statistics were refreshed. - Recorded in milliseconds since the Unix Epoch. - type: number - nodes._common___Processor: + name: + $ref: '#/components/schemas/_common___Name' + attr: + type: object + additionalProperties: true + max_local_storage_nodes: + type: string + required: + - attr + - name + nodes.info___NodeInfoSettingsPlugins: + type: object + additionalProperties: true + nodes.info___NodeInfoSettingsTransport: type: object properties: - count: - description: Number of documents transformed by the processor. - type: number - current: - description: Number of documents currently being transformed by the processor. - type: number - failed: - description: Number of failed operations for the processor. - type: number - time: - $ref: '#/components/schemas/_common___Duration' - time_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - nodes._common___PublishedClusterStates: + type: + type: string + type.default: + type: string + required: + - type + nodes.info___NodeInfoTransport: type: object properties: - full_states: - description: Number of published cluster states. - type: number - incompatible_diffs: - description: Number of incompatible differences between published cluster states. - type: number - compatible_diffs: - description: Number of compatible differences between published cluster states. - type: number - nodes._common___Recording: + bound_address: + type: array + items: + type: string + publish_address: + type: string + profiles: + type: object + additionalProperties: + type: string + required: + - bound_address + - profiles + - publish_address + nodes.info___NodeJvmInfo: type: object properties: - name: + gc_collectors: + type: array + items: + type: string + mem: + $ref: '#/components/schemas/nodes.info___NodeInfoJvmMemory' + memory_pools: + type: array + items: + type: string + pid: + type: integer + format: int32 + start_time: + $ref: '#/components/schemas/_common___DateTime' + start_time_in_millis: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + version: + $ref: '#/components/schemas/_common___VersionString' + vm_name: + $ref: '#/components/schemas/_common___Name' + vm_vendor: type: string - cumulative_execution_count: - type: number - cumulative_execution_time: + vm_version: + $ref: '#/components/schemas/_common___VersionString' + bundled_jdk: + type: boolean + using_bundled_jdk: + type: + - boolean + - 'null' + using_compressed_ordinary_object_pointers: + $ref: '#/components/schemas/_common___StringifiedBoolean' + input_arguments: + type: array + items: + type: string + required: + - bundled_jdk + - mem + - pid + - start_time_in_millis + nodes.info___NodeOperatingSystemInfo: + type: object + properties: + arch: + description: 'Name of the JVM architecture (ex: amd64, x86)' + type: string + available_processors: + description: Number of processors available to the Java virtual machine + type: integer + format: int32 + allocated_processors: + description: The number of processors actually used to calculate thread pool size. This number can be set with the `node.processors` setting of a node and defaults to the number of processors reported by the OS. + type: integer + format: int32 + name: + $ref: '#/components/schemas/_common___Name' + pretty_name: + $ref: '#/components/schemas/_common___Name' + refresh_interval: $ref: '#/components/schemas/_common___Duration' - cumulative_execution_time_millis: + refresh_interval_in_millis: $ref: '#/components/schemas/_common___DurationValueUnitMillis' - nodes._common___RemoteStoreStats: + version: + $ref: '#/components/schemas/_common___VersionString' + cpu: + $ref: '#/components/schemas/nodes.info___NodeInfoOSCPU' + mem: + $ref: '#/components/schemas/nodes.info___NodeInfoMemory' + swap: + $ref: '#/components/schemas/nodes.info___NodeInfoMemory' + required: + - available_processors + - refresh_interval_in_millis + nodes.info___NodeProcessInfo: type: object properties: - last_successful_fetch_of_pinned_timestamps: - description: Timestamp for the last successful fetch of pinned timestamps. - $ref: '#/components/schemas/_common___StringifiedEpochTimeUnitSeconds' - nodes._common___SampleType: - type: string - description: The type to sample. - enum: - - block - - cpu - - wait - nodes._common___ScriptCache: + id: + description: Process identifier (PID) + type: integer + format: int64 + mlockall: + description: Indicates if the process address space has been successfully locked in memory + type: boolean + refresh_interval: + $ref: '#/components/schemas/_common___Duration' + refresh_interval_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + required: + - id + - mlockall + - refresh_interval_in_millis + nodes.info___NodeThreadPoolInfo: type: object properties: - cache_evictions: - description: Total number of times the script cache has evicted old data. - type: number - compilation_limit_triggered: - description: Total number of times the script compilation circuit breaker has limited inline script compilations. - type: number - compilations: - description: Total number of inline script compilations performed by the node. - type: number - context: + core: + type: integer + format: int32 + keep_alive: + $ref: '#/components/schemas/_common___Duration' + max: + type: integer + format: int32 + queue_size: + type: integer + format: int32 + size: + type: integer + format: int32 + type: type: string - nodes._common___Scripting: + required: + - queue_size + - type + nodes.reload_secure_settings___NodeReloadError: + allOf: + - $ref: '#/components/schemas/nodes.reload_secure_settings___NodeReloadResponse' + - type: object + properties: + reload_exception: + $ref: '#/components/schemas/_common___ErrorCause' + nodes.reload_secure_settings___NodeReloadResponse: type: object properties: - cache_evictions: - description: Total number of times the script cache has evicted old data. - type: number - compilations: - description: Total number of inline script compilations performed by the node. - type: number - compilations_history: - description: Contains this recent history of script compilations. - type: object - additionalProperties: - type: number - compilation_limit_triggered: - description: Total number of times the script compilation circuit breaker has limited inline script compilations. - type: number - contexts: - type: array - items: - $ref: '#/components/schemas/nodes._common___Context' - nodes._common___SerializedClusterState: + name: + $ref: '#/components/schemas/_common___Name' + required: + - name + nodes.reload_secure_settings___NodeReloadResult: + anyOf: + - $ref: '#/components/schemas/nodes.reload_secure_settings___NodeReloadResponse' + - $ref: '#/components/schemas/nodes.reload_secure_settings___NodeReloadError' + nodes.stats___AdaptiveSelection: type: object properties: - full_states: - $ref: '#/components/schemas/nodes._common___SerializedClusterStateDetail' - diffs: - $ref: '#/components/schemas/nodes._common___SerializedClusterStateDetail' - nodes._common___SerializedClusterStateDetail: + avg_queue_size: + description: The exponentially weighted moving average queue size of search requests on the keyed node. + type: integer + format: int64 + avg_response_time: + $ref: '#/components/schemas/_common___Duration' + avg_response_time_ns: + description: The exponentially weighted moving average response time, in nanoseconds, of search requests on the keyed node. + $ref: '#/components/schemas/_common___DurationValueUnitNanos' + avg_service_time: + $ref: '#/components/schemas/_common___Duration' + avg_service_time_ns: + description: The exponentially weighted moving average service time, in nanoseconds, of search requests on the keyed node. + $ref: '#/components/schemas/_common___DurationValueUnitNanos' + outgoing_searches: + description: The number of outstanding search requests to the keyed node from the node these stats are for. + type: integer + format: int64 + rank: + description: The rank of this node; used for shard selection when routing search requests. + type: string + nodes.stats___Breaker: type: object properties: - count: - type: number - uncompressed_size: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - uncompressed_size_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - compressed_size: + estimated_size: + description: Estimated memory used for the operation. $ref: '#/components/schemas/_common___HumanReadableByteCount' - compressed_size_in_bytes: + estimated_size_in_bytes: + description: Estimated memory used, in bytes, for the operation. $ref: '#/components/schemas/_common___ByteCount' - nodes._common___ShardAdmissionControlStats: - type: object - properties: - global_io_usage: - $ref: '#/components/schemas/nodes._common___UsageStats' - global_cpu_usage: - $ref: '#/components/schemas/nodes._common___UsageStats' - nodes._common___ShardCachesStats: - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___ShardCacheStats' - nodes._common___ShardCacheStats: - type: object - properties: - size: + limit_size: + description: Memory limit for the circuit breaker. $ref: '#/components/schemas/_common___HumanReadableByteCount' - size_in_bytes: + limit_size_in_bytes: + description: Memory limit, in bytes, for the circuit breaker. $ref: '#/components/schemas/_common___ByteCount' - evictions: - type: number - hit_count: - type: number - miss_count: - type: number - item_count: + overhead: + description: A constant that all estimates for the circuit breaker are multiplied with to calculate a final estimate. type: number - store_name: - type: string - nodes._common___ShardClusterManagerThrottlingStats: + format: double + tripped: + description: Total number of times the circuit breaker has been triggered and prevented an out of memory error. + type: integer + format: int64 + nodes.stats___CgroupCpuAcctStats: type: object properties: - stats: - $ref: '#/components/schemas/nodes._common___ShardClusterManagerThrottlingStatsDetail' - nodes._common___ShardClusterManagerThrottlingStatsDetail: + control_group: + description: The `cpuacct` control group to which the OpenSearch process belongs. + type: string + usage_nanos: + $ref: '#/components/schemas/_common___DurationValueUnitNanos' + nodes.stats___CgroupCpuStat: type: object properties: - total_throttled_tasks: - type: number - throttled_tasks_per_task_type: - type: object - nodes._common___ShardIndexingPressureStats: + number_of_elapsed_periods: + description: The number of reporting periods (as specified by `cfs_period_micros`) that have elapsed. + type: integer + format: int64 + number_of_times_throttled: + description: The number of times all tasks in the same cgroup as the OpenSearch process have been throttled. + type: integer + format: int64 + time_throttled_nanos: + $ref: '#/components/schemas/_common___DurationValueUnitNanos' + nodes.stats___CgroupCpuStats: type: object properties: - stats: - type: object - enabled: - type: boolean - enforced: - type: boolean - total_rejections_breakup: - $ref: '#/components/schemas/nodes._common___TotalRejectionsBreakup' - total_rejections_breakup_shadow_mode: - $ref: '#/components/schemas/nodes._common___TotalRejectionsBreakup' - nodes._common___ShardRepositoriesStats: - type: array - nodes._common___ShardResourceUsageStats: - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___ShardResourceUsageStatsDetail' - nodes._common___ShardResourceUsageStatsDetail: + control_group: + description: The `cpu` control group to which the OpenSearch process belongs. + type: string + cfs_period_micros: + description: The period of time, in microseconds, for how regularly all tasks in the same cgroup as the OpenSearch process should have their access to CPU resources reallocated. + $ref: '#/components/schemas/_common___DurationValueUnitMicros' + cfs_quota_micros: + description: The total amount of time, in microseconds, for which all tasks in the same cgroup as the OpenSearch process can run during one period `cfs_period_micros`. + $ref: '#/components/schemas/_common___DurationValueUnitMicros' + stat: + $ref: '#/components/schemas/nodes.stats___CgroupCpuStat' + nodes.stats___CgroupMemoryStats: type: object properties: - timestamp: - type: number - cpu_utilization_percent: - $ref: '#/components/schemas/_common___PercentageString' - memory_utilization_percent: - $ref: '#/components/schemas/_common___PercentageString' - io_usage_stats: - $ref: '#/components/schemas/nodes._common___ShardResourceUsageStatsIoUsageStats' - nodes._common___ShardResourceUsageStatsIoUsageStats: + control_group: + description: The `memory` control group to which the OpenSearch process belongs. + type: string + limit_in_bytes: + description: |- + The maximum amount of user memory (including file cache) allowed for all tasks in the same cgroup as the OpenSearch process. + This value can be too big to store in a `long`, so is returned as a string so that the value returned can exactly match what the underlying operating system interface returns. + Any value that is too large to parse into a `long` almost certainly means no limit has been set for the cgroup. + type: string + usage_in_bytes: + description: |- + The total current memory usage by processes in the cgroup, in bytes, by all tasks in the same cgroup as the OpenSearch process. + This value is stored as a string for consistency with `limit_in_bytes`. + type: string + nodes.stats___CgroupStats: type: object properties: - max_io_utilization_percent: - $ref: '#/components/schemas/_common___PercentageString' - nodes._common___ShardSearchBackpressureMode: - type: string - enum: - - disabled - - enforced - - monitor_only - nodes._common___ShardSearchBackpressureStats: + cpuacct: + $ref: '#/components/schemas/nodes.stats___CgroupCpuAcctStats' + cpu: + $ref: '#/components/schemas/nodes.stats___CgroupCpuStats' + memory: + $ref: '#/components/schemas/nodes.stats___CgroupMemoryStats' + nodes.stats___ClusterStateOverallStats: type: object properties: - search_task: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureTaskStats' - search_shard_task: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureTaskStats' - mode: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureMode' - nodes._common___ShardSearchBackpressureTaskCancellationStats: + update_count: + type: integer + format: int64 + total_time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + failed_count: + type: integer + format: int64 + nodes.stats___ClusterStateQueue: type: object properties: - cancellation_count: - type: number - cancellation_limit_reached_count: - type: number - cancelled_task_percentage: - $ref: '#/components/schemas/_common___PercentageNumber' - current_cancellation_eligible_tasks_count: - type: number - nodes._common___ShardSearchBackpressureTaskResourceTrackerCpuUsageTrackerStats: + total: + description: Total number of cluster states in queue. + type: integer + format: int32 + pending: + description: Number of pending cluster states in queue. + type: integer + format: int32 + committed: + description: Number of committed cluster states in queue. + type: integer + format: int32 + nodes.stats___ClusterStateStats: type: object properties: - cancellation_count: - type: number - current_max: - $ref: '#/components/schemas/_common___Duration' - current_max_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - current_avg: - $ref: '#/components/schemas/_common___Duration' - current_avg_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - nodes._common___ShardSearchBackpressureTaskResourceTrackerElapsedTimeTrackerStats: + overall: + $ref: '#/components/schemas/nodes.stats___ClusterStateOverallStats' + nodes.stats___DataPathStats: type: object properties: - cancellation_count: - type: number - current_max: - $ref: '#/components/schemas/_common___Duration' - current_max_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - current_avg: - $ref: '#/components/schemas/_common___Duration' - current_avg_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - nodes._common___ShardSearchBackpressureTaskResourceTrackerHeapUsageTrackerStats: - type: object - properties: - cancellation_count: - type: number - current_max: + available: + description: Total amount of disk space available to this Java virtual machine on this file store. $ref: '#/components/schemas/_common___HumanReadableByteCount' - current_max_bytes: + available_in_bytes: + description: Total number of bytes available to this Java virtual machine on this file store. $ref: '#/components/schemas/_common___ByteCount' - current_avg: + cache_reserved: + x-version-added: '2.7' + description: Total number of cache bytes reserved available to this Java virtual machine on this file store. $ref: '#/components/schemas/_common___HumanReadableByteCount' - current_avg_bytes: + cache_reserved_in_bytes: + x-version-added: '2.7' + description: Total number of cache bytes reserved available to this Java virtual machine on this file store. $ref: '#/components/schemas/_common___ByteCount' - rolling_avg: + free: + description: Total amount of unallocated disk space in the file store. $ref: '#/components/schemas/_common___HumanReadableByteCount' - rolling_avg_bytes: + free_in_bytes: + description: Total number of unallocated bytes in the file store. + $ref: '#/components/schemas/_common___ByteCount' + mount: + description: 'Mount point of the file store (for example: `/dev/sda2`).' + type: string + path: + description: Path to the file store. + type: string + total: + description: Total size of the file store. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + total_in_bytes: + description: Total size of the file store in bytes. $ref: '#/components/schemas/_common___ByteCount' - nodes._common___ShardSearchBackpressureTaskResourceTrackerStats: + type: + description: 'Type of the file store (ex: ext4).' + type: string + nodes.stats___Discovery: type: object properties: - heap_usage_tracker: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureTaskResourceTrackerHeapUsageTrackerStats' - elapsed_time_tracker: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureTaskResourceTrackerElapsedTimeTrackerStats' - cpu_usage_tracker: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureTaskResourceTrackerCpuUsageTrackerStats' - nodes._common___ShardSearchBackpressureTaskStats: + cluster_state_queue: + $ref: '#/components/schemas/nodes.stats___ClusterStateQueue' + cluster_state_stats: + $ref: '#/components/schemas/nodes.stats___ClusterStateStats' + published_cluster_states: + $ref: '#/components/schemas/nodes.stats___PublishedClusterStates' + nodes.stats___ExtendedMemoryStats: + allOf: + - $ref: '#/components/schemas/nodes.stats___MemoryStatsBase' + - type: object + properties: + free_percent: + description: Percentage of free memory. + $ref: '#/components/schemas/_common___PercentageNumber' + used_percent: + description: Percentage of used memory. + $ref: '#/components/schemas/_common___PercentageNumber' + nodes.stats___FileSystem: type: object properties: - resource_tracker_stats: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureTaskResourceTrackerStats' - cancellation_stats: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureTaskCancellationStats' - completion_count: - x-version-added: '3.0' - type: number - nodes._common___ShardSearchPipelineStats: + data: + description: List of all file stores. + type: array + items: + $ref: '#/components/schemas/nodes.stats___DataPathStats' + timestamp: + description: |- + Last time the file stores statistics were refreshed. + Recorded in milliseconds since the Unix Epoch. + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + total: + $ref: '#/components/schemas/nodes.stats___FileSystemTotal' + io_stats: + $ref: '#/components/schemas/nodes.stats___IoStats' + nodes.stats___FileSystemTotal: type: object properties: - total_request: - $ref: '#/components/schemas/nodes._common___ShardSearchPipelineTotalStats' - total_response: - $ref: '#/components/schemas/nodes._common___ShardSearchPipelineTotalStats' - pipelines: + available: + description: |- + Total disk space available to this Java virtual machine on all file stores. + Depending on OS or process level restrictions, this might appear less than `free`. + This is the actual amount of free disk space the OpenSearch node can utilize. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + available_in_bytes: + description: |- + Total number of bytes available to this Java virtual machine on all file stores. + Depending on OS or process level restrictions, this might appear less than `free_in_bytes`. + This is the actual amount of free disk space the OpenSearch node can utilize. + $ref: '#/components/schemas/_common___ByteCount' + free: + description: Total unallocated disk space in all file stores. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + free_in_bytes: + description: Total number of unallocated bytes in all file stores. + $ref: '#/components/schemas/_common___ByteCount' + total: + description: Total size of all file stores. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + total_in_bytes: + description: Total size of all file stores in bytes. + $ref: '#/components/schemas/_common___ByteCount' + cache_reserved: + x-version-added: '2.7' + description: Total size of cache bytes reserved in all file stores. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + cache_reserved_in_bytes: + x-version-added: '2.7' + description: Total size of cache bytes reserved in all file stores. + $ref: '#/components/schemas/_common___ByteCount' + nodes.stats___GarbageCollector: + type: object + properties: + collectors: + description: Contains statistics about JVM garbage collectors for the node. type: object - nodes._common___ShardSearchPipelineTotalStats: + additionalProperties: + $ref: '#/components/schemas/nodes.stats___GarbageCollectorTotal' + nodes.stats___GarbageCollectorTotal: type: object properties: - count: - type: number - time: + collection_count: + description: Total number of JVM garbage collectors that collect objects. + type: integer + format: int64 + collection_time: + description: Total time spent by JVM collecting objects. $ref: '#/components/schemas/_common___Duration' - time_in_millis: + collection_time_in_millis: + description: Total time, in milliseconds, spent by JVM collecting objects. $ref: '#/components/schemas/_common___DurationValueUnitMillis' - current: - type: number - failed: - type: number - nodes._common___ShardSegmentReplicationBackpressureStats: + nodes.stats___Http: type: object properties: - total_rejected_requests: - type: number - nodes._common___ShardTaskCancellationStats: + current_open: + description: Current number of open HTTP connections for the node. + type: integer + format: int64 + total_opened: + description: Total number of HTTP connections opened for the node. + type: integer + format: int64 + nodes.stats___IndexingPressure: type: object properties: - search_shard_task: - $ref: '#/components/schemas/nodes._common___ShardTaskCancellationStatsDetail' - nodes._common___ShardTaskCancellationStatsDetail: + memory: + $ref: '#/components/schemas/nodes.stats___IndexingPressureMemory' + nodes.stats___IndexingPressureMemory: type: object properties: - current_count_post_cancel: - type: number - total_count_post_cancel: - type: number - nodes._common___ShardWeightedRoutingStats: + limit: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + limit_in_bytes: + description: |- + Configured memory limit, in bytes, for the indexing requests. + Replica requests have an automatic limit that is 1.5x this value. + $ref: '#/components/schemas/_common___ByteCount' + current: + $ref: '#/components/schemas/nodes.stats___PressureMemory' + total: + $ref: '#/components/schemas/nodes.stats___PressureMemory' + nodes.stats___IndexMetric: + type: string + enum: + - _all + - completion + - docs + - fielddata + - flush + - get + - indexing + - merge + - query_cache + - recovery + - refresh + - request_cache + - search + - segments + - store + - suggest + - translog + - warmer + nodes.stats___Ingest: type: object properties: - stats: - $ref: '#/components/schemas/nodes._common___ShardWeightedRoutingStatsDetail' - nodes._common___ShardWeightedRoutingStatsDetail: + pipelines: + description: Contains statistics about ingest pipelines for the node. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___IngestTotal' + total: + $ref: '#/components/schemas/nodes.stats___IngestTotal' + nodes.stats___IngestTotal: type: object properties: - fail_open_count: - type: number - nodes._common___Stats: + count: + description: Total number of documents ingested during the lifetime of this node. + type: integer + format: int64 + current: + description: Total number of documents currently being ingested. + type: integer + format: int64 + failed: + description: Total number of failed ingest operations during the lifetime of this node. + type: integer + format: int64 + processors: + description: Total number of ingest processors. + type: array + items: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___KeyedProcessor' + time: + $ref: '#/components/schemas/_common___Duration' + time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + nodes.stats___IoStatDevice: type: object properties: - adaptive_selection: - description: Statistics about adaptive replica selection. - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___AdaptiveSelection' - breakers: - description: Statistics about the field data circuit breaker. - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___Breaker' - fs: - $ref: '#/components/schemas/nodes._common___FileSystem' - host: - $ref: '#/components/schemas/_common___Host' - http: - $ref: '#/components/schemas/nodes._common___Http' - ingest: - $ref: '#/components/schemas/nodes._common___Ingest' - ip: - description: IP address and port for the node. - oneOf: - - $ref: '#/components/schemas/_common___Ip' - - type: array - items: - $ref: '#/components/schemas/_common___Ip' - jvm: - $ref: '#/components/schemas/nodes._common___Jvm' - name: - $ref: '#/components/schemas/_common___Name' - os: - $ref: '#/components/schemas/nodes._common___OperatingSystem' - process: - $ref: '#/components/schemas/nodes._common___Process' - roles: - $ref: '#/components/schemas/_common___NodeRoles' - script: - $ref: '#/components/schemas/nodes._common___Scripting' - script_cache: - type: object - additionalProperties: - oneOf: - - $ref: '#/components/schemas/nodes._common___ScriptCache' - - type: array - items: - $ref: '#/components/schemas/nodes._common___ScriptCache' - thread_pool: - description: Statistics about each thread pool, including current size, queue and rejected tasks. - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___ThreadCount' - timestamp: - type: number - transport: - $ref: '#/components/schemas/nodes._common___Transport' - transport_address: - $ref: '#/components/schemas/_common___TransportAddress' - attributes: - description: Contains a list of attributes for the node. - type: object - additionalProperties: - type: string - discovery: - $ref: '#/components/schemas/nodes._common___Discovery' - indexing_pressure: - $ref: '#/components/schemas/nodes._common___IndexingPressure' - indices: - $ref: '#/components/schemas/indices.stats___IndexShardStats' - shard_indexing_pressure: - $ref: '#/components/schemas/nodes._common___ShardIndexingPressureStats' - search_backpressure: - $ref: '#/components/schemas/nodes._common___ShardSearchBackpressureStats' - cluster_manager_throttling: - $ref: '#/components/schemas/nodes._common___ShardClusterManagerThrottlingStats' - weighted_routing: - $ref: '#/components/schemas/nodes._common___ShardWeightedRoutingStats' - task_cancellation: - $ref: '#/components/schemas/nodes._common___ShardTaskCancellationStats' - resource_usage_stats: - $ref: '#/components/schemas/nodes._common___ShardResourceUsageStats' - search_pipeline: - $ref: '#/components/schemas/nodes._common___ShardSearchPipelineStats' - segment_replication_backpressure: - $ref: '#/components/schemas/nodes._common___ShardSegmentReplicationBackpressureStats' - remote_store: - $ref: '#/components/schemas/nodes._common___RemoteStoreStats' - repositories: - $ref: '#/components/schemas/nodes._common___ShardRepositoriesStats' - admission_control: - $ref: '#/components/schemas/nodes._common___ShardAdmissionControlStats' - caches: - $ref: '#/components/schemas/nodes._common___ShardCachesStats' - nodes._common___ThreadCount: + device_name: + description: The Linux device name. + type: string + operations: + description: The total number of read and write operations for the device completed since starting OpenSearch. + type: integer + format: int64 + read_kilobytes: + description: The total number of kilobytes read for the device since starting OpenSearch. + type: integer + format: int64 + read_operations: + description: The total number of read operations for the device completed since starting OpenSearch. + type: integer + format: int64 + write_kilobytes: + description: The total number of kilobytes written for the device since starting OpenSearch. + type: integer + format: int64 + write_operations: + description: The total number of write operations for the device completed since starting OpenSearch. + type: integer + format: int64 + read_time: + type: integer + format: int64 + write_time: + type: integer + format: int64 + queue_size: + type: integer + format: int64 + io_time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + nodes.stats___IoStats: type: object properties: - active: - description: Number of active threads in the thread pool. - type: number - completed: - description: Number of tasks completed by the thread pool executor. - type: number - largest: - description: Highest number of active threads in the thread pool. - type: number - queue: - description: Number of tasks in queue for the thread pool. - type: number - rejected: - description: Number of tasks rejected by the thread pool executor. - type: number + devices: + description: |- + Array of disk metrics for each device that is backing an OpenSearch data path. + These disk metrics are probed periodically and averages between the last probe and the current probe are computed. + type: array + items: + $ref: '#/components/schemas/nodes.stats___IoStatDevice' + total: + $ref: '#/components/schemas/nodes.stats___IoStatDevice' + nodes.stats___Jvm: + type: object + properties: + buffer_pools: + description: Contains statistics about JVM buffer pools for the node. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___NodeBufferPool' + classes: + $ref: '#/components/schemas/nodes.stats___JvmClasses' + gc: + $ref: '#/components/schemas/nodes.stats___GarbageCollector' + mem: + $ref: '#/components/schemas/nodes.stats___JvmMemoryStats' threads: - description: Number of threads in the thread pool. - type: number - total_wait_time: - description: | - The total amount of time that tasks spend waiting in the thread pool queue. - Currently, only `search`, `search_throttled`, and `index_searcher` thread pools support this metric. + $ref: '#/components/schemas/nodes.stats___JvmThreads' + timestamp: + description: Last time JVM statistics were refreshed. + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + uptime: + description: |- + Human-readable JVM uptime. + Only returned if the `human` query parameter is `true`. $ref: '#/components/schemas/_common___Duration' - total_wait_time_in_nanos: - description: | - The total amount of time that tasks spend waiting in the thread pool queue. - Currently, only `search`, `search_throttled`, and `index_searcher` thread pools support this metric. - type: number - nodes._common___TotalRejectionsBreakup: + uptime_in_millis: + description: JVM uptime in milliseconds. + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + nodes.stats___JvmClasses: type: object properties: - node_limits: - type: number - no_successful_request_limits: - type: number - throughput_degradation_limits: - type: number - nodes._common___Transport: + current_loaded_count: + description: Number of classes currently loaded by JVM. + type: integer + format: int64 + total_loaded_count: + description: Total number of classes loaded since the JVM started. + type: integer + format: int64 + total_unloaded_count: + description: Total number of classes unloaded since the JVM started. + type: integer + format: int64 + nodes.stats___JvmMemoryStats: type: object properties: - inbound_handling_time_histogram: - description: The distribution of the time spent handling each inbound message on a transport thread, represented as a histogram. - type: array - items: - $ref: '#/components/schemas/nodes._common___TransportHistogram' - outbound_handling_time_histogram: - description: The distribution of the time spent sending each outbound transport message on a transport thread, represented as a histogram. - type: array - items: - $ref: '#/components/schemas/nodes._common___TransportHistogram' - rx_count: - description: Total number of RX (receive) packets received by the node during internal cluster communication. - type: number - rx_size: - description: Size of RX packets received by the node during internal cluster communication. + heap_used: + description: Memory currently in use by the heap. $ref: '#/components/schemas/_common___HumanReadableByteCount' - rx_size_in_bytes: - description: Size, in bytes, of RX packets received by the node during internal cluster communication. + heap_used_in_bytes: + description: Memory, in bytes, currently in use by the heap. $ref: '#/components/schemas/_common___ByteCount' - server_open: - description: Current number of inbound TCP connections used for internal communication between nodes. - type: number - tx_count: - description: Total number of TX (transmit) packets sent by the node during internal cluster communication. - type: number - tx_size: - description: Size of TX packets sent by the node during internal cluster communication. + heap_used_percent: + description: Percentage of memory currently in use by the heap. + $ref: '#/components/schemas/_common___PercentageNumber' + heap_committed: + description: Amount of memory available for use by the heap. $ref: '#/components/schemas/_common___HumanReadableByteCount' - tx_size_in_bytes: - description: Size, in bytes, of TX packets sent by the node during internal cluster communication. + heap_committed_in_bytes: + description: Amount of memory, in bytes, available for use by the heap. $ref: '#/components/schemas/_common___ByteCount' - total_outbound_connections: - description: |- - The cumulative number of outbound transport connections that this node has opened since it started. - Each transport connection may comprise multiple TCP connections but is only counted once in this statistic. - Transport connections are typically long-lived so this statistic should remain constant in a stable cluster. - type: number - nodes._common___TransportHistogram: + heap_max: + description: Maximum amount of memory available for use by the heap. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + heap_max_in_bytes: + description: Maximum amount of memory, in bytes, available for use by the heap. + $ref: '#/components/schemas/_common___ByteCount' + non_heap_used: + description: Non-heap memory used. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + non_heap_used_in_bytes: + description: Non-heap memory used, in bytes. + $ref: '#/components/schemas/_common___ByteCount' + non_heap_committed: + description: Amount of non-heap memory available. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + non_heap_committed_in_bytes: + description: Amount of non-heap memory available, in bytes. + $ref: '#/components/schemas/_common___ByteCount' + pools: + description: Contains statistics about heap memory usage for the node. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___Pool' + nodes.stats___JvmThreads: type: object properties: count: - description: The number of times a transport thread took a period of time within the bounds of this bucket to handle an inbound message. - type: number - lt_millis: - description: |- - The exclusive upper bound of the bucket in milliseconds. - May be omitted on the last bucket if this bucket has no upper bound. - type: number - ge_millis: - description: The inclusive lower bound of the bucket in milliseconds. May be omitted on the first bucket if this bucket has no lower bound. - type: number - nodes._common___TransportUsageStats: + description: Number of active threads in use by JVM. + type: integer + format: int64 + peak_count: + description: Highest number of threads used by JVM. + type: integer + format: int64 + nodes.stats___KeyedProcessor: type: object properties: - rejection_count: - type: object - nodes._common___UsageStats: + stats: + $ref: '#/components/schemas/nodes.stats___Processor' + type: + type: string + nodes.stats___LastGcStats: type: object properties: - transport: - $ref: '#/components/schemas/nodes._common___TransportUsageStats' - nodes.info___DeprecationIndexing: + used: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + used_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + max: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + max_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + usage_percent: + $ref: '#/components/schemas/_common___PercentageNumber' + nodes.stats___MemoryStats: + allOf: + - $ref: '#/components/schemas/nodes.stats___MemoryStatsBase' + - type: object + properties: {} + nodes.stats___MemoryStatsBase: type: object properties: - enabled: - oneOf: - - type: boolean - - type: string - required: - - enabled - nodes.info___Metric: + total: + description: Total amount of physical memory. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + total_in_bytes: + description: Total amount of physical memory in bytes. + $ref: '#/components/schemas/_common___ByteCount' + free: + description: Amount of free physical memory. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + free_in_bytes: + description: Amount of free physical memory in bytes. + $ref: '#/components/schemas/_common___ByteCount' + used: + description: Amount of used physical memory. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + used_in_bytes: + description: Amount of used physical memory in bytes. + $ref: '#/components/schemas/_common___ByteCount' + nodes.stats___Metric: type: string enum: - _all - - aggregations + - adaptive_selection + - admission_control + - breaker + - caches + - cluster_manager_throttling + - discovery + - file_cache + - fs - http + - indexing_pressure - indices - ingest - jvm - os - - plugins - process - - search_pipelines - - settings + - repositories + - resource_usage_stats + - script + - script_cache + - search_backpressure + - search_pipeline + - segment_replication_backpressure + - shard_indexing_pressure + - task_cancellation - thread_pool - transport - nodes.info___NodeInfo: + - weighted_routing + nodes.stats___NodeBufferPool: type: object properties: - attributes: - type: object - additionalProperties: - type: string - build_flavor: - type: string - build_hash: - description: Short hash of the last git commit in this release. - type: string - build_type: - type: string - host: - $ref: '#/components/schemas/_common___Host' - http: - $ref: '#/components/schemas/nodes.info___NodeInfoHttp' - ip: - $ref: '#/components/schemas/_common___Ip' - jvm: - $ref: '#/components/schemas/nodes.info___NodeJvmInfo' - name: - $ref: '#/components/schemas/_common___Name' - network: - $ref: '#/components/schemas/nodes.info___NodeInfoNetwork' - os: - $ref: '#/components/schemas/nodes.info___NodeOperatingSystemInfo' - plugins: - type: array - items: - $ref: '#/components/schemas/_common___PluginStats' - process: - $ref: '#/components/schemas/nodes.info___NodeProcessInfo' - roles: - $ref: '#/components/schemas/_common___NodeRoles' - settings: - $ref: '#/components/schemas/nodes.info___NodeInfoSettings' - thread_pool: - type: object - additionalProperties: - $ref: '#/components/schemas/nodes.info___NodeThreadPoolInfo' - total_indexing_buffer: - description: Total heap allowed to be used to hold recently indexed documents before they must be written to disk. This size is a shared pool across all shards on this node, and is controlled by Indexing Buffer settings. - type: number - total_indexing_buffer_in_bytes: + count: + description: Number of buffer pools. + type: integer + format: int64 + total_capacity: + description: Total capacity of buffer pools. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + total_capacity_in_bytes: + description: Total capacity of buffer pools in bytes. $ref: '#/components/schemas/_common___ByteCount' - transport: - $ref: '#/components/schemas/nodes.info___NodeInfoTransport' - transport_address: - $ref: '#/components/schemas/_common___TransportAddress' - version: - $ref: '#/components/schemas/_common___VersionString' - modules: - type: array - items: - $ref: '#/components/schemas/_common___PluginStats' - ingest: - $ref: '#/components/schemas/nodes.info___NodeInfoIngest' - aggregations: + used: + description: Size of buffer pools. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + used_in_bytes: + description: Size of buffer pools in bytes. + $ref: '#/components/schemas/_common___ByteCount' + nodes.stats___NodeIndexShardStats: + allOf: + - $ref: '#/components/schemas/indices.stats___IndexShardStatsBase' + - type: object + properties: {} + nodes.stats___NodeIndicesStats: + allOf: + - $ref: '#/components/schemas/indices.stats___IndexStatsBase' + - type: object + properties: + indices: + type: object + additionalProperties: + $ref: '#/components/schemas/indices.stats___IndexStats' + shards: + type: object + additionalProperties: + type: array + items: + type: object + propertyNames: + title: shard_id + type: string + additionalProperties: + $ref: '#/components/schemas/nodes.stats___NodeIndexShardStats' + minProperties: 1 + maxProperties: 1 + nodes.stats___OperatingSystem: + type: object + properties: + cpu: + $ref: '#/components/schemas/nodes.stats___OperatingSystemCpuStats' + mem: + $ref: '#/components/schemas/nodes.stats___ExtendedMemoryStats' + swap: + $ref: '#/components/schemas/nodes.stats___MemoryStats' + cgroup: + $ref: '#/components/schemas/nodes.stats___CgroupStats' + timestamp: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + nodes.stats___OperatingSystemCpuStats: + type: object + properties: + percent: + $ref: '#/components/schemas/_common___PercentageNumber' + load_average: type: object additionalProperties: - $ref: '#/components/schemas/nodes.info___NodeInfoAggregation' - search_pipelines: - $ref: '#/components/schemas/nodes.info___NodeInfoSearchPipelines' + type: number + format: double + nodes.stats___Pool: + type: object + properties: + used: + description: Memory used by the heap. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + used_in_bytes: + description: Memory, in bytes, used by the heap. + $ref: '#/components/schemas/_common___ByteCount' + max: + description: Maximum amount of memory available for use by the heap. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + max_in_bytes: + description: Maximum amount of memory, in bytes, available for use by the heap. + $ref: '#/components/schemas/_common___ByteCount' + peak_used: + description: Largest amount of memory historically used by the heap. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + peak_used_in_bytes: + description: Largest amount of memory, in bytes, historically used by the heap. + $ref: '#/components/schemas/_common___ByteCount' + peak_max: + description: Largest amount of memory historically used by the heap. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + peak_max_in_bytes: + description: Largest amount of memory, in bytes, historically used by the heap. + $ref: '#/components/schemas/_common___ByteCount' + last_gc_stats: + description: Most recent GC cycle stats for a particular memory pool. + $ref: '#/components/schemas/nodes.stats___LastGcStats' + nodes.stats___PressureMemory: + type: object + properties: + all: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + all_in_bytes: + description: Memory consumed, in bytes, by indexing requests in the coordinating, primary, or replica stage. + $ref: '#/components/schemas/_common___ByteCount' + combined_coordinating_and_primary: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + combined_coordinating_and_primary_in_bytes: + description: |- + Memory consumed, in bytes, by indexing requests in the coordinating or primary stage. + This value is not the sum of coordinating and primary as a node can reuse the coordinating memory if the primary stage is executed locally. + $ref: '#/components/schemas/_common___ByteCount' + coordinating: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + coordinating_in_bytes: + description: Memory consumed, in bytes, by indexing requests in the coordinating stage. + $ref: '#/components/schemas/_common___ByteCount' + primary: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + primary_in_bytes: + description: Memory consumed, in bytes, by indexing requests in the primary stage. + $ref: '#/components/schemas/_common___ByteCount' + replica: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + replica_in_bytes: + description: Memory consumed, in bytes, by indexing requests in the replica stage. + $ref: '#/components/schemas/_common___ByteCount' + coordinating_rejections: + description: Number of indexing requests rejected in the coordinating stage. + type: integer + format: int64 + primary_rejections: + description: Number of indexing requests rejected in the primary stage. + type: integer + format: int64 + replica_rejections: + description: Number of indexing requests rejected in the replica stage. + type: integer + format: int64 + nodes.stats___Process: + type: object + properties: + cpu: + $ref: '#/components/schemas/nodes.stats___ProcessCpuStats' + mem: + $ref: '#/components/schemas/nodes.stats___ProcessMemoryStats' + open_file_descriptors: + description: Number of opened file descriptors associated with the current or `-1` if not supported. + type: integer + format: int64 + max_file_descriptors: + description: Maximum number of file descriptors allowed on the system, or `-1` if not supported. + type: integer + format: int64 + timestamp: + description: |- + Last time the statistics were refreshed. + Recorded in milliseconds since the Unix Epoch. + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + nodes.stats___ProcessCpuStats: + type: object + properties: + percent: + $ref: '#/components/schemas/_common___PercentageNumber' + total: + $ref: '#/components/schemas/_common___Duration' + total_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' required: - - build_hash - - build_type - - name - - roles - - version - nodes.info___NodeInfoAction: + - percent + - total_in_millis + nodes.stats___ProcessMemoryStats: type: object properties: - destructive_requires_name: - type: string - required: - - destructive_requires_name - nodes.info___NodeInfoAggregation: + total_virtual: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + total_virtual_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + nodes.stats___Processor: type: object properties: - types: + count: + description: Number of documents transformed by the processor. + type: integer + format: int64 + current: + description: Number of documents currently being transformed by the processor. + type: integer + format: int64 + failed: + description: Number of failed operations for the processor. + type: integer + format: int64 + time: + $ref: '#/components/schemas/_common___Duration' + time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + nodes.stats___PublishedClusterStates: + type: object + properties: + full_states: + description: Number of published cluster states. + type: integer + format: int64 + incompatible_diffs: + description: Number of incompatible differences between published cluster states. + type: integer + format: int64 + compatible_diffs: + description: Number of compatible differences between published cluster states. + type: integer + format: int64 + nodes.stats___RemoteStoreStats: + type: object + properties: + last_successful_fetch_of_pinned_timestamps: + description: Timestamp for the last successful fetch of pinned timestamps. + $ref: '#/components/schemas/_common___EpochTimeUnitSeconds' + nodes.stats___ScriptCacheStats: + type: object + properties: + sum: + $ref: '#/components/schemas/nodes.stats___ScriptStats' + contexts: type: array items: - type: string + $ref: '#/components/schemas/nodes.stats___ScriptContextStats' required: - - types - nodes.info___NodeInfoBootstrap: + - sum + nodes.stats___ScriptContextStats: + allOf: + - $ref: '#/components/schemas/nodes.stats___ScriptStatsBase' + - type: object + properties: + context: + type: string + required: + - context + nodes.stats___ScriptStats: + allOf: + - $ref: '#/components/schemas/nodes.stats___ScriptStatsBase' + - type: object + properties: {} + nodes.stats___ScriptStatsBase: type: object properties: - memory_lock: - type: string + cache_evictions: + description: Total number of times the script cache has evicted old data. + type: integer + format: int64 + compilations: + description: Total number of inline script compilations performed by the node. + type: integer + format: int64 + compilation_limit_triggered: + description: Total number of times the script compilation circuit breaker has limited inline script compilations. + type: integer + format: int64 required: - - memory_lock - nodes.info___NodeInfoClient: + - cache_evictions + - compilation_limit_triggered + - compilations + nodes.stats___ShardAdmissionControlStats: type: object properties: - type: - type: string - required: - - type - nodes.info___NodeInfoDiscovery: + global_io_usage: + $ref: '#/components/schemas/nodes.stats___UsageStats' + global_cpu_usage: + $ref: '#/components/schemas/nodes.stats___UsageStats' + nodes.stats___ShardCachesStats: type: object - properties: - type: - type: string - seed_hosts: - type: string - nodes.info___NodeInfoHttp: + additionalProperties: + $ref: '#/components/schemas/nodes.stats___ShardCacheStats' + nodes.stats___ShardCacheStats: type: object properties: - bound_address: - type: array - items: - type: string - max_content_length: + size: $ref: '#/components/schemas/_common___HumanReadableByteCount' - max_content_length_in_bytes: + size_in_bytes: $ref: '#/components/schemas/_common___ByteCount' - publish_address: + evictions: + type: integer + format: int64 + hit_count: + type: integer + format: int64 + miss_count: + type: integer + format: int64 + item_count: + type: integer + format: int64 + store_name: type: string - required: - - bound_address - - max_content_length_in_bytes - - publish_address - nodes.info___NodeInfoIngest: + nodes.stats___ShardClusterManagerThrottlingStats: type: object properties: - processors: - type: array - items: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestProcessor' - required: - - processors - nodes.info___NodeInfoIngestDownloader: + stats: + $ref: '#/components/schemas/nodes.stats___ShardClusterManagerThrottlingStatsDetail' + nodes.stats___ShardClusterManagerThrottlingStatsDetail: type: object properties: - enabled: - type: string + total_throttled_tasks: + type: integer + format: int64 + throttled_tasks_per_task_type: + type: object + additionalProperties: + type: integer + format: int64 required: - - enabled - nodes.info___NodeInfoIngestInfo: + - throttled_tasks_per_task_type + - total_throttled_tasks + nodes.stats___ShardIndexingPressurePerShardIndexingStats: type: object properties: - downloader: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestDownloader' + coordinating_time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + coordinating_count: + type: integer + format: int64 + primary_time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + primary_count: + type: integer + format: int64 + replica_time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + replica_count: + type: integer + format: int64 required: - - downloader - nodes.info___NodeInfoIngestProcessor: + - coordinating_count + - coordinating_time_in_millis + - primary_count + - primary_time_in_millis + - replica_count + - replica_time_in_millis + nodes.stats___ShardIndexingPressurePerShardLastSuccessfulTimestamp: type: object properties: - type: - type: string + coordinating_last_successful_request_timestamp_in_millis: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + primary_last_successful_request_timestamp_in_millis: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + replica_last_successful_request_timestamp_in_millis: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' required: - - type - nodes.info___NodeInfoJvmMemory: + - coordinating_last_successful_request_timestamp_in_millis + - primary_last_successful_request_timestamp_in_millis + - replica_last_successful_request_timestamp_in_millis + nodes.stats___ShardIndexingPressurePerShardMemoryAllocationCurrentStats: type: object properties: - direct_max: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - direct_max_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - heap_init: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - heap_init_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - heap_max: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - heap_max_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - non_heap_init: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - non_heap_init_in_bytes: + current_coordinating_and_primary_bytes: $ref: '#/components/schemas/_common___ByteCount' - non_heap_max: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - non_heap_max_in_bytes: + current_replica_bytes: $ref: '#/components/schemas/_common___ByteCount' required: - - direct_max_in_bytes - - heap_init_in_bytes - - heap_max_in_bytes - - non_heap_init_in_bytes - - non_heap_max_in_bytes - nodes.info___NodeInfoMemory: + - current_coordinating_and_primary_bytes + - current_replica_bytes + nodes.stats___ShardIndexingPressurePerShardMemoryAllocationLimitStats: type: object properties: - total: - $ref: '#/components/schemas/_common___HumanReadableByteCount' - total_in_bytes: + current_coordinating_and_primary_limits_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + current_replica_limits_in_bytes: $ref: '#/components/schemas/_common___ByteCount' required: - - total - - total_in_bytes - nodes.info___NodeInfoNetwork: + - current_coordinating_and_primary_limits_in_bytes + - current_replica_limits_in_bytes + nodes.stats___ShardIndexingPressurePerShardMemoryAllocationStats: type: object properties: - primary_interface: - $ref: '#/components/schemas/nodes.info___NodeInfoNetworkInterface' - refresh_interval: - type: number + current: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardMemoryAllocationCurrentStats' + limit: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardMemoryAllocationLimitStats' required: - - primary_interface - - refresh_interval - nodes.info___NodeInfoNetworkInterface: + - current + - limit + nodes.stats___ShardIndexingPressurePerShardMemoryStats: type: object properties: - address: - type: string - mac_address: - type: string - name: - $ref: '#/components/schemas/_common___Name' + current: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardMemoryStatsDetails' + total: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardMemoryStatsDetails' required: - - address - - mac_address - - name - nodes.info___NodeInfoOSCPU: + - current + - total + nodes.stats___ShardIndexingPressurePerShardMemoryStatsDetails: type: object properties: - cache_size: + coordinating: $ref: '#/components/schemas/_common___HumanReadableByteCount' - cache_size_in_bytes: + coordinating_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + primary: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + primary_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + replica: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + replica_in_bytes: $ref: '#/components/schemas/_common___ByteCount' - cores_per_socket: - type: number - mhz: - type: number - model: - type: string - total_cores: - type: number - total_sockets: - type: number - vendor: - type: string required: - - cache_size - - cache_size_in_bytes - - cores_per_socket - - mhz - - model - - total_cores - - total_sockets - - vendor - nodes.info___NodeInfoPath: + - coordinating_in_bytes + - primary_in_bytes + - replica_in_bytes + nodes.stats___ShardIndexingPressurePerShardRejectionCoordinatingStats: type: object properties: - logs: - type: string - home: - type: string - repo: - type: array - items: - type: string - data: - type: array - items: - type: string + coordinating_rejections: + type: integer + format: int64 + breakup: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureRejectionsBreakupStats' + breakup_shadow_mode: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureRejectionsBreakupStats' required: - - home - - logs - nodes.info___NodeInfoRepositories: + - coordinating_rejections + nodes.stats___ShardIndexingPressurePerShardRejectionPrimaryStats: type: object properties: - url: - $ref: '#/components/schemas/nodes.info___NodeInfoRepositoriesUrl' + primary_rejections: + type: integer + format: int64 + breakup: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureRejectionsBreakupStats' + breakup_shadow_mode: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureRejectionsBreakupStats' required: - - url - nodes.info___NodeInfoRepositoriesUrl: + - primary_rejections + nodes.stats___ShardIndexingPressurePerShardRejectionReplicaStats: type: object properties: - allowed_urls: - type: string + replica_rejections: + type: integer + format: int64 + breakup: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureRejectionsBreakupStats' + breakup_shadow_mode: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureRejectionsBreakupStats' required: - - allowed_urls - nodes.info___NodeInfoScript: + - replica_rejections + nodes.stats___ShardIndexingPressurePerShardRejectionStats: type: object properties: - allowed_types: - type: string - disable_max_compilations_rate: - type: string + coordinating: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardRejectionCoordinatingStats' + primary: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardRejectionPrimaryStats' + replica: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardRejectionReplicaStats' required: - - allowed_types - - disable_max_compilations_rate - nodes.info___NodeInfoSearch: + - coordinating + - primary + - replica + nodes.stats___ShardIndexingPressurePerShardStats: type: object properties: - remote: - $ref: '#/components/schemas/nodes.info___NodeInfoSearchRemote' + memory: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardMemoryStats' + rejection: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardRejectionStats' + last_successful_timestamp: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardLastSuccessfulTimestamp' + indexing: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardIndexingStats' + memory_allocation: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardMemoryAllocationStats' required: - - remote - nodes.info___NodeInfoSearchPipelines: + - indexing + - last_successful_timestamp + - memory + - memory_allocation + - rejection + nodes.stats___ShardIndexingPressureRejectionsBreakupStats: type: object properties: - response_processors: - type: array - items: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestProcessor' - request_processors: - type: array - items: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestProcessor' - required: - - request_processors - - response_processors - nodes.info___NodeInfoSearchRemote: + node_limits: + type: integer + format: int64 + no_successful_request_limits: + type: integer + format: int64 + throughput_degradation_limits: + type: integer + format: int64 + nodes.stats___ShardIndexingPressureStats: type: object properties: - connect: - type: string - required: - - connect - nodes.info___NodeInfoSettings: + stats: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressurePerShardStats' + enabled: + type: boolean + enforced: + type: boolean + total_rejections_breakup: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureRejectionsBreakupStats' + total_rejections_breakup_shadow_mode: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureRejectionsBreakupStats' + nodes.stats___ShardRepositoriesStats: + type: array + nodes.stats___ShardResourceUsageStats: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___ShardResourceUsageStatsDetail' + nodes.stats___ShardResourceUsageStatsDetail: type: object properties: - cluster: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsCluster' - node: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsNode' - path: - $ref: '#/components/schemas/nodes.info___NodeInfoPath' - repositories: - $ref: '#/components/schemas/nodes.info___NodeInfoRepositories' - discovery: - $ref: '#/components/schemas/nodes.info___NodeInfoDiscovery' - action: - $ref: '#/components/schemas/nodes.info___NodeInfoAction' - client: - $ref: '#/components/schemas/nodes.info___NodeInfoClient' - http: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsHttp' - bootstrap: - $ref: '#/components/schemas/nodes.info___NodeInfoBootstrap' - transport: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsTransport' - network: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsNetwork' - script: - $ref: '#/components/schemas/nodes.info___NodeInfoScript' - search: - $ref: '#/components/schemas/nodes.info___NodeInfoSearch' - ingest: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIngest' - index: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIndex' - plugins: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsPlugins' - required: - - client - - cluster - - http - - node - - path - - transport - nodes.info___NodeInfoSettingsCluster: + timestamp: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + cpu_utilization_percent: + $ref: '#/components/schemas/_common___PercentageString' + memory_utilization_percent: + $ref: '#/components/schemas/_common___PercentageString' + io_usage_stats: + $ref: '#/components/schemas/nodes.stats___ShardResourceUsageStatsIoUsageStats' + nodes.stats___ShardResourceUsageStatsIoUsageStats: type: object properties: - name: - $ref: '#/components/schemas/_common___Name' - routing: - $ref: '#/components/schemas/indices._common___IndexRouting' - election: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsClusterElection' - initial_cluster_manager_nodes: - type: string - initial_master_nodes: - type: string - deprecation_indexing: - $ref: '#/components/schemas/nodes.info___DeprecationIndexing' - required: - - name - nodes.info___NodeInfoSettingsClusterElection: + max_io_utilization_percent: + $ref: '#/components/schemas/_common___PercentageString' + nodes.stats___ShardSearchBackpressureMode: + type: string + enum: + - disabled + - enforced + - monitor_only + nodes.stats___ShardSearchBackpressureStats: type: object properties: - strategy: - $ref: '#/components/schemas/_common___Name' - required: - - strategy - nodes.info___NodeInfoSettingsHttp: + search_task: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureTaskStats' + search_shard_task: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureTaskStats' + mode: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureMode' + nodes.stats___ShardSearchBackpressureTaskCancellationStats: type: object properties: - type: - type: string - type.default: - type: string - compression: - oneOf: - - type: boolean - - type: string - port: - oneOf: - - type: number - - type: string - required: - - type - nodes.info___NodeInfoSettingsIndex: + cancellation_count: + type: integer + format: int64 + cancellation_limit_reached_count: + type: integer + format: int64 + cancelled_task_percentage: + $ref: '#/components/schemas/_common___PercentageNumber' + current_cancellation_eligible_tasks_count: + type: integer + format: int64 + nodes.stats___ShardSearchBackpressureTaskResourceTrackerCpuUsageTrackerStats: type: object properties: - store: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIndexStore' - nodes.info___NodeInfoSettingsIndexHybrid: + cancellation_count: + type: integer + format: int64 + current_max: + $ref: '#/components/schemas/_common___Duration' + current_max_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + current_avg: + $ref: '#/components/schemas/_common___Duration' + current_avg_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + nodes.stats___ShardSearchBackpressureTaskResourceTrackerElapsedTimeTrackerStats: type: object properties: - mmap: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIndexStoreMmap' - nodes.info___NodeInfoSettingsIndexStore: + cancellation_count: + type: integer + format: int64 + current_max: + $ref: '#/components/schemas/_common___Duration' + current_max_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + current_avg: + $ref: '#/components/schemas/_common___Duration' + current_avg_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + nodes.stats___ShardSearchBackpressureTaskResourceTrackerHeapUsageTrackerStats: + type: object + properties: + cancellation_count: + type: integer + format: int64 + current_max: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + current_max_bytes: + $ref: '#/components/schemas/_common___ByteCount' + current_avg: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + current_avg_bytes: + $ref: '#/components/schemas/_common___ByteCount' + rolling_avg: + $ref: '#/components/schemas/_common___HumanReadableByteCount' + rolling_avg_bytes: + $ref: '#/components/schemas/_common___ByteCount' + nodes.stats___ShardSearchBackpressureTaskResourceTrackerStats: + type: object + properties: + heap_usage_tracker: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureTaskResourceTrackerHeapUsageTrackerStats' + elapsed_time_tracker: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureTaskResourceTrackerElapsedTimeTrackerStats' + cpu_usage_tracker: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureTaskResourceTrackerCpuUsageTrackerStats' + nodes.stats___ShardSearchBackpressureTaskStats: + type: object + properties: + resource_tracker_stats: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureTaskResourceTrackerStats' + cancellation_stats: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureTaskCancellationStats' + completion_count: + x-version-added: '3.0' + type: integer + format: int64 + nodes.stats___ShardSearchPipelineOperationStats: + type: object + properties: + count: + type: integer + format: int64 + time: + $ref: '#/components/schemas/_common___Duration' + time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + current: + type: integer + format: int64 + failed: + type: integer + format: int64 + nodes.stats___ShardSearchPipelinePerPipelineProcessorStats: type: object properties: - hybrid: - $ref: '#/components/schemas/nodes.info___NodeInfoSettingsIndexHybrid' - nodes.info___NodeInfoSettingsIndexStoreMmap: + type: + type: string + stats: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelineOperationStats' + nodes.stats___ShardSearchPipelinePerPipelineStats: type: object properties: - extensions: + request: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelineOperationStats' + response: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelineOperationStats' + request_processors: type: array items: - type: string - nodes.info___NodeInfoSettingsIngest: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelinePerPipelineProcessorStats' + response_processors: + type: array + items: + type: object + propertyNames: + title: processor_name + type: string + additionalProperties: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelinePerPipelineProcessorStats' + minProperties: 1 + maxProperties: 1 + nodes.stats___ShardSearchPipelineStats: type: object properties: - attachment: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - append: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - csv: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - convert: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - date: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - date_index_name: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - dot_expander: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - enrich: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - fail: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - foreach: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - json: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - user_agent: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - kv: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - geoip: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - grok: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - gsub: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - join: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - lowercase: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - remove: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - rename: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - script: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - set: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - sort: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - split: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - trim: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - uppercase: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - urldecode: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - bytes: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - dissect: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - set_security_user: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - pipeline: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - drop: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - circle: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - inference: - $ref: '#/components/schemas/nodes.info___NodeInfoIngestInfo' - nodes.info___NodeInfoSettingsNetwork: + total_request: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelineOperationStats' + total_response: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelineOperationStats' + pipelines: + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelinePerPipelineStats' + nodes.stats___ShardSegmentReplicationBackpressureStats: type: object properties: - host: - $ref: '#/components/schemas/_common___Host' - required: - - host - nodes.info___NodeInfoSettingsNode: + total_rejected_requests: + type: integer + format: int64 + nodes.stats___ShardTaskCancellationStats: type: object properties: - name: - $ref: '#/components/schemas/_common___Name' - attr: - $ref: '#/components/schemas/nodes.info___NodeInfoShardIndexingPressureEnabled' - max_local_storage_nodes: - type: string - required: - - attr - - name - nodes.info___NodeInfoSettingsPlugins: + search_shard_task: + $ref: '#/components/schemas/nodes.stats___ShardTaskCancellationStatsDetail' + nodes.stats___ShardTaskCancellationStatsDetail: type: object - additionalProperties: - $ref: '#/components/schemas/_common___FieldValue' - nodes.info___NodeInfoSettingsTransport: + properties: + current_count_post_cancel: + type: integer + format: int64 + total_count_post_cancel: + type: integer + format: int64 + nodes.stats___ShardWeightedRoutingStats: type: object properties: - type: - type: string - type.default: - type: string - required: - - type - nodes.info___NodeInfoShardIndexingPressureEnabled: + stats: + $ref: '#/components/schemas/nodes.stats___ShardWeightedRoutingStatsDetail' + nodes.stats___ShardWeightedRoutingStatsDetail: type: object properties: - shard_indexing_pressure_enabled: - type: string - required: - - shard_indexing_pressure_enabled - nodes.info___NodeInfoTransport: + fail_open_count: + type: integer + format: int32 + nodes.stats___Stats: type: object properties: - bound_address: - type: array - items: - type: string - publish_address: - type: string - profiles: + adaptive_selection: + description: Statistics about adaptive replica selection. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___AdaptiveSelection' + breakers: + description: Statistics about the field data circuit breaker. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___Breaker' + fs: + $ref: '#/components/schemas/nodes.stats___FileSystem' + host: + $ref: '#/components/schemas/_common___Host' + http: + $ref: '#/components/schemas/nodes.stats___Http' + ingest: + $ref: '#/components/schemas/nodes.stats___Ingest' + ip: + description: IP address and port for the node. + oneOf: + - $ref: '#/components/schemas/_common___Ip' + - type: array + items: + $ref: '#/components/schemas/_common___Ip' + jvm: + $ref: '#/components/schemas/nodes.stats___Jvm' + name: + $ref: '#/components/schemas/_common___Name' + os: + $ref: '#/components/schemas/nodes.stats___OperatingSystem' + process: + $ref: '#/components/schemas/nodes.stats___Process' + roles: + $ref: '#/components/schemas/_common___NodeRoles' + script: + $ref: '#/components/schemas/nodes.stats___ScriptStats' + script_cache: + $ref: '#/components/schemas/nodes.stats___ScriptCacheStats' + thread_pool: + description: Statistics about each thread pool, including current size, queue and rejected tasks. + type: object + additionalProperties: + $ref: '#/components/schemas/nodes.stats___ThreadCount' + timestamp: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + transport: + $ref: '#/components/schemas/nodes.stats___Transport' + transport_address: + $ref: '#/components/schemas/_common___TransportAddress' + attributes: + description: Contains a list of attributes for the node. type: object additionalProperties: type: string - required: - - bound_address - - profiles - - publish_address - nodes.info___NodeJvmInfo: + discovery: + $ref: '#/components/schemas/nodes.stats___Discovery' + indexing_pressure: + $ref: '#/components/schemas/nodes.stats___IndexingPressure' + indices: + $ref: '#/components/schemas/nodes.stats___NodeIndicesStats' + shard_indexing_pressure: + $ref: '#/components/schemas/nodes.stats___ShardIndexingPressureStats' + search_backpressure: + $ref: '#/components/schemas/nodes.stats___ShardSearchBackpressureStats' + cluster_manager_throttling: + $ref: '#/components/schemas/nodes.stats___ShardClusterManagerThrottlingStats' + weighted_routing: + $ref: '#/components/schemas/nodes.stats___ShardWeightedRoutingStats' + task_cancellation: + $ref: '#/components/schemas/nodes.stats___ShardTaskCancellationStats' + resource_usage_stats: + $ref: '#/components/schemas/nodes.stats___ShardResourceUsageStats' + search_pipeline: + $ref: '#/components/schemas/nodes.stats___ShardSearchPipelineStats' + segment_replication_backpressure: + $ref: '#/components/schemas/nodes.stats___ShardSegmentReplicationBackpressureStats' + remote_store: + $ref: '#/components/schemas/nodes.stats___RemoteStoreStats' + repositories: + $ref: '#/components/schemas/nodes.stats___ShardRepositoriesStats' + admission_control: + $ref: '#/components/schemas/nodes.stats___ShardAdmissionControlStats' + caches: + $ref: '#/components/schemas/nodes.stats___ShardCachesStats' + nodes.stats___ThreadCount: type: object properties: - gc_collectors: - type: array - items: - type: string - mem: - $ref: '#/components/schemas/nodes.info___NodeInfoJvmMemory' - memory_pools: - type: array - items: - type: string - pid: - type: number - start_time_in_millis: - $ref: '#/components/schemas/_common___EpochTimeUnitMillis' - version: - $ref: '#/components/schemas/_common___VersionString' - vm_name: - $ref: '#/components/schemas/_common___Name' - vm_vendor: - type: string - vm_version: - $ref: '#/components/schemas/_common___VersionString' - bundled_jdk: - type: boolean - using_bundled_jdk: - type: - - boolean - - 'null' - using_compressed_ordinary_object_pointers: - oneOf: - - type: boolean - - type: string - input_arguments: - type: array - items: - type: string - required: - - bundled_jdk - - mem - - pid - - start_time_in_millis - nodes.info___NodeOperatingSystemInfo: + active: + description: Number of active threads in the thread pool. + type: integer + format: int64 + completed: + description: Number of tasks completed by the thread pool executor. + type: integer + format: int64 + largest: + description: Highest number of active threads in the thread pool. + type: integer + format: int64 + queue: + description: Number of tasks in queue for the thread pool. + type: integer + format: int64 + rejected: + description: Number of tasks rejected by the thread pool executor. + type: integer + format: int64 + threads: + description: Number of threads in the thread pool. + type: integer + format: int64 + total_wait_time: + description: | + The total amount of time that tasks spend waiting in the thread pool queue. + Currently, only `search`, `search_throttled`, and `index_searcher` thread pools support this metric. + $ref: '#/components/schemas/_common___Duration' + total_wait_time_in_nanos: + description: | + The total amount of time that tasks spend waiting in the thread pool queue. + Currently, only `search`, `search_throttled`, and `index_searcher` thread pools support this metric. + $ref: '#/components/schemas/_common___DurationValueUnitNanos' + nodes.stats___Transport: type: object properties: - arch: - description: 'Name of the JVM architecture (ex: amd64, x86)' - type: string - available_processors: - description: Number of processors available to the Java virtual machine - type: number - allocated_processors: - description: The number of processors actually used to calculate thread pool size. This number can be set with the `node.processors` setting of a node and defaults to the number of processors reported by the OS. - type: number - name: - $ref: '#/components/schemas/_common___Name' - pretty_name: - $ref: '#/components/schemas/_common___Name' - refresh_interval_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - version: - $ref: '#/components/schemas/_common___VersionString' - cpu: - $ref: '#/components/schemas/nodes.info___NodeInfoOSCPU' - mem: - $ref: '#/components/schemas/nodes.info___NodeInfoMemory' - swap: - $ref: '#/components/schemas/nodes.info___NodeInfoMemory' - required: - - available_processors - - refresh_interval_in_millis - nodes.info___NodeProcessInfo: + rx_count: + description: Total number of RX (receive) packets received by the node during internal cluster communication. + type: integer + format: int64 + rx_size: + description: Size of RX packets received by the node during internal cluster communication. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + rx_size_in_bytes: + description: Size, in bytes, of RX packets received by the node during internal cluster communication. + $ref: '#/components/schemas/_common___ByteCount' + server_open: + description: Current number of inbound TCP connections used for internal communication between nodes. + type: integer + format: int64 + tx_count: + description: Total number of TX (transmit) packets sent by the node during internal cluster communication. + type: integer + format: int64 + tx_size: + description: Size of TX packets sent by the node during internal cluster communication. + $ref: '#/components/schemas/_common___HumanReadableByteCount' + tx_size_in_bytes: + description: Size, in bytes, of TX packets sent by the node during internal cluster communication. + $ref: '#/components/schemas/_common___ByteCount' + total_outbound_connections: + description: |- + The cumulative number of outbound transport connections that this node has opened since it started. + Each transport connection may comprise multiple TCP connections but is only counted once in this statistic. + Transport connections are typically long-lived so this statistic should remain constant in a stable cluster. + type: integer + format: int64 + nodes.stats___TransportUsageStats: type: object properties: - id: - description: Process identifier (PID) - type: number - mlockall: - description: Indicates if the process address space has been successfully locked in memory - type: boolean - refresh_interval_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - required: - - id - - mlockall - - refresh_interval_in_millis - nodes.info___NodeThreadPoolInfo: + rejection_count: + type: object + additionalProperties: + type: integer + format: int64 + nodes.stats___UsageStats: type: object properties: - core: - type: number - keep_alive: - $ref: '#/components/schemas/_common___Duration' - max: - type: number - queue_size: - type: number - size: - type: number - type: - type: string - required: - - queue_size - - type - nodes.info___ResponseBase: - allOf: - - $ref: '#/components/schemas/nodes._common___NodesResponseBase' - - type: object - properties: - cluster_name: - $ref: '#/components/schemas/_common___Name' - nodes: - type: object - additionalProperties: - $ref: '#/components/schemas/nodes.info___NodeInfo' - required: - - cluster_name - - nodes - nodes.reload_secure_settings___ResponseBase: - allOf: - - $ref: '#/components/schemas/nodes._common___NodesResponseBase' - - type: object - properties: - cluster_name: - $ref: '#/components/schemas/_common___Name' - nodes: - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___NodeReloadResult' - required: - - cluster_name - - nodes - nodes.stats___IndexMetric: - type: string - enum: - - _all - - completion - - docs - - fielddata - - flush - - get - - indexing - - merge - - query_cache - - recovery - - refresh - - request_cache - - search - - segments - - store - - suggest - - translog - - warmer - nodes.stats___Metric: - type: string - enum: - - _all - - adaptive_selection - - admission_control - - breaker - - caches - - cluster_manager_throttling - - discovery - - file_cache - - fs - - http - - indexing_pressure - - indices - - ingest - - jvm - - os - - process - - repositories - - resource_usage_stats - - script - - script_cache - - search_backpressure - - search_pipeline - - segment_replication_backpressure - - shard_indexing_pressure - - task_cancellation - - thread_pool - - transport - - weighted_routing - nodes.stats___ResponseBase: - allOf: - - $ref: '#/components/schemas/nodes._common___NodesResponseBase' - - type: object - properties: - cluster_name: - $ref: '#/components/schemas/_common___Name' - nodes: - type: object - additionalProperties: - $ref: '#/components/schemas/nodes._common___Stats' - required: - - nodes + transport: + $ref: '#/components/schemas/nodes.stats___TransportUsageStats' nodes.usage___Metric: type: string enum: - _all + - aggregations - rest_actions nodes.usage___NodeUsage: type: object @@ -55181,34 +57242,18 @@ components: rest_actions: type: object additionalProperties: - type: number + type: integer + format: int64 since: $ref: '#/components/schemas/_common___EpochTimeUnitMillis' timestamp: $ref: '#/components/schemas/_common___EpochTimeUnitMillis' aggregations: type: object - additionalProperties: - type: object + additionalProperties: true required: - - aggregations - - rest_actions - since - timestamp - nodes.usage___ResponseBase: - allOf: - - $ref: '#/components/schemas/nodes._common___NodesResponseBase' - - type: object - properties: - cluster_name: - $ref: '#/components/schemas/_common___Name' - nodes: - type: object - additionalProperties: - $ref: '#/components/schemas/nodes.usage___NodeUsage' - required: - - cluster_name - - nodes notifications._common___Chime: type: object properties: @@ -55542,7 +57587,6 @@ components: $ref: '#/components/schemas/observability._common___SavedQuery' required: - objectId - - tenant observability._common___ObservabilityObjectList: type: object properties: @@ -56090,19 +58134,6 @@ components: type: string follower_cluster_role: type: string - rollups._common___Continuous: - type: object - properties: - next_window_start_time: - type: number - next_window_end_time: - type: number - status: - type: string - failure_reason: - type: string - stats: - $ref: '#/components/schemas/rollups._common___Stats' rollups._common___Cron: type: object properties: @@ -56123,6 +58154,10 @@ components: type: string target_field: type: string + format: + type: + - 'null' + - string rollups._common___DimensionsConfigItem: type: object properties: @@ -56137,17 +58172,18 @@ components: rollups._common___Explain: type: object properties: - rollup_id: - type: string - last_updated_time: - type: number - continuous: - $ref: '#/components/schemas/rollups._common___Continuous' + metadata_id: + type: + - 'null' + - string + rollup_metadata: + type: + - 'null' + - object rollups._common___ExplainEntities: type: object - properties: - item: - $ref: '#/components/schemas/rollups._common___Explain' + additionalProperties: + $ref: '#/components/schemas/rollups._common___Explain' rollups._common___HistogramDimension: type: object properties: @@ -56222,7 +58258,9 @@ components: target_index: type: string metadata_id: - type: string + type: + - 'null' + - string page_size: type: number delay: @@ -56244,11 +58282,14 @@ components: type: object properties: _id: - type: string - _seqNo: - type: number - _primaryTerm: - type: number + $ref: '#/components/schemas/_common___Id' + _seq_no: + $ref: '#/components/schemas/_common___SequenceNumber' + _primary_term: + type: integer + format: int64 + _version: + $ref: '#/components/schemas/_common___VersionNumber' rollup: $ref: '#/components/schemas/rollups._common___Rollup' rollups._common___Schedule: @@ -56256,19 +58297,6 @@ components: properties: interval: $ref: '#/components/schemas/rollups._common___Interval' - rollups._common___Stats: - type: object - properties: - pages_processed: - type: number - documents_processed: - type: number - rollups_indexed: - type: number - index_time_in_ms: - type: number - search_time_in_ms: - type: number rollups._common___TermsDimension: type: object properties: @@ -57235,6 +59263,10 @@ components: required: - op - path + security._common___PatchOperations: + type: array + items: + $ref: '#/components/schemas/security._common___PatchOperation' security._common___PermissionsInfo: type: object properties: @@ -57491,11 +59523,361 @@ components: type: boolean is_node_certificate_request: type: boolean + sm._common___BadRequestResponse: + type: object + properties: + error: + type: string + status: + type: integer + sm._common___CreateUpdatePolicyRequest: + type: object + properties: + description: + type: string + creation: + $ref: '#/components/schemas/sm._common___CreationConfig' + deletion: + $ref: '#/components/schemas/sm._common___DeletionConfig' + snapshot_config: + $ref: '#/components/schemas/sm._common___SnapshotConfig' + notification: + $ref: '#/components/schemas/sm._common___NotificationConfig' + enabled: + type: boolean + description: 'Whether the policy should be enabled at creation. Default: true' + required: + - creation + - snapshot_config + sm._common___CreationConfig: + type: object + properties: + schedule: + $ref: '#/components/schemas/sm._common___CronSchedule' + time_limit: + type: string + description: Maximum time for snapshot creation. + required: + - schedule + sm._common___CronExpression: + type: object + properties: + expression: + type: string + timezone: + type: string + required: + - expression + - timezone + sm._common___CronSchedule: + type: object + properties: + cron: + $ref: '#/components/schemas/sm._common___CronExpression' + sm._common___DeletePolicyResponse: + type: object + properties: + _index: + type: string + _id: + type: string + _version: + type: integer + result: + type: string + forced_refresh: + type: boolean + _shards: + $ref: '#/components/schemas/sm._common___ShardsInfo' + _seq_no: + type: integer + _primary_term: + type: integer + required: + - _id + - _index + - _primary_term + - _seq_no + - _shards + - _version + - forced_refresh + - result + sm._common___DeletionCondition: + type: object + properties: + max_age: + type: string + max_count: + type: integer + min_count: + type: integer + sm._common___DeletionConfig: + type: object + properties: + schedule: + $ref: '#/components/schemas/sm._common___CronSchedule' + condition: + $ref: '#/components/schemas/sm._common___DeletionCondition' + time_limit: + type: string + sm._common___ExecutionInfo: + type: object + properties: + message: + type: string + cause: + type: string + sm._common___ExecutionMetadata: + type: object + properties: + info: + $ref: '#/components/schemas/sm._common___ExecutionInfo' + sm._common___ExplainedPolicy: + type: object + properties: + name: + type: string + creation: + $ref: '#/components/schemas/sm._common___StateMetadata' + deletion: + $ref: '#/components/schemas/sm._common___StateMetadata' + policy_seq_no: + type: integer + policy_primary_term: + type: integer + enabled: + type: boolean + sm._common___GetPoliciesResponse: + type: object + properties: + total_policies: + type: integer + policies: + type: array + items: + $ref: '#/components/schemas/sm._common___ListedPolicy' + required: + - policies + - total_policies + sm._common___IntervalConfig: + type: object + properties: + start_time: + type: integer + period: + type: integer + unit: + type: string + enum: + - Days + - Hours + - Minutes + required: + - period + - start_time + - unit + sm._common___IntervalSchedule: + type: object + properties: + interval: + $ref: '#/components/schemas/sm._common___IntervalConfig' + sm._common___ListedPolicy: + type: object + properties: + _id: + type: string + _seq_no: + type: integer + _primary_term: + type: integer + sm_policy: + $ref: '#/components/schemas/sm._common___SMPolicy' + required: + - _id + - sm_policy + sm._common___NotFoundError: + type: object + properties: + root_cause: + type: array + items: + $ref: '#/components/schemas/sm._common___RootCause' + type: + type: string + reason: + type: string + required: + - reason + - type + sm._common___NotFoundResponse: + type: object + properties: + error: + $ref: '#/components/schemas/sm._common___NotFoundError' + status: + type: integer + required: + - error + - status + sm._common___NotificationChannel: + type: object + properties: + id: + type: string + required: + - id + sm._common___NotificationConditions: + type: object + properties: + creation: + type: boolean + default: true + deletion: + type: boolean + default: false + failure: + type: boolean + default: false + time_limit_exceeded: + type: boolean + default: false + sm._common___NotificationConfig: + type: object + properties: + channel: + $ref: '#/components/schemas/sm._common___NotificationChannel' + conditions: + $ref: '#/components/schemas/sm._common___NotificationConditions' + sm._common___PolicyExplanation: + type: object + properties: + policies: + type: array + items: + $ref: '#/components/schemas/sm._common___ExplainedPolicy' + sm._common___PolicyResponse: + type: object + properties: + _id: + type: string + _version: + type: integer + _seq_no: + type: integer + _primary_term: + type: integer + sm_policy: + $ref: '#/components/schemas/sm._common___SMPolicy' + required: + - _id + - _primary_term + - _seq_no + - _version + - sm_policy + sm._common___RetryMetadata: + type: object + properties: + count: + type: integer + sm._common___RootCause: + type: object + properties: + type: + type: string + reason: + type: string + sm._common___ShardsInfo: + type: object + properties: + total: + type: integer + successful: + type: integer + failed: + type: integer + sm._common___SMPolicy: + type: object + properties: + name: + type: string + description: + type: string + schema_version: + type: integer + creation: + $ref: '#/components/schemas/sm._common___CreationConfig' + deletion: + $ref: '#/components/schemas/sm._common___DeletionConfig' + description: Configuration for snapshot deletion, optional. + snapshot_config: + $ref: '#/components/schemas/sm._common___SnapshotConfig' + notification: + $ref: '#/components/schemas/sm._common___NotificationConfig' + schedule: + $ref: '#/components/schemas/sm._common___IntervalSchedule' + description: System-generated schedule metadata returned by the API. + enabled: + type: boolean + last_updated_time: + type: integer + enabled_time: + type: integer + required: + - creation + - description + - name + - snapshot_config + sm._common___SnapshotConfig: + type: object + properties: + date_format: + type: string + description: Default "yyyy-MM-dd'T'HH:mm:ss" + timezone: + type: string + description: Default UTC + indices: + type: string + description: Default "*" + repository: + type: string + ignore_unavailable: + type: boolean + description: Default false + include_global_state: + type: boolean + description: Default true + partial: + type: boolean + description: Default false + metadata: + type: object + additionalProperties: + type: string + required: + - repository + sm._common___StateMetadata: + type: object + properties: + current_state: + type: string + trigger: + $ref: '#/components/schemas/sm._common___TriggerMetadata' + latest_execution: + $ref: '#/components/schemas/sm._common___ExecutionMetadata' + retry: + $ref: '#/components/schemas/sm._common___RetryMetadata' + sm._common___TriggerMetadata: + type: object + properties: + time: + type: integer snapshot._common___FileCountSnapshotStats: type: object properties: file_count: - type: number + type: integer + format: int32 size_in_bytes: $ref: '#/components/schemas/_common___ByteCount' required: @@ -57519,79 +59901,15 @@ components: chunk_size: type: string compress: - oneOf: - - type: string - - type: boolean + $ref: '#/components/schemas/_common___StringifiedBoolean' concurrent_streams: - oneOf: - - type: string - - type: number + $ref: '#/components/schemas/_common___StringifiedInteger' location: type: string read_only: - oneOf: - - type: string - - type: boolean + $ref: '#/components/schemas/_common___StringifiedBoolean' required: - location - snapshot._common___ShardsStats: - type: object - properties: - done: - type: number - failed: - type: number - finalizing: - type: number - initializing: - type: number - started: - type: number - total: - type: number - required: - - done - - failed - - finalizing - - initializing - - started - - total - snapshot._common___ShardsStatsStage: - type: string - enum: - - DONE - - FAILURE - - FINALIZE - - INIT - - STARTED - snapshot._common___ShardsStatsSummary: - type: object - properties: - incremental: - $ref: '#/components/schemas/snapshot._common___ShardsStatsSummaryItem' - total: - $ref: '#/components/schemas/snapshot._common___ShardsStatsSummaryItem' - start_time_in_millis: - $ref: '#/components/schemas/_common___EpochTimeUnitMillis' - time: - $ref: '#/components/schemas/_common___Duration' - time_in_millis: - $ref: '#/components/schemas/_common___DurationValueUnitMillis' - required: - - incremental - - start_time_in_millis - - time_in_millis - - total - snapshot._common___ShardsStatsSummaryItem: - type: object - properties: - file_count: - type: number - size_in_bytes: - $ref: '#/components/schemas/_common___ByteCount' - required: - - file_count - - size_in_bytes snapshot._common___SnapshotIndexStats: type: object properties: @@ -57600,7 +59918,7 @@ components: additionalProperties: $ref: '#/components/schemas/snapshot._common___SnapshotShardsStatus' shards_stats: - $ref: '#/components/schemas/snapshot._common___ShardsStats' + $ref: '#/components/schemas/snapshot._common___SnapshotShardsStats' stats: $ref: '#/components/schemas/snapshot._common___SnapshotStats' required: @@ -57678,13 +59996,93 @@ components: - reason - shard_id - status + snapshot._common___SnapshotShardsStats: + type: object + properties: + done: + type: integer + format: int64 + failed: + type: integer + format: int64 + finalizing: + type: integer + format: int64 + initializing: + type: integer + format: int64 + started: + type: integer + format: int64 + total: + type: integer + format: int64 + required: + - done + - failed + - finalizing + - initializing + - started + - total + snapshot._common___SnapshotShardsStatsStage: + oneOf: + - type: string + const: DONE + description: Number of shards in the snapshot that were successfully stored in the repository. + - type: string + const: FAILURE + description: Number of shards in the snapshot that were not successfully stored in the repository. + - type: string + const: FINALIZE + description: Number of shards in the snapshot that are in the finalizing stage of being stored in the repository. + - type: string + const: INIT + description: Number of shards in the snapshot that are in the initializing stage of being stored in the repository. + - type: string + const: STARTED + description: Number of shards in the snapshot that are in the started stage of being stored in the repository. + snapshot._common___SnapshotShardsStatsSummary: + type: object + properties: + incremental: + $ref: '#/components/schemas/snapshot._common___SnapshotShardsStatsSummaryItem' + processed: + $ref: '#/components/schemas/snapshot._common___SnapshotShardsStatsSummaryItem' + total: + $ref: '#/components/schemas/snapshot._common___SnapshotShardsStatsSummaryItem' + start_time_in_millis: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' + time: + $ref: '#/components/schemas/_common___Duration' + time_in_millis: + $ref: '#/components/schemas/_common___DurationValueUnitMillis' + required: + - incremental + - start_time_in_millis + - time_in_millis + - total + snapshot._common___SnapshotShardsStatsSummaryItem: + type: object + properties: + file_count: + type: integer + format: int64 + size_in_bytes: + $ref: '#/components/schemas/_common___ByteCount' + required: + - file_count + - size_in_bytes snapshot._common___SnapshotShardsStatus: type: object properties: + node: + $ref: '#/components/schemas/_common___NodeId' + reason: + type: string stage: - $ref: '#/components/schemas/snapshot._common___ShardsStatsStage' + $ref: '#/components/schemas/snapshot._common___SnapshotShardsStatsStage' stats: - $ref: '#/components/schemas/snapshot._common___ShardsStatsSummary' + $ref: '#/components/schemas/snapshot._common___SnapshotShardsStatsSummary' required: - stage - stats @@ -57693,6 +60091,8 @@ components: properties: incremental: $ref: '#/components/schemas/snapshot._common___FileCountSnapshotStats' + processed: + $ref: '#/components/schemas/snapshot._common___FileCountSnapshotStats' start_time_in_millis: $ref: '#/components/schemas/_common___EpochTimeUnitMillis' time: @@ -57706,7 +60106,7 @@ components: - start_time_in_millis - time_in_millis - total - snapshot._common___Status: + snapshot._common___SnapshotStatus: type: object properties: include_global_state: @@ -57718,7 +60118,7 @@ components: repository: type: string shards_stats: - $ref: '#/components/schemas/snapshot._common___ShardsStats' + $ref: '#/components/schemas/snapshot._common___SnapshotShardsStats' snapshot: type: string state: @@ -57728,7 +60128,6 @@ components: uuid: $ref: '#/components/schemas/_common___Uuid' required: - - include_global_state - indices - repository - shards_stats @@ -57999,6 +60398,8 @@ components: type: boolean cancellable: type: boolean + cancellation_time_millis: + $ref: '#/components/schemas/_common___EpochTimeUnitMillis' description: type: string headers: @@ -58022,6 +60423,8 @@ components: type: string parent_task_id: $ref: '#/components/schemas/_common___TaskId' + resource_stats: + $ref: '#/components/schemas/_common___ResourceStats' required: - action - cancellable @@ -58084,13 +60487,68 @@ components: type: string target_field: type: string + transforms._common___DeletedTransformResponse: + type: object + properties: + _type: + $ref: '#/components/schemas/_common___Type' + _index: + type: string + _id: + $ref: '#/components/schemas/_common___Id' + _version: + $ref: '#/components/schemas/_common___VersionNumber' + result: + type: string + forced_refresh: + type: boolean + _shards: + $ref: '#/components/schemas/_common___ShardStatistics' + _primary_term: + type: integer + format: int64 + _seq_no: + $ref: '#/components/schemas/_common___SequenceNumber' + status: + type: number + required: + - _id + - _index + - _primary_term + - _seq_no + - _shards + - _version + - forced_refresh + - result + - status + transforms._common___DeleteTransformResponseItem: + type: object + properties: + delete: + $ref: '#/components/schemas/transforms._common___DeletedTransformResponse' + transforms._common___DeleteTransformsResponse: + type: object + properties: + took: + type: integer + format: int64 + errors: + type: boolean + items: + type: array + items: + $ref: '#/components/schemas/transforms._common___DeleteTransformResponseItem' transforms._common___Explain: type: object properties: metadata_id: - type: string + type: + - 'null' + - string transform_metadata: - $ref: '#/components/schemas/transforms._common___TransformMetadata' + oneOf: + - $ref: '#/components/schemas/transforms._common___TransformMetadata' + - type: 'null' transforms._common___ExplainResponse: type: object additionalProperties: @@ -58128,32 +60586,6 @@ components: type: string interval: type: string - transforms._common___MetricsConfigItem: - type: object - properties: - source_field: - type: string - target_field: - type: string - metrics: - type: array - items: - $ref: '#/components/schemas/transforms._common___MetricsConfigMetrics' - transforms._common___MetricsConfigMetrics: - type: object - properties: - avg: - type: object - sum: - type: object - max: - type: object - min: - type: object - value_count: - type: object - minProperties: 1 - maxProperties: 1 transforms._common___Preview: type: object properties: @@ -58196,13 +60628,17 @@ components: schedule: $ref: '#/components/schemas/transforms._common___Schedule' metadata_id: - type: string + type: + - 'null' + - string updated_at: - type: string + type: number enabled: type: boolean enabled_at: - type: number + type: + - 'null' + - number description: type: string source_index: @@ -58222,20 +60658,9 @@ components: items: $ref: '#/components/schemas/transforms._common___GroupsConfigItem' aggregations: - type: array - items: - $ref: '#/components/schemas/transforms._common___MetricsConfigItem' - transforms._common___TransformEntity: - type: object - properties: - _id: - type: string - _seqNo: - type: number - _primaryTerm: - type: number - transform: - $ref: '#/components/schemas/transforms._common___Transform' + type: object + additionalProperties: + $ref: '#/components/schemas/transforms._common___GroupsConfigItem' transforms._common___TransformMetadata: type: object properties: @@ -58251,6 +60676,27 @@ components: type: string stats: $ref: '#/components/schemas/transforms._common___ExplainStats' + transforms._common___TransformRequest: + type: object + properties: + transform: + $ref: '#/components/schemas/transforms._common___Transform' + required: + - transform + transforms._common___TransformResponse: + type: object + properties: + _id: + $ref: '#/components/schemas/_common___Id' + _primary_term: + type: integer + format: int64 + _seq_no: + $ref: '#/components/schemas/_common___SequenceNumber' + _version: + $ref: '#/components/schemas/_common___VersionNumber' + transform: + $ref: '#/components/schemas/transforms._common___Transform' transforms._common___TransformsResponse: type: object properties: @@ -58259,7 +60705,7 @@ components: transforms: type: array items: - $ref: '#/components/schemas/transforms._common___TransformEntity' + $ref: '#/components/schemas/transforms._common___TransformResponse' wlm._common___QueryGroupCreate: type: object properties: diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Cat.cs b/src/OpenSearch.Client/_Generated/Descriptors.Cat.cs index 6198e73b9c..13843021d0 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Cat.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Cat.cs @@ -85,27 +85,27 @@ public CatAliasesDescriptor Name(Names name) => Assign(name, (a, v) => a.RouteValues.Optional("name", v)); // Request parameters - /// Whether to expand wildcard expression to concrete indexes that are open, closed or both. + /// Expands wildcard expressions to concrete indexes. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, `hidden`, and `none`. public CatAliasesDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatAliasesDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatAliasesDescriptor Headers(params string[] headers) => Qs("h", headers); - /// Return help information. + /// Returns help information. public CatAliasesDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Whether to return information from the local node only instead of from the cluster manager node. public CatAliasesDescriptor Local(bool? local = true) => Qs("local", local); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatAliasesDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatAliasesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -122,23 +122,23 @@ public partial class CatAllPitSegmentsDescriptor // values part of the url path // Request parameters - /// The unit in which to display byte values. + /// The units used to display byte values. public CatAllPitSegmentsDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatAllPitSegmentsDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatAllPitSegmentsDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatAllPitSegmentsDescriptor Help(bool? help = true) => Qs("help", help); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatAllPitSegmentsDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatAllPitSegmentsDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -165,43 +165,43 @@ public CatAllocationDescriptor(NodeIds nodeId) // values part of the url path NodeIds ICatAllocationRequest.NodeId => Self.RouteValues.Get("node_id"); - /// Comma-separated list of node identifiers or names used to limit the returned information. + /// A comma-separated list of node IDs or names used to limit the returned information. public CatAllocationDescriptor NodeId(NodeIds nodeId) => Assign(nodeId, (a, v) => a.RouteValues.Optional("node_id", v)); // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public CatAllocationDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatAllocationDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the HTTP `Accept` header, such as `json` or `yaml`. public CatAllocationDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatAllocationDescriptor Headers(params string[] headers) => Qs("h", headers); - /// Return help information. + /// Returns help information. public CatAllocationDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from cluster-manager node. public CatAllocationDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatAllocationDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatAllocationDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatAllocationDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -218,35 +218,35 @@ public partial class CatClusterManagerDescriptor // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatClusterManagerDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the HTTP `Accept` header, such as `json` or `yaml`. public CatClusterManagerDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatClusterManagerDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatClusterManagerDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatClusterManagerDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatClusterManagerDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatClusterManagerDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatClusterManagerDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -282,20 +282,20 @@ public CatCountDescriptor Index() public CatCountDescriptor AllIndices() => Index(Indices.All); // Request parameters - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatCountDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatCountDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatCountDescriptor Help(bool? help = true) => Qs("help", help); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatCountDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatCountDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -322,32 +322,32 @@ public CatFielddataDescriptor(Fields fields) // values part of the url path Fields ICatFielddataRequest.Fields => Self.RouteValues.Get("fields"); - /// Comma-separated list of fields used to limit returned information. To retrieve all fields, omit this parameter. + /// A comma-separated list of fields used to limit the amount of returned information. To retrieve all fields, omit this parameter. public CatFielddataDescriptor Fields(Fields fields) => Assign(fields, (a, v) => a.RouteValues.Optional("fields", v)); - /// Comma-separated list of fields used to limit returned information. To retrieve all fields, omit this parameter. + /// A comma-separated list of fields used to limit the amount of returned information. To retrieve all fields, omit this parameter. public CatFielddataDescriptor Fields(params Expression>[] fields) => Assign(fields, (a, v) => a.RouteValues.Optional("fields", (Fields)v)); // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public CatFielddataDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatFielddataDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatFielddataDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatFielddataDescriptor Help(bool? help = true) => Qs("help", help); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatFielddataDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatFielddataDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -360,24 +360,24 @@ public partial class CatHealthDescriptor // values part of the url path // Request parameters - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatHealthDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatHealthDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatHealthDescriptor Help(bool? help = true) => Qs("help", help); - /// If `true`, returns `HH:MM:SS` and Unix epoch timestamps. + /// When `true`, returns `HH:MM:SS` and Unix epoch timestamps. public CatHealthDescriptor IncludeTimestamp(bool? includetimestamp = true) => Qs("ts", includetimestamp); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatHealthDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatHealthDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -414,7 +414,7 @@ public CatIndicesDescriptor(Indices index) // values part of the url path Indices ICatIndicesRequest.Index => Self.RouteValues.Get("index"); - /// Comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. + /// A comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. public CatIndicesDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -427,10 +427,10 @@ public CatIndicesDescriptor Index() public CatIndicesDescriptor AllIndices() => Index(Indices.All); // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public CatIndicesDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatIndicesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); @@ -439,40 +439,40 @@ public CatIndicesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => public CatIndicesDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatIndicesDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatIndicesDescriptor Headers(params string[] headers) => Qs("h", headers); - /// The health status used to limit returned indexes. By default, the response includes indexes of any health status. + /// Limits indexes based on their health status. Supported values are `green`, `yellow`, and `red`. public CatIndicesDescriptor Health(HealthStatus? health) => Qs("health", health); /// Return help information. public CatIndicesDescriptor Help(bool? help = true) => Qs("help", help); - /// If `true`, the response includes information from segments that are not loaded into memory. + /// Whether to include information from segments not loaded into memory. public CatIndicesDescriptor IncludeUnloadedSegments(bool? includeunloadedsegments = true) => Qs("include_unloaded_segments", includeunloadedsegments); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatIndicesDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatIndicesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// If `true`, the response only includes information from primary shards. + /// When `true`, returns information only from the primary shards. public CatIndicesDescriptor Pri(bool? pri = true) => Qs("pri", pri); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatIndicesDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatIndicesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -485,35 +485,35 @@ public partial class CatMasterDescriptor // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatMasterDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatMasterDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatMasterDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatMasterDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatMasterDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatMasterDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatMasterDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatMasterDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -530,35 +530,35 @@ public partial class CatNodeAttributesDescriptor // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatNodeAttributesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatNodeAttributesDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatNodeAttributesDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatNodeAttributesDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatNodeAttributesDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatNodeAttributesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatNodeAttributesDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatNodeAttributesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -571,44 +571,44 @@ public partial class CatNodesDescriptor // values part of the url path // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public CatNodesDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatNodesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatNodesDescriptor Format(string format) => Qs("format", format); - /// If `true`, return the full node ID. If `false`, return the shortened node ID. + /// When `true`, returns the full node ID. When `false`, returns the shortened node ID. public CatNodesDescriptor FullId(bool? fullid = true) => Qs("full_id", fullid); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatNodesDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatNodesDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. [Obsolete( "Deprecated as of: 1.0.0, reason: This parameter does not cause this API to act locally." )] public CatNodesDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatNodesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatNodesDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatNodesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -625,35 +625,35 @@ public partial class CatPendingTasksDescriptor // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatPendingTasksDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatPendingTasksDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatPendingTasksDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatPendingTasksDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatPendingTasksDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatPendingTasksDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatPendingTasksDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatPendingTasksDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -670,23 +670,23 @@ public partial class CatPitSegmentsDescriptor // values part of the url path // Request parameters - /// The unit in which to display byte values. + /// The units used to display byte values. public CatPitSegmentsDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatPitSegmentsDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatPitSegmentsDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatPitSegmentsDescriptor Help(bool? help = true) => Qs("help", help); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatPitSegmentsDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatPitSegmentsDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -703,35 +703,35 @@ public partial class CatPluginsDescriptor // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatPluginsDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatPluginsDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatPluginsDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatPluginsDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatPluginsDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatPluginsDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatPluginsDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatPluginsDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -775,26 +775,26 @@ public CatRecoveryDescriptor Index() public CatRecoveryDescriptor ActiveOnly(bool? activeonly = true) => Qs("active_only", activeonly); - /// The unit used to display byte values. + /// The units used to display byte values. public CatRecoveryDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// If `true`, the response includes detailed information about shard recoveries. + /// When `true`, includes detailed information about shard recoveries. public CatRecoveryDescriptor Detailed(bool? detailed = true) => Qs("detailed", detailed); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatRecoveryDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatRecoveryDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatRecoveryDescriptor Help(bool? help = true) => Qs("help", help); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatRecoveryDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatRecoveryDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -811,35 +811,35 @@ public partial class CatRepositoriesDescriptor // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatRepositoriesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatRepositoriesDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatRepositoriesDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatRepositoriesDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatRepositoriesDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatRepositoriesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatRepositoriesDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatRepositoriesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -866,7 +866,7 @@ public CatSegmentReplicationDescriptor(Indices index) // values part of the url path Indices ICatSegmentReplicationRequest.Index => Self.RouteValues.Get("index"); - /// Comma-separated list or wildcard expression of index names to limit the returned information. + /// A comma-separated list of data streams, indexes, and aliases used to limit the request. Supports wildcards (`*`). To target all data streams and indexes, omit this parameter or use `*` or `_all`. public CatSegmentReplicationDescriptor Index(Indices index) => Assign(index, (a, v) => a.RouteValues.Optional("index", v)); @@ -879,58 +879,58 @@ public CatSegmentReplicationDescriptor Index() public CatSegmentReplicationDescriptor AllIndices() => Index(Indices.All); // Request parameters - /// If `true`, the response only includes ongoing segment replication events. + /// When `true`, the response only includes ongoing segment replication events. public CatSegmentReplicationDescriptor ActiveOnly(bool? activeonly = true) => Qs("active_only", activeonly); - /// Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have been specified). + /// Whether to ignore the index if a wildcard index expression resolves to no concrete indexes. This includes the `_all` string or when no indexes have been specified. public CatSegmentReplicationDescriptor AllowNoIndices(bool? allownoindices = true) => Qs("allow_no_indices", allownoindices); - /// The unit in which to display byte values. + /// The units used to display byte values. public CatSegmentReplicationDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// If `true`, the response only includes latest completed segment replication events. + /// When `true`, the response only includes the last-completed segment replication events. public CatSegmentReplicationDescriptor CompletedOnly(bool? completedonly = true) => Qs("completed_only", completedonly); - /// If `true`, the response includes detailed information about segment replications. + /// When `true`, the response includes additional metrics for each stage of a segment replication event. public CatSegmentReplicationDescriptor Detailed(bool? detailed = true) => Qs("detailed", detailed); - /// Whether to expand wildcard expression to concrete indexes that are open, closed or both. + /// Whether to expand the wildcard expression to include concrete indexes that are open, closed, or both. public CatSegmentReplicationDescriptor ExpandWildcards(ExpandWildcards? expandwildcards) => Qs("expand_wildcards", expandwildcards); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatSegmentReplicationDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatSegmentReplicationDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatSegmentReplicationDescriptor Help(bool? help = true) => Qs("help", help); - /// Whether specified concrete, expanded or aliased indexes should be ignored when throttled. + /// Whether specified concrete, expanded, or aliased indexes should be ignored when throttled. public CatSegmentReplicationDescriptor IgnoreThrottled(bool? ignorethrottled = true) => Qs("ignore_throttled", ignorethrottled); - /// Whether specified concrete indexes should be ignored when unavailable (missing or closed). + /// Whether the specified concrete indexes should be ignored when missing or closed. public CatSegmentReplicationDescriptor IgnoreUnavailable(bool? ignoreunavailable = true) => Qs("ignore_unavailable", ignoreunavailable); - /// Comma-separated list of shards to display. + /// A comma-separated list of shards to display. public CatSegmentReplicationDescriptor Shards(params string[] shards) => Qs("shards", shards); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatSegmentReplicationDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Operation timeout. + /// The operation timeout. public CatSegmentReplicationDescriptor Timeout(Time timeout) => Qs("timeout", timeout); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatSegmentReplicationDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -970,35 +970,35 @@ public CatSegmentsDescriptor Index() public CatSegmentsDescriptor AllIndices() => Index(Indices.All); // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public CatSegmentsDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatSegmentsDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatSegmentsDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatSegmentsDescriptor Headers(params string[] headers) => Qs("h", headers); - /// Return help information. + /// Returns help information. public CatSegmentsDescriptor Help(bool? help = true) => Qs("help", help); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatSegmentsDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatSegmentsDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatSegmentsDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -1034,38 +1034,38 @@ public CatShardsDescriptor Index() public CatShardsDescriptor AllIndices() => Index(Indices.All); // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public CatShardsDescriptor Bytes(ByteUnit? bytes) => Qs("bytes", bytes); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatShardsDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatShardsDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatShardsDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatShardsDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatShardsDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatShardsDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatShardsDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatShardsDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -1097,36 +1097,36 @@ public CatSnapshotsDescriptor RepositoryName(Names repository) => Assign(repository, (a, v) => a.RouteValues.Optional("repository", v)); // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatSnapshotsDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatSnapshotsDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatSnapshotsDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatSnapshotsDescriptor Help(bool? help = true) => Qs("help", help); - /// If `true`, the response does not include information from unavailable snapshots. + /// When `true`, the response does not include information from unavailable snapshots. public CatSnapshotsDescriptor IgnoreUnavailable(bool? ignoreunavailable = true) => Qs("ignore_unavailable", ignoreunavailable); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatSnapshotsDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatSnapshotsDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatSnapshotsDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -1139,33 +1139,33 @@ public partial class CatTasksDescriptor // values part of the url path // Request parameters - /// The task action names, which are used to limit the response. + /// The task action names used to limit the response. public CatTasksDescriptor Actions(params string[] actions) => Qs("actions", actions); /// If `true`, the response includes detailed information about shard recoveries. public CatTasksDescriptor Detailed(bool? detailed = true) => Qs("detailed", detailed); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatTasksDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatTasksDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatTasksDescriptor Help(bool? help = true) => Qs("help", help); - /// Comma-separated list of node IDs or names to limit the returned information; use `_local` to return information from the node you're connecting to, leave empty to get information from all nodes. + /// A comma-separated list of node IDs or names used to limit the returned information. Use `_local` to return information from the node to which you're connecting, specify a specific node from which to get information, or keep the parameter empty to get information from all nodes. public CatTasksDescriptor Nodes(params string[] nodes) => Qs("nodes", nodes); /// The parent task identifier, which is used to limit the response. public CatTasksDescriptor ParentTaskId(string parenttaskid) => Qs("parent_task_id", parenttaskid); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatTasksDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatTasksDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -1197,35 +1197,35 @@ public CatTemplatesDescriptor Name(Name name) => Assign(name, (a, v) => a.RouteValues.Optional("name", v)); // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatTemplatesDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatTemplatesDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatTemplatesDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatTemplatesDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatTemplatesDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] public CatTemplatesDescriptor MasterTimeout(Time mastertimeout) => Qs("master_timeout", mastertimeout); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatTemplatesDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatTemplatesDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } @@ -1258,24 +1258,24 @@ public CatThreadPoolDescriptor ThreadPoolPatterns(Names threadPoolPatterns) => Assign(threadPoolPatterns, (a, v) => a.RouteValues.Optional("thread_pool_patterns", v)); // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public CatThreadPoolDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public CatThreadPoolDescriptor Format(string format) => Qs("format", format); - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public CatThreadPoolDescriptor Headers(params string[] headers) => Qs("h", headers); /// Return help information. public CatThreadPoolDescriptor Help(bool? help = true) => Qs("help", help); - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public CatThreadPoolDescriptor Local(bool? local = true) => Qs("local", local); - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -1285,11 +1285,11 @@ public CatThreadPoolDescriptor MasterTimeout(Time mastertimeout) => /// The multiplier in which to display values. public CatThreadPoolDescriptor Size(long? size) => Qs("size", size); - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public CatThreadPoolDescriptor SortByColumns(params string[] sortbycolumns) => Qs("s", sortbycolumns); - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public CatThreadPoolDescriptor Verbose(bool? verbose = true) => Qs("v", verbose); } } diff --git a/src/OpenSearch.Client/_Generated/Descriptors.Cluster.cs b/src/OpenSearch.Client/_Generated/Descriptors.Cluster.cs index 037774c1e9..b629fb69a7 100644 --- a/src/OpenSearch.Client/_Generated/Descriptors.Cluster.cs +++ b/src/OpenSearch.Client/_Generated/Descriptors.Cluster.cs @@ -215,6 +215,10 @@ public GetComponentTemplateDescriptor Name(Name name) => public GetComponentTemplateDescriptor ClusterManagerTimeout(Time clustermanagertimeout) => Qs("cluster_manager_timeout", clustermanagertimeout); + /// If `true`, returns settings in flat format. + public GetComponentTemplateDescriptor FlatSettings(bool? flatsettings = true) => + Qs("flat_settings", flatsettings); + /// If `true`, the request retrieves information from the local node only. If `false`, information is retrieved from the cluster-manager node. public GetComponentTemplateDescriptor Local(bool? local = true) => Qs("local", local); diff --git a/src/OpenSearch.Client/_Generated/Requests.Cat.cs b/src/OpenSearch.Client/_Generated/Requests.Cat.cs index 31500a099d..1f5a4152bf 100644 --- a/src/OpenSearch.Client/_Generated/Requests.Cat.cs +++ b/src/OpenSearch.Client/_Generated/Requests.Cat.cs @@ -87,14 +87,17 @@ public CatAliasesRequest(Names name) Names ICatAliasesRequest.Name => Self.RouteValues.Get("name"); // Request parameters - /// Whether to expand wildcard expression to concrete indexes that are open, closed or both. + /// + /// Expands wildcard expressions to concrete indexes. Combine multiple values with commas. Supported values are `all`, `open`, `closed`, + /// `hidden`, and `none`. + /// public ExpandWildcards? ExpandWildcards { get => Q("expand_wildcards"); set => Q("expand_wildcards", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -105,35 +108,35 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); set => Q("h", value); } - /// Return help information. + /// Returns help information. public bool? Help { get => Q("help"); set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Whether to return information from the local node only instead of from the cluster manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -156,14 +159,14 @@ public partial class CatAllPitSegmentsRequest // values part of the url path // Request parameters - /// The unit in which to display byte values. + /// The units used to display byte values. public ByteUnit? Bytes { get => Q("bytes"); set => Q("bytes", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -174,7 +177,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -188,14 +191,14 @@ public bool? Help set => Q("help", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -232,14 +235,14 @@ public CatAllocationRequest(NodeIds nodeId) NodeIds ICatAllocationRequest.NodeId => Self.RouteValues.Get("node_id"); // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public ByteUnit? Bytes { get => Q("bytes"); set => Q("bytes", value); } - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -247,7 +250,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the HTTP `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -258,28 +261,28 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); set => Q("h", value); } - /// Return help information. + /// Returns help information. public bool? Help { get => Q("help"); set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from cluster-manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -289,14 +292,14 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -319,7 +322,7 @@ public partial class CatClusterManagerRequest // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -327,7 +330,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the HTTP `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -338,7 +341,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -352,14 +355,14 @@ public bool? Help set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// A timeout for connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -369,14 +372,14 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -413,7 +416,7 @@ public CatCountRequest(Indices index) Indices ICatCountRequest.Index => Self.RouteValues.Get("index"); // Request parameters - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -424,7 +427,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -438,14 +441,14 @@ public bool? Help set => Q("help", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -482,14 +485,14 @@ public CatFielddataRequest(Fields fields) Fields ICatFielddataRequest.Fields => Self.RouteValues.Get("fields"); // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public ByteUnit? Bytes { get => Q("bytes"); set => Q("bytes", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -500,7 +503,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -514,14 +517,14 @@ public bool? Help set => Q("help", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -543,7 +546,7 @@ public partial class CatHealthRequest // values part of the url path // Request parameters - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -554,7 +557,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -568,21 +571,21 @@ public bool? Help set => Q("help", value); } - /// If `true`, returns `HH:MM:SS` and Unix epoch timestamps. + /// When `true`, returns `HH:MM:SS` and Unix epoch timestamps. public bool? IncludeTimestamp { get => Q("ts"); set => Q("ts", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -634,14 +637,14 @@ public CatIndicesRequest(Indices index) Indices ICatIndicesRequest.Index => Self.RouteValues.Get("index"); // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public ByteUnit? Bytes { get => Q("bytes"); set => Q("bytes", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -656,7 +659,7 @@ public ExpandWildcards? ExpandWildcards set => Q("expand_wildcards", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -667,14 +670,14 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); set => Q("h", value); } - /// The health status used to limit returned indexes. By default, the response includes indexes of any health status. + /// Limits indexes based on their health status. Supported values are `green`, `yellow`, and `red`. public HealthStatus? Health { get => Q("health"); @@ -688,21 +691,21 @@ public bool? Help set => Q("help", value); } - /// If `true`, the response includes information from segments that are not loaded into memory. + /// Whether to include information from segments not loaded into memory. public bool? IncludeUnloadedSegments { get => Q("include_unloaded_segments"); set => Q("include_unloaded_segments", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -712,21 +715,21 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// If `true`, the response only includes information from primary shards. + /// When `true`, returns information only from the primary shards. public bool? Pri { get => Q("pri"); set => Q("pri", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -748,7 +751,7 @@ public partial class CatMasterRequest // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -756,7 +759,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -767,7 +770,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -781,14 +784,14 @@ public bool? Help set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -798,14 +801,14 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -828,7 +831,7 @@ public partial class CatNodeAttributesRequest // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -836,7 +839,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -847,7 +850,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -861,14 +864,14 @@ public bool? Help set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -878,14 +881,14 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -907,14 +910,14 @@ public partial class CatNodesRequest // values part of the url path // Request parameters - /// The unit used to display byte values. + /// The units used to display byte values. public ByteUnit? Bytes { get => Q("bytes"); set => Q("bytes", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -922,7 +925,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -933,14 +936,14 @@ public string Format } } - /// If `true`, return the full node ID. If `false`, return the shortened node ID. + /// When `true`, returns the full node ID. When `false`, returns the shortened node ID. public bool? FullId { get => Q("full_id"); set => Q("full_id", value); } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -954,7 +957,7 @@ public bool? Help set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. [Obsolete( "Deprecated as of: 1.0.0, reason: This parameter does not cause this API to act locally." )] @@ -964,7 +967,7 @@ public bool? Local set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -974,14 +977,14 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -1004,7 +1007,7 @@ public partial class CatPendingTasksRequest // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -1012,7 +1015,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -1023,7 +1026,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -1037,14 +1040,14 @@ public bool? Help set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -1054,14 +1057,14 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -1083,14 +1086,14 @@ public partial class CatPitSegmentsRequest // values part of the url path // Request parameters - /// The unit in which to display byte values. + /// The units used to display byte values. public ByteUnit? Bytes { get => Q("bytes"); set => Q("bytes", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -1101,7 +1104,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -1115,14 +1118,14 @@ public bool? Help set => Q("help", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -1144,7 +1147,7 @@ public partial class CatPluginsRequest // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -1152,7 +1155,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -1163,7 +1166,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -1177,14 +1180,14 @@ public bool? Help set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -1194,14 +1197,14 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -1245,21 +1248,21 @@ public bool? ActiveOnly set => Q("active_only", value); } - /// The unit used to display byte values. + /// The units used to display byte values. public ByteUnit? Bytes { get => Q("bytes"); set => Q("bytes", value); } - /// If `true`, the response includes detailed information about shard recoveries. + /// When `true`, includes detailed information about shard recoveries. public bool? Detailed { get => Q("detailed"); set => Q("detailed", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -1270,7 +1273,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -1284,14 +1287,14 @@ public bool? Help set => Q("help", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -1314,7 +1317,7 @@ public partial class CatRepositoriesRequest // values part of the url path // Request parameters - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. /// Supported by OpenSearch servers of version 2.0.0 or greater. public Time ClusterManagerTimeout { @@ -1322,7 +1325,7 @@ public Time ClusterManagerTimeout set => Q("cluster_manager_timeout", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -1333,7 +1336,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -1347,14 +1350,14 @@ public bool? Help set => Q("help", value); } - /// Return local information, do not retrieve the state from cluster-manager node. + /// Returns local information but does not retrieve the state from the cluster manager node. public bool? Local { get => Q("local"); set => Q("local", value); } - /// Operation timeout for connection to cluster-manager node. + /// The amount of time allowed to establish a connection to the cluster manager node. [Obsolete( "Deprecated as of: 2.0.0, reason: To promote inclusive language, use `cluster_manager_timeout` instead." )] @@ -1364,14 +1367,14 @@ public Time MasterTimeout set => Q("master_timeout", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Verbose mode. Display column headers. + /// Enables verbose mode, which displays column headers. public bool? Verbose { get => Q("v"); @@ -1409,7 +1412,7 @@ public CatSegmentReplicationRequest(Indices index) Indices ICatSegmentReplicationRequest.Index => Self.RouteValues.Get("index"); // Request parameters - /// If `true`, the response only includes ongoing segment replication events. + /// When `true`, the response only includes ongoing segment replication events. public bool? ActiveOnly { get => Q("active_only"); @@ -1417,8 +1420,8 @@ public bool? ActiveOnly } /// - /// Whether to ignore if a wildcard indexes expression resolves into no concrete indexes. (This includes `_all` string or when no indexes have - /// been specified). + /// Whether to ignore the index if a wildcard index expression resolves to no concrete indexes. This includes the `_all` string or when no + /// indexes have been specified. /// public bool? AllowNoIndices { @@ -1426,35 +1429,35 @@ public bool? AllowNoIndices set => Q("allow_no_indices", value); } - /// The unit in which to display byte values. + /// The units used to display byte values. public ByteUnit? Bytes { get => Q("bytes"); set => Q("bytes", value); } - /// If `true`, the response only includes latest completed segment replication events. + /// When `true`, the response only includes the last-completed segment replication events. public bool? CompletedOnly { get => Q("completed_only"); set => Q("completed_only", value); } - /// If `true`, the response includes detailed information about segment replications. + /// When `true`, the response includes additional metrics for each stage of a segment replication event. public bool? Detailed { get => Q("detailed"); set => Q("detailed", value); } - /// Whether to expand wildcard expression to concrete indexes that are open, closed or both. + /// Whether to expand the wildcard expression to include concrete indexes that are open, closed, or both. public ExpandWildcards? ExpandWildcards { get => Q("expand_wildcards"); set => Q("expand_wildcards", value); } - /// A short version of the Accept header (for example, `json`, `yaml`). + /// A short version of the `Accept` header, such as `json` or `yaml`. public string Format { get => Q("format"); @@ -1465,7 +1468,7 @@ public string Format } } - /// Comma-separated list of column names to display. + /// A comma-separated list of column names to display. public string[] Headers { get => Q("h"); @@ -1479,42 +1482,42 @@ public bool? Help set => Q("help", value); } - /// Whether specified concrete, expanded or aliased indexes should be ignored when throttled. + /// Whether specified concrete, expanded, or aliased indexes should be ignored when throttled. public bool? IgnoreThrottled { get => Q("ignore_throttled"); set => Q("ignore_throttled", value); } - /// Whether specified concrete indexes should be ignored when unavailable (missing or closed). + /// Whether the specified concrete indexes should be ignored when missing or closed. public bool? IgnoreUnavailable { get => Q("ignore_unavailable"); set => Q("ignore_unavailable", value); } - /// Comma-separated list of shards to display. + /// A comma-separated list of shards to display. public string[] Shards { get => Q("shards"); set => Q("shards", value); } - /// Comma-separated list of column names or column aliases to sort by. + /// A comma-separated list of column names or column aliases to sort by. public string[] SortByColumns { get => Q("s"); set => Q("s", value); } - /// Operation timeout. + /// The operation timeout. public Time Timeout { get => Q