files.com 1.1.148 → 1.1.150

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01b556c1e4110c4fe2f19c4eb3cc837666d96b8bf9aa5dfab43134f84a195396
-  data.tar.gz: 39fad710efe27bdce3e25c9912d9555da07169fa183610c23ed50abad7f46733
+  metadata.gz: 05ba4dfda040251805845298b4d16e1c08e463c1783780643fbb2778f03e4c70
+  data.tar.gz: 7eb0dd471806a96dcc029547eb9467b5afc8a70799d97c49de7d2106459ed8b2
 SHA512:
-  metadata.gz: 00047fb734bcfd0311b8e7fb14876490f4535515c0161b600f7702673c72cfd606d1287b274b75a820efb9650605ed456782b3a1222d6add89cdce62e6387f2f
-  data.tar.gz: 50374ba0bb21964bd0507c05a8ef9415864eae085f0c1f976583ef6e641ae6da83532143ff041293c870dc070f4cee48cadfe494bfae79ffa39c18d03efeb06a
+  metadata.gz: 44f980bec46fcadae38195bcac11a5b1ddb5aeba966c2643514ed44cdf0c84ca402478df67c13f1426f8a93e1829cb08858a2abcacb1ac343863e930c2e373f2
+  data.tar.gz: ab2b25cd6265796e367d2cf9015ccf2d66a8c74214b852bb5b518c9360b4787bb33416d3a0999109310af760c537611e309118feafae9e68469f94822861ff93

data/_VERSION

@@ -1 +1 @@
-1.1.148
+1.1.150

data/docs/permission.md

@@ -62,18 +62,20 @@ Files::Permission.create(
   permission: "full", 
   recursive: true, 
   user_id: 1, 
-  username: "user"
+  username: "user", 
+  group_name: "example"
 )
 ```
 
 ### Parameters
 
 * `path` (string): Required - Folder path
-* `group_id` (int64): Group ID
+* `group_id` (int64): Group ID. Provide `group_name` or `group_id`
 * `permission` (string): Permission type.  Can be `admin`, `full`, `readonly`, `writeonly`, `list`, or `history`
 * `recursive` (boolean): Apply to subfolders recursively?
 * `user_id` (int64): User ID.  Provide `username` or `user_id`
 * `username` (string): User username.  Provide `username` or `user_id`
+* `group_name` (string): Group name.  Provide `group_name` or `group_id`
 
 
 ---

data/docs/remote_server.md

@@ -152,6 +152,9 @@ Files::RemoteServer.list
 
 * `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).
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `name`, `server_type`, `backblaze_b2_bucket`, `google_cloud_storage_bucket`, `wasabi_bucket`, `s3_bucket`, `rackspace_container`, `azure_blob_storage_container`, `azure_files_storage_share_name`, `s3_compatible_bucket`, `filebase_bucket`, `cloudflare_bucket` or `linode_bucket`.
+* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `name`, `server_type`, `backblaze_b2_bucket`, `google_cloud_storage_bucket`, `wasabi_bucket`, `s3_bucket`, `rackspace_container`, `azure_blob_storage_container`, `azure_files_storage_share_name`, `s3_compatible_bucket`, `filebase_bucket`, `cloudflare_bucket` or `linode_bucket`. Valid field combinations are `[ name, server_type ]`, `[ name, backblaze_b2_bucket ]`, `[ name, google_cloud_storage_bucket ]`, `[ name, wasabi_bucket ]`, `[ name, s3_bucket ]`, `[ name, rackspace_container ]`, `[ name, azure_blob_storage_container ]`, `[ name, azure_files_storage_share_name ]`, `[ name, s3_compatible_bucket ]`, `[ name, filebase_bucket ]`, `[ name, cloudflare_bucket ]` or `[ name, linode_bucket ]`.
+* `filter_prefix` (object): If set, return records where the specified field is prefixed by the supplied value. Valid fields are `name`, `backblaze_b2_bucket`, `google_cloud_storage_bucket`, `wasabi_bucket`, `s3_bucket`, `rackspace_container`, `azure_blob_storage_container`, `azure_files_storage_share_name`, `s3_compatible_bucket`, `filebase_bucket`, `cloudflare_bucket` or `linode_bucket`. Valid field combinations are `[ name, backblaze_b2_bucket ]`, `[ name, google_cloud_storage_bucket ]`, `[ name, wasabi_bucket ]`, `[ name, s3_bucket ]`, `[ name, rackspace_container ]`, `[ name, azure_blob_storage_container ]`, `[ name, azure_files_storage_share_name ]`, `[ name, s3_compatible_bucket ]`, `[ name, filebase_bucket ]`, `[ name, cloudflare_bucket ]` or `[ name, linode_bucket ]`.
 
 
 ---

