files.com 1.1.760 → 1.1.761

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 863eebcc7d0dfdd28d2ef610470ca2b796e28e0e6d32c4b8670ba423affe1e2a
4
- data.tar.gz: 9538a214f58b655770f68af638e7311b9a93a820bb31e9c7f26db40fba282019
3
+ metadata.gz: 70eb87b154c75bdd0e5e0b1400eaf10e2c7c375890c60a6ac19e37d43c1b1905
4
+ data.tar.gz: 11a8a18817d44f14e45cf0ad245eb8206e261fa4e08a244e50264ed29f2e1760
5
5
  SHA512:
6
- metadata.gz: 3672c8b78beb7952a2a00114bbafd782c7baf70bddc752e6bb4a097eaf0c4e9177de6ef006e51f7cbc13cbb8ee2ee2eed71b87f985691049f605b6def7e81c28
7
- data.tar.gz: 6068131aa6e7ef5e828bb41492f4f01dece6b2afe1ecaf8a0d1ad90f31d9dfaa9e644d72e7784d55aed7d0a8046dd9c047ee8cca887867b85258206d61f24289
6
+ metadata.gz: b7246637ce8c0a6757471590692615cbf7746911bc43691054e5a1752ff57a611fc420d8ccc02d4da8904c02a30afa57f0ed3270c86e27ab0f828f1a0db1dc4d
7
+ data.tar.gz: ac784118649ef9ed5b7421ad19a206d916bc716162af295319e5b7689e315d1f111f6d565ddaa974ee5c9faafbe919feef03dcf3f4f8b710a5345d89d5498a64
data/_VERSION CHANGED
@@ -1 +1 @@
1
- 1.1.760
1
+ 1.1.761
data/docs/restore.md CHANGED
@@ -31,7 +31,7 @@
31
31
  }
32
32
  ```
33
33
 
34
- * `earliest_date` (date-time): 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.
34
+ * `earliest_date` (date-time): 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.
35
35
  * `id` (int64): Restore Record ID.
36
36
  * `dirs_restored` (int64): Number of directories that were successfully restored.
37
37
  * `dirs_errored` (int64): Number of directories that were not able to be restored.
@@ -39,10 +39,10 @@
39
39
  * `files_restored` (int64): Number of files successfully restored.
40
40
  * `files_errored` (int64): Number of files that were not able to be restored.
41
41
  * `files_total` (int64): Total number of files processed.
42
- * `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.
43
- * `restoration_type` (string): Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
42
+ * `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.
43
+ * `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.
44
44
  * `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.
45
- * `restore_deleted_permissions` (boolean): If true, we will also restore any Permissions that match the same path prefix from the same dates.
45
+ * `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.
46
46
  * `users_restored` (int64): Number of users successfully restored (only present for `restoration_type=users`).
47
47
  * `users_errored` (int64): Number of users that failed to restore (only present for `restoration_type=users`).
48
48
  * `users_total` (int64): Total number of users processed (only present for `restoration_type=users`).
@@ -89,10 +89,10 @@ Files::Restore.create(
89
89
 
90
90
  ### Parameters
91
91
 
92
- * `earliest_date` (string): Required - 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.
93
- * `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.
94
- * `restoration_type` (string): Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
95
- * `restore_deleted_permissions` (boolean): If true, we will also restore any Permissions that match the same path prefix from the same dates.
92
+ * `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.
93
+ * `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.
94
+ * `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.
95
+ * `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.
96
96
  * `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.
97
97
  * `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.
98
98
  * `workspace_id` (int64): Workspace ID for a workspace-scoped restore. `0` means the default site-wide scope.
@@ -9,7 +9,7 @@ module Files
9
9
  @options = options || {}
10
10
  end
11
11
 
12
- # date-time - 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.
12
+ # date-time - 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.
13
13
  def earliest_date
14
14
  @attributes[:earliest_date]
15
15
  end
@@ -81,7 +81,7 @@ module Files
81
81
  @attributes[:files_total] = value
82
82
  end
83
83
 
84
- # 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.
84
+ # 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.
85
85
  def prefix
86
86
  @attributes[:prefix]
87
87
  end
@@ -90,7 +90,7 @@ module Files
90
90
  @attributes[:prefix] = value
91
91
  end
92
92
 
93
- # string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
93
+ # 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.
94
94
  def restoration_type
95
95
  @attributes[:restoration_type]
96
96
  end
@@ -108,7 +108,7 @@ module Files
108
108
  @attributes[:restore_in_place] = value
109
109
  end
110
110
 
111
- # boolean - If true, we will also restore any Permissions that match the same path prefix from the same dates.
111
+ # 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.
112
112
  def restore_deleted_permissions
113
113
  @attributes[:restore_deleted_permissions]
114
114
  end
@@ -239,10 +239,10 @@ module Files
239
239
  end
240
240
 
241
241
  # Parameters:
242
- # 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.
243
- # 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.
244
- # restoration_type - string - Type of restoration to perform. `files` restores deleted filesystem items. `users` restores deleted users and associated access/authentication records.
245
- # restore_deleted_permissions - boolean - If true, we will also restore any Permissions that match the same path prefix from the same dates.
242
+ # 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.
243
+ # 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.
244
+ # 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.
245
+ # 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.
246
246
  # 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.
247
247
  # 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.
248
248
  # workspace_id - int64 - Workspace ID for a workspace-scoped restore. `0` means the default site-wide scope.
@@ -1,5 +1,5 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  module Files
4
- VERSION = "1.1.760"
4
+ VERSION = "1.1.761"
5
5
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: files.com
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.1.760
4
+ version: 1.1.761
5
5
  platform: ruby
6
6
  authors:
7
7
  - files.com
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2026-09-30 00:00:00.000000000 Z
11
+ date: 2026-10-01 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: addressable