files.com 1.1.702 → 1.1.703

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 0acf3ca829b1f589c4215997d54340fdd629d1c6c2dd1d0721867177ffd7ad19
-  data.tar.gz: d0aa06a6630c68a3c4f3dcb00113887626e797cd0ea58818566d57fdef0fbb66
+  metadata.gz: d21c10fb02cba890d2adc0bbafc9f55a5c76301a087f687211fb2fc35c5f918e
+  data.tar.gz: 58312e4a9ab5afbc1700da689042ac0ee74e6af6123d99f0d7087e14f3268e1e
 SHA512:
-  metadata.gz: b1f03566c17c5599b8642c7c6d2267cfd5d9809e4f55b2d88222a53a654f1ccbd54fb5bc6e349fd0e6b3462f21a124946cfb22ec43d399c1b8330cb6a85b664d
-  data.tar.gz: aea8520b418b619f5660eafb44e2745b42a0c4506afc3d2ec4f24368c8a4d95615b18a0475b771816b62262bbcecae1ca5a3f131cbd19811e8cf59c6aefcd28e
+  metadata.gz: e77d1a15b6ed2f10e48614d1fc64000bf675ba82d129bed38d497cabd9f8e9539711ec1495f08288b8f6fa7318249e649bb10ecee03e076372b28d1b5c0b3302
+  data.tar.gz: 7bf7b242c71b7217b5d56cda007f3b5b699ad7af9705367eb72cada949d4cb34edab19291ac8d60a8ab566f5ab987db4091ce082f0862499c02d19f56febbdeb

data/_VERSION

@@ -1 +1 @@
-1.1.702
+1.1.703

data/docs/agent_node.md

@@ -0,0 +1,27 @@
+# AgentNode
+
+## Example AgentNode Object
+
+```
+{
+  "node_id": "example",
+  "name": "example",
+  "hostname": "example",
+  "availability_role": "example",
+  "connection_status": "example",
+  "is_default": true,
+  "agent_version": "example",
+  "direct_transfer_available": true,
+  "last_seen_at": "2000-01-01T01:00:00Z"
+}
+```
+
+* `node_id` (string): Stable Agent installation ID
+* `name` (string): Customer-configured Agent node name
+* `hostname` (string): Hostname reported by the Agent
+* `availability_role` (string): Configured traffic preference
+* `connection_status` (string): Whether this node is currently available for traffic
+* `is_default` (boolean): Whether this node is the current default route for new unscoped work
+* `agent_version` (string): Agent version reported by this node
+* `direct_transfer_available` (boolean): Whether the proxy recently validated a direct connection to this Agent node. False means direct transfers are enabled but not currently available; null means disabled or unsupported.
+* `last_seen_at` (date-time): Most recent successful node observation

data/docs/exavault_api_request_log.md

