ProductAgents :: List · Customer Self-Service

Retrieves a list of managed product Security Agents.

HTTP Request

GET /WebApp/API/AgentResource/ProductAgents

Parameters

Name	Type	Description
Optional Parameters
entity_id	String	The GUID of the managed product agent
ip_address	String	The IP address of the managed product agent
mac_address	String	The MAC address of the managed product agent
host_name	String	The endpoint name of the managed product agent
product	String	The Trend Micro product that the agent is for For available values, see Automation API Product Values.
managing_server_id	String	The GUID of the product server that manages the agent

HTTP Request Example

GET /WebApp/API/ServerResource/ProductAgents?
ip_address=192.168.121.132&mac_address=00-0C-29-9B-AB-65&
host_name=OSCECLIENT

HTTP Request Body

Specify a JSON object containing the following:

HTTP header:

Field Name	Value
Authorization	Bearer [Generated JWT authentication token]

Request body:

[Blank]

Response

If successful, this method returns an HTTP status code of "200" and a response body with a result code of "1" and the following structure:

{
 "result_code":1,
 "result_description":"Operation successful",
 "result_content":[         
     {
      "entity_id":"8a1a84550462-40bc9afc-3770-16ac-cd6c",
      "product":"SLF_PRODUCT_OFFICESCAN_CE",
      "managing_server_id":
         "026332F39EBC-41C19604-02DD-2C5F-EDE5",
      "ad_domain":"",
      "folder_path":"Workgroup",          
      "ip_address_list":"192.168.121.132",
      "mac_address_list":"00-0C-29-9B-AB-65",
      "host_name":"OSCECLIENT",
      "isolation_status":"normal",          
      "capabilities":[
         "cmd_uninstall_agent",             
         "cmd_relocate_agent",
         "cmd_isolate_agent",
         "cmd_restore_isolated_agent"
         ]
      }
   ]
}

Where the result_content object contains a list of agents that match all of the specified parameters:

Name	Type	Description
entity_id	String	The GUID of the managed product agent
product	String	The Trend Micro product that the agent is for For available values, see Automation API Product Values.
managing_server_id	String	The GUID of the product server that manages the agent
ad_domain	String	The Active Directory domain that the agent belongs to (if applicable)
folder_path	String	The folder path of where the agent is located on the managing server (for example, the Apex One domain that the agent is listed under)
ip_address_list	String	Lists the IP addresses on the agent endpoint
mac_address_list	String	Lists the MAC addresses on the agent endpoint
host_name	String	The endpoint name of the managed product agent
isolation_status	String	Indicates the agent isolation status (if applicable). For available values, see Automation API Isolation Statuses.
capabilities	String	Lists the API actions that can be performed on the agent For available values, see Automation API Actions/Capabilities.

For more information about API responses and descriptions of response codes, see the following topics: