files.com 1.0.236 → 1.0.240

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 552519b04a1256d02139b97b36d9c2d398b0b35aa06e934380b2c0e6dbcc48a9
-  data.tar.gz: 57a407a420d4f2646937ae647022f8b0f1ba8e93e8f0a52fe5fd413f1ad5fd36
+  metadata.gz: e34bb016ac2238fe372490914bdbf006e867d96129ff4d7498d11a6eaabe4456
+  data.tar.gz: aaef67d18bc72a8e1f9341a9925f5c2ebdad0fe877c4e1db0c85387510bcc711
 SHA512:
-  metadata.gz: fd27015305911d0ed20e1dca918c11113d44a93587e57dc6888176ec4fba12704a8cc74ad20d941c9b62e79eef13340ab19419c7b9cb0698aa76e08a8f8fcf03
-  data.tar.gz: 653f9efbd638f7b202974897bbc70ac6af3f910f85fdac4c6c6a188e40b1a25ad33de8bece0554dbe013531ec9c3a40c5a50714014255016828e97e911fcb9df
+  metadata.gz: 4ee29f639118d4be3cadc79989a1f301a3f61e2d9c2f17ea6589e1a1ac793f5606a3a4e7c8c1c8301d1adbe4c8d86492ee87287d1e592f4a029af41eb50c731b
+  data.tar.gz: b9ec81c3662ff7f73f57473d66c2c9e663d50834631dfa6819f19fdbfe393f7300be0d0fe7ff0c6f667a0393c77e224b6a1c50e8302dacad13d1928b4ca68d85

data/_VERSION

@@ -1 +1 @@
-1.0.236
+1.0.240

data/docs/file.md

@@ -17,7 +17,7 @@ may places where a Ruby File object can be used.
   "md5": "17c54824e9931a4688ca032d03f6663c",
   "mime_type": "application/octet-stream",
   "region": "us-east-1",
-  "permissions": "rpw",
+  "permissions": "rwd",
   "subfolders_locked?": true,
   "download_uri": "https://mysite.files.com/...",
   "priority_color": "red",
@@ -42,7 +42,7 @@ may places where a Ruby File object can be used.
 * `md5` (string): File MD5 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
 * `mime_type` (string): MIME Type.  This is determined by the filename extension and is not stored separately internally.
 * `region` (string): Region location
-* `permissions` (string): A short string representing the current user's permissions.  Can be `r`,`w`,`p`, or any combination
+* `permissions` (string): A short string representing the current user's permissions.  Can be `r`,`w`,`d`, `l` or any combination
 * `subfolders_locked?` (boolean): Are subfolders locked and unable to be modified?
 * `download_uri` (string): Link to download file. Provided only in response to a download request.
 * `priority_color` (string): Bookmark/priority color of file/folder

data/docs/folder.md

@@ -19,7 +19,7 @@ Files::Dir is an alias of Files::Folder
   "md5": "17c54824e9931a4688ca032d03f6663c",
   "mime_type": "application/octet-stream",
   "region": "us-east-1",
-  "permissions": "rpw",
+  "permissions": "rwd",
   "subfolders_locked?": true,
   "download_uri": "https://mysite.files.com/...",
   "priority_color": "red",
@@ -44,7 +44,7 @@ Files::Dir is an alias of Files::Folder
 * `md5` (string): File MD5 checksum. This is sometimes delayed, so if you get a blank response, wait and try again.
 * `mime_type` (string): MIME Type.  This is determined by the filename extension and is not stored separately internally.
 * `region` (string): Region location
-* `permissions` (string): A short string representing the current user's permissions.  Can be `r`,`w`,`p`, or any combination
+* `permissions` (string): A short string representing the current user's permissions.  Can be `r`,`w`,`d`, `l` or any combination
 * `subfolders_locked?` (boolean): Are subfolders locked and unable to be modified?
 * `download_uri` (string): Link to download file. Provided only in response to a download request.
 * `priority_color` (string): Bookmark/priority color of file/folder

data/docs/session.md

@@ -20,6 +20,7 @@
   "allowed_2fa_method_sms": true,
   "allowed_2fa_method_totp": true,
   "allowed_2fa_method_u2f": true,
+  "allowed_2fa_method_webauthn": true,
   "allowed_2fa_method_yubi": true,
   "use_provided_modified_at": true,
   "windows_mode_ftp": true
@@ -42,6 +43,7 @@
 * `allowed_2fa_method_sms` (boolean): Sent only if 2FA setup is needed. Is SMS two factor authentication allowed?
 * `allowed_2fa_method_totp` (boolean): Sent only if 2FA setup is needed. Is TOTP two factor authentication allowed?
 * `allowed_2fa_method_u2f` (boolean): Sent only if 2FA setup is needed. Is U2F two factor authentication allowed?
+* `allowed_2fa_method_webauthn` (boolean): Sent only if 2FA setup is needed. Is WebAuthn two factor authentication allowed?
 * `allowed_2fa_method_yubi` (boolean): Sent only if 2FA setup is needed. Is Yubikey two factor authentication allowed?
 * `use_provided_modified_at` (boolean): Allow the user to provide file/folder modified at dates?  If false, the server will always use the current date/time.
 * `windows_mode_ftp` (boolean): Does this user want to use Windows line-ending emulation?  (CR vs CRLF)

data/docs/settings_change.md

@@ -4,7 +4,6 @@
 
 ```
 {
-  "change_details": "{ domain: [\"olddomain.com', \"newdomain.com\"] }",
   "changes": [
     ""
   ],
@@ -13,7 +12,6 @@
 }
 ```
 
-* `change_details` (object): Specifics on what changed.
 * `changes` (string): Markdown-formatted change messages.
 * `created_at` (date-time): The time this change was made
 * `user_id` (int64): The user id responsible for this change

data/docs/site.md

@@ -8,6 +8,7 @@
   "allowed_2fa_method_sms": true,
   "allowed_2fa_method_totp": true,
   "allowed_2fa_method_u2f": true,
+  "allowed_2fa_method_webauthn": true,
   "allowed_2fa_method_yubi": true,
   "admin_user_id": 1,
   "allow_bundle_names": true,
@@ -130,6 +131,7 @@
     "allowed_2fa_method_sms": true,
     "allowed_2fa_method_totp": true,
     "allowed_2fa_method_u2f": true,
+    "allowed_2fa_method_webauthn": true,
     "allowed_2fa_method_yubi": true,
     "use_provided_modified_at": true,
     "windows_mode_ftp": false
@@ -226,6 +228,7 @@
 * `allowed_2fa_method_sms` (boolean): Is SMS two factor authentication allowed?
 * `allowed_2fa_method_totp` (boolean): Is TOTP two factor authentication allowed?
 * `allowed_2fa_method_u2f` (boolean): Is U2F two factor authentication allowed?
+* `allowed_2fa_method_webauthn` (boolean): Is WebAuthn two factor authentication allowed?
 * `allowed_2fa_method_yubi` (boolean): Is yubikey two factor authentication allowed?
 * `admin_user_id` (int64): User ID for the main site administrator
 * `allow_bundle_names` (boolean): Are manual Bundle names allowed?
