files.com 1.1.761 → 1.1.763

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 70eb87b154c75bdd0e5e0b1400eaf10e2c7c375890c60a6ac19e37d43c1b1905
-  data.tar.gz: 11a8a18817d44f14e45cf0ad245eb8206e261fa4e08a244e50264ed29f2e1760
+  metadata.gz: 775d5f4aa69fd45aa9a49a3c3c6065f10db5aeeff9e39110aaf86b26974a9887
+  data.tar.gz: 6f045f8bf6cd934e045f29ffa6875815139b781d35b78c4356dc2c9c8c40ecd4
 SHA512:
-  metadata.gz: b7246637ce8c0a6757471590692615cbf7746911bc43691054e5a1752ff57a611fc420d8ccc02d4da8904c02a30afa57f0ed3270c86e27ab0f828f1a0db1dc4d
-  data.tar.gz: ac784118649ef9ed5b7421ad19a206d916bc716162af295319e5b7689e315d1f111f6d565ddaa974ee5c9faafbe919feef03dcf3f4f8b710a5345d89d5498a64
+  metadata.gz: df4946656ad31bab48a1635b211c1ec01fec6cb5d4124e9ce311800ed26a0819fce26f6de0138f40fa7e0b45effec05705480b69d479e8fb37e5de36cd7281bc
+  data.tar.gz: e53af20846196b7002e28b8d2ea5d6730281c74bd8eb32f75c57b4b30e1f8c61cf7837a397abf871dd903878af6a78295e2808bafb631356b47cacf073a9323a

data/_VERSION

@@ -1 +1 @@
-1.1.761
+1.1.763

data/docs/remote_server_credential.md

@@ -79,7 +79,7 @@ Files::RemoteServerCredential.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: 10000, 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 `workspace_id` and `id`.
+* `sort_by` (object): If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id` and `name`.
 * `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `workspace_id` and `name`. Valid field combinations are `[ workspace_id, name ]`.
 * `filter_prefix` (object): If set, return records where the specified field is prefixed by the supplied value. Valid fields are `name`.
 

data/docs/restore.md

@@ -39,10 +39,10 @@
 * `files_restored` (int64): Number of files successfully restored.
 * `files_errored` (int64): Number of files that were not able to be restored.
 * `files_total` (int64): Total number of files processed.
-* `prefix` (string): Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+* `prefix` (string): Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. A trailing slash selects that folder and its contents only; without it, the prefix matches any path beginning with that text. Do not use a leading slash. To restore all deleted items of the selected restoration type within the selected site or workspace scope, specify an empty string (`''`) or omit the field.
 * `restoration_type` (string): Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
 * `restore_in_place` (boolean): If true, we will restore the files in place (into their original paths). If false, we will create a new restoration folder in the root and restore files there.
-* `restore_deleted_permissions` (boolean): If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
+* `restore_deleted_permissions` (boolean): If true, a user restore restores permissions removed as part of deleting the selected users. An in-place file restore restores user and group permissions on returned folders and their subfolders that were deleted from the time of the folder's deletion through 24 hours afterward, including permissions removed independently within that window. File restores into a new folder do not restore permissions.
 * `users_restored` (int64): Number of users successfully restored (only present for `restoration_type=users`).
 * `users_errored` (int64): Number of users that failed to restore (only present for `restoration_type=users`).
 * `users_total` (int64): Total number of users processed (only present for `restoration_type=users`).
