files-com 1.6.137__py3-none-any.whl → 1.6.171__py3-none-any.whl

files_sdk/models/restore.py

@@ -19,8 +19,15 @@ class Restore:
         "files_errored": None,  # int64 - Number of files that were not able to be restored.
         "files_total": None,  # int64 - Total number of files processed.
         "prefix": None,  # string - Prefix of the files/folders to restore. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items, specify an empty string (`''`) in the prefix field or omit the field from the request.
+        "restoration_type": None,  # string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
         "restore_in_place": None,  # 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": None,  # boolean - If true, we will also restore any Permissions that match the same path prefix from the same dates.
+        "users_restored": None,  # int64 - Number of users successfully restored (only present for `restoration_type=users`).
+        "users_errored": None,  # int64 - Number of users that failed to restore (only present for `restoration_type=users`).
+        "users_total": None,  # int64 - Total number of users processed (only present for `restoration_type=users`).
+        "api_keys_restored": None,  # int64 - Number of API keys restored (only present for `restoration_type=users`).
+        "public_keys_restored": None,  # int64 - Number of public keys restored (only present for `restoration_type=users`).
+        "two_factor_authentication_methods_restored": None,  # int64 - Number of two factor authentication methods restored (only present for `restoration_type=users`).
         "status": None,  # string - Status of the restoration process.
         "update_timestamps": None,  # 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.
         "error_messages": None,  # array(string) - Error messages received while restoring files and/or directories. Only present if there were errors.
@@ -59,6 +66,8 @@ class Restore:
 # 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 .
+#   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `restoration_type`.
 def list(params=None, options=None):
     if not isinstance(params, dict):
         params = {}
@@ -68,6 +77,10 @@ def list(params=None, options=None):
         raise InvalidParameterError("Bad parameter: cursor must be an str")
     if "per_page" in params and not isinstance(params["per_page"], int):
         raise InvalidParameterError("Bad parameter: per_page must be an int")
+    if "sort_by" in params and not isinstance(params["sort_by"], dict):
+        raise InvalidParameterError("Bad parameter: sort_by must be an dict")
+    if "filter" in params and not isinstance(params["filter"], dict):
+        raise InvalidParameterError("Bad parameter: filter must be an dict")
     return ListObj(Restore, "GET", "/restores", params, options)
 
 
@@ -78,6 +91,7 @@ def all(params=None, options=None):
 # Parameters:
 #   earliest_date (required) - string - Restore all files deleted 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. To restore a folder, add a trailing slash to the folder name. Do not use a leading slash. To restore all deleted items, specify an empty string (`''`) in the prefix field or omit the field from the request.
+#   restoration_type - string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
 #   restore_deleted_permissions - boolean - If true, we will also restore any Permissions that match the same path prefix from the same dates.
 #   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.
@@ -94,6 +108,12 @@ def create(params=None, options=None):
         )
     if "prefix" in params and not isinstance(params["prefix"], str):
         raise InvalidParameterError("Bad parameter: prefix must be an str")
+    if "restoration_type" in params and not isinstance(
+        params["restoration_type"], str
+    ):
+        raise InvalidParameterError(
+            "Bad parameter: restoration_type must be an str"
+        )
     if "restore_deleted_permissions" in params and not isinstance(
         params["restore_deleted_permissions"], bool
     ):

files_sdk/models/site.py

@@ -157,7 +157,6 @@ class Site:
         "smtp_from": None,  # string - From address to use when mailing through custom SMTP
         "smtp_port": None,  # int64 - SMTP server port
         "smtp_username": None,  # string - SMTP server username
-        "session_expiry": None,  # double - Session expiry in hours
         "session_expiry_minutes": None,  # int64 - Session expiry in minutes
         "snapshot_sharing_enabled": None,  # boolean - Allow snapshot share links creation
         "ssl_required": None,  # boolean - Is SSL required?  Disabling this is insecure.
@@ -269,7 +268,7 @@ def get_usage(params=None, options=None):
 #   legacy_checksums_mode - boolean - Use legacy checksums mode?
 #   migrate_remote_server_sync_to_sync - boolean - If true, we will migrate all remote server syncs to the new Sync model.
 #   as2_message_retention_days - int64 - Number of days to retain AS2 messages (incoming and outgoing).
-#   session_expiry - double - Session expiry in hours
+#   session_expiry_minutes - int64 - Session expiry in minutes
 #   ssl_required - boolean - Is SSL required?  Disabling this is insecure.
 #   sftp_insecure_ciphers - boolean - If true, we will allow weak and known insecure ciphers to be used for SFTP connections.  Enabling this setting severely weakens the security of your site and it is not recommend, except as a last resort for compatibility.
 #   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.
@@ -391,7 +390,6 @@ def get_usage(params=None, options=None):
 #   ldap_password_change - string - New LDAP password.
 #   ldap_password_change_confirmation - string - Confirm new LDAP password.
 #   smtp_password - string - Password for SMTP server.
-#   session_expiry_minutes - int64 - Session expiry in minutes
 def update(params=None, options=None):
     if not isinstance(params, dict):
         params = {}
@@ -633,11 +631,11 @@ def update(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: as2_message_retention_days must be an int"
         )
-    if "session_expiry" in params and not isinstance(
-        params["session_expiry"], float
+    if "session_expiry_minutes" in params and not isinstance(
+        params["session_expiry_minutes"], int
     ):
         raise InvalidParameterError(
-            "Bad parameter: session_expiry must be an float"
+            "Bad parameter: session_expiry_minutes must be an int"
         )
     if "ssl_required" in params and not isinstance(
         params["ssl_required"], bool
@@ -1283,12 +1281,6 @@ def update(params=None, options=None):
         raise InvalidParameterError(
             "Bad parameter: smtp_password must be an str"
         )
-    if "session_expiry_minutes" in params and not isinstance(
-        params["session_expiry_minutes"], int
-    ):
-        raise InvalidParameterError(
-            "Bad parameter: session_expiry_minutes must be an int"
-        )
     response, options = Api.send_request("PATCH", "/site", params, options)
     return Site(response.data, options)
 

files_sdk/models/sync.py

@@ -251,6 +251,8 @@ class Sync:
 # 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 `site_id`.
+#   filter - object - If set, return records where the specified field is equal to the supplied value. Valid fields are `src_remote_server_id` and `dest_remote_server_id`.
 def list(params=None, options=None):
     if not isinstance(params, dict):
         params = {}
@@ -260,6 +262,10 @@ def list(params=None, options=None):
         raise InvalidParameterError("Bad parameter: cursor must be an str")
     if "per_page" in params and not isinstance(params["per_page"], int):
         raise InvalidParameterError("Bad parameter: per_page must be an int")
+    if "sort_by" in params and not isinstance(params["sort_by"], dict):
+        raise InvalidParameterError("Bad parameter: sort_by must be an dict")
+    if "filter" in params and not isinstance(params["filter"], dict):
+        raise InvalidParameterError("Bad parameter: filter must be an dict")
     return ListObj(Sync, "GET", "/syncs", params, options)