Remote Server Configuration Files

A RemoteServerConfigurationFile is a configuration file (required for some Remote Server integrations, such as the Files.com Agent).

Download configuration file (required for some Remote Server integrations, such as the Files.com Agent)

SDK Method

files_sdk.remote_server.find_configuration_file()

Return Object

RemoteServerConfigurationFile

Authorization Requirement

Requires a Site-Wide API key, or a User API key or session from a Site Administrator, a Workspace Administrator for the relevant workspace, or a user with an Integration-Centric file system layout managing their own Remote Servers.

Method Arguments

Argument	Description
id int64 Required	Remote Server ID.

Example Request

import files_sdk

try:
  remote_server_configuration_file = files_sdk.remote_server.find_configuration_file(id)
  # Operate on remote_server_configuration_file
except files_sdk.error.NotAuthenticatedError as err:
  print(f"Authentication Error Occurred ({type(err).__name__}):", err)
except files_sdk.error.Error as err:
  print(f"Unknown Error Occurred ({type(err).__name__}):", err)

The RemoteServerConfigurationFile Object

Some of the methods above return a RemoteServerConfigurationFile object. The attributes of this object are listed below.

Attribute	Description
id int64	The remote server ID of the agent
permission_set string	The permission set for the agent ['read_write', 'read_only', 'write_only']
private_key string	The private key for the agent
subdomain string	Files.com subdomain site name
root string	The root directory for the agent
node_name string	Optional customer-facing name for this Agent installation
follow_links boolean	Follow symlinks when traversing directories
prefer_protocol string	Preferred network protocol ['udp', 'tcp'] (default udp)
dns string	DNS lookup method ['auto','doh','system'] (default auto)
proxy_all_outbound boolean	Proxy all outbound traffic through files.com proxy server
endpoint_override string	Custom site endpoint URL
log_file string	Log file name and location
log_level string	Log level for the agent logs ['debug', 'info', 'warn', 'error', 'fatal'] (default info)
log_rotate_num int64	Log route for agent logs. (default 5)
log_rotate_size int64	Log route size in MB for agent logs. (default 20)
override_max_concurrent_jobs int64	Maximum number of concurrent jobs (default 500)
graceful_shutdown_timeout int64	Graceful shutdown timeout in seconds (default 15)
transfer_rate_limit string	File transfer (upload/download) rate limit `<limit>-<period>`, with the given periods: * 'S': second * 'M': minute * 'H': hour * 'D': day Examples: * 5 requests/second: '5-S' * 10 requests/minute: '10-M' * 1000 requests/hour: '1000-H' * 2000 requests/day: '2000-D'
auto_update_policy string	Auto update policy ['manual_trigger', 'critical_only', 'always', 'never'] (default always)