opensearch-ruby 4.0.0.pre.beta.1 → 4.0.0.pre.beta.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdf5c69e20343405defeff71ac640af01cd87f6222ffa2052029f31911267dda
-  data.tar.gz: 0e7242dbf0511fc0dad15fa3afc85ff98de796b5a842001dcd60823c2537481b
+  metadata.gz: 52165e3bcc6883923f6bbfc57aeaf73b0cd9d054983804de6432baece83483ee
+  data.tar.gz: 0eb577153a23b0d91f091e901e8a209b6a880da271a5e426a27586bdccaa2710
 SHA512:
-  metadata.gz: 73c975b47facb08c4643a5567251c0b4de1f065e05eb357e5e704166258461b8611b89839346280296eb1e1614bf5932c8169e650dac24474e172bed11ee4011
-  data.tar.gz: b541b72c1493c598e02e4cf2583c83802c97811e7c62904e9d84f4862397340db9ee41a4d777f55323c718a90d6571494d9544d6674afe6d8ea0a7c3c9b1dbd9
+  metadata.gz: 900fd3c53f3b222fece0968e1094a87f5ce2cd6a7174d8a54470d74a19af5db6982351459d5efdedd03545ac824123daefb2373ae109a263fca50bbd755ba357
+  data.tar.gz: c72d67452b64da318baf2d9f71b2aff32ebb7c0e6f1eb493b5c91ddd7ab3b54590108b56dcc2ce5a705868cbf2c7772742029d55a85629de7a42cea129ce52e2

data/USER_GUIDE.md

