Software Changes

Describe a software change

get/softwarechanges/{softwareChangeID}

Describe a software change by ID.

Related SDK Methods:
Java

SoftwareChangesApi.describeSoftwareChange([param1, param2, ...])

Python

SoftwareChangesApi.describe_software_change([param1, param2, ...])

JavaScript

SoftwareChangesApi.describeSoftwareChange([param1, param2, ...])

Request
path Parameters
softwareChangeID
required
integer <int64> \d+

The ID number of the software change to describe.

Example: 1
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 software changes.

404

The software change 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.SoftwareChangesApi;
import com.trendmicro.deepsecurity.model.SoftwareChange;


public class DescribeSoftwareChangeExample {
	
	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
		SoftwareChangesApi instance = new SoftwareChangesApi();
		Long softwareChangeID = 1L;
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			SoftwareChange result = instance.describeSoftwareChange(softwareChangeID, apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling SoftwareChangesApi.describeSoftwareChange");
			e.printStackTrace();
		}
	}
}

Response samples
application/json
{
  • "computerID": 0,
  • "computerGroupID": 0,
  • "vendorName": "string",
  • "productName": "string",
  • "productVersion": "string",
  • "fileVersion": "string",
  • "fileDescription": "string",
  • "sha1": "string",
  • "sha256": "string",
  • "md5": "string",
  • "fileName": "string",
  • "installPath": "string",
  • "fileSize": 0,
  • "changeEventTime": 0,
  • "changeByUser": "string",
  • "changeByUserID": "string",
  • "changeByProcess": "string",
  • "changeByProcessID": "string",
  • "changeByProcessSignerName": "string",
  • "changeByProcessSignerInfo": "string",
  • "changeByProcessVendor": "string",
  • "changeByProcessProductName": "string",
  • "fileSignerName": "string",
  • "fileSignerInfo": "string",
  • "filePathName": "string",
  • "ID": 0
}

List software changes

get/softwarechanges

Lists all software changes.

Related SDK Methods:
Java

SoftwareChangesApi.listSoftwareChanges([param1, param2, ...])

Python

SoftwareChangesApi.list_software_changes([param1, param2, ...])

JavaScript

SoftwareChangesApi.listSoftwareChanges([param1, param2, ...])

Request
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 software changes.

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.SoftwareChangesApi;
import com.trendmicro.deepsecurity.model.SoftwareChanges;


public class ListSoftwareChangesExample {
	
	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
		SoftwareChangesApi instance = new SoftwareChangesApi();
		String apiVersion = "YOUR VERSION";
		try {
			// Please replace the parameter values with yours
			SoftwareChanges result = instance.listSoftwareChanges(apiVersion);
			System.out.println(result);
		} catch (ApiException e) {
			System.err.println("An exception occurred when calling SoftwareChangesApi.listSoftwareChanges");
			e.printStackTrace();
		}
	}
}

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

Search software changes

post/softwarechanges/search

Search for software changes using optional filters.

Related SDK Methods:
Java

SoftwareChangesApi.searchSoftwareChanges([param1, param2, ...])

Python

SoftwareChangesApi.search_software_changes([param1, param2, ...])

JavaScript

SoftwareChangesApi.searchSoftwareChanges([param1, param2, ...])

Request
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 software changes.

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

Review software changes

post/softwarechanges/review

Review software changes by given ID list.

Related SDK Methods:
Java

SoftwareChangesApi.reviewSoftwareChanges([param1, param2, ...])

Python

SoftwareChangesApi.review_software_changes([param1, param2, ...])

JavaScript

SoftwareChangesApi.reviewSoftwareChanges([param1, param2, ...])

Request
header Parameters
api-version
required
string

The version of the api being called.

Example: YOUR VERSION
Request Body schema: application/json

The software change review settings.

action
string

Action to perform on the software changes.

Enum: "allow" "block"
softwareChangeIDs
Array of integers <int64>

List of software change IDs.

Responses
200

successful operation

403

Not authorized to delete software changes.

404

Software changes do not exist.

Request samples
application/json
{
  • "softwareChangeIDs": [
    ],
  • "action": "allow"
}
Response samples
application/json
{
  • "softwareChangeIDs": [
    ],
  • "action": "allow",
  • "softwareChangeReviewResults": [
    ]
}