Computers

List Computers

get/computers

Lists all computers.

Related SDK Methods:
Java

ComputersApi.listComputers([param1, param2, ...])

Python

ComputersApi.list_computers([param1, param2, ...])

JavaScript

ComputersApi.listComputers([param1, param2, ...])

Request
query Parameters
expand
Array of strings

Determines the computer information to include in the response. Use "none" to retrieve only basic computer information such as policyID and hostName. Use one or several expand options to retrieve a tailored response in addition to the basic information. Use "all" to retrieve all of the computer information. The default is "all", but we recommend using "none" or a limited set of options on all requests to improve performance.

Items Enum: "none" "all" "computerStatus" "tasks" "securityUpdates" "computerSettings" "allSecurityModules" "antiMalware" "webReputation" "activityMonitoring" "deviceControl" "firewall" "intrusionPrevention" "integrityMonitoring" "logInspection" "applicationControl" "SAP" "interfaces" "ESXSummary" "allVirtualMachineSummaries" "azureARMVirtualMachineSummary" "azureVMVirtualMachineSummary" "ec2VirtualMachineSummary" "noConnectorVirtualMachineSummary" "vmwareVMVirtualMachineSummary" "vcloudVMVirtualMachineSummary" "workspaceVirtualMachineSummary" "gcpVirtualMachineSummary"
overrides
boolean

Show only overrides defined for the current computer.

header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Responses
200

successful operation

403

Not authorized to view computers.

Request samples
import com.trendmicro.deepsecurity.ApiClient;
import com.trendmicro.deepsecurity.Configuration;
import com.trendmicro.deepsecurity.auth.ApiKeyAuth;
import com.trendmicro.deepsecurity.ApiException;
import com.trendmicro.deepsecurity.api.ComputersApi;
import com.trendmicro.deepsecurity.model.Computers;
import com.trendmicro.deepsecurity.model.Expand;

import java.util.List;

public class ListComputersExample {
	
	public static void main(String[] args) {
		// Setup
		ApiClient defaultClient = Configuration.getDefaultApiClient();
		defaultClient.setBasePath("YOUR HOST");

		// Authentication
		ApiKeyAuth DefaultAuthentication = (ApiKeyAuth) defaultClient.getAuthentication("DefaultAuthentication");
		DefaultAuthentication.setApiKey("YOUR API KEY");
		try {
			defaultClient.trustAllCertificates(false);
		} catch (Exception e) {
			System.err.println("An exception occurred when calling ApiClient.trustAllCertificates");
			e.printStackTrace();
		}
		
		// Initialization
		// Set Any Required Values
		ComputersApi instance = new ComputersApi();
		List<String> expand = new Expand(Expand.OptionsEnum.NONE).list();
		Boolean overrides = false;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			Computers result = instance.listComputers(expand, overrides, apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling ComputersApi.listComputers");
			e.printStackTrace();
		}
	}
}

Response samples
application/json
{
  • "computers": [
    ]
}

Create a Computer

post/computers

Create a new computer.

Related SDK Methods:
Java

ComputersApi.createComputer([param1, param2, ...])

Python

ComputersApi.create_computer([param1, param2, ...])

JavaScript

ComputersApi.createComputer([param1, param2, ...])

Request
query Parameters
expand
Array of strings

Determines the computer information to include in the response. Use "none" to retrieve only basic computer information such as policyID and hostName. Use one or several expand options to retrieve a tailored response in addition to the basic information. Use "all" to retrieve all of the computer information. The default is "all", but we recommend using "none" or a limited set of options on all requests to improve performance.

Items Enum: "none" "all" "computerStatus" "tasks" "securityUpdates" "computerSettings" "allSecurityModules" "antiMalware" "webReputation" "activityMonitoring" "deviceControl" "firewall" "intrusionPrevention" "integrityMonitoring" "logInspection" "applicationControl" "SAP" "interfaces" "ESXSummary" "allVirtualMachineSummaries" "azureARMVirtualMachineSummary" "azureVMVirtualMachineSummary" "ec2VirtualMachineSummary" "noConnectorVirtualMachineSummary" "vmwareVMVirtualMachineSummary" "vcloudVMVirtualMachineSummary" "workspaceVirtualMachineSummary" "gcpVirtualMachineSummary"
overrides
boolean

