files.com 1.0.236 → 1.0.237

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 552519b04a1256d02139b97b36d9c2d398b0b35aa06e934380b2c0e6dbcc48a9
-  data.tar.gz: 57a407a420d4f2646937ae647022f8b0f1ba8e93e8f0a52fe5fd413f1ad5fd36
+  metadata.gz: c9b01ad36b460e0a396f659522c814ccdf52cf3bd0c233cd22152e04f512b8a0
+  data.tar.gz: 83f49c3285c98a4dcd7aab591ab5770734aff469057932379a8e4bd01212e282
 SHA512:
-  metadata.gz: fd27015305911d0ed20e1dca918c11113d44a93587e57dc6888176ec4fba12704a8cc74ad20d941c9b62e79eef13340ab19419c7b9cb0698aa76e08a8f8fcf03
-  data.tar.gz: 653f9efbd638f7b202974897bbc70ac6af3f910f85fdac4c6c6a188e40b1a25ad33de8bece0554dbe013531ec9c3a40c5a50714014255016828e97e911fcb9df
+  metadata.gz: e776d1997e2f912d06d97671c839c03179162002fd06a5e4e30df39c5054108ce5ea572ff87ae0890a6fbe90b4f88e12e0580966008a454a607bebddd2eba71d
+  data.tar.gz: 31957d31a4be647e5a847c7f8ddedcd53cc8abe0e12adb81e3ccccdd2343120c2e363a085cbbc3813613a8ff5876774f581d63c44fa81234c1cbb288965776ce

data/_VERSION

@@ -1 +1 @@
-1.0.236
+1.0.237

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/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.237
 platform: ruby
 authors:
 - files.com
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-01-28 00:00:00.000000000 Z
+date: 2022-01-31 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: addressable