[API] Updates x-pack APIs

- Source code documentation updated
- APIs promoted from experimental:
  - fleet.global_checkpoints
  - monitoring.bulk
  - searchable_snapshots.mount
  - searchable_snapshots.stats
  - security/clear_cached_service_tokens
  - security/create_service_token
  - security/delete_service_token
  - security/get_service_accounts
  - security/get_service_credentials
  - terms_enum

Author: picandocodigo

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/cat/ml_trained_models.rb

@@ -24,8 +24,8 @@ module Actions
           #
           # @option arguments [String] :model_id The ID of the trained models stats to fetch
           # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no trained models. (This includes `_all` string or when no trained models have been specified)
-          # @option arguments [Int] :from skips a number of trained models
-          # @option arguments [Int] :size specifies a max number of trained models to get
+          # @option arguments [Integer] :from skips a number of trained models
+          # @option arguments [Integer] :size specifies a max number of trained models to get
           # @option arguments [String] :bytes The unit in which to display byte values (options: b, k, kb, m, mb, g, gb, t, tb, p, pb)
           # @option arguments [String] :format a short version of the Accept header, e.g. json, yaml
           # @option arguments [List] :h Comma-separated list of column names to display

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/cat/transforms.rb

@@ -23,8 +23,8 @@ module Actions
           # Gets configuration and usage information about transforms.
           #
           # @option arguments [String] :transform_id The id of the transform for which to get stats. '_all' or '*' implies all transforms
-          # @option arguments [Int] :from skips a number of transform configs, defaults to 0
-          # @option arguments [Int] :size specifies a max number of transforms to get, defaults to 100
+          # @option arguments [Integer] :from skips a number of transform configs, defaults to 0
+          # @option arguments [Integer] :size specifies a max number of transforms to get, defaults to 100
           # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no transforms. (This includes `_all` string or when no transforms have been specified)
           # @option arguments [String] :format a short version of the Accept header, e.g. json, yaml
           # @option arguments [List] :h Comma-separated list of column names to display

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/data_frame_transform_deprecated/get_transform.rb

@@ -27,8 +27,8 @@ module Actions
           # SLA of official GA features.
           #
           # @option arguments [String] :transform_id The id or comma delimited list of id expressions of the transforms to get, '_all' or '*' implies get all transforms
-          # @option arguments [Int] :from skips a number of transform configs, defaults to 0
-          # @option arguments [Int] :size specifies a max number of transforms to get, defaults to 100
+          # @option arguments [Integer] :from skips a number of transform configs, defaults to 0
+          # @option arguments [Integer] :size specifies a max number of transforms to get, defaults to 100
           # @option arguments [Boolean] :allow_no_match Whether to ignore if a wildcard expression matches no transforms. (This includes `_all` string or when no transforms have been specified)
           # @option arguments [Boolean] :exclude_generated Omits generated fields. Allows transform configurations to be easily copied between clusters and within the same cluster
           # @option arguments [Hash] :headers Custom HTTP headers

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/fleet/global_checkpoints.rb

@@ -21,10 +21,6 @@ module API
       module Fleet
         module Actions
           # Returns the current global checkpoints for an index. This API is design for internal use by the fleet server project.
-          # This functionality is Experimental and may be changed or removed
-          # completely in a future release. Elastic will take a best effort approach
-          # to fix any issues, but experimental features are not subject to the
-          # support SLA of official GA features.
           #
           # @option arguments [String] :index The name of the index.
           # @option arguments [Boolean] :wait_for_advance Whether to wait for the global checkpoint to advance past the specified current checkpoints
@@ -33,7 +29,7 @@ module Actions
           # @option arguments [Time] :timeout Timeout to wait for global checkpoint to advance
           # @option arguments [Hash] :headers Custom HTTP headers
           #
-          # @see [TODO]
+          # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/get-global-checkpoints.html
           #
           def global_checkpoints(arguments = {})
             raise ArgumentError, "Required argument 'index' missing" unless arguments[:index]

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/machine_learning/explain_data_frame_analytics.rb

@@ -41,11 +41,11 @@ def explain_data_frame_analytics(arguments = {})
                        Elasticsearch::API::HTTP_GET
                      end
 