@@ -90,9 +90,9 @@ Files::Restore.create(
 ### Parameters
 
 * `earliest_date` (string): Required - Restore files or users deleted on or after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
-* `prefix` (string): Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+* `prefix` (string): Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. A trailing slash selects that folder and its contents only; without it, the prefix matches any path beginning with that text. Do not use a leading slash. To restore all deleted items of the selected restoration type within the selected site or workspace scope, specify an empty string (`''`) or omit the field.
 * `restoration_type` (string): Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
-* `restore_deleted_permissions` (boolean): If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
+* `restore_deleted_permissions` (boolean): If true, a user restore restores permissions removed as part of deleting the selected users. An in-place file restore restores user and group permissions on returned folders and their subfolders that were deleted from the time of the folder's deletion through 24 hours afterward, including permissions removed independently within that window. File restores into a new folder do not restore permissions.
 * `restore_in_place` (boolean): If true, we will restore the files in place (into their original paths). If false, we will create a new restoration folder in the root and restore files there.
 * `update_timestamps` (boolean): If true, we will update the last modified timestamp of restored files to today's date. If false, we might trigger File Expiration to delete the file again.
 * `workspace_id` (int64): Workspace ID for a workspace-scoped restore. `0` means the default site-wide scope.

data/docs/site.md

@@ -251,6 +251,7 @@
   "smtp_authentication": "plain",
   "smtp_from": "me@my-mail-server.com",
   "smtp_port": 25,
+  "smtp_ssl": "require",
   "smtp_username": "mail",
   "session_expiry_minutes": 360,
   "snapshot_sharing_enabled": true,
@@ -545,6 +546,7 @@
 * `smtp_authentication` (string): SMTP server authentication type
 * `smtp_from` (string): From address to use when mailing through custom SMTP
 * `smtp_port` (int64): SMTP server port
+* `smtp_ssl` (string): Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted. A certificate-verified STARTTLS connection automatically changes if_available to require unless smtp_ssl is managed by a parent policy. require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address. Encryption is never automatically downgraded.
 * `smtp_username` (string): SMTP server username
 * `session_expiry_minutes` (int64): Session expiry in minutes
 * `snapshot_sharing_enabled` (boolean): Allow snapshot share links creation
@@ -750,6 +752,7 @@ Files::Site.update(
   smtp_from: "me@my-mail-server.com", 
   smtp_username: "mail", 
   smtp_port: 1, 
+  smtp_ssl: "require", 
   ldap_enabled: false, 
   ldap_type: "open_ldap", 
   ldap_host: "ldap.site.com", 
@@ -936,6 +939,7 @@ Files::Site.update(
 * `smtp_from` (string): From address to use when mailing through custom SMTP
 * `smtp_username` (string): SMTP server username
 * `smtp_port` (int64): SMTP server port
+* `smtp_ssl` (string): Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted. A certificate-verified STARTTLS connection automatically changes if_available to require unless smtp_ssl is managed by a parent policy. require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address. Encryption is never automatically downgraded.
 * `ldap_enabled` (boolean): Main LDAP setting: is LDAP enabled?
 * `ldap_type` (string): LDAP type
 * `ldap_host` (string): LDAP host

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

@@ -468,7 +468,7 @@ 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: 10000, 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 `workspace_id` and `id`.
+    #   sort_by - object - If set, sort records by the specified field in either `asc` or `desc` direction. Valid fields are `workspace_id` and `name`.
     #   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `workspace_id` and `name`. Valid field combinations are `[ workspace_id, name ]`.
     #   filter_prefix - object - If set, return records where the specified field is prefixed by the supplied value. Valid fields are `name`.
     def self.list(params = {}, options = {})

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

@@ -81,7 +81,7 @@ module Files
       @attributes[:files_total] = value
     end
 
-    # string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+    # string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. A trailing slash selects that folder and its contents only; without it, the prefix matches any path beginning with that text. Do not use a leading slash. To restore all deleted items of the selected restoration type within the selected site or workspace scope, specify an empty string (`''`) or omit the field.
     def prefix
       @attributes[:prefix]
     end
@@ -108,7 +108,7 @@ module Files
       @attributes[:restore_in_place] = value
     end
 
-    # boolean - If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
+    # boolean - If true, a user restore restores permissions removed as part of deleting the selected users. An in-place file restore restores user and group permissions on returned folders and their subfolders that were deleted from the time of the folder's deletion through 24 hours afterward, including permissions removed independently within that window. File restores into a new folder do not restore permissions.
     def restore_deleted_permissions
       @attributes[:restore_deleted_permissions]
     end
@@ -240,9 +240,9 @@ module Files
 
     # Parameters:
     #   earliest_date (required) - string - Restore files or users deleted on or after this date/time. Don't set this earlier than you need. Can not be greater than 365 days prior to the restore request.
-    #   prefix - string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items of the selected restoration type, specify an empty string (`''`) in the prefix field or omit the field from the request.
+    #   prefix - string - Prefix of the files/folders to restore, or a case-insensitive username prefix for a user restore. A trailing slash selects that folder and its contents only; without it, the prefix matches any path beginning with that text. Do not use a leading slash. To restore all deleted items of the selected restoration type within the selected site or workspace scope, specify an empty string (`''`) or omit the field.
     #   restoration_type - string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records removed as part of deleting those users.
-    #   restore_deleted_permissions - boolean - If true, restore permissions removed as part of deleting the selected users for a user restore, or permissions matching the selected path prefix and deletion dates for a file restore.
+    #   restore_deleted_permissions - boolean - If true, a user restore restores permissions removed as part of deleting the selected users. An in-place file restore restores user and group permissions on returned folders and their subfolders that were deleted from the time of the folder's deletion through 24 hours afterward, including permissions removed independently within that window. File restores into a new folder do not restore permissions.
     #   restore_in_place - boolean - If true, we will restore the files in place (into their original paths). If false, we will create a new restoration folder in the root and restore files there.
     #   update_timestamps - boolean - If true, we will update the last modified timestamp of restored files to today's date. If false, we might trigger File Expiration to delete the file again.
     #   workspace_id - int64 - Workspace ID for a workspace-scoped restore. `0` means the default site-wide scope.

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

@@ -864,6 +864,11 @@ module Files
       @attributes[:smtp_port]
     end
 
+    # string - Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted. A certificate-verified STARTTLS connection automatically changes if_available to require unless smtp_ssl is managed by a parent policy. require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address. Encryption is never automatically downgraded.
+    def smtp_ssl
+      @attributes[:smtp_ssl]
+    end
+
     # string - SMTP server username
     def smtp_username
       @attributes[:smtp_username]
@@ -1163,6 +1168,7 @@ module Files
     #   smtp_from - string - From address to use when mailing through custom SMTP
     #   smtp_username - string - SMTP server username
     #   smtp_port - int64 - SMTP server port
+    #   smtp_ssl - string - Custom SMTP encryption mode: if_available (default) uses STARTTLS when offered and otherwise sends credentials and messages unencrypted. A certificate-verified STARTTLS connection automatically changes if_available to require unless smtp_ssl is managed by a parent policy. require requires STARTTLS before authentication; require_implicit uses TLS from connection start; never disables TLS. TLS verifies the server certificate against smtp_address. Encryption is never automatically downgraded.
     #   ldap_enabled - boolean - Main LDAP setting: is LDAP enabled?
     #   ldap_type - string - LDAP type
     #   ldap_host - string - LDAP host
@@ -1260,6 +1266,7 @@ module Files
       raise InvalidParameterError.new("Bad parameter: smtp_from must be an String") if params[:smtp_from] and !params[:smtp_from].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: smtp_username must be an String") if params[:smtp_username] and !params[:smtp_username].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: smtp_port must be an Integer") if params[:smtp_port] and !params[:smtp_port].is_a?(Integer)
+      raise InvalidParameterError.new("Bad parameter: smtp_ssl must be an String") if params[:smtp_ssl] and !params[:smtp_ssl].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: ldap_type must be an String") if params[:ldap_type] and !params[:ldap_type].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: ldap_host must be an String") if params[:ldap_host] and !params[:ldap_host].is_a?(String)
       raise InvalidParameterError.new("Bad parameter: ldap_host_2 must be an String") if params[:ldap_host_2] and !params[:ldap_host_2].is_a?(String)

data/lib/files.com/version.rb

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

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.761
+  version: 1.1.763
 platform: ruby
 authors:
 - files.com