[API] Updates new indices APIs

Adds experimental status message, required parameter name

- delete_data_lifecycle
- get_data_lifecycle
- put_data_lifecycle

Author: picandocodigo

elasticsearch-api/lib/elasticsearch/api/actions/indices/delete_data_lifecycle.rb

@@ -23,6 +23,10 @@ module API
     module Indices
       module Actions
         # Deletes the data lifecycle of the selected data streams.
+        # 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 [List] :name A comma-separated list of data streams of which the data lifecycle will be deleted; use `*` to get all data streams
         # @option arguments [String] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open) (options: open, closed, hidden, none, all)
@@ -33,6 +37,8 @@ module Actions
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.8/dlm-delete-lifecycle.html
         #
         def delete_data_lifecycle(arguments = {})
+          raise ArgumentError, "Required argument 'name' missing" unless arguments[:name]
+
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
@@ -41,11 +47,7 @@ def delete_data_lifecycle(arguments = {})
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_DELETE
-          path   = if _name
-                     "_data_stream/#{Utils.__listify(_name)}/_lifecycle"
-                   else
-                     "_data_stream/_lifecycle"
-                   end
+          path   = "_data_stream/#{Utils.__listify(_name)}/_lifecycle"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

elasticsearch-api/lib/elasticsearch/api/actions/indices/get_data_lifecycle.rb

@@ -23,6 +23,10 @@ module API
     module Indices
       module Actions
         # Returns the data lifecycle of the selected data streams.
+        # 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 [List] :name A comma-separated list of data streams to get; use `*` to get all data streams
         # @option arguments [String] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open) (options: open, closed, hidden, none, all)
@@ -32,6 +36,8 @@ module Actions
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.8/dlm-get-lifecycle.html
         #
         def get_data_lifecycle(arguments = {})
+          raise ArgumentError, "Required argument 'name' missing" unless arguments[:name]
+
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
@@ -40,11 +46,7 @@ def get_data_lifecycle(arguments = {})
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_GET
-          path   = if _name
-                     "_data_stream/#{Utils.__listify(_name)}/_lifecycle"
-                   else
-                     "_data_stream/_lifecycle"
-                   end
+          path   = "_data_stream/#{Utils.__listify(_name)}/_lifecycle"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

elasticsearch-api/lib/elasticsearch/api/actions/indices/put_data_lifecycle.rb

@@ -23,6 +23,10 @@ module API
     module Indices
       module Actions
         # Updates the data lifecycle of the selected data streams.
+        # 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 [List] :name A comma-separated list of data streams whose lifecycle will be updated; use `*` to set the lifecycle to all data streams
         # @option arguments [String] :expand_wildcards Whether wildcard expressions should get expanded to open or closed indices (default: open) (options: open, closed, hidden, none, all)
@@ -34,6 +38,8 @@ module Actions
         # @see https://www.elastic.co/guide/en/elasticsearch/reference/8.8/dlm-put-lifecycle.html
         #
         def put_data_lifecycle(arguments = {})
+          raise ArgumentError, "Required argument 'name' missing" unless arguments[:name]
+
           arguments = arguments.clone
           headers = arguments.delete(:headers) || {}
 
@@ -42,11 +48,7 @@ def put_data_lifecycle(arguments = {})
           _name = arguments.delete(:name)
 
           method = Elasticsearch::API::HTTP_PUT
-          path   = if _name
-                     "_data_stream/#{Utils.__listify(_name)}/_lifecycle"
-                   else
-                     "_data_stream/_lifecycle"
-                   end
+          path   = "_data_stream/#{Utils.__listify(_name)}/_lifecycle"
           params = Utils.process_params(arguments)
 
           Elasticsearch::API::Response.new(

elasticsearch-api/spec/elasticsearch/api/actions/indices/delete_data_lifecycle_spec.rb

@@ -21,24 +21,14 @@
   let(:expected_args) do
     [
       'DELETE',
-      url,
+      '_data_stream/foo/_lifecycle',
       {},
       nil,
       {}
     ]
   end
 
-  let(:url) { '_data_stream/_lifecycle'}
-
   it 'performs the request' do
-    expect(client_double.indices.delete_data_lifecycle).to be_a Elasticsearch::API::Response
-  end
-
-  context 'when name is specified' do
-    let(:url) { '_data_stream/foo/_lifecycle'}
-
-    it 'performs the request' do
-      expect(client_double.indices.delete_data_lifecycle(name: 'foo')).to be_a Elasticsearch::API::Response
-    end
+    expect(client_double.indices.delete_data_lifecycle(name: 'foo')).to be_a Elasticsearch::API::Response
   end
 end

elasticsearch-api/spec/elasticsearch/api/actions/indices/get_data_lifecycle_spec.rb

@@ -21,24 +21,14 @@
   let(:expected_args) do
     [
       'GET',
-      url,
+      '_data_stream/foo/_lifecycle',
       {},
       nil,
       {}
     ]
   end
 
-  let(:url) { '_data_stream/_lifecycle'}
-
   it 'performs the request' do
-    expect(client_double.indices.get_data_lifecycle).to be_a Elasticsearch::API::Response
-  end
-
-  context 'when name is specified' do
-    let(:url) { '_data_stream/foo/_lifecycle'}
-
-    it 'performs the request' do
-      expect(client_double.indices.get_data_lifecycle(name: 'foo')).to be_a Elasticsearch::API::Response
-    end
+    expect(client_double.indices.get_data_lifecycle(name: 'foo')).to be_a Elasticsearch::API::Response
   end
 end

elasticsearch-api/spec/elasticsearch/api/actions/indices/put_data_lifecycle_spec.rb

@@ -21,24 +21,14 @@
   let(:expected_args) do
     [
       'PUT',
-      url,
+      '_data_stream/foo/_lifecycle',
       {},
       nil,
       {}
     ]
   end
 
-  let(:url) { '_data_stream/_lifecycle'}
-
   it 'performs the request' do
-    expect(client_double.indices.put_data_lifecycle).to be_a Elasticsearch::API::Response
-  end
-
-  context 'when name is specified' do
-    let(:url) { '_data_stream/foo/_lifecycle'}
-
-    it 'performs the request' do
-      expect(client_double.indices.put_data_lifecycle(name: 'foo')).to be_a Elasticsearch::API::Response
-    end
+    expect(client_double.indices.put_data_lifecycle(name: 'foo')).to be_a Elasticsearch::API::Response
   end
 end