@@ -3,6 +3,7 @@
   - [Basic Usage](#basic-usage)
   - [OpenSearch DSL](#opensearch-dsl)
   - [Guides by Topics](#guides-by-topics)
+  - [Using a Request Signer](#using-a-request-signer)
   - [Amazon OpenSearch Service](#amazon-opensearch-service)
 
 # User Guide
@@ -24,12 +25,12 @@ bundle install
 Import the client:
 
 ```ruby
-require 'opensearch'
+require 'opensearch-ruby'
 ```
 
 ## Basic Usage
 ```ruby
-require 'opensearch'
+require 'opensearch-ruby'
 
 client = OpenSearch::Client.new(
   host: 'https://localhost:9200',
@@ -114,8 +115,8 @@ puts response
 The `opensearch-dsl` library is designed as a group of standalone Ruby modules, classes and DSL methods, which provide an idiomatic way to build complex search definitions
 
 ```ruby
-require 'opensearch'
-require 'opensearch/dsl'
+require 'opensearch-ruby'
+require 'opensearch-dsl'
 include OpenSearch::DSL
 
 response = client.search index: index_name, body: search {
@@ -142,8 +143,25 @@ response = client.search index: index_name, body: search {
 - [Transport Options](guides/transport_options.md)
 - [Custom HTTP Requests](guides/json.md)
 
+
+## Using a Request Signer
+The OpenSearch ruby client supports request signing as an authentication mechanism. When instantiating a client, you can pass a request signer object to sign requests. This object is often created via a 3rd party library such as `opensearch-aws-sigv4`, but you can also create your own (Check the [DEVELOPER_GUIDE](./DEVELOPER_GUIDE.md) for more details). Below is a very simple example of a request signer object that simply signs the request with a timestamp:
+
+```ruby
+require 'opensearch-ruby'
+
+client = OpenSearch::Client.new(
+  host: 'https://localhost:9200',
+  request_signer: Struct.new(:signer) do
+    def self.sign_request(**args)
+      args[:headers].merge({ 'X-signature' => Time.now.utc })
+    end
+  end
+)
+```
+
 ## Amazon OpenSearch Service
 
-Requests to [OpenSearch Service and OpenSearch Serverless](https://docs.aws.amazon.com/opensearch-service/index.html) must be signed using the AWS signing protocol. Use `opensearch-aws-sigv4` gem in place of `opensearch-ruby` gem.
+Requests to [OpenSearch Service and OpenSearch Serverless](https://docs.aws.amazon.com/opensearch-service/index.html) must be signed using the AWS signing protocol. The `opensearch-aws-sigv4` gem provides a request signer object that can be passed to the `OpenSearch::Client` during instantiation to sign requests.
 
 For more information, checkout the [USER_GUIDE](https://github.com/opensearch-project/opensearch-ruby-aws-sigv4/blob/main/USER_GUIDE.md) of [opensearch-aws-sigv4 gem](https://github.com/opensearch-project/opensearch-ruby-aws-sigv4).

data/lib/opensearch/api/actions/asynchronous_search/delete.rb

@@ -13,24 +13,22 @@ module OpenSearch
   module API
     module AsynchronousSearch
       module Actions
-        # Delete asynchronous search.
+        # Deletes any responses from an asynchronous search.
         #
         # @option args [String] :id *Required*
-        # @option args [List] :ignore set to [404] to ignore server's NOT FOUND error for this request
         def delete(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           raise ArgumentError, "Required argument 'id' missing" if args['id'].nil?
 
           _id = args.delete('id')
 
-          ignore  = args.delete('ignore') || []
           headers = args.delete('headers') || {}
           body    = args.delete('body')
           method  = 'DELETE'
           url     = Utils.build_url('_plugins/_asynchronous_search', _id)
 
           Utils.validate_query_params! args
-          transport.perform_delete_request method, url, args, body, headers, ignore.include?(404)
+          transport.perform_delete_request method, url, args, body, headers
         end
       end
     end

data/lib/opensearch/api/actions/asynchronous_search/get.rb

@@ -13,7 +13,7 @@ module OpenSearch
   module API
     module AsynchronousSearch
       module Actions
-        # Get partial responses from asynchronous search.
+        # Gets partial responses from an asynchronous search.
         #
         # @option args [String] :id *Required*
         def get(args = {})

data/lib/opensearch/api/actions/asynchronous_search/search.rb

@@ -13,12 +13,12 @@ module OpenSearch
   module API
     module AsynchronousSearch
       module Actions
-        # Perform an asynchronous search.
+        # Performs an asynchronous search.
         #
         # @option args [String] :index 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.
-        # @option args [String] :keep_alive 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.
-        # @option args [Boolean] :keep_on_completion Whether you want to save the results in the cluster after the search is complete.
-        # @option args [String] :wait_for_completion_timeout 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`.
+        # @option args [String] :keep_alive 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 exceeds this amount of time, the process cancels this query automatically.
+        # @option args [Boolean] :keep_on_completion Whether to save the results in the cluster after the search is complete. You can examine the stored results at a later time.
+        # @option args [String] :wait_for_completion_timeout The amount of time to wait for the results. You can poll the remaining results based on an ID. The maximum value is 300 seconds. Default is `1s`.
         # @option args [Hash] :body The search definition using the Query DSL.
         def search(args = {})
           args = Utils.clone_and_normalize_arguments(args)

data/lib/opensearch/api/actions/asynchronous_search/stats.rb

@@ -13,7 +13,7 @@ module OpenSearch
   module API
     module AsynchronousSearch
       module Actions
-        # Monitoring of asynchronous searches that are running, completed, and/or persisted.
+        # Monitors any asynchronous searches that are `running`, `completed`, or `persisted`.
         #
         def stats(args = {})
           args = Utils.clone_and_normalize_arguments(args)

data/lib/opensearch/api/actions/cat/aliases.rb

@@ -13,15 +13,15 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Shows information about currently configured aliases to indexes including filter and routing info.
+        # Shows information about aliases currently configured to indexes, including filter and routing information.
         #
-        # @option args [Enumerable<String>, String] :expand_wildcards Whether to expand wildcard expression to concrete indexes that are open, closed or both.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [Enumerable<String>, String] :expand_wildcards Specifies the type of index that wildcard expressions can match. Supports comma-separated values.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local Whether to return information from the local node only instead of from the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         # @option args [Enumerable<String>, String] :name A comma-separated list of aliases to retrieve. Supports wildcards (`*`).  To retrieve all aliases, omit this parameter or use `*` or `_all`.
         def aliases(args = {})
           args = Utils.clone_and_normalize_arguments(args)

data/lib/opensearch/api/actions/cat/all_pit_segments.rb

@@ -13,14 +13,14 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Lists all active point-in-time segments.
+        # Lists all active CAT point-in-time segments.
         #
-        # @option args [String] :bytes The unit in which to display byte values.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :bytes The units used to display byte values.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def all_pit_segments(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/cat/allocation.rb

@@ -15,16 +15,16 @@ module OpenSearch
       module Actions
         # Provides a snapshot of how many shards are allocated to each data node and how much disk space they are using.
         #
-        # @option args [String] :bytes The unit used to display byte values.
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
-        # @option args [Enumerable<String>, String] :node_id Comma-separated list of node identifiers or names used to limit the returned information.
+        # @option args [String] :bytes The units used to display byte values.
+        # @option args [String] :cluster_manager_timeout A timeout for connection to the cluster manager node.
+        # @option args [String] :format A short version of the HTTP `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local Returns local information but does not retrieve the state from cluster-manager node.
+        # @option args [String] :master_timeout DEPRECATED A timeout for connection to the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
+        # @option args [Enumerable<String>, String] :node_id A comma-separated list of node IDs or names used to limit the returned information.
         def allocation(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           _node_id = args.delete('node_id')

data/lib/opensearch/api/actions/cat/cluster_manager.rb

@@ -15,14 +15,14 @@ module OpenSearch
       module Actions
         # Returns information about the cluster-manager node.
         #
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :cluster_manager_timeout A timeout for connection to the cluster manager node.
+        # @option args [String] :format A short version of the HTTP `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local Returns local information but does not retrieve the state from the cluster manager node.
+        # @option args [String] :master_timeout DEPRECATED A timeout for connection to the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def cluster_manager(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/cat/count.rb

@@ -13,13 +13,13 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Provides quick access to the document count of the entire cluster, or individual indexes.
+        # Provides quick access to the document count of the entire cluster or of an individual index.
         #
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         # @option args [Enumerable<String>, String] :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`.
         def count(args = {})
           args = Utils.clone_and_normalize_arguments(args)

data/lib/opensearch/api/actions/cat/fielddata.rb

@@ -15,13 +15,13 @@ module OpenSearch
       module Actions
         # Shows how much heap memory is currently being used by field data on every data node in the cluster.
         #
-        # @option args [String] :bytes The unit used to display byte values.
-        # @option args [Enumerable<String>, String] :fields Comma-separated list of fields used to limit returned information.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :bytes The units used to display byte values.
+        # @option args [Enumerable<String>, String] :fields A comma-separated list of fields used to limit the amount of returned information.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def fielddata(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           _fields = args.delete('fields')

data/lib/opensearch/api/actions/cat/health.rb

@@ -15,13 +15,13 @@ module OpenSearch
       module Actions
         # Returns a concise representation of the cluster health.
         #
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
         # @option args [String] :time The unit used to display time values.
-        # @option args [Boolean] :ts (default: true) If `true`, returns `HH:MM:SS` and Unix epoch timestamps.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [Boolean] :ts (default: true) When `true`, returns `HH:MM:SS` and Unix epoch timestamps.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def health(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/cat/indices.rb

@@ -13,23 +13,23 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Returns information about indexes: number of primaries and replicas, document counts, disk size, ...
+        # 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.
         #
-        # @option args [String] :bytes The unit used to display byte values.
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>, String] :expand_wildcards The type of index that wildcard patterns can match.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [String] :health The health status used to limit returned indexes. By default, the response includes indexes of any health status.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :include_unloaded_segments If `true`, the response includes information from segments that are not loaded into memory.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Boolean] :pri If `true`, the response only includes information from primary shards.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [String] :time The unit used to display time values.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
-        # @option args [Enumerable<String>, String] :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`.
+        # @option args [String] :bytes The units used to display byte values.
+        # @option args [String] :cluster_manager_timeout The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [Enumerable<String>, String] :expand_wildcards Specifies the type of index that wildcard expressions can match. Supports comma-separated values.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [String] :health Limits indexes based on their health status. Supported values are `green`, `yellow`, and `red`.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :include_unloaded_segments Whether to include information from segments not loaded into memory.
+        # @option args [Boolean] :local Returns local information but does not retrieve the state from the cluster manager node.
+        # @option args [String] :master_timeout DEPRECATED The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [Boolean] :pri When `true`, returns information only from the primary shards.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [String] :time Specifies the time units.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
+        # @option args [Enumerable<String>, String] :index 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`.
         def indices(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           _index = args.delete('index')

data/lib/opensearch/api/actions/cat/master.rb

@@ -15,14 +15,14 @@ module OpenSearch
       module Actions
         # Returns information about the cluster-manager node.
         #
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :cluster_manager_timeout The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local Returns local information but does not retrieve the state from the cluster manager node.
+        # @option args [String] :master_timeout DEPRECATED The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def master(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/cat/nodeattrs.rb

@@ -15,14 +15,14 @@ module OpenSearch
       module Actions
         # Returns information about custom node attributes.
         #
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :cluster_manager_timeout The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local Returns local information but does not retrieve the state from the cluster manager node.
+        # @option args [String] :master_timeout DEPRECATED The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def nodeattrs(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/cat/nodes.rb

@@ -13,19 +13,19 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Returns basic statistics about performance of cluster nodes.
+        # Returns basic statistics about the performance of cluster nodes.
         #
-        # @option args [String] :bytes The unit used to display byte values.
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Boolean, String] :full_id If `true`, return the full node ID. If `false`, return the shortened node ID.
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local DEPRECATED Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [String] :time The unit in which to display time values.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :bytes The units used to display byte values.
+        # @option args [String] :cluster_manager_timeout The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Boolean, String] :full_id When `true`, returns the full node ID. When `false`, returns the shortened node ID.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local DEPRECATED Returns local information but does not retrieve the state from the cluster manager node.
+        # @option args [String] :master_timeout DEPRECATED The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [String] :time Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/).
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def nodes(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/cat/pending_tasks.rb

@@ -13,17 +13,17 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Returns a concise representation of the cluster pending tasks.
+        # Returns a concise representation of the cluster's pending tasks.
         #
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [String] :time The unit in which to display time values.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :cluster_manager_timeout The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local Returns local information but does not retrieve the state from the cluster manager node.
+        # @option args [String] :master_timeout DEPRECATED The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [String] :time Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/).
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def pending_tasks(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/cat/pit_segments.rb

@@ -13,14 +13,14 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # List segments for one or several PITs.
+        # Lists one or several CAT point-in-time segments.
         #
-        # @option args [String] :bytes The unit in which to display byte values.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :bytes The units used to display byte values.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         # @option args [Hash] :body
         def pit_segments(args = {})
           args = Utils.clone_and_normalize_arguments(args)

data/lib/opensearch/api/actions/cat/plugins.rb

@@ -13,16 +13,16 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Returns information about installed plugins across nodes node.
+        # Returns information about the names, components, and versions of the installed plugins.
         #
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :cluster_manager_timeout The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local Returns local information but does not retrieve the state from the cluster manager node.
+        # @option args [String] :master_timeout DEPRECATED The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def plugins(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}

data/lib/opensearch/api/actions/cat/recovery.rb

@@ -13,18 +13,18 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Returns information about index shard recoveries, both on-going completed.
+        # Returns all completed and ongoing index and shard recoveries.
         #
         # @option args [Boolean] :active_only If `true`, the response only includes ongoing shard recoveries.
-        # @option args [String] :bytes The unit used to display byte values.
-        # @option args [Boolean] :detailed If `true`, the response includes detailed information about shard recoveries.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Enumerable<String>] :index Comma-separated list or wildcard expression of index names to limit the returned information.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [String] :time The unit in which to display time values.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :bytes The units used to display byte values.
+        # @option args [Boolean] :detailed When `true`, includes detailed information about shard recoveries.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Enumerable<String>] :index 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`.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [String] :time Specifies the time units, for example, `5d` or `7h`. For more information, see [Supported units](https://opensearch.org/docs/latest/api-reference/units/).
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def recovery(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           _index = args.delete('index')

data/lib/opensearch/api/actions/cat/repositories.rb

@@ -13,16 +13,16 @@ module OpenSearch
   module API
     module Cat
       module Actions
-        # Returns information about snapshot repositories registered in the cluster.
+        # Returns information about all snapshot repositories for a cluster.
         #
-        # @option args [String] :cluster_manager_timeout Operation timeout for connection to cluster-manager node.
-        # @option args [String] :format A short version of the Accept header (for example, `json`, `yaml`).
-        # @option args [Enumerable<String>] :h Comma-separated list of column names to display.
-        # @option args [Boolean] :help Return help information.
-        # @option args [Boolean] :local Return local information, do not retrieve the state from cluster-manager node.
-        # @option args [String] :master_timeout DEPRECATED Operation timeout for connection to cluster-manager node.
-        # @option args [Enumerable<String>] :s Comma-separated list of column names or column aliases to sort by.
-        # @option args [Boolean] :v Verbose mode. Display column headers.
+        # @option args [String] :cluster_manager_timeout The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [String] :format A short version of the `Accept` header, such as `json` or `yaml`.
+        # @option args [Enumerable<String>] :h A comma-separated list of column names to display.
+        # @option args [Boolean] :help Returns help information.
+        # @option args [Boolean] :local Returns local information but does not retrieve the state from the cluster manager node.
+        # @option args [String] :master_timeout DEPRECATED The amount of time allowed to establish a connection to the cluster manager node.
+        # @option args [Enumerable<String>] :s A comma-separated list of column names or column aliases to sort by.
+        # @option args [Boolean] :v Enables verbose mode, which displays column headers.
         def repositories(args = {})
           args = Utils.clone_and_normalize_arguments(args)
           headers = args.delete('headers') || {}