Devices¶
-
class
py42.clients.devices.
DeviceClient
(session)¶ Bases:
py42.clients.BaseClient
A class to interact with Code42 device/computer APIs.
-
block
(device_id)¶ Blocks a device causing the user not to be able to login or restore.
- Parameters
device_id (int) – The ID of the device.
- Returns
-
deactivate
(device_id)¶ Deactivates a device, causing backups to stop and archives to go to cold storage.
- Parameters
device_id (int) – The ID of the device.
- Returns
- Deauthorizes the device with the given ID. If used on a cloud connector device, it will
remove the authorization token for that account.
- Parameters
device_id (int) – The ID of the device.
- Returns
-
get_all
(active=None, blocked=None, org_uid=None, user_uid=None, destination_guid=None, include_backup_usage=None, include_counts=True, q=None, **kwargs)¶ Gets all device information.
When no arguments are passed, all records are returned. To filter results, specify respective arguments. For example, to retrieve all active and blocked devices, pass active=true and blocked=true.
- Parameters
active (bool, optional) – Filters results by device state. When set to True, gets all active devices. When set to False, gets all deactivated devices. When set to None or excluded, gets all devices regardless of state. Defaults to None.
blocked (bool, optional) – Filters results by blocked status, True or False. Defaults to None.
org_uid (int, optional) – An ID of an Organization. Defaults to None.
user_uid (int, optional) – An ID of a User. Defaults to None.
destination_guid (str of int, optional) – The GUID of the server that the desktop clients back up their files to. Defaults to None.
include_backup_usage (type, bool) – A flag to denote whether to include destination and its backup summary. Defaults to None.
include_counts (bool, optional) – A flag to denote whether to include total, warning, and critical counts. Defaults to True.
q (type, optional) – Searches results flexibly by incomplete GUID, host-name, computer name, etc. Defaults to None.
- Returns
An object that iterates over
py42.sdk.response.Py42Response
objects that each contain a page of devices.For a logged in ordinary end user, it returns all the user’s devices.
For an organization administrator, it returns all the devices in the organization.
For a cross-organization administrator, it returns all the devices from all the user’s organizations.
Finally, for are a customer cloud administrator, it returns all devices in all organizations.
- Return type
generator
-
get_by_guid
(guid, include_backup_usage=None, **kwargs)¶ Gets device information by GUID.
- Parameters
guid (str) – The GUID of the device.
include_backup_usage (bool, optional) – A flag to denote whether to include its backup summary. Defaults to None.
- Returns
A response containing device information.
- Return type
-
get_by_id
(device_id, include_backup_usage=None, **kwargs)¶ Gets device information by ID.
- Parameters
device_id (int) – The ID of the device.
include_backup_usage (bool, optional) – A flag to denote whether to include its backup summary. Defaults to None.
- Returns
A response containing device information.
- Return type
-
get_settings
(guid, keys=None)¶ Gets settings of the device.
- Parameters
guid (str) – The GUID of the device.
keys (type, optional) – A comma separated list of device keys. Defaults to None.
- Returns
A response containing settings information.
- Return type
-
reactivate
(device_id)¶ Activates a previously deactivated device.
- Parameters
device_id (int) – The ID of the device.
- Returns
-
unblock
(device_id)¶ Unblocks a device, permitting a user to be able to login and restore again.
- Parameters
device_id (int) – The ID of the device.
- Returns
-