List Devices

Returns information about user devices protected using Druva inSync.

External Documentation

To learn more, visit the Druva documentation.

​

Basic Parameters

Parameter	Description
Device IDs	Filter the list of devices by specifying only the required device IDs, separated by commas. Can be obtained using the List Devices action.
Profile IDs	Specify the profile IDs, separated by commas, to get a list of devices associated with multiple profiles. Can be obtained by using the List Profiles action.
User ID	Specify the user ID to get a list of devices associated with a single user.
User IDs	Specify the user IDs, separated by commas, to get a list of devices associated with multiple users. Can be obtained using the List Users action.

​

Advanced Parameters

Parameter	Description
Client Version	Filter the list of devices by the inSync Client version installed on it.
Device Marked Inactive	Filter the list of devices that are marked as inactive.
Device Status	Filter the list by specifying the status of the device.
Max Added On	Filter to list devices that are added to Druva inSync after a particular date.
Max Last Connected	Filter to list devices that are connected to Druva inSync before a particular date.
Min Added On	Filter to list devices that are added to Druva inSync after a particular date.
Min Last Connected	Filter to list devices that are connected to Druva inSync after a particular date.
Page Token	The token to access the next page of results. Use the token value received in the previous response’s parameter ‘nextPageToken’.
Platform OS	Filter the list of devices by specifying the operating system of the device.
Search Prefix Device Name	Specify the prefix from the device name by which you intend to search and list the devices.
Serial Number	Get device information using the unique serial number assigned to an individual piece of hardware by the manufacturer.
Upgrade State	The upgrade state of the device.
Uuid	Get device information using the unique 128-bit number UUID used to identify device on internet.

​

Example Output

{
	"totalSize": 1,
	"nextPageToken": "MTExMQ==",
	"devices": [
		{
			"deviceID": 12345,
			"deviceName": "Ernie Carter's Macbook",
			"serialNumber": "PX045",
			"deviceOS": "mojave",
			"deviceOSVersion": "10.14 r34567",
			"platformOS": "darwin",
			"uuid": "TY5h67-5674r-675645",
			"clientVersion": "6.1.0 r56746",
			"deviceStatus": "enabled",
			"upgradeState": "NOT UPGRADABLE",
			"userID": 1,
			"totalBackupData": "40.05 GB",
			"totalBackupDataInBytes": 43003360051,
			"addedOn": "2019-10-25T00:00:00Z",
			"lastUpgradedOn": "2019-10-25T00:00:00Z",
			"lastConnected": "2019-10-25T00:00:00Z",
			"deviceMarkedInactive": true,
			"disabledMode": "Manual",
			"disabledOn": "2019-10-25T00:00:00Z"
		}
	]
}