files.com 1.1.669 → 1.1.671
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 +4 -4
- data/README.md +1 -0
- data/_VERSION +1 -1
- data/docs/account.md +155 -0
- data/docs/action_log.md +21 -1
- data/docs/action_notification_export_result.md +17 -0
- data/docs/action_webhook_failure.md +28 -0
- data/docs/agent_proxy_identity.md +49 -0
- data/docs/agent_proxy_identity_endpoint.md +11 -0
- data/docs/agent_proxy_identity_result.md +24 -0
- data/docs/agent_v2_auth.md +17 -0
- data/docs/ai_assistant_personality.md +14 -0
- data/docs/ai_task.md +14 -0
- data/docs/announcement.md +57 -0
- data/docs/api_key.md +27 -1
- data/docs/api_request_log.md +21 -1
- data/docs/app.md +15 -0
- data/docs/as2_incoming_message.md +18 -0
- data/docs/as2_outgoing_message.md +18 -0
- data/docs/as2_partner.md +14 -0
- data/docs/as2_station.md +14 -0
- data/docs/automation.md +22 -1
- data/docs/automation_log.md +21 -1
- data/docs/automation_run.md +19 -0
- data/docs/bandwidth_snapshot.md +18 -0
- data/docs/behavior.md +14 -0
- data/docs/blog_post.md +57 -0
- data/docs/bundle.md +50 -1
- data/docs/bundle_action.md +25 -0
- data/docs/bundle_download.md +23 -0
- data/docs/bundle_notification.md +19 -0
- data/docs/bundle_recipient.md +21 -0
- data/docs/bundle_recipient_registration.md +39 -0
- data/docs/bundle_registration.md +61 -0
- data/docs/certificate.md +258 -0
- data/docs/chat_session.md +14 -0
- data/docs/child_site.md +583 -0
- data/docs/child_site_management_policy.md +9 -0
- data/docs/clickwrap.md +13 -0
- data/docs/clickwrap_acceptance.md +30 -0
- data/docs/client_log.md +17 -0
- data/docs/crash_report.md +50 -0
- data/docs/custom_domain.md +13 -0
- data/docs/custom_domain_for_proxy.md +23 -0
- data/docs/desktop_configuration_profile.md +14 -0
- data/docs/dns_record.md +9 -0
- data/docs/email_incoming_message.md +19 -0
- data/docs/email_log.md +20 -1
- data/docs/email_preference.md +108 -0
- data/docs/email_preference_bundle_notification.md +15 -0
- data/docs/email_preference_notification.md +17 -0
- data/docs/event_channel.md +14 -0
- data/docs/event_delivery_attempt.md +14 -0
- data/docs/event_record.md +19 -0
- data/docs/event_subscription.md +14 -0
- data/docs/event_target.md +14 -0
- data/docs/exavault_api_request_log.md +21 -1
- data/docs/expectation.md +14 -0
- data/docs/expectation_evaluation.md +14 -0
- data/docs/expectation_incident.md +14 -0
- data/docs/export.md +90 -0
- data/docs/external_event.md +18 -0
- data/docs/file.md +90 -2
- data/docs/file_migration.md +32 -0
- data/docs/file_migration_log.md +20 -1
- data/docs/file_upload_part.md +3 -1
- data/docs/folder.md +20 -0
- data/docs/form_field_set.md +15 -0
- data/docs/front_end_server.md +111 -0
- data/docs/frontend_metric.md +34 -0
- data/docs/ftp_action_log.md +21 -1
- data/docs/gpg_key.md +21 -0
- data/docs/group.md +19 -0
- data/docs/group_user.md +22 -2
- data/docs/history.md +85 -0
- data/docs/history_export_result.md +17 -0
- data/docs/holiday_region.md +9 -0
- data/docs/inbound_s3_log.md +21 -1
- data/docs/inbox.md +102 -0
- data/docs/inbox_recipient.md +19 -0
- data/docs/inbox_recipient_registration.md +35 -0
- data/docs/inbox_registration.md +57 -0
- data/docs/inbox_upload.md +18 -0
- data/docs/invoice.md +9 -0
- data/docs/ip.md +63 -0
- data/docs/ip_abuse_entry.md +47 -0
- data/docs/ip_address.md +59 -0
- data/docs/key_lifecycle_rule.md +14 -0
- data/docs/label.md +9 -0
- data/docs/lead.md +161 -0
- data/docs/lock.md +15 -0
- data/docs/message.md +17 -0
- data/docs/message_comment.md +18 -0
- data/docs/message_comment_reaction.md +18 -0
- data/docs/message_reaction.md +17 -0
- data/docs/metadata_category.md +13 -0
- data/docs/monitoring_stat.md +38 -0
- data/docs/monitoring_stats.md +15 -0
- data/docs/mover_package.md +68 -0
- data/docs/notification.md +20 -0
- data/docs/nps_response.md +75 -0
- data/docs/oauth_redirect.md +11 -0
- data/docs/outbound_connection_log.md +21 -1
- data/docs/paired_api_key.md +19 -0
- data/docs/partner.md +14 -0
- data/docs/partner_channel.md +14 -0
- data/docs/partner_site_request.md +14 -0
- data/docs/payment.md +9 -0
- data/docs/paypal_express_info.md +31 -0
- data/docs/paypal_express_url.md +11 -0
- data/docs/pending_work_event.md +18 -0
- data/docs/permission.md +22 -0
- data/docs/plan.md +107 -0
- data/docs/preview.md +57 -0
- data/docs/project.md +9 -0
- data/docs/public_hosting_request_log.md +21 -1
- data/docs/public_hosting_session_pairing.md +15 -0
- data/docs/public_inbox.md +121 -0
- data/docs/public_key.md +21 -0
- data/docs/public_url.md +59 -0
- data/docs/regional_migration.md +0 -0
- data/docs/release.md +83 -0
- data/docs/release_package.md +19 -0
- data/docs/remote_bandwidth_snapshot.md +18 -0
- data/docs/remote_mount_backend.md +13 -0
- data/docs/remote_server.md +233 -0
- data/docs/remote_server_credential.md +15 -0
- data/docs/request.md +17 -0
- data/docs/restore.md +14 -0
- data/docs/revision.md +40 -0
- data/docs/safe_plan.md +0 -0
- data/docs/scheduled_export.md +15 -0
- data/docs/scim_log.md +13 -0
- data/docs/session.md +232 -1
- data/docs/session_available_site.md +26 -0
- data/docs/setting.md +33 -0
- data/docs/settings.md +498 -0
- data/docs/settings_change.md +16 -0
- data/docs/sftp_action_log.md +21 -1
- data/docs/sftp_host_key.md +9 -0
- data/docs/share_group.md +15 -0
- data/docs/siem_http_destination.md +9 -0
- data/docs/siem_http_destination_event.md +18 -0
- data/docs/site.md +179 -0
- data/docs/site_subdomain_redirect.md +13 -0
- data/docs/snapshot.md +9 -0
- data/docs/ssl_certificate.md +37 -0
- data/docs/sso_event.md +19 -0
- data/docs/sso_strategy.md +406 -0
- data/docs/staging_site.md +591 -0
- data/docs/support_request.md +126 -0
- data/docs/sync.md +14 -0
- data/docs/sync_api_usage_snapshot.md +23 -0
- data/docs/sync_api_usage_snapshot_report.md +71 -0
- data/docs/sync_bandwidth_snapshot.md +48 -0
- data/docs/sync_log.md +20 -1
- data/docs/sync_run.md +21 -0
- data/docs/two_factor_authentication_method.md +169 -0
- data/docs/usage_daily_snapshot.md +18 -0
- data/docs/usage_snapshot.md +9 -0
- data/docs/user.md +49 -2
- data/docs/user_cipher_use.md +21 -0
- data/docs/user_lifecycle_rule.md +14 -0
- data/docs/user_request.md +9 -0
- data/docs/user_security_event.md +18 -0
- data/docs/user_sftp_client_use.md +15 -0
- data/docs/warning.md +36 -0
- data/docs/web_dav_action_log.md +21 -1
- data/docs/webauthn_sign_request.md +13 -0
- data/docs/workspace.md +15 -0
- data/docs/zip_download.md +32 -0
- data/docs/zip_download_file.md +45 -0
- data/docs/zip_download_files.md +23 -0
- data/lib/files.com/errors.rb +1 -0
- data/lib/files.com/models/account.rb +346 -0
- data/lib/files.com/models/action_log.rb +24 -0
- data/lib/files.com/models/action_notification_export_result.rb +12 -0
- data/lib/files.com/models/action_webhook_failure.rb +34 -0
- data/lib/files.com/models/agent_proxy_identity.rb +47 -0
- data/lib/files.com/models/agent_proxy_identity_endpoint.rb +17 -0
- data/lib/files.com/models/agent_proxy_identity_result.rb +27 -0
- data/lib/files.com/models/agent_v2_auth.rb +32 -0
- data/lib/files.com/models/ai_assistant_personality.rb +11 -0
- data/lib/files.com/models/ai_task.rb +11 -0
- data/lib/files.com/models/announcement.rb +89 -0
- data/lib/files.com/models/api_key.rb +39 -5
- data/lib/files.com/models/api_request_log.rb +24 -0
- data/lib/files.com/models/app.rb +13 -0
- data/lib/files.com/models/as2_incoming_message.rb +19 -0
- data/lib/files.com/models/as2_outgoing_message.rb +19 -0
- data/lib/files.com/models/as2_partner.rb +11 -0
- data/lib/files.com/models/as2_station.rb +11 -0
- data/lib/files.com/models/automation.rb +30 -0
- data/lib/files.com/models/automation_log.rb +24 -0
- data/lib/files.com/models/automation_run.rb +16 -0
- data/lib/files.com/models/bandwidth_snapshot.rb +19 -0
- data/lib/files.com/models/behavior.rb +11 -0
- data/lib/files.com/models/blog_post.rb +84 -0
- data/lib/files.com/models/bundle.rb +52 -0
- data/lib/files.com/models/bundle_action.rb +25 -0
- data/lib/files.com/models/bundle_download.rb +23 -0
- data/lib/files.com/models/bundle_notification.rb +15 -0
- data/lib/files.com/models/bundle_recipient.rb +27 -0
- data/lib/files.com/models/bundle_recipient_registration.rb +105 -0
- data/lib/files.com/models/bundle_registration.rb +125 -0
- data/lib/files.com/models/certificate.rb +455 -0
- data/lib/files.com/models/chat_session.rb +11 -0
- data/lib/files.com/models/child_site.rb +1756 -0
- data/lib/files.com/models/child_site_management_policy.rb +5 -0
- data/lib/files.com/models/clickwrap.rb +9 -0
- data/lib/files.com/models/clickwrap_acceptance.rb +56 -0
- data/lib/files.com/models/client_log.rb +25 -0
- data/lib/files.com/models/crash_report.rb +151 -0
- data/lib/files.com/models/custom_domain.rb +9 -0
- data/lib/files.com/models/custom_domain_for_proxy.rb +47 -0
- data/lib/files.com/models/desktop_configuration_profile.rb +11 -0
- data/lib/files.com/models/dns_record.rb +5 -0
- data/lib/files.com/models/email_incoming_message.rb +21 -0
- data/lib/files.com/models/email_log.rb +22 -0
- data/lib/files.com/models/email_preference.rb +124 -0
- data/lib/files.com/models/email_preference_bundle_notification.rb +27 -0
- data/lib/files.com/models/email_preference_notification.rb +32 -0
- data/lib/files.com/models/event_channel.rb +11 -0
- data/lib/files.com/models/event_delivery_attempt.rb +11 -0
- data/lib/files.com/models/event_record.rb +21 -0
- data/lib/files.com/models/event_subscription.rb +11 -0
- data/lib/files.com/models/event_target.rb +11 -0
- data/lib/files.com/models/exavault_api_request_log.rb +24 -0
- data/lib/files.com/models/expectation.rb +11 -0
- data/lib/files.com/models/expectation_evaluation.rb +11 -0
- data/lib/files.com/models/expectation_incident.rb +11 -0
- data/lib/files.com/models/export.rb +153 -0
- data/lib/files.com/models/external_event.rb +19 -0
- data/lib/files.com/models/file.rb +207 -0
- data/lib/files.com/models/file_migration.rb +27 -0
- data/lib/files.com/models/file_migration_log.rb +22 -0
- data/lib/files.com/models/file_upload_part.rb +5 -0
- data/lib/files.com/models/folder.rb +69 -0
- data/lib/files.com/models/form_field_set.rb +9 -0
- data/lib/files.com/models/front_end_server.rb +335 -0
- data/lib/files.com/models/frontend_metric.rb +65 -0
- data/lib/files.com/models/ftp_action_log.rb +24 -0
- data/lib/files.com/models/gpg_key.rb +21 -0
- data/lib/files.com/models/group.rb +16 -0
- data/lib/files.com/models/group_user.rb +21 -1
- data/lib/files.com/models/history.rb +94 -0
- data/lib/files.com/models/history_export_result.rb +12 -0
- data/lib/files.com/models/holiday_region.rb +5 -0
- data/lib/files.com/models/inbound_s3_log.rb +24 -0
- data/lib/files.com/models/inbox.rb +123 -0
- data/lib/files.com/models/inbox_recipient.rb +25 -0
- data/lib/files.com/models/inbox_recipient_registration.rb +87 -0
- data/lib/files.com/models/inbox_registration.rb +121 -0
- data/lib/files.com/models/inbox_upload.rb +19 -0
- data/lib/files.com/models/invoice.rb +5 -0
- data/lib/files.com/models/ip.rb +82 -0
- data/lib/files.com/models/ip_abuse_entry.rb +96 -0
- data/lib/files.com/models/ip_address.rb +37 -0
- data/lib/files.com/models/key_lifecycle_rule.rb +11 -0
- data/lib/files.com/models/label.rb +22 -0
- data/lib/files.com/models/lead.rb +434 -0
- data/lib/files.com/models/lock.rb +27 -0
- data/lib/files.com/models/message.rb +12 -0
- data/lib/files.com/models/message_comment.rb +14 -0
- data/lib/files.com/models/message_comment_reaction.rb +14 -0
- data/lib/files.com/models/message_reaction.rb +12 -0
- data/lib/files.com/models/metadata_category.rb +9 -0
- data/lib/files.com/models/monitoring_stat.rb +43 -0
- data/lib/files.com/models/monitoring_stats.rb +22 -0
- data/lib/files.com/models/mover_package.rb +80 -0
- data/lib/files.com/models/notification.rb +18 -0
- data/lib/files.com/models/nps_response.rb +128 -0
- data/lib/files.com/models/oauth_redirect.rb +17 -0
- data/lib/files.com/models/outbound_connection_log.rb +24 -0
- data/lib/files.com/models/paired_api_key.rb +37 -0
- data/lib/files.com/models/partner.rb +11 -0
- data/lib/files.com/models/partner_channel.rb +11 -0
- data/lib/files.com/models/partner_site_request.rb +11 -0
- data/lib/files.com/models/payment.rb +5 -0
- data/lib/files.com/models/paypal_express_info.rb +67 -0
- data/lib/files.com/models/paypal_express_url.rb +17 -0
- data/lib/files.com/models/pending_work_event.rb +19 -0
- data/lib/files.com/models/permission.rb +22 -0
- data/lib/files.com/models/plan.rb +209 -0
- data/lib/files.com/models/preview.rb +57 -0
- data/lib/files.com/models/project.rb +5 -0
- data/lib/files.com/models/public_hosting_request_log.rb +24 -0
- data/lib/files.com/models/public_hosting_session_pairing.rb +27 -0
- data/lib/files.com/models/public_inbox.rb +142 -0
- data/lib/files.com/models/public_key.rb +21 -0
- data/lib/files.com/models/public_url.rb +177 -0
- data/lib/files.com/models/regional_migration.rb +12 -0
- data/lib/files.com/models/release.rb +153 -0
- data/lib/files.com/models/release_package.rb +37 -0
- data/lib/files.com/models/remote_bandwidth_snapshot.rb +19 -0
- data/lib/files.com/models/remote_mount_backend.rb +9 -0
- data/lib/files.com/models/remote_server.rb +297 -0
- data/lib/files.com/models/remote_server_credential.rb +13 -0
- data/lib/files.com/models/request.rb +12 -0
- data/lib/files.com/models/restore.rb +11 -0
- data/lib/files.com/models/revision.rb +53 -0
- data/lib/files.com/models/safe_plan.rb +12 -0
- data/lib/files.com/models/scheduled_export.rb +13 -0
- data/lib/files.com/models/scim_log.rb +9 -0
- data/lib/files.com/models/session.rb +493 -0
- data/lib/files.com/models/session_available_site.rb +47 -0
- data/lib/files.com/models/setting.rb +36 -0
- data/lib/files.com/models/settings.rb +1072 -0
- data/lib/files.com/models/settings_change.rb +16 -0
- data/lib/files.com/models/sftp_action_log.rb +24 -0
- data/lib/files.com/models/sftp_host_key.rb +5 -0
- data/lib/files.com/models/share_group.rb +9 -0
- data/lib/files.com/models/siem_http_destination.rb +5 -0
- data/lib/files.com/models/siem_http_destination_event.rb +19 -0
- data/lib/files.com/models/site.rb +1021 -0
- data/lib/files.com/models/site_subdomain_redirect.rb +9 -0
- data/lib/files.com/models/snapshot.rb +5 -0
- data/lib/files.com/models/ssl_certificate.rb +77 -0
- data/lib/files.com/models/sso_event.rb +21 -0
- data/lib/files.com/models/sso_strategy.rb +632 -0
- data/lib/files.com/models/staging_site.rb +1781 -0
- data/lib/files.com/models/support_request.rb +209 -0
- data/lib/files.com/models/sync.rb +11 -0
- data/lib/files.com/models/sync_api_usage_snapshot.rb +47 -0
- data/lib/files.com/models/sync_api_usage_snapshot_report.rb +162 -0
- data/lib/files.com/models/sync_bandwidth_snapshot.rb +104 -0
- data/lib/files.com/models/sync_log.rb +22 -0
- data/lib/files.com/models/sync_run.rb +21 -0
- data/lib/files.com/models/two_factor_authentication_method.rb +250 -0
- data/lib/files.com/models/usage_daily_snapshot.rb +19 -0
- data/lib/files.com/models/usage_snapshot.rb +5 -0
- data/lib/files.com/models/user.rb +59 -0
- data/lib/files.com/models/user_cipher_use.rb +21 -0
- data/lib/files.com/models/user_lifecycle_rule.rb +11 -0
- data/lib/files.com/models/user_request.rb +5 -0
- data/lib/files.com/models/user_security_event.rb +19 -0
- data/lib/files.com/models/user_sftp_client_use.rb +9 -0
- data/lib/files.com/models/warning.rb +38 -0
- data/lib/files.com/models/web_dav_action_log.rb +24 -0
- data/lib/files.com/models/webauthn_sign_request.rb +17 -0
- data/lib/files.com/models/workspace.rb +13 -0
- data/lib/files.com/models/zip_download.rb +73 -0
- data/lib/files.com/models/zip_download_file.rb +111 -0
- data/lib/files.com/models/zip_download_files.rb +42 -0
- data/lib/files.com/version.rb +1 -1
- data/lib/files.com.rb +59 -0
- metadata +120 -2
data/docs/file.md
CHANGED
|
@@ -7,7 +7,9 @@ may places where a Ruby File object can be used.
|
|
|
7
7
|
|
|
8
8
|
```
|
|
9
9
|
{
|
|
10
|
+
"id": 1,
|
|
10
11
|
"path": "path/file.txt",
|
|
12
|
+
"path_absolute": "path/file.txt",
|
|
11
13
|
"created_by_id": 1,
|
|
12
14
|
"created_by_api_key_id": 1,
|
|
13
15
|
"created_by_as2_incoming_message_id": 1,
|
|
@@ -40,6 +42,14 @@ may places where a Ruby File object can be used.
|
|
|
40
42
|
"permissions": "rwd",
|
|
41
43
|
"subfolders_locked?": true,
|
|
42
44
|
"is_locked": true,
|
|
45
|
+
"remote_server_id": 1,
|
|
46
|
+
"headers": {
|
|
47
|
+
"key": "example value"
|
|
48
|
+
},
|
|
49
|
+
"socks_ips": [
|
|
50
|
+
"example"
|
|
51
|
+
],
|
|
52
|
+
"internal_download_uri": "example",
|
|
43
53
|
"download_uri": "https://mysite.files.com/...",
|
|
44
54
|
"priority_color": "red",
|
|
45
55
|
"preview_id": 1,
|
|
@@ -53,7 +63,9 @@ may places where a Ruby File object can be used.
|
|
|
53
63
|
}
|
|
54
64
|
```
|
|
55
65
|
|
|
66
|
+
* `id` (int64): File/Folder ID. Used only for ExaVault compatibility API. Do not use for other purposes, as this value will not always be set.
|
|
56
67
|
* `path` (string): File/Folder path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
|
|
68
|
+
* `path_absolute` (string): File/Folder absolute path for Bundle Trusted Relay use
|
|
57
69
|
* `created_by_id` (int64): User ID of the User who created the file/folder
|
|
58
70
|
* `created_by_api_key_id` (int64): ID of the API key that created the file/folder
|
|
59
71
|
* `created_by_as2_incoming_message_id` (int64): ID of the AS2 Incoming Message that created the file/folder
|
|
@@ -84,20 +96,33 @@ may places where a Ruby File object can be used.
|
|
|
84
96
|
* `permissions` (string): A short string representing the current user's permissions. Can be `r` (Read),`w` (Write),`d` (Delete), `l` (List) or any combination
|
|
85
97
|
* `subfolders_locked?` (boolean): Are subfolders locked and unable to be modified?
|
|
86
98
|
* `is_locked` (boolean): Is this folder locked and unable to be modified?
|
|
99
|
+
* `remote_server_id` (int64): Used for internal bandwidth tracking
|
|
100
|
+
* `headers` (object): Used for internal url management
|
|
101
|
+
* `socks_ips` (array(string)): Used for internal url management
|
|
102
|
+
* `internal_download_uri` (string): For use with internal services and should also be with headers and socks_ips
|
|
87
103
|
* `download_uri` (string): Link to download file. Provided only in response to a download request.
|
|
88
104
|
* `priority_color` (string): Bookmark/priority color of file/folder
|
|
89
105
|
* `preview_id` (int64): File preview ID
|
|
90
106
|
* `preview` (Preview): File preview
|
|
107
|
+
* `copy_destination` (string):
|
|
108
|
+
* `move_destination` (string):
|
|
91
109
|
* `action` (string): The action to perform. Can be `append`, `attachment`, `end`, `upload`, `put`, or may not exist
|
|
110
|
+
* `action_attributes` (object): Attributes to pass through for recording the Action. Used for overriding action types (i.e. representing copy/move)
|
|
111
|
+
* `file` (object):
|
|
112
|
+
* `crc32b` (string):
|
|
92
113
|
* `length` (int64): Length of file.
|
|
93
114
|
* `mkdir_parents` (boolean): Create parent directories if they do not exist?
|
|
115
|
+
* `overwrite` (boolean): Overwrite existing file(s) in the destination?
|
|
94
116
|
* `part` (int64): Part if uploading a part.
|
|
95
117
|
* `parts` (int64): How many parts to fetch?
|
|
118
|
+
* `prefer_spdy` (boolean):
|
|
96
119
|
* `ref` (string):
|
|
97
120
|
* `restart` (int64): File byte offset to restart from.
|
|
98
121
|
* `copy_behaviors` (boolean): If copying a folder, also copy supported behaviors to the destination folder tree?
|
|
99
122
|
* `structure` (string): If copying folder, copy just the structure?
|
|
100
123
|
* `with_rename` (boolean): Allow file rename instead of overwrite?
|
|
124
|
+
* `inbox_registration_code` (string):
|
|
125
|
+
* `bundle_registration_code` (string):
|
|
101
126
|
* `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
|
|
102
127
|
|
|
103
128
|
|
|
@@ -107,8 +132,10 @@ may places where a Ruby File object can be used.
|
|
|
107
132
|
|
|
108
133
|
```
|
|
109
134
|
Files::File.download(path,
|
|
135
|
+
prefer_spdy: false,
|
|
110
136
|
with_previews: false,
|
|
111
|
-
with_priority_color: false
|
|
137
|
+
with_priority_color: false,
|
|
138
|
+
full_document_preview: false
|
|
112
139
|
)
|
|
113
140
|
```
|
|
114
141
|
|
|
@@ -116,9 +143,12 @@ Files::File.download(path,
|
|
|
116
143
|
|
|
117
144
|
* `path` (string): Required - Path to operate on.
|
|
118
145
|
* `action` (string): Can be blank, `redirect` or `stat`. If set to `stat`, we will return file information but without a download URL, and without logging a download. If set to `redirect` we will serve a 302 redirect directly to the file. This is used for integrations with Zapier, and is not recommended for most integrations.
|
|
146
|
+
* `bundle_registration_code` (string):
|
|
147
|
+
* `prefer_spdy` (boolean):
|
|
119
148
|
* `preview_size` (string): Request a preview size. Can be `small` (default), `large`, `xlarge`, or `pdf`.
|
|
120
149
|
* `with_previews` (boolean): Include file preview information?
|
|
121
150
|
* `with_priority_color` (boolean): Include file priority color information?
|
|
151
|
+
* `full_document_preview` (boolean): If true, always return a proxied download uri
|
|
122
152
|
|
|
123
153
|
|
|
124
154
|
---
|
|
@@ -127,12 +157,18 @@ Files::File.download(path,
|
|
|
127
157
|
|
|
128
158
|
```
|
|
129
159
|
Files::File.create(path,
|
|
160
|
+
crc32: "70976923",
|
|
130
161
|
length: 1,
|
|
162
|
+
md5: "17c54824e9931a4688ca032d03f6663c",
|
|
131
163
|
mkdir_parents: false,
|
|
164
|
+
overwrite: false,
|
|
132
165
|
part: 1,
|
|
133
166
|
parts: 1,
|
|
167
|
+
prefer_spdy: false,
|
|
134
168
|
provided_mtime: "2000-01-01T01:00:00Z",
|
|
135
169
|
restart: 1,
|
|
170
|
+
sha1: "a94a8fe5ccb19ba61c4c0873d391e987982fbbd3",
|
|
171
|
+
sha256: "9f86d081884c7d659a2feaa0c55ad015a3bf4f1b2b0b822cd15d6c15b0f00a08",
|
|
136
172
|
size: 1,
|
|
137
173
|
copy_behaviors: false,
|
|
138
174
|
with_rename: false,
|
|
@@ -143,20 +179,33 @@ Files::File.create(path,
|
|
|
143
179
|
### Parameters
|
|
144
180
|
|
|
145
181
|
* `path` (string): Required - Path to operate on.
|
|
182
|
+
* `copy_destination` (string):
|
|
183
|
+
* `move_destination` (string):
|
|
146
184
|
* `action` (string): The action to perform. Can be `append`, `attachment`, `end`, `upload`, `put`, or may not exist
|
|
185
|
+
* `action_attributes` (object): Attributes to pass through for recording the Action. Used for overriding action types (i.e. representing copy/move)
|
|
186
|
+
* `file` (object):
|
|
187
|
+
* `crc32` (string):
|
|
188
|
+
* `crc32b` (string):
|
|
147
189
|
* `etags[etag]` (array(string)): etag identifier.
|
|
148
190
|
* `etags[part]` (array(int64)): Part number.
|
|
149
191
|
* `length` (int64): Length of file.
|
|
192
|
+
* `md5` (string):
|
|
150
193
|
* `mkdir_parents` (boolean): Create parent directories if they do not exist?
|
|
194
|
+
* `overwrite` (boolean): Overwrite existing file(s) in the destination?
|
|
151
195
|
* `part` (int64): Part if uploading a part.
|
|
152
196
|
* `parts` (int64): How many parts to fetch?
|
|
197
|
+
* `prefer_spdy` (boolean):
|
|
153
198
|
* `provided_mtime` (string): User provided modification time.
|
|
154
199
|
* `ref` (string):
|
|
155
200
|
* `restart` (int64): File byte offset to restart from.
|
|
201
|
+
* `sha1` (string):
|
|
202
|
+
* `sha256` (string):
|
|
156
203
|
* `size` (int64): Size of file.
|
|
157
204
|
* `copy_behaviors` (boolean): If copying a folder, also copy supported behaviors to the destination folder tree?
|
|
158
205
|
* `structure` (string): If copying folder, copy just the structure?
|
|
159
206
|
* `with_rename` (boolean): Allow file rename instead of overwrite?
|
|
207
|
+
* `inbox_registration_code` (string):
|
|
208
|
+
* `bundle_registration_code` (string):
|
|
160
209
|
* `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
|
|
161
210
|
|
|
162
211
|
|
|
@@ -194,6 +243,26 @@ Files::File.delete(path,
|
|
|
194
243
|
|
|
195
244
|
* `path` (string): Required - Path to operate on.
|
|
196
245
|
* `recursive` (boolean): If true, will recursively delete folders. Otherwise, will error on non-empty folders.
|
|
246
|
+
* `bundle_registration_code` (string):
|
|
247
|
+
|
|
248
|
+
|
|
249
|
+
---
|
|
250
|
+
|
|
251
|
+
## Find File/Folder by ID
|
|
252
|
+
|
|
253
|
+
```
|
|
254
|
+
Files::File.find_id(id,
|
|
255
|
+
with_previews: false,
|
|
256
|
+
with_priority_color: false
|
|
257
|
+
)
|
|
258
|
+
```
|
|
259
|
+
|
|
260
|
+
### Parameters
|
|
261
|
+
|
|
262
|
+
* `id` (int64): Required - File/Folder ID
|
|
263
|
+
* `preview_size` (string): Request a preview size. Can be `small` (default), `large`, `xlarge`, or `pdf`.
|
|
264
|
+
* `with_previews` (boolean): Include file preview information?
|
|
265
|
+
* `with_priority_color` (boolean): Include file priority color information?
|
|
197
266
|
|
|
198
267
|
|
|
199
268
|
---
|
|
@@ -213,6 +282,7 @@ Files::File.find(path,
|
|
|
213
282
|
* `preview_size` (string): Request a preview size. Can be `small` (default), `large`, `xlarge`, or `pdf`.
|
|
214
283
|
* `with_previews` (boolean): Include file preview information?
|
|
215
284
|
* `with_priority_color` (boolean): Include file priority color information?
|
|
285
|
+
* `bundle_registration_code` (string):
|
|
216
286
|
|
|
217
287
|
|
|
218
288
|
---
|
|
@@ -248,6 +318,7 @@ Files::File.copy(path,
|
|
|
248
318
|
* `copy_behaviors` (boolean): If copying a folder, also copy supported behaviors to the destination folder tree?
|
|
249
319
|
* `structure` (boolean): Copy structure only?
|
|
250
320
|
* `overwrite` (boolean): Overwrite existing file(s) in the destination?
|
|
321
|
+
* `bundle_registration_code` (string):
|
|
251
322
|
|
|
252
323
|
|
|
253
324
|
---
|
|
@@ -266,6 +337,7 @@ Files::File.move(path,
|
|
|
266
337
|
* `path` (string): Required - Path to operate on.
|
|
267
338
|
* `destination` (string): Required - Move destination path.
|
|
268
339
|
* `overwrite` (boolean): Overwrite existing file(s) in the destination?
|
|
340
|
+
* `bundle_registration_code` (string):
|
|
269
341
|
|
|
270
342
|
|
|
271
343
|
---
|
|
@@ -392,6 +464,7 @@ Files::File.begin_upload(path,
|
|
|
392
464
|
mkdir_parents: false,
|
|
393
465
|
part: 1,
|
|
394
466
|
parts: 1,
|
|
467
|
+
prefer_spdy: false,
|
|
395
468
|
ref: "upload-1",
|
|
396
469
|
restart: 1,
|
|
397
470
|
size: 1,
|
|
@@ -406,10 +479,13 @@ Files::File.begin_upload(path,
|
|
|
406
479
|
* `mkdir_parents` (boolean): Create parent directories if they do not exist?
|
|
407
480
|
* `part` (int64): Part if uploading a part.
|
|
408
481
|
* `parts` (int64): How many parts to fetch?
|
|
482
|
+
* `prefer_spdy` (boolean):
|
|
409
483
|
* `ref` (string):
|
|
410
484
|
* `restart` (int64): File byte offset to restart from.
|
|
411
485
|
* `size` (int64): Total bytes of file being uploaded (include bytes being retained if appending/restarting).
|
|
412
486
|
* `with_rename` (boolean): Allow file rename instead of overwrite?
|
|
487
|
+
* `action` (string):
|
|
488
|
+
* `bundle_registration_code` (string):
|
|
413
489
|
* `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
|
|
414
490
|
|
|
415
491
|
|
|
@@ -421,8 +497,10 @@ Files::File.begin_upload(path,
|
|
|
421
497
|
file = Files::File.find(path)
|
|
422
498
|
|
|
423
499
|
file.download(
|
|
500
|
+
prefer_spdy: false,
|
|
424
501
|
with_previews: false,
|
|
425
|
-
with_priority_color: false
|
|
502
|
+
with_priority_color: false,
|
|
503
|
+
full_document_preview: false
|
|
426
504
|
)
|
|
427
505
|
```
|
|
428
506
|
|
|
@@ -430,9 +508,12 @@ file.download(
|
|
|
430
508
|
|
|
431
509
|
* `path` (string): Required - Path to operate on.
|
|
432
510
|
* `action` (string): Can be blank, `redirect` or `stat`. If set to `stat`, we will return file information but without a download URL, and without logging a download. If set to `redirect` we will serve a 302 redirect directly to the file. This is used for integrations with Zapier, and is not recommended for most integrations.
|
|
511
|
+
* `bundle_registration_code` (string):
|
|
512
|
+
* `prefer_spdy` (boolean):
|
|
433
513
|
* `preview_size` (string): Request a preview size. Can be `small` (default), `large`, `xlarge`, or `pdf`.
|
|
434
514
|
* `with_previews` (boolean): Include file preview information?
|
|
435
515
|
* `with_priority_color` (boolean): Include file priority color information?
|
|
516
|
+
* `full_document_preview` (boolean): If true, always return a proxied download uri
|
|
436
517
|
|
|
437
518
|
|
|
438
519
|
---
|
|
@@ -473,6 +554,7 @@ file.delete(
|
|
|
473
554
|
|
|
474
555
|
* `path` (string): Required - Path to operate on.
|
|
475
556
|
* `recursive` (boolean): If true, will recursively delete folders. Otherwise, will error on non-empty folders.
|
|
557
|
+
* `bundle_registration_code` (string):
|
|
476
558
|
|
|
477
559
|
|
|
478
560
|
---
|
|
@@ -512,6 +594,7 @@ file.copy(
|
|
|
512
594
|
* `copy_behaviors` (boolean): If copying a folder, also copy supported behaviors to the destination folder tree?
|
|
513
595
|
* `structure` (boolean): Copy structure only?
|
|
514
596
|
* `overwrite` (boolean): Overwrite existing file(s) in the destination?
|
|
597
|
+
* `bundle_registration_code` (string):
|
|
515
598
|
|
|
516
599
|
|
|
517
600
|
---
|
|
@@ -532,6 +615,7 @@ file.move(
|
|
|
532
615
|
* `path` (string): Required - Path to operate on.
|
|
533
616
|
* `destination` (string): Required - Move destination path.
|
|
534
617
|
* `overwrite` (boolean): Overwrite existing file(s) in the destination?
|
|
618
|
+
* `bundle_registration_code` (string):
|
|
535
619
|
|
|
536
620
|
|
|
537
621
|
---
|
|
@@ -649,6 +733,7 @@ file.begin_upload(
|
|
|
649
733
|
mkdir_parents: false,
|
|
650
734
|
part: 1,
|
|
651
735
|
parts: 1,
|
|
736
|
+
prefer_spdy: false,
|
|
652
737
|
ref: "upload-1",
|
|
653
738
|
restart: 1,
|
|
654
739
|
size: 1,
|
|
@@ -663,8 +748,11 @@ file.begin_upload(
|
|
|
663
748
|
* `mkdir_parents` (boolean): Create parent directories if they do not exist?
|
|
664
749
|
* `part` (int64): Part if uploading a part.
|
|
665
750
|
* `parts` (int64): How many parts to fetch?
|
|
751
|
+
* `prefer_spdy` (boolean):
|
|
666
752
|
* `ref` (string):
|
|
667
753
|
* `restart` (int64): File byte offset to restart from.
|
|
668
754
|
* `size` (int64): Total bytes of file being uploaded (include bytes being retained if appending/restarting).
|
|
669
755
|
* `with_rename` (boolean): Allow file rename instead of overwrite?
|
|
756
|
+
* `action` (string):
|
|
757
|
+
* `bundle_registration_code` (string):
|
|
670
758
|
* `buffered_upload` (boolean): If true, and the path refers to a destination not stored on Files.com (such as a remote server mount), the upload will be uploaded first to Files.com before being sent to the remote server mount. This can allow clients to upload using parallel parts to a remote server destination that does not offer parallel parts support natively.
|
data/docs/file_migration.md
CHANGED
|
@@ -29,6 +29,23 @@
|
|
|
29
29
|
* `log_url` (string): Link to download the log file for this migration.
|
|
30
30
|
|
|
31
31
|
|
|
32
|
+
---
|
|
33
|
+
|
|
34
|
+
## List in-progress file migrations. Returns the 10 most recently active migrations, after narrowing the list to remove overlapping operations
|
|
35
|
+
|
|
36
|
+
```
|
|
37
|
+
Files::FileMigration.list(
|
|
38
|
+
user_id: 1
|
|
39
|
+
)
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
### Parameters
|
|
43
|
+
|
|
44
|
+
* `user_id` (int64): User ID. Provide a value of `0` to operate the current session's user.
|
|
45
|
+
* `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.
|
|
46
|
+
* `per_page` (int64): Number of records to show per page. (Max: 10000, 1,000 or less is recommended).
|
|
47
|
+
|
|
48
|
+
|
|
32
49
|
---
|
|
33
50
|
|
|
34
51
|
## Show File Migration
|
|
@@ -40,3 +57,18 @@ Files::FileMigration.find(id)
|
|
|
40
57
|
### Parameters
|
|
41
58
|
|
|
42
59
|
* `id` (int64): Required - File Migration ID.
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
---
|
|
63
|
+
|
|
64
|
+
## List in-progress file migrations. Returns the 10 most recently active migrations, after narrowing the list to remove overlapping operations
|
|
65
|
+
|
|
66
|
+
```
|
|
67
|
+
Files::FileMigration.create_export(
|
|
68
|
+
user_id: 1
|
|
69
|
+
)
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### Parameters
|
|
73
|
+
|
|
74
|
+
* `user_id` (int64): User ID. Provide a value of `0` to operate the current session's user.
|
data/docs/file_migration_log.md
CHANGED
|
@@ -12,7 +12,8 @@
|
|
|
12
12
|
"operation": "example",
|
|
13
13
|
"path": "example",
|
|
14
14
|
"status": "example",
|
|
15
|
-
"created_at": "2000-01-01T01:00:00Z"
|
|
15
|
+
"created_at": "2000-01-01T01:00:00Z",
|
|
16
|
+
"log_type": "example"
|
|
16
17
|
}
|
|
17
18
|
```
|
|
18
19
|
|
|
@@ -25,6 +26,7 @@
|
|
|
25
26
|
* `path` (string): File path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
|
|
26
27
|
* `status` (string): Status
|
|
27
28
|
* `created_at` (date-time): Start Time of Action
|
|
29
|
+
* `log_type` (string): Log Type
|
|
28
30
|
|
|
29
31
|
|
|
30
32
|
---
|
|
@@ -44,3 +46,20 @@ Files::FileMigrationLog.list
|
|
|
44
46
|
* `filter_gteq` (object): If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. Valid field combinations are `[ file_migration_id ]`, `[ operation ]`, `[ status ]`, `[ type ]`, `[ created_at ]`, `[ file_migration_id, operation ]`, `[ file_migration_id, status ]`, `[ file_migration_id, type ]`, `[ file_migration_id, created_at ]`, `[ operation, status ]`, `[ operation, type ]`, `[ operation, created_at ]`, `[ status, type ]`, `[ status, created_at ]`, `[ type, created_at ]`, `[ file_migration_id, operation, status ]`, `[ file_migration_id, operation, type ]`, `[ file_migration_id, operation, created_at ]`, `[ file_migration_id, status, type ]`, `[ file_migration_id, status, created_at ]`, `[ file_migration_id, type, created_at ]`, `[ operation, status, type ]`, `[ operation, status, created_at ]`, `[ operation, type, created_at ]`, `[ status, type, created_at ]`, `[ file_migration_id, operation, status, type ]`, `[ file_migration_id, operation, status, created_at ]`, `[ file_migration_id, operation, type, created_at ]`, `[ file_migration_id, status, type, created_at ]`, `[ operation, status, type, created_at ]` or `[ file_migration_id, operation, status, type, created_at ]`.
|
|
45
47
|
* `filter_lt` (object): If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. Valid field combinations are `[ file_migration_id ]`, `[ operation ]`, `[ status ]`, `[ type ]`, `[ created_at ]`, `[ file_migration_id, operation ]`, `[ file_migration_id, status ]`, `[ file_migration_id, type ]`, `[ file_migration_id, created_at ]`, `[ operation, status ]`, `[ operation, type ]`, `[ operation, created_at ]`, `[ status, type ]`, `[ status, created_at ]`, `[ type, created_at ]`, `[ file_migration_id, operation, status ]`, `[ file_migration_id, operation, type ]`, `[ file_migration_id, operation, created_at ]`, `[ file_migration_id, status, type ]`, `[ file_migration_id, status, created_at ]`, `[ file_migration_id, type, created_at ]`, `[ operation, status, type ]`, `[ operation, status, created_at ]`, `[ operation, type, created_at ]`, `[ status, type, created_at ]`, `[ file_migration_id, operation, status, type ]`, `[ file_migration_id, operation, status, created_at ]`, `[ file_migration_id, operation, type, created_at ]`, `[ file_migration_id, status, type, created_at ]`, `[ operation, status, type, created_at ]` or `[ file_migration_id, operation, status, type, created_at ]`.
|
|
46
48
|
* `filter_lteq` (object): If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. Valid field combinations are `[ file_migration_id ]`, `[ operation ]`, `[ status ]`, `[ type ]`, `[ created_at ]`, `[ file_migration_id, operation ]`, `[ file_migration_id, status ]`, `[ file_migration_id, type ]`, `[ file_migration_id, created_at ]`, `[ operation, status ]`, `[ operation, type ]`, `[ operation, created_at ]`, `[ status, type ]`, `[ status, created_at ]`, `[ type, created_at ]`, `[ file_migration_id, operation, status ]`, `[ file_migration_id, operation, type ]`, `[ file_migration_id, operation, created_at ]`, `[ file_migration_id, status, type ]`, `[ file_migration_id, status, created_at ]`, `[ file_migration_id, type, created_at ]`, `[ operation, status, type ]`, `[ operation, status, created_at ]`, `[ operation, type, created_at ]`, `[ status, type, created_at ]`, `[ file_migration_id, operation, status, type ]`, `[ file_migration_id, operation, status, created_at ]`, `[ file_migration_id, operation, type, created_at ]`, `[ file_migration_id, status, type, created_at ]`, `[ operation, status, type, created_at ]` or `[ file_migration_id, operation, status, type, created_at ]`.
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
---
|
|
52
|
+
|
|
53
|
+
## Create an export CSV of File Migration Log resources
|
|
54
|
+
|
|
55
|
+
```
|
|
56
|
+
Files::FileMigrationLog.create_export
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
### Parameters
|
|
60
|
+
|
|
61
|
+
* `filter` (object): If set, return records where the specified field is equal to the supplied value. Valid fields are `file_migration_id`, `operation`, `status`, `type` or `created_at`. Valid field combinations are `[ file_migration_id ]`, `[ operation ]`, `[ status ]`, `[ type ]`, `[ created_at ]`, `[ file_migration_id, operation ]`, `[ file_migration_id, status ]`, `[ file_migration_id, type ]`, `[ file_migration_id, created_at ]`, `[ operation, status ]`, `[ operation, type ]`, `[ operation, created_at ]`, `[ status, type ]`, `[ status, created_at ]`, `[ type, created_at ]`, `[ file_migration_id, operation, status ]`, `[ file_migration_id, operation, type ]`, `[ file_migration_id, operation, created_at ]`, `[ file_migration_id, status, type ]`, `[ file_migration_id, status, created_at ]`, `[ file_migration_id, type, created_at ]`, `[ operation, status, type ]`, `[ operation, status, created_at ]`, `[ operation, type, created_at ]`, `[ status, type, created_at ]`, `[ file_migration_id, operation, status, type ]`, `[ file_migration_id, operation, status, created_at ]`, `[ file_migration_id, operation, type, created_at ]`, `[ file_migration_id, status, type, created_at ]`, `[ operation, status, type, created_at ]` or `[ file_migration_id, operation, status, type, created_at ]`.
|
|
62
|
+
* `filter_gt` (object): If set, return records where the specified field is greater than the supplied value. Valid fields are `created_at`. Valid field combinations are `[ file_migration_id ]`, `[ operation ]`, `[ status ]`, `[ type ]`, `[ created_at ]`, `[ file_migration_id, operation ]`, `[ file_migration_id, status ]`, `[ file_migration_id, type ]`, `[ file_migration_id, created_at ]`, `[ operation, status ]`, `[ operation, type ]`, `[ operation, created_at ]`, `[ status, type ]`, `[ status, created_at ]`, `[ type, created_at ]`, `[ file_migration_id, operation, status ]`, `[ file_migration_id, operation, type ]`, `[ file_migration_id, operation, created_at ]`, `[ file_migration_id, status, type ]`, `[ file_migration_id, status, created_at ]`, `[ file_migration_id, type, created_at ]`, `[ operation, status, type ]`, `[ operation, status, created_at ]`, `[ operation, type, created_at ]`, `[ status, type, created_at ]`, `[ file_migration_id, operation, status, type ]`, `[ file_migration_id, operation, status, created_at ]`, `[ file_migration_id, operation, type, created_at ]`, `[ file_migration_id, status, type, created_at ]`, `[ operation, status, type, created_at ]` or `[ file_migration_id, operation, status, type, created_at ]`.
|
|
63
|
+
* `filter_gteq` (object): If set, return records where the specified field is greater than or equal the supplied value. Valid fields are `created_at`. Valid field combinations are `[ file_migration_id ]`, `[ operation ]`, `[ status ]`, `[ type ]`, `[ created_at ]`, `[ file_migration_id, operation ]`, `[ file_migration_id, status ]`, `[ file_migration_id, type ]`, `[ file_migration_id, created_at ]`, `[ operation, status ]`, `[ operation, type ]`, `[ operation, created_at ]`, `[ status, type ]`, `[ status, created_at ]`, `[ type, created_at ]`, `[ file_migration_id, operation, status ]`, `[ file_migration_id, operation, type ]`, `[ file_migration_id, operation, created_at ]`, `[ file_migration_id, status, type ]`, `[ file_migration_id, status, created_at ]`, `[ file_migration_id, type, created_at ]`, `[ operation, status, type ]`, `[ operation, status, created_at ]`, `[ operation, type, created_at ]`, `[ status, type, created_at ]`, `[ file_migration_id, operation, status, type ]`, `[ file_migration_id, operation, status, created_at ]`, `[ file_migration_id, operation, type, created_at ]`, `[ file_migration_id, status, type, created_at ]`, `[ operation, status, type, created_at ]` or `[ file_migration_id, operation, status, type, created_at ]`.
|
|
64
|
+
* `filter_lt` (object): If set, return records where the specified field is less than the supplied value. Valid fields are `created_at`. Valid field combinations are `[ file_migration_id ]`, `[ operation ]`, `[ status ]`, `[ type ]`, `[ created_at ]`, `[ file_migration_id, operation ]`, `[ file_migration_id, status ]`, `[ file_migration_id, type ]`, `[ file_migration_id, created_at ]`, `[ operation, status ]`, `[ operation, type ]`, `[ operation, created_at ]`, `[ status, type ]`, `[ status, created_at ]`, `[ type, created_at ]`, `[ file_migration_id, operation, status ]`, `[ file_migration_id, operation, type ]`, `[ file_migration_id, operation, created_at ]`, `[ file_migration_id, status, type ]`, `[ file_migration_id, status, created_at ]`, `[ file_migration_id, type, created_at ]`, `[ operation, status, type ]`, `[ operation, status, created_at ]`, `[ operation, type, created_at ]`, `[ status, type, created_at ]`, `[ file_migration_id, operation, status, type ]`, `[ file_migration_id, operation, status, created_at ]`, `[ file_migration_id, operation, type, created_at ]`, `[ file_migration_id, status, type, created_at ]`, `[ operation, status, type, created_at ]` or `[ file_migration_id, operation, status, type, created_at ]`.
|
|
65
|
+
* `filter_lteq` (object): If set, return records where the specified field is less than or equal the supplied value. Valid fields are `created_at`. Valid field combinations are `[ file_migration_id ]`, `[ operation ]`, `[ status ]`, `[ type ]`, `[ created_at ]`, `[ file_migration_id, operation ]`, `[ file_migration_id, status ]`, `[ file_migration_id, type ]`, `[ file_migration_id, created_at ]`, `[ operation, status ]`, `[ operation, type ]`, `[ operation, created_at ]`, `[ status, type ]`, `[ status, created_at ]`, `[ type, created_at ]`, `[ file_migration_id, operation, status ]`, `[ file_migration_id, operation, type ]`, `[ file_migration_id, operation, created_at ]`, `[ file_migration_id, status, type ]`, `[ file_migration_id, status, created_at ]`, `[ file_migration_id, type, created_at ]`, `[ operation, status, type ]`, `[ operation, status, created_at ]`, `[ operation, type, created_at ]`, `[ status, type, created_at ]`, `[ file_migration_id, operation, status, type ]`, `[ file_migration_id, operation, status, created_at ]`, `[ file_migration_id, operation, type, created_at ]`, `[ file_migration_id, status, type, created_at ]`, `[ operation, status, type, created_at ]` or `[ file_migration_id, operation, status, type, created_at ]`.
|
data/docs/file_upload_part.md
CHANGED
|
@@ -25,7 +25,8 @@
|
|
|
25
25
|
"partsize": 1,
|
|
26
26
|
"path": "",
|
|
27
27
|
"ref": "upload-1",
|
|
28
|
-
"upload_uri": "example"
|
|
28
|
+
"upload_uri": "example",
|
|
29
|
+
"internal_upload_uri": "example"
|
|
29
30
|
}
|
|
30
31
|
```
|
|
31
32
|
|
|
@@ -45,3 +46,4 @@
|
|
|
45
46
|
* `path` (string): New file path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
|
|
46
47
|
* `ref` (string): Reference name for this upload part
|
|
47
48
|
* `upload_uri` (string): URI to upload this part to
|
|
49
|
+
* `internal_upload_uri` (string): For use with internal services URI to upload this part to
|
data/docs/folder.md
CHANGED
|
@@ -9,7 +9,9 @@ Files::Dir is an alias of Files::Folder
|
|
|
9
9
|
|
|
10
10
|
```
|
|
11
11
|
{
|
|
12
|
+
"id": 1,
|
|
12
13
|
"path": "path/file.txt",
|
|
14
|
+
"path_absolute": "path/file.txt",
|
|
13
15
|
"created_by_id": 1,
|
|
14
16
|
"created_by_api_key_id": 1,
|
|
15
17
|
"created_by_as2_incoming_message_id": 1,
|
|
@@ -42,6 +44,14 @@ Files::Dir is an alias of Files::Folder
|
|
|
42
44
|
"permissions": "rwd",
|
|
43
45
|
"subfolders_locked?": true,
|
|
44
46
|
"is_locked": true,
|
|
47
|
+
"remote_server_id": 1,
|
|
48
|
+
"headers": {
|
|
49
|
+
"key": "example value"
|
|
50
|
+
},
|
|
51
|
+
"socks_ips": [
|
|
52
|
+
"example"
|
|
53
|
+
],
|
|
54
|
+
"internal_download_uri": "example",
|
|
45
55
|
"download_uri": "https://mysite.files.com/...",
|
|
46
56
|
"priority_color": "red",
|
|
47
57
|
"preview_id": 1,
|
|
@@ -55,7 +65,9 @@ Files::Dir is an alias of Files::Folder
|
|
|
55
65
|
}
|
|
56
66
|
```
|
|
57
67
|
|
|
68
|
+
* `id` (int64): File/Folder ID. Used only for ExaVault compatibility API. Do not use for other purposes, as this value will not always be set.
|
|
58
69
|
* `path` (string): File/Folder path. This must be slash-delimited, but it must neither start nor end with a slash. Maximum of 5000 characters.
|
|
70
|
+
* `path_absolute` (string): File/Folder absolute path for Bundle Trusted Relay use
|
|
59
71
|
* `created_by_id` (int64): User ID of the User who created the file/folder
|
|
60
72
|
* `created_by_api_key_id` (int64): ID of the API key that created the file/folder
|
|
61
73
|
* `created_by_as2_incoming_message_id` (int64): ID of the AS2 Incoming Message that created the file/folder
|
|
@@ -86,11 +98,16 @@ Files::Dir is an alias of Files::Folder
|
|
|
86
98
|
* `permissions` (string): A short string representing the current user's permissions. Can be `r` (Read),`w` (Write),`d` (Delete), `l` (List) or any combination
|
|
87
99
|
* `subfolders_locked?` (boolean): Are subfolders locked and unable to be modified?
|
|
88
100
|
* `is_locked` (boolean): Is this folder locked and unable to be modified?
|
|
101
|
+
* `remote_server_id` (int64): Used for internal bandwidth tracking
|
|
102
|
+
* `headers` (object): Used for internal url management
|
|
103
|
+
* `socks_ips` (array(string)): Used for internal url management
|
|
104
|
+
* `internal_download_uri` (string): For use with internal services and should also be with headers and socks_ips
|
|
89
105
|
* `download_uri` (string): Link to download file. Provided only in response to a download request.
|
|
90
106
|
* `priority_color` (string): Bookmark/priority color of file/folder
|
|
91
107
|
* `preview_id` (int64): File preview ID
|
|
92
108
|
* `preview` (Preview): File preview
|
|
93
109
|
* `mkdir_parents` (boolean): Create parent directories if they do not exist?
|
|
110
|
+
* `bundle_registration_code` (string):
|
|
94
111
|
|
|
95
112
|
|
|
96
113
|
---
|
|
@@ -113,6 +130,8 @@ Files::Folder.list_for(path,
|
|
|
113
130
|
* `cursor` (string): Send cursor to resume an existing list from the point at which you left off. Get a cursor from an existing list via the X-Files-Cursor-Next header or the X-Files-Cursor-Prev header.
|
|
114
131
|
* `per_page` (int64): Number of records to show per page. (Max: 10000, 1,000 or less is recommended).
|
|
115
132
|
* `path` (string): Required - Path to operate on.
|
|
133
|
+
* `action` (string): Action to take. Can be `count`, `size`, `permissions`, or blank.
|
|
134
|
+
* `bundle_registration_code` (string):
|
|
116
135
|
* `preview_size` (string): Request a preview size. Can be `small` (default), `large`, `xlarge`, or `pdf`.
|
|
117
136
|
* `sort_by` (object): Search by field and direction. Valid fields are `path`, `size`, `modified_at_datetime`, `provided_modified_at`. Valid directions are `asc` and `desc`. Defaults to `{"path":"asc"}`.
|
|
118
137
|
* `search` (string): If specified, will search the folders/files list by name. Ignores text before last `/`. This is the same API used by the search bar in the web UI when running 'Search This Folder'. Search results are a best effort, not real time, and not guaranteed to perfectly match the latest folder listing. Results may be truncated if more than 1,000 possible matches exist. This field should only be used for ad-hoc (human) searching, and not as part of an automated process.
|
|
@@ -140,3 +159,4 @@ Files::Folder.create(path,
|
|
|
140
159
|
* `path` (string): Required - Path to operate on.
|
|
141
160
|
* `mkdir_parents` (boolean): Create parent directories if they do not exist?
|
|
142
161
|
* `provided_mtime` (string): User provided modification time.
|
|
162
|
+
* `bundle_registration_code` (string):
|
data/docs/form_field_set.md
CHANGED
|
@@ -104,6 +104,21 @@ Files::FormFieldSet.create(
|
|
|
104
104
|
* `form_fields` (array(object)):
|
|
105
105
|
|
|
106
106
|
|
|
107
|
+
---
|
|
108
|
+
|
|
109
|
+
## Create an export CSV of Form Field Set resources
|
|
110
|
+
|
|
111
|
+
```
|
|
112
|
+
Files::FormFieldSet.create_export(
|
|
113
|
+
user_id: 1
|
|
114
|
+
)
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
### Parameters
|
|
118
|
+
|
|
119
|
+
* `user_id` (int64): User ID. Provide a value of `0` to operate the current session's user.
|
|
120
|
+
|
|
121
|
+
|
|
107
122
|
---
|
|
108
123
|
|
|
109
124
|
## Update Form Field Set
|
|
@@ -0,0 +1,111 @@
|
|
|
1
|
+
# FrontEndServer
|
|
2
|
+
|
|
3
|
+
## Example FrontEndServer Object
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
{
|
|
7
|
+
"ip": "example",
|
|
8
|
+
"external_ip": "example",
|
|
9
|
+
"assigned": true,
|
|
10
|
+
"site": {
|
|
11
|
+
"name": "example",
|
|
12
|
+
"certificate": "example",
|
|
13
|
+
"private_key": "example",
|
|
14
|
+
"key": "example",
|
|
15
|
+
"intermediates": "example",
|
|
16
|
+
"id": 1,
|
|
17
|
+
"domain_hsts_header": true,
|
|
18
|
+
"ftps_enabled": true,
|
|
19
|
+
"https_enabled": true,
|
|
20
|
+
"sftp_insecure_ciphers": true,
|
|
21
|
+
"tls_disabled": true,
|
|
22
|
+
"subdomain": "example",
|
|
23
|
+
"domains": [
|
|
24
|
+
"example"
|
|
25
|
+
]
|
|
26
|
+
},
|
|
27
|
+
"ftp_enabled": true,
|
|
28
|
+
"sftp_enabled": true,
|
|
29
|
+
"sftp_host_key_type": "example",
|
|
30
|
+
"sftp_host_key_private_key": "example",
|
|
31
|
+
"site_id": 1,
|
|
32
|
+
"motd_text": "example",
|
|
33
|
+
"motd_use_for_ftp": true,
|
|
34
|
+
"motd_use_for_sftp": true,
|
|
35
|
+
"custom_domains": [
|
|
36
|
+
{
|
|
37
|
+
"id": 1,
|
|
38
|
+
"domain": "example",
|
|
39
|
+
"destination": "example",
|
|
40
|
+
"ssl_certificate_id": 1,
|
|
41
|
+
"certificate": "example",
|
|
42
|
+
"private_key": "example",
|
|
43
|
+
"intermediates": "example"
|
|
44
|
+
}
|
|
45
|
+
],
|
|
46
|
+
"pair_type": "example"
|
|
47
|
+
}
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
* `ip` (string): Private IP of the server.
|
|
51
|
+
* `external_ip` (string): Public IP of the server.
|
|
52
|
+
* `assigned` (boolean): Flag to signal to other systems to use this config
|
|
53
|
+
* `site` (SslCertificate): SSL certificate information for the site associated with this IP, if available.
|
|
54
|
+
* `ftp_enabled` (boolean):
|
|
55
|
+
* `sftp_enabled` (boolean):
|
|
56
|
+
* `sftp_host_key_type` (string): Which SFTP host key to use.
|
|
57
|
+
* `sftp_host_key_private_key` (string): SFTP Host Key private key if using a custom key.
|
|
58
|
+
* `site_id` (int64): Site Id
|
|
59
|
+
* `motd_text` (string): A message to show users when they connect via FTP or SFTP.
|
|
60
|
+
* `motd_use_for_ftp` (boolean): Show message to users connecting via FTP
|
|
61
|
+
* `motd_use_for_sftp` (boolean): Show message to users connecting via SFTP
|
|
62
|
+
* `custom_domains` (array(object)): Active Custom Domains for the site associated with this IP, with their attached SSL certificate content.
|
|
63
|
+
* `pair_type` (string): Pair type for General Use Public IPs
|
|
64
|
+
* `name` (string): Server's short name.
|
|
65
|
+
* `hostname` (string): Server's full hostname.
|
|
66
|
+
* `zone` (string): Availability zone where this server lives.
|
|
67
|
+
* `ips` (array(string)): An array of public and private ip address pairs.
|
|
68
|
+
* `primary_ip` (string): Primary Internal IP.
|
|
69
|
+
* `primary_ip_public` (string): Primary Public IP.
|
|
70
|
+
* `soo_ip` (string): Security Opt Out Internal IP.
|
|
71
|
+
* `soo_ip_public` (string): Security Opt Out Public IP.
|
|
72
|
+
* `exavault_ip` (string): Exavault Internal IP.
|
|
73
|
+
* `exavault_ip_public` (string): Exavault Public IP.
|
|
74
|
+
* `exavault_soo_ip` (string): Exavault Security Opt Out Internal IP.
|
|
75
|
+
* `exavault_soo_ip_public` (string): Exavault Security Opt Out Public IP.
|
|
76
|
+
* `smartfile_ip` (string): Smartfile Internal IP.
|
|
77
|
+
* `smartfile_ip_public` (string): Smartfile Public IP.
|
|
78
|
+
* `smartfile_soo_ip` (string): Smartfile Security Opt Out Internal IP.
|
|
79
|
+
* `smartfile_soo_ip_public` (string): Smartfile Security Opt Out Public IP.
|
|
80
|
+
|
|
81
|
+
|
|
82
|
+
---
|
|
83
|
+
|
|
84
|
+
## Create or update a front end server and perform a checkin for the given IPs
|
|
85
|
+
|
|
86
|
+
```
|
|
87
|
+
Files::FrontEndServer.create(
|
|
88
|
+
name: "name"
|
|
89
|
+
)
|
|
90
|
+
```
|
|
91
|
+
|
|
92
|
+
### Parameters
|
|
93
|
+
|
|
94
|
+
* `name` (string): Required - Server's short name.
|
|
95
|
+
* `hostname` (string): Server's full hostname.
|
|
96
|
+
* `zone` (string): Availability zone where this server lives.
|
|
97
|
+
* `ips` (array(string)): An array of public and private ip address pairs.
|
|
98
|
+
* `ips[private_ip]` (array(string)): Private IP address associated with the server.
|
|
99
|
+
* `ips[public_ip]` (array(string)): Public IP address associated with the server.
|
|
100
|
+
* `primary_ip` (string): Primary Internal IP.
|
|
101
|
+
* `primary_ip_public` (string): Primary Public IP.
|
|
102
|
+
* `soo_ip` (string): Security Opt Out Internal IP.
|
|
103
|
+
* `soo_ip_public` (string): Security Opt Out Public IP.
|
|
104
|
+
* `exavault_ip` (string): Exavault Internal IP.
|
|
105
|
+
* `exavault_ip_public` (string): Exavault Public IP.
|
|
106
|
+
* `exavault_soo_ip` (string): Exavault Security Opt Out Internal IP.
|
|
107
|
+
* `exavault_soo_ip_public` (string): Exavault Security Opt Out Public IP.
|
|
108
|
+
* `smartfile_ip` (string): Smartfile Internal IP.
|
|
109
|
+
* `smartfile_ip_public` (string): Smartfile Public IP.
|
|
110
|
+
* `smartfile_soo_ip` (string): Smartfile Security Opt Out Internal IP.
|
|
111
|
+
* `smartfile_soo_ip_public` (string): Smartfile Security Opt Out Public IP.
|
|
@@ -0,0 +1,34 @@
|
|
|
1
|
+
# FrontendMetric
|
|
2
|
+
|
|
3
|
+
## Example FrontendMetric Object
|
|
4
|
+
|
|
5
|
+
```
|
|
6
|
+
{
|
|
7
|
+
"metric_type": "increment",
|
|
8
|
+
"subkey": "abc123",
|
|
9
|
+
"ms": 100
|
|
10
|
+
}
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
* `metric_type` (string): Statsd metric type
|
|
14
|
+
* `subkey` (string): Where in statsd to store the metric. The final key in statsd will be `files-react.[environment].[subkey]`
|
|
15
|
+
* `ms` (int64): For timing metrics, the number of milliseconds. Required if `metric_type` is `timing`.
|
|
16
|
+
|
|
17
|
+
|
|
18
|
+
---
|
|
19
|
+
|
|
20
|
+
## Submit Frontend Metric data
|
|
21
|
+
|
|
22
|
+
```
|
|
23
|
+
Files::FrontendMetric.create(
|
|
24
|
+
metric_type: "metric_type",
|
|
25
|
+
subkey: "abc123",
|
|
26
|
+
ms: 100
|
|
27
|
+
)
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
### Parameters
|
|
31
|
+
|
|
32
|
+
* `metric_type` (string): Required - Statsd metric type. Use `timing` to submit the amount of time something took, or `increment` to increment a counter
|
|
33
|
+
* `subkey` (string): Required - Where in statsd to store the metric. The final key in statsd will be `files-react.[environment].[subkey]`
|
|
34
|
+
* `ms` (int64): For timing metrics, the number of milliseconds. Required if `metric_type` is `timing`.
|