Device Action

Action Type:

• exempt: exempt a device completely.

  • Apply: all devices exclude Unknown, Ignored, Out-of-license-usage devices, Domain controller

• unexempt: unexempt device

  • Apply: all devices exclude Unknown, Ignored, Out-of-license-usage devices, Domain controller

• ignore: ignore an unknown device

  • Apply: unknown devices only

• unignore: undo ignore action.

  • Apply: ignored devices only

• delete: delete devices

  • Apply: all devices

• dhcprenew: force ME call a DHCP request

  • Apply: devices which installed a persistent agent only

• re-identify: force ME re-identify the device

  • Apply: This action is only applicable for Windows persistent agent version 7.6.71.0+ and macOS persistent agent 10.4.123.0+ and Mobile agent

• assign_to_group: assign devices to a group

  • Apply: all devices exclude devices with domain controller agent installed

• fetch_agent_log: request to retrieve My OPSWAT Central Management agent log on devices

• scan_threats: perform an on-demand threats scan on devices. This action is only applicable for Windows persistent agent version 7.6.206.0+ and macOS persistent agent 10.4.205.0+

Device IDs of devices to be applied the action.

The request body must have ids parameter or macs parameter, but not both.

MAC addresses of devices to be applied the action

The request body must have ids parameter or macs parameter, but not both.

Specify how long you want to exempt devices in hour. Value should be less than 65000

if this parameter equals 0, My OPSWAT Central Management will exempt devices forever

Specify which group (group id) you want to assign devices to

This parameter should be specified when action type is assign_to_group

Only apply for scan_threats action

0: custom scan, 1: full scan

Only apply for scan_threats action

Specify which types of custom scan agent will perform the scanning. Types are defined as below

0: Memory

1: System Volume

2: Portable Volumes

3: Additional Volumes

4: Specific Path

5: Boot Records

Only apply for scan_threats action

Specify a location where agent will perform the scanning

action status. Value can be

• -1: the action is not supported for a specified device
• 0: failed to apply the action
• 1: apply action successfully

Apply for fetch_agent_log action and scan_threats action

Command ID of the action. This will be used in Get Report v3.0+. This parameter will be empty if the action is failed/not supported (status is -1/0) or the action type is not fetch_agent_log, scan_threats

Renew IP

Exempt

Unexempt