files.com 1.1.148 → 1.1.149

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 01b556c1e4110c4fe2f19c4eb3cc837666d96b8bf9aa5dfab43134f84a195396
-  data.tar.gz: 39fad710efe27bdce3e25c9912d9555da07169fa183610c23ed50abad7f46733
+  metadata.gz: 10fbda85aaebf20a675954a777aef95ebbddb70ca27153bae15fc72e8f1e9b9f
+  data.tar.gz: a5b9f65d1f04237f2d9a27f9f4173f8441f43272ac1cfbd305342ddaeb70c866
 SHA512:
-  metadata.gz: 00047fb734bcfd0311b8e7fb14876490f4535515c0161b600f7702673c72cfd606d1287b274b75a820efb9650605ed456782b3a1222d6add89cdce62e6387f2f
-  data.tar.gz: 50374ba0bb21964bd0507c05a8ef9415864eae085f0c1f976583ef6e641ae6da83532143ff041293c870dc070f4cee48cadfe494bfae79ffa39c18d03efeb06a
+  metadata.gz: b1e4cf5b61e39768d19af342595e09fcb0f0d882d3639d93985f45c503a57a4e22326804e8146f822c5c18d12fe39689c485bef2f6a4e585b60ec0bf2623d465
+  data.tar.gz: 0b79895ad9e6df66452797aa3eb112741fdf49bf16571ee85bd4f6c3c0cc0e9986a14580e77ce5781edef6a9b135ed27eccab09adf91304eb4db8016fefb297f

data/_VERSION

@@ -1 +1 @@
-1.1.148
+1.1.149

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/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/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.149"
 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.149
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2024-10-08 00:00:00.000000000 Z
+date: 2024-10-10 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