Show only overrides defined for the current computer.

header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Request Body schema: application/json

The settings of the new computer.

object (ActivityMonitoringComputerExtension)

Computer-level configuration for the Activity Monitoring module.

object (AntiMalwareComputerExtension)

Computer-level configuration for the Anti-Malware module. Null for tenants for whom Anti-Malware is hidden.

object (ApplicationControlComputerExtension)

Computer-level configuration for the Application Control module. Null for tenants for whom Application Control is hidden.

assetImportanceID
integer <int32>

ID of the asset importance assigned to the computer. Set to 0 to remove any assignment. Searchable as Numeric.

object (azureARMVirtualMachineSummary)

Details of an Azure virtual machine that is managed using the Azure Resource Manager (ARM).

object (azureVMVirtualMachineSummary)

Details for an Azure virtual machine.

object (ComputerSettings)
object (computerStatus)

Computer status details.

description
string

Description of the computer. Searchable as String.

object (DeviceControlComputerExtension)

Computer-level configuration for the Device Control module. Null for tenants for whom Device Control is hidden.

displayName
string

Display name of the computer. Searchable as String.

object (ec2VirtualMachineSummary)

Details of an AWS EC2 virtual machine.

object (ESXSummary)

VMware ESX Host Information.

object (FirewallComputerExtension)

Computer-level configuration for the Firewall module. Null for tenants for whom Firewall is hidden.

object (gcpVirtualMachineSummary)

Details of a GCP virtual machine.

groupID
integer <int32>

ID of the computer group to which the computer belongs. Set to 0 to remove any assignment. Searchable as Numeric.

hostName
string

Hostname of the computer. Searchable as String.

object (IntegrityMonitoringComputerExtension)

Computer-level configuration for the Integrity Monitoring module. Null for tenants for whom Integrity Monitoring is hidden.

object (Interfaces)
object (IntrusionPreventionComputerExtension)

Computer-level configuration for the Intrusion Prevention module. Null for tenants for whom Intrusion Prevention is hidden.

object (LogInspectionComputerExtension)

Computer-level configuration for the Log Inspection module. Null for tenants for whom Log Inspection is hidden.

object (noConnectorVirtualMachineSummary)

Details of an AWS virtual machine that was added to Deep Security Manager using the legacy Add Cloud Account wizard.

policyID
integer <int32>

ID of the policy assigned to the computer. Set to 0 to remove any assignment. Searchable as Numeric.

relayListID
integer <int32>

ID of the relay list that is assigned to the computer. Set to 0 to remove any assignment. Searchable as Numeric.

object (SAPComputerExtension)

Computer-level configuration for the Scanner module (SAP integration). Null for tenants for whom SAP is hidden.

object (securityUpdates)

Security update details.

object (computerTasks)

Computer task details.

object (vcloudVMVirtualMachineSummary)

Details of a vCloud virtual machine.

object (vmwareVMVirtualMachineSummary)

Details of a VMWare virtual machine.

object (WebReputationComputerExtension)

Computer-level configuration for the Web Reputation module. Null for tenants for whom Web Reputation is hidden.

object (workspaceVirtualMachineSummary)

Details of an AWS Workspace.

Responses
200

successful operation

403

Not authorized to create computers.

