Device Type Exemptions
This API is for listing all the temporarily exempted device types in your network.
- Functionality
- To retrieve the device types temporarily exempted in the network.
- HTTP Method
- GET
- API URI
- api/1.4/reports/dcm/devicetypeexemption
- Filters
- os_platform={Numeric}
This is to filter based on OS Platform
1 - Windows
2 - Mac
status={Numeric}
This is to filter temporary access permission records based on device exemption status.
0 - Yet to apply
1 - Awaiting schedule
2 - Active
3 - Expired
devicetype={Numeric}
This is to filter devices based on type. The code equivalents for each device type are as follows:
2 - Biometric
3 - Bluetooth
4 - CDROM
5 - DiskDrive
9 - FloppyDisk
19 - Image
20 - Infrared
21 - Keyboard
24 - Modem
26 - Mouse
37 - Printer
42 - SmartCardReader
46 - TapeDrive
49 - WPD
100 - WPD_AppleDevices
102 - SerialPorts(COM)
103 - ParallelPorts(LPT)
104 - WirelessNetworkAdapters
period={Numeric}
Can filter based on time period
0 - This week
1 - This month
2 - This year
3 - Last week
4 - Last month
5 - Last two months
6 - Last three months
7 - Last six months
8 - Last nine months
9 - Last year
domain={String}
Can filter the records based on domain names.
- Paging
- page={Numeric}
This is for navigating to specific pages. This field denotes the current page.
pagelimit={Numeric}
This is to specify the number of records to be displayed per page.
- Response Parameters
- duration_type
This denotes the type of duration for the latest temporary access session.
1 - Fixed
2 - Window
duration
The duration of access is given in minutes.
All times are in epoch long format.
Response Data
{ "message_type": "dcm", "message_response": { "total": 2, "limit": 25, "page": 1, "dcm": [ { "cr.domain_netbios_name": "WORKGROUP", "ur.name": "Administrator", "policy_id": 8703, "ta_type": 1, "duration_type": 1, "duration_to": 1737643300131, "cr.name": "EC2AMAZ-DS25S0F", "os_platform": 1, "allowed_devices": 2, "policy_name": "Access Name_2003", "is_agent_deployed_access": "[i18n]dc.common.SUCCESS[/i18n]", "device_type": "smp.dcm.removablestoragedevice", "applied_time": 1737639717393, "duration_from": 1737639700131, "duration": 60, "modified_time": 1737639714238 }, { "cr.domain_netbios_name": "macosgroup", "ur.name": "administrator", "policy_id": 8702, "ta_type": 1, "duration_type": 1, "duration_to": 1737643284239, "cr.name": "Darci", "os_platform": 2, "allowed_devices": 2, "policy_name": "Access Name_2354", "is_agent_deployed_access": "smp.status.ytdeploy", "device_type": "smp.dcm.removablestoragedevice", "applied_time": 0, "duration_from": 1737639684239, "duration": 60, "modified_time": 1737639694818 } ] }, "message_version": "1.4", "status": "success", "response_code": 200 }