-            path = if _id
-                     "_ml/data_frame/analytics/#{Elasticsearch::API::Utils.__listify(_id)}/_explain"
-                   else
-                     "_ml/data_frame/analytics/_explain"
-                   end
+            path   = if _id
+                       "_ml/data_frame/analytics/#{Elasticsearch::API::Utils.__listify(_id)}/_explain"
+                     else
+                       "_ml/data_frame/analytics/_explain"
+                     end
             params = {}
 
             body = arguments[:body]

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/machine_learning/find_file_structure.rb

@@ -26,8 +26,8 @@ module Actions
           # to fix any issues, but experimental features are not subject to the
           # support SLA of official GA features.
           #
-          # @option arguments [Int] :lines_to_sample How many lines of the file should be included in the analysis
-          # @option arguments [Int] :line_merge_size_limit Maximum number of characters permitted in a single message when lines are merged to create messages.
+          # @option arguments [Integer] :lines_to_sample How many lines of the file should be included in the analysis
+          # @option arguments [Integer] :line_merge_size_limit Maximum number of characters permitted in a single message when lines are merged to create messages.
           # @option arguments [Time] :timeout Timeout after which the analysis will be aborted
           # @option arguments [String] :charset Optional parameter to specify the character set of the file
           # @option arguments [String] :format Optional parameter to specify the high level file format (options: ndjson, xml, delimited, semi_structured_text)

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/machine_learning/get_buckets.rb

@@ -26,8 +26,8 @@ module Actions
           # @option arguments [String] :timestamp The timestamp of the desired single bucket result
           # @option arguments [Boolean] :expand Include anomaly records
           # @option arguments [Boolean] :exclude_interim Exclude interim results
-          # @option arguments [Int] :from skips a number of buckets
-          # @option arguments [Int] :size specifies a max number of buckets to get
+          # @option arguments [Integer] :from skips a number of buckets
+          # @option arguments [Integer] :size specifies a max number of buckets to get
           # @option arguments [String] :start Start time filter for buckets
           # @option arguments [String] :end End time filter for buckets
           # @option arguments [Double] :anomaly_score Filter for the most anomalous buckets

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/machine_learning/get_calendar_events.rb

@@ -26,8 +26,8 @@ module Actions
           # @option arguments [String] :job_id Get events for the job. When this option is used calendar_id must be '_all'
           # @option arguments [String] :start Get events after this time
           # @option arguments [Date] :end Get events before this time
-          # @option arguments [Int] :from Skips a number of events
-          # @option arguments [Int] :size Specifies a max number of events to get
+          # @option arguments [Integer] :from Skips a number of events
+          # @option arguments [Integer] :size Specifies a max number of events to get
           # @option arguments [Hash] :headers Custom HTTP headers
           #
           # @see https://www.elastic.co/guide/en/elasticsearch/reference/7.x/ml-get-calendar-event.html

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/machine_learning/get_calendars.rb

@@ -23,8 +23,8 @@ module Actions
           # Retrieves configuration information for calendars.
           #
           # @option arguments [String] :calendar_id The ID of the calendar to fetch
-          # @option arguments [Int] :from skips a number of calendars
-          # @option arguments [Int] :size specifies a max number of calendars to get
+          # @option arguments [Integer] :from skips a number of calendars
+          # @option arguments [Integer] :size specifies a max number of calendars to get
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body The from and size parameters optionally sent in the body
           #

elasticsearch-xpack/lib/elasticsearch/xpack/api/actions/machine_learning/get_categories.rb

@@ -24,8 +24,8 @@ module Actions
           #
           # @option arguments [String] :job_id The name of the job
           # @option arguments [Long] :category_id The identifier of the category definition of interest
-          # @option arguments [Int] :from skips a number of categories
-          # @option arguments [Int] :size specifies a max number of categories to get
+          # @option arguments [Integer] :from skips a number of categories
+          # @option arguments [Integer] :size specifies a max number of categories to get
           # @option arguments [String] :partition_field_value Specifies the partition to retrieve categories for. This is optional, and should never be used for jobs where per-partition categorization is disabled.
           # @option arguments [Hash] :headers Custom HTTP headers
           # @option arguments [Hash] :body Category selection details if not provided in URI