Request samples
application/json
{
  • "hostName": "string",
  • "displayName": "string",
  • "description": "string",
  • "groupID": 0,
  • "policyID": 0,
  • "assetImportanceID": 0,
  • "relayListID": 0,
  • "computerStatus": { },
  • "tasks": { },
  • "securityUpdates": {
    },
  • "computerSettings": {
    },
  • "interfaces": {
    },
  • "azureARMVirtualMachineSummary": {
    },
  • "azureVMVirtualMachineSummary": {
    },
  • "ec2VirtualMachineSummary": {
    },
  • "noConnectorVirtualMachineSummary": {
    },
  • "vmwareVMVirtualMachineSummary": {
    },
  • "vcloudVMVirtualMachineSummary": {
    },
  • "workspaceVirtualMachineSummary": {
    },
  • "gcpVirtualMachineSummary": {
    },
  • "antiMalware": {
    },
  • "webReputation": {
    },
  • "deviceControl": {
    },
  • "activityMonitoring": {
    },
  • "firewall": {
    },
  • "intrusionPrevention": {
    },
  • "integrityMonitoring": {
    },
  • "logInspection": {
    },
  • "applicationControl": {
    },
  • "ESXSummary": {
    },
  • "SAP": {
    }
}
Response samples
application/json
{
  • "hostName": "string",
  • "displayName": "string",
  • "description": "string",
  • "lastIPUsed": "string",
  • "platform": "string",
  • "groupID": 0,
  • "policyID": 0,
  • "assetImportanceID": 0,
  • "relayListID": 0,
  • "agentFingerPrint": "string",
  • "applianceFingerPrint": "string",
  • "lastAgentCommunication": 0,
  • "lastApplianceCommunication": 0,
  • "lastSendPolicyRequest": 0,
  • "lastSendPolicySuccess": 0,
  • "agentVersion": "string",
  • "computerStatus": {
    },
  • "tasks": {
    },
  • "securityUpdates": {
    },
  • "computerSettings": {
    },
  • "interfaces": {
    },
  • "biosUUID": "string",
  • "azureARMVirtualMachineSummary": {
    },
  • "azureVMVirtualMachineSummary": {
    },
  • "ec2VirtualMachineSummary": {
    },
  • "noConnectorVirtualMachineSummary": {
    },
  • "vmwareVMVirtualMachineSummary": {
    },
  • "vcloudVMVirtualMachineSummary": {
    },
  • "workspaceVirtualMachineSummary": {
    },
  • "gcpVirtualMachineSummary": {
    },
  • "hostGUID": "string",
  • "agentGUID": "string",
  • "ID": 0,
  • "antiMalware": {
    },
  • "webReputation": {
    },
  • "deviceControl": {
    },
  • "activityMonitoring": {
    },
  • "firewall": {
    },
  • "intrusionPrevention": {
    },
  • "integrityMonitoring": {
    },
  • "logInspection": {
    },
  • "applicationControl": {
    },
  • "ESXSummary": {
    },
  • "SAP": {
    }
}

Search Computers

post/computers/search

Search for computers using optional filters.

Related SDK Methods:
Java

ComputersApi.searchComputers([param1, param2, ...])

Python

ComputersApi.search_computers([param1, param2, ...])

JavaScript

ComputersApi.searchComputers([param1, param2, ...])

Request
query Parameters
expand
Array of strings

Determines the computer information to include in the response. Use "none" to retrieve only basic computer information such as policyID and hostName. Use one or several expand options to retrieve a tailored response in addition to the basic information. Use "all" to retrieve all of the computer information. The default is "all", but we recommend using "none" or a limited set of options on all requests to improve performance.

Items Enum: "none" "all" "computerStatus" "tasks" "securityUpdates" "computerSettings" "allSecurityModules" "antiMalware" "webReputation" "activityMonitoring" "deviceControl" "firewall" "intrusionPrevention" "integrityMonitoring" "logInspection" "applicationControl" "SAP" "interfaces" "ESXSummary" "allVirtualMachineSummaries" "azureARMVirtualMachineSummary" "azureVMVirtualMachineSummary" "ec2VirtualMachineSummary" "noConnectorVirtualMachineSummary" "vmwareVMVirtualMachineSummary" "vcloudVMVirtualMachineSummary" "workspaceVirtualMachineSummary" "gcpVirtualMachineSummary"
overrides
boolean

Show only overrides defined for the current computer.

header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Request Body schema: application/json

A collection of options used to filter the search results.

maxItems
integer <int32>

Limits the number of objects returned. Default 5000.

Array of objects (searchCriteria)

Array of search critiera used to filter objects. Searching with multiple criteria returns results that satisfy all of the criteria. Searching with no criteria returns all objects.

sortByObjectID
boolean

If true, forces the response objects to be sorted by ID, overriding the default sort order. Default "false".

Responses
200

successful operation

403

Not authorized to view computers.

Request samples
application/json
{
  • "maxItems": 0,
  • "searchCriteria": [
    ],
  • "sortByObjectID": true
}
Response samples
application/json
{
  • "computers": [