crimson-falcon 1.0.1 → 1.2.0

data/lib/crimson-falcon/api/device_control_with_bluetooth.rb

@@ -0,0 +1,420 @@
+=begin
+Crimson Falcon - Ruby Client SDK
+
+Code auto-generated by OpenAPI Generator; DO NOT EDIT.
+
+MIT License
+
+Copyright (c) 2023 Crowdstrike
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+=end
+
+require 'cgi'
+
+module Falcon
+  class DeviceControlWithBluetooth
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # Get default device control settings (USB and Bluetooth)
+    # @param [Hash] opts the optional parameters
+    # @return [DeviceControlRespDefaultSettingV1]
+    def get_default_device_control_settings(opts = {})
+      data, _status_code, _headers = get_default_device_control_settings_with_http_info(opts)
+      data
+    end
+
+    # Get default device control settings (USB and Bluetooth)
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeviceControlRespDefaultSettingV1, Integer, Hash)>] DeviceControlRespDefaultSettingV1 data, response status code and response headers
+    def get_default_device_control_settings_with_http_info(opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DeviceControlWithBluetooth.get_default_device_control_settings ...'
+      end
+      # resource path
+      local_var_path = '/policy/entities/device-control-default-settings/v1'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeviceControlRespDefaultSettingV1'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['oauth2']
+
+      new_options = opts.merge(
+        :operation => :"DeviceControlWithBluetooth.get_default_device_control_settings",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DeviceControlWithBluetooth#get_default_device_control_settings\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get device control policies for the given filter criteria. (USB and Bluetooth)
+    # @param ids [Array<String>] The IDs of the policies to get
+    # @param [Hash] opts the optional parameters
+    # @return [DevicecontrolapiRespPoliciesV2]
+    def get_device_control_policies_v2(ids, opts = {})
+      data, _status_code, _headers = get_device_control_policies_v2_with_http_info(ids, opts)
+      data
+    end
+
+    # Get device control policies for the given filter criteria. (USB and Bluetooth)
+    # @param ids [Array<String>] The IDs of the policies to get
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DevicecontrolapiRespPoliciesV2, Integer, Hash)>] DevicecontrolapiRespPoliciesV2 data, response status code and response headers
+    def get_device_control_policies_v2_with_http_info(ids, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DeviceControlWithBluetooth.get_device_control_policies_v2 ...'
+      end
+      # verify the required parameter 'ids' is set
+      if @api_client.config.client_side_validation && ids.nil?
+        fail ArgumentError, "Missing the required parameter 'ids' when calling DeviceControlWithBluetooth.get_device_control_policies_v2"
+      end
+      # resource path
+      local_var_path = '/policy/entities/device-control/v2'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'ids'] = @api_client.build_collection_param(ids, :multi)
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DevicecontrolapiRespPoliciesV2'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['oauth2']
+
+      new_options = opts.merge(
+        :operation => :"DeviceControlWithBluetooth.get_device_control_policies_v2",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DeviceControlWithBluetooth#get_device_control_policies_v2\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update device control policy's classes (USB and Bluetooth)
+    # @param body [DevicecontrolapiReqUpdatePoliciesClassesV1]
+    # @param [Hash] opts the optional parameters
+    # @return [DevicecontrolapiRespPoliciesV2]
+    def patch_device_control_policies_classes_v1(body, opts = {})
+      data, _status_code, _headers = patch_device_control_policies_classes_v1_with_http_info(body, opts)
+      data
+    end
+
+    # Update device control policy&#39;s classes (USB and Bluetooth)
+    # @param body [DevicecontrolapiReqUpdatePoliciesClassesV1]
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DevicecontrolapiRespPoliciesV2, Integer, Hash)>] DevicecontrolapiRespPoliciesV2 data, response status code and response headers
+    def patch_device_control_policies_classes_v1_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DeviceControlWithBluetooth.patch_device_control_policies_classes_v1 ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling DeviceControlWithBluetooth.patch_device_control_policies_classes_v1"
+      end
+      # resource path
+      local_var_path = '/policy/entities/device-control-classes/v1'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+        header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DevicecontrolapiRespPoliciesV2'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['oauth2']
+
+      new_options = opts.merge(
+        :operation => :"DeviceControlWithBluetooth.patch_device_control_policies_classes_v1",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DeviceControlWithBluetooth#patch_device_control_policies_classes_v1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update device control policy base (USB and Bluetooth)
+    # @param body [DevicecontrolapiReqUpdateBasesV1External]
+    # @param [Hash] opts the optional parameters
+    # @return [DevicecontrolapiRespPoliciesV2]
+    def patch_device_control_policies_v2(body, opts = {})
+      data, _status_code, _headers = patch_device_control_policies_v2_with_http_info(body, opts)
+      data
+    end
+
+    # Update device control policy base (USB and Bluetooth)
+    # @param body [DevicecontrolapiReqUpdateBasesV1External]
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DevicecontrolapiRespPoliciesV2, Integer, Hash)>] DevicecontrolapiRespPoliciesV2 data, response status code and response headers
+    def patch_device_control_policies_v2_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DeviceControlWithBluetooth.patch_device_control_policies_v2 ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling DeviceControlWithBluetooth.patch_device_control_policies_v2"
+      end
+      # resource path
+      local_var_path = '/policy/entities/device-control/v2'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+        header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DevicecontrolapiRespPoliciesV2'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['oauth2']
+
+      new_options = opts.merge(
+        :operation => :"DeviceControlWithBluetooth.patch_device_control_policies_v2",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DeviceControlWithBluetooth#patch_device_control_policies_v2\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Create/clone a device control policy (USB and Bluetooth)
+    # @param body [DevicecontrolapiReqCreatePoliciesV1]
+    # @param [Hash] opts the optional parameters
+    # @return [DevicecontrolapiRespPoliciesV2]
+    def post_device_control_policies_v2(body, opts = {})
+      data, _status_code, _headers = post_device_control_policies_v2_with_http_info(body, opts)
+      data
+    end
+
+    # Create/clone a device control policy (USB and Bluetooth)
+    # @param body [DevicecontrolapiReqCreatePoliciesV1]
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DevicecontrolapiRespPoliciesV2, Integer, Hash)>] DevicecontrolapiRespPoliciesV2 data, response status code and response headers
+    def post_device_control_policies_v2_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DeviceControlWithBluetooth.post_device_control_policies_v2 ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling DeviceControlWithBluetooth.post_device_control_policies_v2"
+      end
+      # resource path
+      local_var_path = '/policy/entities/device-control/v2'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+        header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DevicecontrolapiRespPoliciesV2'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['oauth2']
+
+      new_options = opts.merge(
+        :operation => :"DeviceControlWithBluetooth.post_device_control_policies_v2",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DeviceControlWithBluetooth#post_device_control_policies_v2\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Update the configuration for Default Device Control Settings
+    # @param body [DeviceControlReqUpdateDefaultSettingsV1]
+    # @param [Hash] opts the optional parameters
+    # @return [DeviceControlRespDefaultSettingV1]
+    def update_default_device_control_settings(body, opts = {})
+      data, _status_code, _headers = update_default_device_control_settings_with_http_info(body, opts)
+      data
+    end
+
+    # Update the configuration for Default Device Control Settings
+    # @param body [DeviceControlReqUpdateDefaultSettingsV1]
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(DeviceControlRespDefaultSettingV1, Integer, Hash)>] DeviceControlRespDefaultSettingV1 data, response status code and response headers
+    def update_default_device_control_settings_with_http_info(body, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: DeviceControlWithBluetooth.update_default_device_control_settings ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling DeviceControlWithBluetooth.update_default_device_control_settings"
+      end
+      # resource path
+      local_var_path = '/policy/entities/device-control-default-settings/v1'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+      # HTTP header 'Content-Type'
+      content_type = @api_client.select_header_content_type(['application/json'])
+      if !content_type.nil?
+        header_params['Content-Type'] = content_type
+      end
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'DeviceControlRespDefaultSettingV1'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['oauth2']
+
+      new_options = opts.merge(
+        :operation => :"DeviceControlWithBluetooth.update_default_device_control_settings",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:PATCH, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: DeviceControlWithBluetooth#update_default_device_control_settings\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/crimson-falcon/api/discover.rb

@@ -448,72 +448,6 @@ module Falcon
       return data, status_code, headers
     end
 
-    # Add external assets for external asset scanning.
-    # @param body [InventoryapiUserExternalAssetCreateRequestV1] Asset addition specification.
-    # @param [Hash] opts the optional parameters
-    # @return [InventoryapiUserExternalAssetCreateResponseV1]
-    def post_external_assets_inventory_v1(body, opts = {})
-      data, _status_code, _headers = post_external_assets_inventory_v1_with_http_info(body, opts)
-      data
-    end
-
-    # Add external assets for external asset scanning.
-    # @param body [InventoryapiUserExternalAssetCreateRequestV1] Asset addition specification.
-    # @param [Hash] opts the optional parameters
-    # @return [Array<(InventoryapiUserExternalAssetCreateResponseV1, Integer, Hash)>] InventoryapiUserExternalAssetCreateResponseV1 data, response status code and response headers
-    def post_external_assets_inventory_v1_with_http_info(body, opts = {})
-      if @api_client.config.debugging
-        @api_client.config.logger.debug 'Calling API: Discover.post_external_assets_inventory_v1 ...'
-      end
-      # verify the required parameter 'body' is set
-      if @api_client.config.client_side_validation && body.nil?
-        fail ArgumentError, "Missing the required parameter 'body' when calling Discover.post_external_assets_inventory_v1"
-      end
-      # resource path
-      local_var_path = '/fem/entities/external-asset-inventory/v1'
-
-      # query parameters
-      query_params = opts[:query_params] || {}
-
-      # header parameters
-      header_params = opts[:header_params] || {}
-      # HTTP header 'Accept' (if needed)
-      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
-      # HTTP header 'Content-Type'
-      content_type = @api_client.select_header_content_type(['application/json'])
-      if !content_type.nil?
-        header_params['Content-Type'] = content_type
-      end
-
-      # form parameters
-      form_params = opts[:form_params] || {}
-
-      # http body (model)
-      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
-
-      # return_type
-      return_type = opts[:debug_return_type] || 'InventoryapiUserExternalAssetCreateResponseV1'
-
-      # auth_names
-      auth_names = opts[:debug_auth_names] || ['oauth2']
-
-      new_options = opts.merge(
-        :operation => :"Discover.post_external_assets_inventory_v1",
-        :header_params => header_params,
-        :query_params => query_params,
-        :form_params => form_params,
-        :body => post_body,
-        :auth_names => auth_names,
-        :return_type => return_type
-      )
-
-      data, status_code, headers = @api_client.call_api(:POST, local_var_path, new_options)
-      if @api_client.config.debugging
-        @api_client.config.logger.debug "API called: Discover#post_external_assets_inventory_v1\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
-      end
-      return data, status_code, headers
-    end
-
     # Search for accounts in your environment by providing an FQL (Falcon Query Language) filter and paging details. Returns a set of account IDs which match the filter criteria.
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :offset An offset used with the &#x60;limit&#x60; parameter to manage pagination of results. On your first request, don’t provide an &#x60;offset&#x60;. On subsequent requests, add previous &#x60;offset&#x60; with the previous &#x60;limit&#x60; to continue from that place in the results.
@@ -752,6 +686,7 @@ module Falcon
     end
 
     # Search for logins in your environment by providing an FQL (Falcon Query Language) filter and paging details. Returns a set of login IDs which match the filter criteria.
+    # The API endpoint returns data only if the response set includes 10,000 or fewer items. This limit applies to the total API response size, regardless of your pagination sizes with the `limit` and `offset` parameters. If your response set includes more than 10,000 items, the CrowdStrike API returns an HTML 400 response instead. To avoid this issue, use the filter parameter to reduce the total number of items in the API response.
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :offset An offset used with the &#x60;limit&#x60; parameter to manage pagination of results. On your first request, don’t provide an &#x60;offset&#x60;. On subsequent requests, add previous &#x60;offset&#x60; with the previous &#x60;limit&#x60; to continue from that place in the results.
     # @option opts [Integer] :limit The number of login IDs to return in this response (min: 1, max: 100, default: 100). Use with the &#x60;offset&#x60; parameter to manage pagination of results.
@@ -764,6 +699,7 @@ module Falcon
     end
 
     # Search for logins in your environment by providing an FQL (Falcon Query Language) filter and paging details. Returns a set of login IDs which match the filter criteria.
+    # The API endpoint returns data only if the response set includes 10,000 or fewer items. This limit applies to the total API response size, regardless of your pagination sizes with the &#x60;limit&#x60; and &#x60;offset&#x60; parameters. If your response set includes more than 10,000 items, the CrowdStrike API returns an HTML 400 response instead. To avoid this issue, use the filter parameter to reduce the total number of items in the API response.
     # @param [Hash] opts the optional parameters
     # @option opts [Integer] :offset An offset used with the &#x60;limit&#x60; parameter to manage pagination of results. On your first request, don’t provide an &#x60;offset&#x60;. On subsequent requests, add previous &#x60;offset&#x60; with the previous &#x60;limit&#x60; to continue from that place in the results.
     # @option opts [Integer] :limit The number of login IDs to return in this response (min: 1, max: 100, default: 100). Use with the &#x60;offset&#x60; parameter to manage pagination of results.

data/lib/crimson-falcon/api/execution.rb

@@ -0,0 +1,122 @@
+=begin
+Crimson Falcon - Ruby Client SDK
+
+Code auto-generated by OpenAPI Generator; DO NOT EDIT.
+
+MIT License
+
+Copyright (c) 2023 Crowdstrike
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+=end
+
+require 'cgi'
+
+module Falcon
+  class Execution
+    attr_accessor :api_client
+
+    def initialize(api_client = ApiClient.default)
+      @api_client = api_client
+    end
+    # retrieve a large request body, such as a file, that has spilled into object storage
+    # @param id [String] Execution ID
+    # @param fn [String] function ref; form of $fn_id:$fn_version
+    # @param filename [String] filename to be retrieved
+    # @param sha256 [String] sha256 checksum for file to be retrieved
+    # @param [Hash] opts the optional parameters
+    # @return [Object]
+    def read_request_body(id, fn, filename, sha256, opts = {})
+      data, _status_code, _headers = read_request_body_with_http_info(id, fn, filename, sha256, opts)
+      data
+    end
+
+    # retrieve a large request body, such as a file, that has spilled into object storage
+    # @param id [String] Execution ID
+    # @param fn [String] function ref; form of $fn_id:$fn_version
+    # @param filename [String] filename to be retrieved
+    # @param sha256 [String] sha256 checksum for file to be retrieved
+    # @param [Hash] opts the optional parameters
+    # @return [Array<(Object, Integer, Hash)>] Object data, response status code and response headers
+    def read_request_body_with_http_info(id, fn, filename, sha256, opts = {})
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: Execution.read_request_body ...'
+      end
+      # verify the required parameter 'id' is set
+      if @api_client.config.client_side_validation && id.nil?
+        fail ArgumentError, "Missing the required parameter 'id' when calling Execution.read_request_body"
+      end
+      # verify the required parameter 'fn' is set
+      if @api_client.config.client_side_validation && fn.nil?
+        fail ArgumentError, "Missing the required parameter 'fn' when calling Execution.read_request_body"
+      end
+      # verify the required parameter 'filename' is set
+      if @api_client.config.client_side_validation && filename.nil?
+        fail ArgumentError, "Missing the required parameter 'filename' when calling Execution.read_request_body"
+      end
+      # verify the required parameter 'sha256' is set
+      if @api_client.config.client_side_validation && sha256.nil?
+        fail ArgumentError, "Missing the required parameter 'sha256' when calling Execution.read_request_body"
+      end
+      # resource path
+      local_var_path = '/faas-gateway/entities/execution-request-body/v2'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'id'] = id
+      query_params[:'fn'] = fn
+      query_params[:'filename'] = filename
+      query_params[:'sha256'] = sha256
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['text/csv', 'text/plain', 'application/octet-stream', 'application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'Object'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || ['oauth2']
+
+      new_options = opts.merge(
+        :operation => :"Execution.read_request_body",
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type
+      )
+
+      data, status_code, headers = @api_client.call_api(:GET, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: Execution#read_request_body\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end