@@ -6,7 +6,7 @@
 {
   "timestamp": "2000-01-01T01:00:00Z",
   "endpoint": "example",
-  "version": 1,
+  "version": 1.0,
   "request_ip": "example",
   "request_method": "example",
   "error_type": "example",
@@ -21,7 +21,7 @@
 
 * `timestamp` (date-time): Start Time of Action. Deprecrated: Use created_at.
 * `endpoint` (string): Name of API Endpoint
-* `version` (int64): Exavault API Version
+* `version` (double): Exavault API Version
 * `request_ip` (string): IP of requesting client
 * `request_method` (string): HTTP Method
 * `error_type` (string): Error type, if applicable

data/docs/remote_server.md

@@ -221,6 +221,19 @@ Files::RemoteServer.find(id)
 * `id` (int64): Required - Remote Server ID.
 
 
+---
+
+## List Files.com Agent nodes
+
+```
+Files::RemoteServer.agent_nodes(id)
+```
+
+### Parameters
+
+* `id` (int64): Required - Remote Server ID.
+
+
 ---
 
 ## Download configuration file (required for some Remote Server integrations, such as the Files.com Agent)
@@ -613,6 +626,21 @@ Files::RemoteServer.delete(id)
 * `id` (int64): Required - Remote Server ID.
 
 
+---
+
+## List Files.com Agent nodes
+
+```
+remote_server = Files::RemoteServer.find(id)
+
+remote_server.agent_nodes
+```
+
+### Parameters
+
+* `id` (int64): Required - Remote Server ID.
+
+
 ---
 
 ## Push update to Files Agent

data/docs/remote_server_configuration_file.md

@@ -9,6 +9,7 @@
   "private_key": "example",
   "subdomain": "example",
   "root": "C:\\Users\\",
+  "node_name": "example",
   "follow_links": true,
   "prefer_protocol": "example",
   "dns": "example",
@@ -37,6 +38,7 @@
 * `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)

data/lib/files.com/models/agent_node.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+module Files
+  class AgentNode
+    attr_reader :options, :attributes
+
+    def initialize(attributes = {}, options = {})
+      @attributes = attributes || {}
+      @options = options || {}
+    end
+
+    # string - Stable Agent installation ID
+    def node_id
+      @attributes[:node_id]
+    end
+
+    # string - Customer-configured Agent node name
+    def name
+      @attributes[:name]
+    end
+
+    # string - Hostname reported by the Agent
+    def hostname
+      @attributes[:hostname]
+    end
+
+    # string - Configured traffic preference
+    def availability_role
+      @attributes[:availability_role]
+    end
+
+    # string - Whether this node is currently available for traffic
+    def connection_status
+      @attributes[:connection_status]
+    end
+
+    # boolean - Whether this node is the current default route for new unscoped work
+    def is_default
+      @attributes[:is_default]
+    end
+
+    # string - Agent version reported by this node
+    def agent_version
+      @attributes[:agent_version]
+    end
+
+    # boolean - Whether the proxy recently validated a direct connection to this Agent node. False means direct transfers are enabled but not currently available; null means disabled or unsupported.
+    def direct_transfer_available
+      @attributes[:direct_transfer_available]
+    end
+
+    # date-time - Most recent successful node observation
+    def last_seen_at
+      @attributes[:last_seen_at]
+    end
+  end
+end

data/lib/files.com/models/exavault_api_request_log.rb

@@ -19,7 +19,7 @@ module Files
       @attributes[:endpoint]
     end
 
-    # int64 - Exavault API Version
+    # double - Exavault API Version
     def version
       @attributes[:version]
     end

data/lib/files.com/models/remote_server.rb

@@ -918,6 +918,17 @@ module Files
       @attributes[:files_api_key] = value
     end
 
+    # List Files.com Agent nodes
+    def agent_nodes(params = {})
+      params ||= {}
+      params[:id] = @attributes[:id]
+      raise MissingParameterError.new("Current object doesn't have a id") unless @attributes[:id]
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      Api.send_request("/remote_servers/#{@attributes[:id]}/agent_nodes", :get, params, @options)
+    end
+
     # Push update to Files Agent
     def agent_push_update(params = {})
       params ||= {}
@@ -1198,6 +1209,17 @@ module Files
       find(id, params, options)
     end
 
+    # List Files.com Agent nodes
+    def self.agent_nodes(id, params = {}, options = {})
+      params ||= {}
+      params[:id] = id
+      raise InvalidParameterError.new("Bad parameter: id must be an Integer") if params[:id] and !params[:id].is_a?(Integer)
+      raise MissingParameterError.new("Parameter missing: id") unless params[:id]
+
+      response, options = Api.send_request("/remote_servers/#{params[:id]}/agent_nodes", :get, params, options)
+      AgentNode.new(response.data, options)
+    end
+
     # Parameters:
     #   id (required) - int64 - Remote Server ID.
     def self.find_configuration_file(id, params = {}, options = {})

data/lib/files.com/models/remote_server_configuration_file.rb

@@ -34,6 +34,11 @@ module Files
       @attributes[:root]
     end
 
+    # string - Optional customer-facing name for this Agent installation
+    def node_name
+      @attributes[:node_name]
+    end
+
     # boolean - Follow symlinks when traversing directories
     def follow_links
       @attributes[:follow_links]

data/lib/files.com/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Files
-  VERSION = "1.1.702"
+  VERSION = "1.1.703"
 end

data/lib/files.com.rb

@@ -37,6 +37,7 @@ require "files.com/models/action"
 require "files.com/models/action_log"
 require "files.com/models/action_notification_export"
 require "files.com/models/action_notification_export_result"
+require "files.com/models/agent_node"
 require "files.com/models/agent_push_update"
 require "files.com/models/ai_assistant_personality"
 require "files.com/models/ai_task"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: files.com
 version: !ruby/object:Gem::Version
-  version: 1.1.702
+  version: 1.1.703
 platform: ruby
 authors:
 - files.com
@@ -175,6 +175,7 @@ files:
 - docs/action_log.md
 - docs/action_notification_export.md
 - docs/action_notification_export_result.md
+- docs/agent_node.md
 - docs/agent_push_update.md
 - docs/ai_assistant_personality.md
 - docs/ai_task.md
@@ -327,6 +328,7 @@ files:
 - lib/files.com/models/action_log.rb
 - lib/files.com/models/action_notification_export.rb
 - lib/files.com/models/action_notification_export_result.rb
+- lib/files.com/models/agent_node.rb
 - lib/files.com/models/agent_push_update.rb
 - lib/files.com/models/ai_assistant_personality.rb
 - lib/files.com/models/ai_task.rb