Remote Mount Backends

A Remote Mount Backend is used to provide high availability for a Remote Server Mount Folder Behavior.

List Remote Mount Backends

SDK Method

Files::RemoteMountBackend.list

Return Object

List<RemoteMountBackend>

Authorization Requirement

Available to all authenticated keys or sessions.

Additional Arguments

Example Request

begin
  remote_mount_backends = Files::RemoteMountBackend.list
  remote_mount_backends.auto_paging_each do |remote_mount_backend|
    # Operate on remote_mount_backend
  end
rescue Files::NotAuthenticatedError => e
  puts "Authentication Error Occurred (#{e.class.to_s}): " + e.message
rescue Files::Error => e
  puts "Unknown Error Occurred (#{e.class.to_s}): " + e.message
end

Show Remote Mount Backend

SDK Method

Files::RemoteMountBackend.find

Return Object

RemoteMountBackend

Authorization Requirement

Available to all authenticated keys or sessions.

Method Arguments

ArgumentDescription
id
int64
Required		Remote Mount Backend ID.

Example Request

begin
  remote_mount_backend = Files::RemoteMountBackend.find(id)
  # Operate on remote_mount_backend
rescue Files::NotAuthenticatedError => e
  puts "Authentication Error Occurred (#{e.class.to_s}): " + e.message
rescue Files::Error => e
  puts "Unknown Error Occurred (#{e.class.to_s}): " + e.message
end

Create Remote Mount Backend

SDK Method

Files::RemoteMountBackend.create

Return Object

RemoteMountBackend

Authorization Requirement

Available to all authenticated keys or sessions.

Method Arguments

ArgumentDefaultDescription
enabled
boolean		trueTrue if this backend is enabled.
fall
int64		1Number of consecutive failures before considering the backend unhealthy.
health_check_enabled
boolean		trueTrue if health checks are enabled for this backend.
health_check_type
string		"active"Type of health check to perform.
Possible values: active, passive
interval
int64		60Interval in seconds between health checks.
min_free_cpu
double		Minimum free CPU percentage required for this backend to be considered healthy.
min_free_mem
double		Minimum free memory percentage required for this backend to be considered healthy.
priority
int64		1Priority of this backend.
remote_path
string		""Path on the remote server to treat as the root of this mount.
rise
int64		1Number of consecutive successes before considering the backend healthy.
canary_file_path
string
Required		Path to the canary file used for health checks.
remote_server_mount_id
int64
Required		The mount ID of the Remote Server Mount that this backend is associated with.
remote_server_id
int64
Required		The remote server that this backend is associated with.

Example Request

begin
  remote_mount_backend = Files::RemoteMountBackend.create(
    canary_file_path: "backend1.txt",
    remote_server_mount_id: 1,
    remote_server_id: 1
  )
  # Operate on remote_mount_backend
rescue Files::NotAuthenticatedError => e
  puts "Authentication Error Occurred (#{e.class.to_s}): " + e.message
rescue Files::Error => e
  puts "Unknown Error Occurred (#{e.class.to_s}): " + e.message
end

Reset backend status to healthy

SDK Method

remote_mount_backend.reset_status

Return Object

nil

Authorization Requirement

Available to all authenticated keys or sessions.

Example Request

begin
  # Find the remote_mount_backend object by its id.
  remote_mount_backend = Files::RemoteMountBackend.find(id)
  remote_mount_backend.reset_status
rescue Files::NotAuthenticatedError => e
  puts "Authentication Error Occurred (#{e.class.to_s}): " + e.message
rescue Files::Error => e
  puts "Unknown Error Occurred (#{e.class.to_s}): " + e.message
end

Update Remote Mount Backend

SDK Method

remote_mount_backend.update

Return Object

RemoteMountBackend

Authorization Requirement

Available to all authenticated keys or sessions.

Method Arguments

ArgumentDescription
enabled
boolean		True if this backend is enabled.
fall
int64		Number of consecutive failures before considering the backend unhealthy.
health_check_enabled
boolean		True if health checks are enabled for this backend.
health_check_type
string		Type of health check to perform.
Possible values: active, passive
interval
int64		Interval in seconds between health checks.
min_free_cpu
double		Minimum free CPU percentage required for this backend to be considered healthy.
min_free_mem
double		Minimum free memory percentage required for this backend to be considered healthy.
priority
int64		Priority of this backend.
remote_path
string		Path on the remote server to treat as the root of this mount.
rise
int64		Number of consecutive successes before considering the backend healthy.
canary_file_path
string		Path to the canary file used for health checks.
remote_server_id
int64		The remote server that this backend is associated with.

Example Request

begin
  # Find the remote_mount_backend object by its id.
  remote_mount_backend = Files::RemoteMountBackend.find(id)
  remote_mount_backend.update(
    enabled: true
  )
rescue Files::NotAuthenticatedError => e
  puts "Authentication Error Occurred (#{e.class.to_s}): " + e.message
rescue Files::Error => e
  puts "Unknown Error Occurred (#{e.class.to_s}): " + e.message
end

Delete Remote Mount Backend

SDK Method

remote_mount_backend.delete

Return Object

nil

Authorization Requirement

Available to all authenticated keys or sessions.

Example Request

begin
  # Find the remote_mount_backend object by its id.
  remote_mount_backend = Files::RemoteMountBackend.find(id)
  remote_mount_backend.delete
rescue Files::NotAuthenticatedError => e
  puts "Authentication Error Occurred (#{e.class.to_s}): " + e.message
rescue Files::Error => e
  puts "Unknown Error Occurred (#{e.class.to_s}): " + e.message
end

The RemoteMountBackend Object

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

AttributeDescription
canary_file_path
string		Path to the canary file used for health checks.
enabled
boolean		True if this backend is enabled.
fall
int64		Number of consecutive failures before considering the backend unhealthy.
health_check_enabled
boolean		True if health checks are enabled for this backend.
health_check_results
array(object)		Array of recent health check results.
health_check_type
string		Type of health check to perform.
Possible values: active, passive
id
int64		Unique identifier for this backend.
interval
int64		Interval in seconds between health checks.
min_free_cpu
decimal		Minimum free CPU percentage required for this backend to be considered healthy.
min_free_mem
decimal		Minimum free memory percentage required for this backend to be considered healthy.
priority
int64		Priority of this backend.
remote_path
string		Path on the remote server to treat as the root of this mount.
remote_server_id
int64		The remote server that this backend is associated with.
remote_server_mount_id
int64		The mount ID of the Remote Server Mount that this backend is associated with.
rise
int64		Number of consecutive successes before considering the backend healthy.
status
string		Status of this backend.
Possible values: healthy, degraded, failed, desynced
undergoing_maintenance
boolean		True if this backend is undergoing maintenance.