Device Action v3.0

04/10/2018: fixed a bug that the API returns HTTP 400 when group id doesn't exist on an account with assign to group action

05/23/2017: added one more action type (types parameter in request), re-identify 06/28/2017: added one more action type (types parameter in request), assign_to_group

Action Type:

• exempt: exempt a device completely.

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

• unexempt: unexempt device

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

• 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: all devices exclude Unknown, Ignored, Out-of-license-usage devices

• assign_to_group: assign devices to a group

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

HWIDs 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, we will do 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

Result for a device which has the given HWID/MAC address

-1: not support 0: apply action failed

1: apply action successfully

Renew IP

Exempt

Unexempt