OData Version 4.0 filter string (limited functionality). Supports only 'and', 'eq', and 'in' conjunction ('or' and 'not' are NOT supported). Supported fields and operators are in the below given table. Multiple filters are supported.
| Field | Operators | Required | Type | Default Value | Summary |
| --------- | -------- | -------- | -------- | -------- | -------- |
| field | eq | No | String | N/A | Format is a string from a specified enum list given below |
| terms | in | No | String | N/A | Format is a list of strings |
The operators are implemented as follows:
-
eq: Only values exactly matching the given value are returned.
-
in: Only values present in the given list are returned.
List of applicable filters for field and terms
| Field | Applicable Terms | Summary |
|---|
| APP_CAT | Refer to list below. Example: ["Antivirus", "Web"] | Returns applications based on their application categories |
| STATE | ["allowed", "partial", "blocked"] | Returns applications based on the permissions they are assigned to |
| RISK | ["Low", "High", "Suspicious", "Moderate", "Trustworthy", "Not Evaluated"] | Returns applications based on their risk level |
| TLS_VERSION | ["TLS 1.1", "TLS 1.2"] These are examples | Returns applications based on their tls versions |
| APPLICATION_HOST_TYPE | ["Hybrid", "Private", "Public"] | Returns applications based on their application host type |
| COUNTRY | Depends on the server location of the apps available in the site. Have to use country code, for example: "IN" | Returns applications based on their server location |
| ROLE | Depends on the roles assigned on the user | Returns applications based on their assigned roles |
List of application categories available:
- Antivirus
- Business and Economy
- Computer and Internet Info
- Computer and Internet Security
- Encrypted
- Internet Communications
- Network Service
- Office365 SAAS
- Standard
- Web
If no filter is passed on as the query param, default behavior will return both active and inactive applications as a default value, which is what the example above filter is.