@@ -439,6 +442,7 @@ Files::Site.update(
   allowed_2fa_method_sms: true, 
   allowed_2fa_method_u2f: true, 
   allowed_2fa_method_totp: true, 
+  allowed_2fa_method_webauthn: true, 
   allowed_2fa_method_yubi: true, 
   require_2fa: true, 
   require_2fa_user_type: "`site_admins`", 
@@ -545,6 +549,7 @@ Files::Site.update(
 * `allowed_2fa_method_sms` (boolean): Is SMS two factor authentication allowed?
 * `allowed_2fa_method_u2f` (boolean): Is U2F two factor authentication allowed?
 * `allowed_2fa_method_totp` (boolean): Is TOTP two factor authentication allowed?
+* `allowed_2fa_method_webauthn` (boolean): Is WebAuthn two factor authentication allowed?
 * `allowed_2fa_method_yubi` (boolean): Is yubikey two factor authentication allowed?
 * `require_2fa` (boolean): Require two-factor authentication for all users?
 * `require_2fa_user_type` (string): What type of user is required to use two-factor authentication (when require_2fa is set to `true` for this site)?

data/docs/usage_daily_snapshot.md

@@ -6,7 +6,14 @@
 {
   "id": 1,
   "date": "2020-11-21",
+  "api_usage_available": true,
+  "read_api_usage": "100",
+  "write_api_usage": "50",
+  "user_count": "25",
   "current_storage": "65536",
+  "deleted_files_storage": "65536",
+  "deleted_files_counted_in_minimum": "65536",
+  "root_storage": "65536",
   "usage_by_top_level_dir": [
 
   ]
@@ -15,7 +22,14 @@
 
 * `id` (int64): ID of the usage record
 * `date` (date): The date of this usage record
-* `current_storage` (int64): The quantity of storage held for this site
+* `api_usage_available` (boolean): True if the API usage fields `read_api_usage` and `write_api_usage` can be relied upon.  If this is false, we suggest hiding that value from any UI.
+* `read_api_usage` (int64): Read API Calls used on this day. Note: only updated for days before the current day.
+* `write_api_usage` (int64): Write API Calls used on this day. Note: only updated for days before the current day.
+* `user_count` (int64): Number of billable users as of this day.
+* `current_storage` (int64): GB of Files Native Storage used on this day.
+* `deleted_files_storage` (int64): GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
+* `deleted_files_counted_in_minimum` (int64): GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
+* `root_storage` (int64): GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
 * `usage_by_top_level_dir` (array): Usage broken down by each top-level folder
 
 

data/docs/usage_snapshot.md

@@ -17,24 +17,34 @@
   "usage_by_top_level_dir": "",
   "root_storage": 1.0,
   "deleted_files_counted_in_minimum": 1.0,
-  "deleted_files_storage": 1.0
+  "deleted_files_storage": 1.0,
+  "total_billable_usage": 1.0,
+  "total_billable_transfer_usage": 1.0,
+  "bytes_sent": 1.0,
+  "sync_bytes_received": 1.0,
+  "sync_bytes_sent": 1.0
 }
 ```
 
-* `id` (int64): Site usage ID
-* `start_at` (date-time): Site usage report start date/time
-* `end_at` (date-time): Site usage report end date/time
-* `created_at` (date-time): Site usage report created at date/time
-* `high_water_user_count` (double): Site usage report highest usage in time period
-* `current_storage` (double): Current site usage as of report
-* `high_water_storage` (double): Site usage report highest usage in time period
-* `total_downloads` (int64): Number of downloads in report time period
-* `total_uploads` (int64): Number of uploads in time period
-* `updated_at` (date-time): The last time this site usage report was updated
-* `usage_by_top_level_dir` (object): A map of root folders to their total usage
-* `root_storage` (double): Usage for root folder
-* `deleted_files_counted_in_minimum` (double): Usage for files that are deleted but uploaded within last 30 days
-* `deleted_files_storage` (double): Usage for files that are deleted but retained as backups
+* `id` (int64): Usage snapshot ID
+* `start_at` (date-time): Usage snapshot start date/time
+* `end_at` (date-time): Usage snapshot end date/time
+* `created_at` (date-time): DEPRECATED: Usage snapshot created at date/time
+* `high_water_user_count` (double): Highest user count number in time period
+* `current_storage` (double): Current total Storage Usage GB as of end date (not necessarily high water mark, which is used for billing)
+* `high_water_storage` (double): Highest Storage Usage GB recorded in time period (used for billing)
+* `total_downloads` (int64): DEPRECATED: Number of downloads in report time period
+* `total_uploads` (int64): DEPRECATED: Number of uploads in time period
+* `updated_at` (date-time): DEPRECATED: The last time this site usage report was updated
+* `usage_by_top_level_dir` (object): Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
+* `root_storage` (double): Storage Usage for root folder as of end date (not necessarily high water mark, which is used for billing)
+* `deleted_files_counted_in_minimum` (double): Storage Usage for files that are deleted but uploaded within last 30 days as of end date (not necessarily high water mark, which is used for billing)
+* `deleted_files_storage` (double): Storage Usage for files that are deleted but retained as backups as of end date (not necessarily high water mark, which is used for billing)
+* `total_billable_usage` (double): Storage + Transfer Usage - Total Billable amount
+* `total_billable_transfer_usage` (double): Transfer usage for period - Total Billable amount
+* `bytes_sent` (double): Transfer Usage for period - Outbound GB from Files Native Storage
+* `sync_bytes_received` (double): Transfer Usage for period - Inbound GB to Remote Servers (Sync/Mount)
+* `sync_bytes_sent` (double): Transfer Usage for period - Outbound GB from Remote Servers (Sync/Mount)
 
 
 ---

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

@@ -682,7 +682,7 @@ module Files
       @attributes[:region] = value
     end
 
-    # string - A short string representing the current user's permissions.  Can be `r`,`w`,`p`, or any combination
+    # string - A short string representing the current user's permissions.  Can be `r`,`w`,`d`, `l` or any combination
     def permissions
       @attributes[:permissions]
     end

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

@@ -240,7 +240,7 @@ module Files
       @attributes[:region] = value
     end
 
-    # string - A short string representing the current user's permissions.  Can be `r`,`w`,`p`, or any combination
+    # string - A short string representing the current user's permissions.  Can be `r`,`w`,`d`, `l` or any combination
     def permissions
       @attributes[:permissions]
     end

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

@@ -157,6 +157,15 @@ module Files
       @attributes[:allowed_2fa_method_u2f] = value
     end
 
+    # boolean - Sent only if 2FA setup is needed. Is WebAuthn two factor authentication allowed?
+    def allowed_2fa_method_webauthn
+      @attributes[:allowed_2fa_method_webauthn]
+    end
+
+    def allowed_2fa_method_webauthn=(value)
+      @attributes[:allowed_2fa_method_webauthn] = value
+    end
+
     # boolean - Sent only if 2FA setup is needed. Is Yubikey two factor authentication allowed?
     def allowed_2fa_method_yubi
       @attributes[:allowed_2fa_method_yubi]

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

@@ -9,11 +9,6 @@ module Files
       @options = options || {}
     end
 
-    # object - Specifics on what changed.
-    def change_details
-      @attributes[:change_details]
-    end
-
     # string - Markdown-formatted change messages.
     def changes
       @attributes[:changes]

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

@@ -29,6 +29,11 @@ module Files
       @attributes[:allowed_2fa_method_u2f]
     end
 
+    # boolean - Is WebAuthn two factor authentication allowed?
+    def allowed_2fa_method_webauthn
+      @attributes[:allowed_2fa_method_webauthn]
+    end
+
     # boolean - Is yubikey two factor authentication allowed?
     def allowed_2fa_method_yubi
       @attributes[:allowed_2fa_method_yubi]
@@ -718,6 +723,7 @@ module Files
     #   allowed_2fa_method_sms - boolean - Is SMS two factor authentication allowed?
     #   allowed_2fa_method_u2f - boolean - Is U2F two factor authentication allowed?
     #   allowed_2fa_method_totp - boolean - Is TOTP two factor authentication allowed?
+    #   allowed_2fa_method_webauthn - boolean - Is WebAuthn two factor authentication allowed?
     #   allowed_2fa_method_yubi - boolean - Is yubikey two factor authentication allowed?
     #   require_2fa - boolean - Require two-factor authentication for all users?
     #   require_2fa_user_type - string - What type of user is required to use two-factor authentication (when require_2fa is set to `true` for this site)?

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

@@ -19,11 +19,46 @@ module Files
       @attributes[:date]
     end
 
-    # int64 - The quantity of storage held for this site
+    # boolean - True if the API usage fields `read_api_usage` and `write_api_usage` can be relied upon.  If this is false, we suggest hiding that value from any UI.
+    def api_usage_available
+      @attributes[:api_usage_available]
+    end
+
+    # int64 - Read API Calls used on this day. Note: only updated for days before the current day.
+    def read_api_usage
+      @attributes[:read_api_usage]
+    end
+
+    # int64 - Write API Calls used on this day. Note: only updated for days before the current day.
+    def write_api_usage
+      @attributes[:write_api_usage]
+    end
+
+    # int64 - Number of billable users as of this day.
+    def user_count
+      @attributes[:user_count]
+    end
+
+    # int64 - GB of Files Native Storage used on this day.
     def current_storage
       @attributes[:current_storage]
     end
 
+    # int64 - GB of Files Native Storage used on this day for files that have been deleted and are stored as backups.
+    def deleted_files_storage
+      @attributes[:deleted_files_storage]
+    end
+
+    # int64 - GB of Files Native Storage used on this day for files that have been permanently deleted but were uploaded less than 30 days ago, and are still billable.
+    def deleted_files_counted_in_minimum
+      @attributes[:deleted_files_counted_in_minimum]
+    end
+
+    # int64 - GB of Files Native Storage used for the root folder.  Included here because this value will not be part of `usage_by_top_level_dir`
+    def root_storage
+      @attributes[:root_storage]
+    end
+
     # array - Usage broken down by each top-level folder
     def usage_by_top_level_dir
       @attributes[:usage_by_top_level_dir]

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

@@ -9,76 +9,101 @@ module Files
       @options = options || {}
     end
 
-    # int64 - Site usage ID
+    # int64 - Usage snapshot ID
     def id
       @attributes[:id]
     end
 
-    # date-time - Site usage report start date/time
+    # date-time - Usage snapshot start date/time
     def start_at
       @attributes[:start_at]
     end
 
-    # date-time - Site usage report end date/time
+    # date-time - Usage snapshot end date/time
     def end_at
       @attributes[:end_at]
     end
 
-    # date-time - Site usage report created at date/time
+    # date-time - DEPRECATED: Usage snapshot created at date/time
     def created_at
       @attributes[:created_at]
     end
 
-    # double - Site usage report highest usage in time period
+    # double - Highest user count number in time period
     def high_water_user_count
       @attributes[:high_water_user_count]
     end
 
-    # double - Current site usage as of report
+    # double - Current total Storage Usage GB as of end date (not necessarily high water mark, which is used for billing)
     def current_storage
       @attributes[:current_storage]
     end
 
-    # double - Site usage report highest usage in time period
+    # double - Highest Storage Usage GB recorded in time period (used for billing)
     def high_water_storage
       @attributes[:high_water_storage]
     end
 
-    # int64 - Number of downloads in report time period
+    # int64 - DEPRECATED: Number of downloads in report time period
     def total_downloads
       @attributes[:total_downloads]
     end
 
-    # int64 - Number of uploads in time period
+    # int64 - DEPRECATED: Number of uploads in time period
     def total_uploads
       @attributes[:total_uploads]
     end
 
-    # date-time - The last time this site usage report was updated
+    # date-time - DEPRECATED: The last time this site usage report was updated
     def updated_at
       @attributes[:updated_at]
     end
 
-    # object - A map of root folders to their total usage
+    # object - Storage Usage - map of root folders to their usage as of end date (not necessarily high water mark, which is used for billing)
     def usage_by_top_level_dir
       @attributes[:usage_by_top_level_dir]
     end
 
-    # double - Usage for root folder
+    # double - Storage Usage for root folder as of end date (not necessarily high water mark, which is used for billing)
     def root_storage
       @attributes[:root_storage]
     end
 
-    # double - Usage for files that are deleted but uploaded within last 30 days
+    # double - Storage Usage for files that are deleted but uploaded within last 30 days as of end date (not necessarily high water mark, which is used for billing)
     def deleted_files_counted_in_minimum
       @attributes[:deleted_files_counted_in_minimum]
     end
 
-    # double - Usage for files that are deleted but retained as backups
+    # double - Storage Usage for files that are deleted but retained as backups as of end date (not necessarily high water mark, which is used for billing)
     def deleted_files_storage
       @attributes[:deleted_files_storage]
     end
 
+    # double - Storage + Transfer Usage - Total Billable amount
+    def total_billable_usage
+      @attributes[:total_billable_usage]
+    end
+
+    # double - Transfer usage for period - Total Billable amount
+    def total_billable_transfer_usage
+      @attributes[:total_billable_transfer_usage]
+    end
+
+    # double - Transfer Usage for period - Outbound GB from Files Native Storage
+    def bytes_sent
+      @attributes[:bytes_sent]
+    end
+
+    # double - Transfer Usage for period - Inbound GB to Remote Servers (Sync/Mount)
+    def sync_bytes_received
+      @attributes[:sync_bytes_received]
+    end
+
+    # double - Transfer Usage for period - Outbound GB from Remote Servers (Sync/Mount)
+    def sync_bytes_sent
+      @attributes[:sync_bytes_sent]
+    end
+
     # Parameters:
     #   cursor - string - Used for pagination.  Send a cursor value to resume an existing list from the point at which you left off.  Get a cursor from an existing list via either the X-Files-Cursor-Next header or the X-Files-Cursor-Prev header.
     #   per_page - int64 - Number of records to show per page.  (Max: 10,000, 1,000 or less is recommended).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.0.236
+  version: 1.0.240
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-28 00:00:00.000000000 Z
+date: 2022-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable