files.com 1.1.308 → 1.1.309

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: d92592a5f32cc6407758f4759c192b59478ca26a2ad2819737d466ed8d13fa8e
-  data.tar.gz: 1e8201a7d236b576dac9f94bd8b34215ccc643f8d49f565ad18a466e98814097
+  metadata.gz: a4ba4caf21009c3188cf188a280d1f76adec2660ef522e47fb906d54d205ad8c
+  data.tar.gz: c4d36691238441dc50f125d296ca955217a3ef6824def876465f1b259c78f847
 SHA512:
-  metadata.gz: 6e385cbe54e4b721030f670cfcef7ec96067058160420d3ade1531c2ca456361b827460c55913b24f6798c0355eb575ced36075e3c10735c019c219e43798c97
-  data.tar.gz: b81e4580098fe594c507e85585fbda9bf86be0e2ae379b741aa4f8f115ff8b4f4a2a93a7a0b5739c7f2973cefd8a8ee8e7e1dbb1d9bccdfc23b37971524c17a4
+  metadata.gz: 8d8e630bcdbb2ff30f14f06d86176aa41863305c20d2011d151b86663fb98ffea8ceb07e935fd39a7d7abc0ec2b912fafc767337597cec18bc8ef0b97493063f
+  data.tar.gz: 5c22b138cac4106b3da4078ecb7d4eef19a933d2cbe61eb345ce49c7168687eb75ffbf9f89c2e9528f5114665051198e5929730663a347900a236d2ed14c7dd3

data/_VERSION

@@ -1 +1 @@
-1.1.308
+1.1.309

data/docs/child_site_management_policy.md

