[Enhancement] Add the DeviceBackupReport with Cleanup!

[phirst]

Summary

The DeviceBackupReport API allows for getting information about the status of device backups. However, the report will include duplicate rows if the user has more than one backup set (including if the user is active in a Code42 Legal Matter).

This request is to have access to the same report but "cleaned up" of duplicate rows.

Proposed API

DeviceBackupReport --raw --onLegalHold --deactivated --lastCompleted # --lastConnected # --lastBackupActivity # --lessThan --state critical | warning | ok --org orgUid | orgName | [list of uids/names] --srtKey --srtDir

• raw: no removing of duplicate rows
• onLegalHold: assuming the user has the correct roles/permissions, only devices of users on legal hold.
• deactivated: the default is only active devices. This would include deactivated devices
• lastCompleted | lastConnected | lastBackupActivity : these would take a number of days (or a date) and only report on devices that have last thing greater than the date/days.
• lessThan: this would do the last thing and only report on the devices that have since the date/days.
• state: with a parameter to get the devices in the specified state
• org: allow to filter by orgUid or orgName or a list of either.
• srtKey: various columns to sort the results
• srtDir: direction of the sort

Intended Use Case

Enable the replacement of or simplification of other scripts written to provide this data.

[alanag13]

Thanks for submitting this, @phirst !
In order to achieve this, we would first want to expose the Device Backup report api in py42. Once that's complete, I think this is a very well-defined use case.

[natrlhy]

Hope this can still be prioritized!

[natrlhy]

Any progress on this?