findnodebyagentid.adoc

FindNodeByAgentId()

FindNodeByAgentId(agentid, currentNode) => Node

Look up [class-node] object by agent ID.

If trusted node validation is enforced, currentNode should point to execution context object (instance of [class-netobj], $node in most cases). If trusted nodes are disabled (default server configuration), currentNode can be omitted or set to null.

Table 1. Parameters

agentid	String	Agent ID.
currentNode	[class-netobj]	Lookup context or null if trusted nodes validation is disabled. Optional parameter.

Return

Instance of [class-node] object or null if not found or not accessible.

Example

node = FindNodeByAgentId("7e54f964-8942-504f-90eb-70e5d6abee92", $node);
if (node != NULL) println(node.name); // Prints node name if node with given agent ID is found