@@ -0,0 +1,138 @@
+# ChildSiteManagementPolicy
+
+## Example ChildSiteManagementPolicy Object
+
+```
+{
+  "id": 1,
+  "site_id": 1,
+  "site_setting_name": "color2_left",
+  "managed_value": "#FF0000",
+  "skip_child_site_ids": [
+    1,
+    5
+  ]
+}
+```
+
+* `id` (int64): ChildSiteManagementPolicy ID
+* `site_id` (int64): ID of the Site managing the policy
+* `site_setting_name` (string): The name of the setting that is managed by the policy
+* `managed_value` (string): The value for the setting that will be enforced for all child sites that are not exempt
+* `skip_child_site_ids` (array(int64)): The list of child site IDs that are exempt from this policy
+
+
+---
+
+## List Child Site Management Policies
+
+```
+Files::ChildSiteManagementPolicy.list
+```
+
+### Parameters
+
+* `cursor` (string): Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
+* `per_page` (int64): Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+
+
+---
+
+## Show Child Site Management Policy
+
+```
+Files::ChildSiteManagementPolicy.find(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.
+
+
+---
+
+## Create Child Site Management Policy
+
+```
+Files::ChildSiteManagementPolicy.create(
+  site_setting_name: "color2_left", 
+  managed_value: "#FF0000", 
+  skip_child_site_ids: [1,5]
+)
+```
+
+### Parameters
+
+* `site_setting_name` (string): Required - The name of the setting that is managed by the policy
+* `managed_value` (string): Required - The value for the setting that will be enforced for all child sites that are not exempt
+* `skip_child_site_ids` (array(int64)): The list of child site IDs that are exempt from this policy
+
+
+---
+
+## Update Child Site Management Policy
+
+```
+Files::ChildSiteManagementPolicy.update(id, 
+  site_setting_name: "color2_left", 
+  managed_value: "#FF0000", 
+  skip_child_site_ids: [1,5]
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.
+* `site_setting_name` (string): Required - The name of the setting that is managed by the policy
+* `managed_value` (string): Required - The value for the setting that will be enforced for all child sites that are not exempt
+* `skip_child_site_ids` (array(int64)): The list of child site IDs that are exempt from this policy
+
+
+---
+
+## Delete Child Site Management Policy
+
+```
+Files::ChildSiteManagementPolicy.delete(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.
+
+
+---
+
+## Update Child Site Management Policy
+
+```
+child_site_management_policy = Files::ChildSiteManagementPolicy.find(id)
+
+child_site_management_policy.update(
+  site_setting_name: "color2_left",
+  managed_value: "#FF0000",
+  skip_child_site_ids: [1,5]
+)
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.
+* `site_setting_name` (string): Required - The name of the setting that is managed by the policy
+* `managed_value` (string): Required - The value for the setting that will be enforced for all child sites that are not exempt
+* `skip_child_site_ids` (array(int64)): The list of child site IDs that are exempt from this policy
+
+
+---
+
+## Delete Child Site Management Policy
+
+```
+child_site_management_policy = Files::ChildSiteManagementPolicy.find(id)
+
+child_site_management_policy.delete
+```
+
+### Parameters
+
+* `id` (int64): Required - Child Site Management Policy ID.

data/docs/remote_server_configuration_file.md

@@ -59,7 +59,7 @@ Examples:
 * 10 requests/minute: '10-M'
 * 1000 requests/hour: '1000-H'
 * 2000 requests/day: '2000-D'
-* `auto_update_policy` (string): Auto update policy ['manual_trigger', 'critical_only', 'always'] (default critical_only)
+* `auto_update_policy` (string): Auto update policy ['manual_trigger', 'critical_only', 'always', 'never'] (default critical_only)
 * `api_token` (string): Files Agent API Token
 * `port` (int64): Incoming port for files agent connections
 * `hostname` (string): 

data/docs/site.md

@@ -300,7 +300,10 @@
   "welcome_email_enabled": true,
   "welcome_screen": "user_controlled",
   "windows_mode_ftp": true,
-  "group_admins_can_set_user_password": true
+  "group_admins_can_set_user_password": true,
+  "managed_site_settings": [
+    "example"
+  ]
 }
 ```
 
@@ -475,6 +478,7 @@
 * `welcome_screen` (string): Does the welcome screen appear?
 * `windows_mode_ftp` (boolean): Does FTP user Windows emulation mode?
 * `group_admins_can_set_user_password` (boolean): Allow group admins set password authentication method
+* `managed_site_settings` (array(string)): List of site settings managed by the parent site
 
 
 ---

data/lib/files.com/models/child_site_management_policy.rb

@@ -0,0 +1,183 @@
+# frozen_string_literal: true
+
+module Files
+  class ChildSiteManagementPolicy
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - ChildSiteManagementPolicy ID
+    def id
+      @attributes[:id]
+    end
+
+    def id=(value)
+      @attributes[:id] = value
+    end
+
+    # int64 - ID of the Site managing the policy
+    def site_id
+      @attributes[:site_id]
+    end
+
+    def site_id=(value)
+      @attributes[:site_id] = value
+    end
+
+    # string - The name of the setting that is managed by the policy
+    def site_setting_name
+      @attributes[:site_setting_name]
+    end
+
+    def site_setting_name=(value)
+      @attributes[:site_setting_name] = value
+    end
+
+    # string - The value for the setting that will be enforced for all child sites that are not exempt
+    def managed_value
+      @attributes[:managed_value]
+    end
+
+    def managed_value=(value)
+      @attributes[:managed_value] = value
+    end
+
+    # array(int64) - The list of child site IDs that are exempt from this policy
+    def skip_child_site_ids
+      @attributes[:skip_child_site_ids]
+    end
+
+    def skip_child_site_ids=(value)
+      @attributes[:skip_child_site_ids] = value
+    end
+
+    # Parameters:
+    #   site_setting_name (required) - string - The name of the setting that is managed by the policy
+    #   managed_value (required) - string - The value for the setting that will be enforced for all child sites that are not exempt
+    #   skip_child_site_ids - array(int64) - The list of child site IDs that are exempt from this policy
+    def update(params = {})
+      params ||= {}
+      params[:id] = @attributes[:id]
+      raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: site_setting_name must be an String") if params[:site_setting_name] and !params[:site_setting_name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: managed_value must be an String") if params[:managed_value] and !params[:managed_value].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: skip_child_site_ids must be an Array") if params[:skip_child_site_ids] and !params[:skip_child_site_ids].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+      raise MissingParameterError.new("Parameter missing: site_setting_name") unless params[:site_setting_name]
+      raise MissingParameterError.new("Parameter missing: managed_value") unless params[:managed_value]
+
+      Api.send_request("/child_site_management_policies/#{@attributes[:id]}", :patch, params, @options)
+    end
+
+    def delete(params = {})
+      params ||= {}
+      params[:id] = @attributes[:id]
+      raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/child_site_management_policies/#{@attributes[:id]}", :delete, params, @options)
+    end
+
+    def destroy(params = {})
+      delete(params)
+      nil
+    end
+
+    def save
+      if @attributes[:id]
+        new_obj = update(@attributes)
+      else
+        new_obj = ChildSiteManagementPolicy.create(@attributes, @options)
+      end
+
+      @attributes = new_obj.attributes
+      true
+    end
+
+    # Parameters:
+    #   cursor - string - Used for pagination.  When a list request has more records available, cursors are provided in the response headers `X-Files-Cursor-Next` and `X-Files-Cursor-Prev`.  Send one of those cursor value here to resume an existing list from the next available record.  Note: many of our SDKs have iterator methods that will automatically handle cursor-based pagination.
+    #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).
+    def self.list(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: cursor must be an String") if params[:cursor] and !params[:cursor].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: per_page must be an Integer") if params[:per_page] and !params[:per_page].is_a?(Integer)
+
+      List.new(ChildSiteManagementPolicy, params) do
+        Api.send_request("/child_site_management_policies", :get, params, options)
+      end
+    end
+
+    def self.all(params = {}, options = {})
+      list(params, options)
+    end
+
+    # Parameters:
+    #   id (required) - int64 - Child Site Management Policy ID.
+    def self.find(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      response, options = Api.send_request("/child_site_management_policies/#{params[:id]}", :get, params, options)
+      ChildSiteManagementPolicy.new(response.data, options)
+    end
+
+    def self.get(id, params = {}, options = {})
+      find(id, params, options)
+    end
+
+    # Parameters:
+    #   site_setting_name (required) - string - The name of the setting that is managed by the policy
+    #   managed_value (required) - string - The value for the setting that will be enforced for all child sites that are not exempt
+    #   skip_child_site_ids - array(int64) - The list of child site IDs that are exempt from this policy
+    def self.create(params = {}, options = {})
+      raise InvalidParameterError.new("Bad parameter: site_setting_name must be an String") if params[:site_setting_name] and !params[:site_setting_name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: managed_value must be an String") if params[:managed_value] and !params[:managed_value].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: skip_child_site_ids must be an Array") if params[:skip_child_site_ids] and !params[:skip_child_site_ids].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: site_setting_name") unless params[:site_setting_name]
+      raise MissingParameterError.new("Parameter missing: managed_value") unless params[:managed_value]
+
+      response, options = Api.send_request("/child_site_management_policies", :post, params, options)
+      ChildSiteManagementPolicy.new(response.data, options)
+    end
+
+    # Parameters:
+    #   site_setting_name (required) - string - The name of the setting that is managed by the policy
+    #   managed_value (required) - string - The value for the setting that will be enforced for all child sites that are not exempt
+    #   skip_child_site_ids - array(int64) - The list of child site IDs that are exempt from this policy
+    def self.update(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: site_setting_name must be an String") if params[:site_setting_name] and !params[:site_setting_name].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: managed_value must be an String") if params[:managed_value] and !params[:managed_value].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: skip_child_site_ids must be an Array") if params[:skip_child_site_ids] and !params[:skip_child_site_ids].is_a?(Array)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+      raise MissingParameterError.new("Parameter missing: site_setting_name") unless params[:site_setting_name]
+      raise MissingParameterError.new("Parameter missing: managed_value") unless params[:managed_value]
+
+      response, options = Api.send_request("/child_site_management_policies/#{params[:id]}", :patch, params, options)
+      ChildSiteManagementPolicy.new(response.data, options)
+    end
+
+    def self.delete(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/child_site_management_policies/#{params[:id]}", :delete, params, options)
+      nil
+    end
+
+    def self.destroy(id, params = {}, options = {})
+      delete(id, params, options)
+      nil
+    end
+  end
+end

data/lib/files.com/models/remote_server_configuration_file.rb

@@ -104,7 +104,7 @@ module Files
       @attributes[:transfer_rate_limit]
     end
 
-    # string - Auto update policy ['manual_trigger', 'critical_only', 'always'] (default critical_only)
+    # string - Auto update policy ['manual_trigger', 'critical_only', 'always', 'never'] (default critical_only)
     def auto_update_policy
       @attributes[:auto_update_policy]
     end

data/lib/files.com/models/site.rb

@@ -864,6 +864,11 @@ module Files
       @attributes[:group_admins_can_set_user_password]
     end
 
+    # array(string) - List of site settings managed by the parent site
+    def managed_site_settings
+      @attributes[:managed_site_settings]
+    end
+
     def self.get(params = {}, options = {})
       response, options = Api.send_request("/site", :get, params, options)
       Site.new(response.data, options)

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.308"
+  VERSION = "1.1.309"
 end

data/lib/files.com.rb

@@ -56,6 +56,7 @@ require "files.com/models/bundle_notification"
 require "files.com/models/bundle_path"
 require "files.com/models/bundle_recipient"
 require "files.com/models/bundle_registration"
+require "files.com/models/child_site_management_policy"
 require "files.com/models/clickwrap"
 require "files.com/models/dns_record"
 require "files.com/models/email_incoming_message"

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.308
+  version: 1.1.309
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2025-07-25 00:00:00.000000000 Z
+date: 2025-07-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -138,6 +138,7 @@ files:
 - docs/bundle_path.md
 - docs/bundle_recipient.md
 - docs/bundle_registration.md
+- docs/child_site_management_policy.md
 - docs/clickwrap.md
 - docs/dns_record.md
 - docs/email_incoming_message.md
@@ -248,6 +249,7 @@ files:
 - lib/files.com/models/bundle_path.rb
 - lib/files.com/models/bundle_recipient.rb
 - lib/files.com/models/bundle_registration.rb
+- lib/files.com/models/child_site_management_policy.rb
 - lib/files.com/models/clickwrap.rb
 - lib/files.com/models/dir.rb
 - lib/files.com/models/dns_record.rb