keyboard_arrow_down
  • 12.0
  • 20.0

Computer Device Control Exception Rules

List Device Exception Rules

get/computers/{computerID}/devicecontrol/usbdeviceexceptionrules

Lists all device exception rules assigned to a computer.

Related SDK Methods:
Java

ComputerDeviceControlExceptionRulesApi.listExceptionRulesOnComputer([param1, param2, ...])
Python

ComputerDeviceControlExceptionRulesApi.list_exception_rules_on_computer([param1, param2, ...])
JavaScript

ComputerDeviceControlExceptionRulesApi.listExceptionRulesOnComputer([param1, param2, ...])

Request
Security:
DefaultAuthentication
path Parameters
computerID
required
integer <int32> \d+

The ID number of the computer.

Example: 1
query Parameters
overrides
boolean

Return only Exception Rules directly related to the current computer.

header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Responses
200

successful operation

403

User or API key is not authorized to view the computer.

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.ComputerDeviceControlExceptionRulesApi;
import com.trendmicro.deepsecurity.model.ExceptionRules;


public class ListExceptionRulesOnComputerExample {
	
	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
		ComputerDeviceControlExceptionRulesApi instance = new ComputerDeviceControlExceptionRulesApi();
		Integer computerID = 1;
		Boolean overrides = false;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			ExceptionRules result = instance.listExceptionRulesOnComputer(computerID, overrides, apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling ComputerDeviceControlExceptionRulesApi.listExceptionRulesOnComputer");
			e.printStackTrace();
		}
	}
}
Response samples
application/json
{
  • "exceptionRules": [
    ]
}

Add Device Exception Rules

post/computers/{computerID}/devicecontrol/usbdeviceexceptionrules

Assign device exception rules to a computer.

Related SDK Methods:
Java

ComputerDeviceControlExceptionRulesApi.addExceptionRulesOnComputer([param1, param2, ...])
Python

ComputerDeviceControlExceptionRulesApi.add_exception_rules_on_computer([param1, param2, ...])
JavaScript

ComputerDeviceControlExceptionRulesApi.addExceptionRulesOnComputer([param1, param2, ...])

Request
Security:
DefaultAuthentication
path Parameters
computerID
required
integer <int32> \d+

The ID number of the computer.

Example: 1
query Parameters
overrides
boolean

Return only Exception Rules directly related to the current computer.

header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Request Body schema: application/json

Exception Rules for the device.

Array of objects (ExceptionRule)
Responses
200

successful operation

403

User or API key is not authorized to modify the computer or the requested modification is not permitted.

404

The computer does not exist.

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

Set Device Exception Rules

put/computers/{computerID}/devicecontrol/usbdeviceexceptionrules

Set device exception rules assigned to a computer.

Related SDK Methods:
Java

ComputerDeviceControlExceptionRulesApi.setExceptionRulesOnComputer([param1, param2, ...])
Python

ComputerDeviceControlExceptionRulesApi.set_exception_rules_on_computer([param1, param2, ...])
JavaScript

ComputerDeviceControlExceptionRulesApi.setExceptionRulesOnComputer([param1, param2, ...])

Request
Security:
DefaultAuthentication
path Parameters
computerID
required
integer <int32> \d+

The ID number of the computer.

Example: 1
query Parameters
overrides
boolean

Return only Exception Rules directly related to the current computer.

header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Request Body schema: application/json

Exception Rules for the device.

Array of objects (ExceptionRule)
Responses
200

successful operation

403

User or API key is not authorized to modify the computer or the requested modification is not permitted.

404

The computer does not exist.

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

Remove a Device Exception Rule

delete/computers/{computerID}/devicecontrol/usbdeviceexceptionrules/{exceptionRuleID}

Unassign a device exception rule from a computer.

Related SDK Methods:
Java

ComputerDeviceControlExceptionRulesApi.removeExceptionRuleOnComputer([param1, param2, ...])
Python

ComputerDeviceControlExceptionRulesApi.remove_exception_rule_on_computer([param1, param2, ...])
JavaScript

ComputerDeviceControlExceptionRulesApi.removeExceptionRuleOnComputer([param1, param2, ...])

Request
Security:
DefaultAuthentication
path Parameters
computerID
required
integer <int32> \d+

The ID number of the computer.

Example: 1
exceptionRuleID
required
integer <int64> \d+

The ID number of the Exception Rule to delete.

Example: 1
query Parameters
overrides
boolean

Return only Exception Rules directly related to the current computer.

header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Responses
200

successful operation

403

User or API key is not authorized to modify the computer or the requested modification is not permitted.

404

The computer does not exist.

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.ComputerDeviceControlExceptionRulesApi;
import com.trendmicro.deepsecurity.model.ExceptionRules;


public class RemoveExceptionRuleOnComputerExample {
	
	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
		ComputerDeviceControlExceptionRulesApi instance = new ComputerDeviceControlExceptionRulesApi();
		Integer computerID = 1;
		Long exceptionRuleID = 1L;
		Boolean overrides = false;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			ExceptionRules result = instance.removeExceptionRuleOnComputer(computerID, exceptionRuleID, overrides, apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling ComputerDeviceControlExceptionRulesApi.removeExceptionRuleOnComputer");
			e.printStackTrace();
		}
	}
}
Response samples
application/json
{
  • "exceptionRules": [
    ]
}
➔ Next to Computer Firewall Rule Assignments