data/docs/site.md

@@ -181,6 +181,7 @@
   "sftp_insecure_diffie_hellman": true,
   "sftp_user_root_enabled": true,
   "sharing_enabled": true,
+  "show_user_notifications_log_in_link": true,
   "show_request_access_link": true,
   "site_footer": "example",
   "site_header": "example",
@@ -414,6 +415,7 @@
 * `sftp_insecure_diffie_hellman` (boolean): If true, we will allow weak Diffie Hellman parameters to be used within ciphers for SFTP that are otherwise on our secure list.  This has the effect of making the cipher weaker than our normal threshold for security, but is required to support certain legacy or broken SSH and MFT clients.  Enabling this weakens security, but not nearly as much as enabling the full `sftp_insecure_ciphers` option.
 * `sftp_user_root_enabled` (boolean): Use user FTP roots also for SFTP?
 * `sharing_enabled` (boolean): Allow bundle creation
+* `show_user_notifications_log_in_link` (boolean): Show log in link in user notifications?
 * `show_request_access_link` (boolean): Show request access link for users without access?  Currently unused.
 * `site_footer` (string): Custom site footer text
 * `site_header` (string): Custom site header text
@@ -563,6 +565,7 @@ Files::Site.update(
   sftp_enabled: true, 
   users_can_create_api_keys: true, 
   users_can_create_ssh_keys: true, 
+  show_user_notifications_log_in_link: true, 
   sftp_host_key_type: "default", 
   active_sftp_host_key_id: 1, 
   protocol_access_groups_only: true, 
@@ -714,6 +717,7 @@ Files::Site.update(
 * `sftp_enabled` (boolean): Is SFTP enabled?
 * `users_can_create_api_keys` (boolean): Allow users to create their own API keys?
 * `users_can_create_ssh_keys` (boolean): Allow users to create their own SSH keys?
+* `show_user_notifications_log_in_link` (boolean): Show log in link in user notifications?
 * `sftp_host_key_type` (string): Sftp Host Key Type
 * `active_sftp_host_key_id` (int64): Id of the currently selected custom SFTP Host Key
 * `protocol_access_groups_only` (boolean): If true, protocol access permissions on users will be ignored, and only protocol access permissions set on Groups will be honored.  Make sure that your current user is a member of a group with API permission when changing this value to avoid locking yourself out of your site.

data/docs/user_sftp_client_use.md

@@ -0,0 +1,36 @@
+# UserSftpClientUse
+
+## Example UserSftpClientUse Object
+
+```
+{
+  "id": 1,
+  "sftp_client": "example",
+  "created_at": "2000-01-01T01:00:00Z",
+  "updated_at": "2000-01-01T01:00:00Z",
+  "user_id": 1
+}
+```
+
+* `id` (int64): UserSftpClientUse ID
+* `sftp_client` (string): The SFTP client used
+* `created_at` (date-time): The earliest recorded use of this SFTP client (for this user)
+* `updated_at` (date-time): The most recent use of this SFTP client (for this user)
+* `user_id` (int64): ID of the user who performed this access
+
+
+---
+
+## List User SFTP Client Uses
+
+```
+Files::UserSftpClientUse.list(
+  user_id: 1
+)
+```
+
+### Parameters
+
+* `user_id` (int64): User ID.  Provide a value of `0` to operate the current session's user.
+* `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).

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

@@ -138,17 +138,19 @@ module Files
 
     # Parameters:
     #   path (required) - string - Folder path
-    #   group_id - int64 - Group ID
+    #   group_id - int64 - Group ID. Provide `group_name` or `group_id`
     #   permission - string - Permission type.  Can be `admin`, `full`, `readonly`, `writeonly`, `list`, or `history`
     #   recursive - boolean - Apply to subfolders recursively?
     #   user_id - int64 - User ID.  Provide `username` or `user_id`
     #   username - string - User username.  Provide `username` or `user_id`
+    #   group_name - string - Group name.  Provide `group_name` or `group_id`
     def self.create(params = {}, options = {})
       raise InvalidParameterError.new("Bad parameter: path must be an String") if params[:path] and !params[:path].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: group_id must be an Integer") if params[:group_id] and !params[:group_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: permission must be an String") if params[:permission] and !params[:permission].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)
       raise InvalidParameterError.new("Bad parameter: username must be an String") if params[:username] and !params[:username].is_a?(String)
+      raise InvalidParameterError.new("Bad parameter: group_name must be an String") if params[:group_name] and !params[:group_name].is_a?(String)
       raise MissingParameterError.new("Parameter missing: path") unless params[:path]
 
       response, options = Api.send_request("/permissions", :post, params, options)

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

@@ -884,9 +884,15 @@ module Files
     # 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).
+    #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `name`, `server_type`, `backblaze_b2_bucket`, `google_cloud_storage_bucket`, `wasabi_bucket`, `s3_bucket`, `rackspace_container`, `azure_blob_storage_container`, `azure_files_storage_share_name`, `s3_compatible_bucket`, `filebase_bucket`, `cloudflare_bucket` or `linode_bucket`.
+    #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `name`, `server_type`, `backblaze_b2_bucket`, `google_cloud_storage_bucket`, `wasabi_bucket`, `s3_bucket`, `rackspace_container`, `azure_blob_storage_container`, `azure_files_storage_share_name`, `s3_compatible_bucket`, `filebase_bucket`, `cloudflare_bucket` or `linode_bucket`. Valid field combinations are `[ name, server_type ]`, `[ name, backblaze_b2_bucket ]`, `[ name, google_cloud_storage_bucket ]`, `[ name, wasabi_bucket ]`, `[ name, s3_bucket ]`, `[ name, rackspace_container ]`, `[ name, azure_blob_storage_container ]`, `[ name, azure_files_storage_share_name ]`, `[ name, s3_compatible_bucket ]`, `[ name, filebase_bucket ]`, `[ name, cloudflare_bucket ]` or `[ name, linode_bucket ]`.
+    #   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `name`, `backblaze_b2_bucket`, `google_cloud_storage_bucket`, `wasabi_bucket`, `s3_bucket`, `rackspace_container`, `azure_blob_storage_container`, `azure_files_storage_share_name`, `s3_compatible_bucket`, `filebase_bucket`, `cloudflare_bucket` or `linode_bucket`. Valid field combinations are `[ name, backblaze_b2_bucket ]`, `[ name, google_cloud_storage_bucket ]`, `[ name, wasabi_bucket ]`, `[ name, s3_bucket ]`, `[ name, rackspace_container ]`, `[ name, azure_blob_storage_container ]`, `[ name, azure_files_storage_share_name ]`, `[ name, s3_compatible_bucket ]`, `[ name, filebase_bucket ]`, `[ name, cloudflare_bucket ]` or `[ name, linode_bucket ]`.
     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)
+      raise InvalidParameterError.new("Bad parameter: sort_by must be an Hash") if params[:sort_by] and !params[:sort_by].is_a?(Hash)
+      raise InvalidParameterError.new("Bad parameter: filter must be an Hash") if params[:filter] and !params[:filter].is_a?(Hash)
+      raise InvalidParameterError.new("Bad parameter: filter_prefix must be an Hash") if params[:filter_prefix] and !params[:filter_prefix].is_a?(Hash)
 
       List.new(RemoteServer, params) do
         Api.send_request("/remote_servers", :get, params, options)

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

@@ -644,6 +644,11 @@ module Files
       @attributes[:sharing_enabled]
     end
 
+    # boolean - Show log in link in user notifications?
+    def show_user_notifications_log_in_link
+      @attributes[:show_user_notifications_log_in_link]
+    end
+
     # boolean - Show request access link for users without access?  Currently unused.
     def show_request_access_link
       @attributes[:show_request_access_link]
@@ -919,6 +924,7 @@ module Files
     #   sftp_enabled - boolean - Is SFTP enabled?
     #   users_can_create_api_keys - boolean - Allow users to create their own API keys?
     #   users_can_create_ssh_keys - boolean - Allow users to create their own SSH keys?
+    #   show_user_notifications_log_in_link - boolean - Show log in link in user notifications?
     #   sftp_host_key_type - string - Sftp Host Key Type
     #   active_sftp_host_key_id - int64 - Id of the currently selected custom SFTP Host Key
     #   protocol_access_groups_only - boolean - If true, protocol access permissions on users will be ignored, and only protocol access permissions set on Groups will be honored.  Make sure that your current user is a member of a group with API permission when changing this value to avoid locking yourself out of your site.

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

@@ -0,0 +1,55 @@
+# frozen_string_literal: true
+
+module Files
+  class UserSftpClientUse
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # int64 - UserSftpClientUse ID
+    def id
+      @attributes[:id]
+    end
+
+    # string - The SFTP client used
+    def sftp_client
+      @attributes[:sftp_client]
+    end
+
+    # date-time - The earliest recorded use of this SFTP client (for this user)
+    def created_at
+      @attributes[:created_at]
+    end
+
+    # date-time - The most recent use of this SFTP client (for this user)
+    def updated_at
+      @attributes[:updated_at]
+    end
+
+    # int64 - ID of the user who performed this access
+    def user_id
+      @attributes[:user_id]
+    end
+
+    # Parameters:
+    #   user_id - int64 - User ID.  Provide a value of `0` to operate the current session's user.
+    #   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: user_id must be an Integer") if params[:user_id] and !params[:user_id].is_a?(Integer)
+      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(UserSftpClientUse, params) do
+        Api.send_request("/user_sftp_client_uses", :get, params, options)
+      end
+    end
+
+    def self.all(params = {}, options = {})
+      list(params, options)
+    end
+  end
+end

data/lib/files.com/version.rb

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

data/lib/files.com.rb

@@ -125,6 +125,7 @@ require "files.com/models/usage_snapshot"
 require "files.com/models/user"
 require "files.com/models/user_cipher_use"
 require "files.com/models/user_request"
+require "files.com/models/user_sftp_client_use"
 require "files.com/models/web_dav_action_log"
 require "files.com/models/webhook_test"
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.148
+  version: 1.1.150
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-08 00:00:00.000000000 Z
+date: 2024-10-11 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable
@@ -208,6 +208,7 @@ files:
 - docs/user.md
 - docs/user_cipher_use.md
 - docs/user_request.md
+- docs/user_sftp_client_use.md
 - docs/web_dav_action_log.md
 - docs/webhook_test.md
 - files.com.gemspec
@@ -311,6 +312,7 @@ files:
 - lib/files.com/models/user.rb
 - lib/files.com/models/user_cipher_use.rb
 - lib/files.com/models/user_request.rb
+- lib/files.com/models/user_sftp_client_use.rb
 - lib/files.com/models/web_dav_action_log.rb
 - lib/files.com/models/webhook_test.rb
 - lib/files.com/path_util.rb