Enumerating Device Statistics in JSON-RPC API

You can get the statistics of devices of your own company and your customers using the EnumerateAccountStatistics method.

A common use of this method is to output a list of storage space used on the cloud per device. You can get this information by using the Columns parameter and using the column I14.

Please be aware that there are no methods which can perform complex calculations, however the Totals parameter can do basic calculations using column codes. If you need to do complex calculations, you will have to take the given sizes (in Bytes) and do these manually.

Required parameters

Parameter	Description	Supported values
`query`	A group of parameters related to the device statistics	`AccountStatisticsQuery` (has child parameters of its own, see the AccountStatisticsQuery child parameters table below)

AccountStatisticsQuery child parameters

Parameter	Description	Supported values
`PartnerId`	The ID of the customer the device is created for (retrieved through the `GetPartnerInfo` method)	`<int>` Integer
`Filter`	Apply a search parameter using RegularExpression (RegEx)	`<std::string>`
`ExcludedPartners`	A list of partner ID's to exclude from the search	`IdSet`
`SelectionMode`	An array of selection modes	`AccountStatisticsSelectionMode::Enum` `Undefined` `Merged` `PerInstallation` `Count`
`Labels`	Any labels to display	`<int>`
`StartRecordNumber`	Which device number to start the output from	`<std::size_t>` Integer (in mebibytes)
`RecordsCount`	How many devices to display	`<std::size_t>` Integer (in mebibytes)
`OrderBy`	How to order the displayed list of results	`<std::string>`
`Columns`	Which column vectors you wish to display in the response	`ColumnVector` (see API Column Codes for all options)
`Totals`	An array of totals represented as strings, will return totalStatistics. For Example: `["SUM(I14)","COUNT(I59==2)"],` This will return totalStatistics with the sum of used storage for the selected partner and filter and also a count of Cloud2Cloud devices	`TotalVector` `SUM` `COUNT` `MAX` `MIN`

Sample request

{
    "jsonrpc":"2.0",
    "id":"jsonrpc",
    "visa": "{{visa}}",
    "method" : "EnumerateAccountStatistics",
    "params" : {
	"query" : {
		"PartnerId" : 123456,
		"Filter": "ANY =~ 'Device*'",
		"SelectionMode": "Merged",
		"StartRecordNumber": 0,
		"RecordsCount": 3,
		"Columns": ["I1", "I14", "I18", "Do9F00", "D01F07"]
	}
    }			
}

Sample response

{
    "id": "jsonrpc",
    "jsonrpc": "2.0",
    "result": {
	"result": [
	    {
		"AccountId": 654321,
		"Flags": [
		    "AutoDeployed"
		],
		"PartnerId": 123456,
		"Settings": [
		    {
			"I1": "computerName"
		    },
		    {
			"I14": "0"
		    },
		    {
			"I78": "D01D02"
		    }
		]
	    },
	    {
		"AccountId": 765432,
		"Flags": null,
		"PartnerId": 456789,
		"Settings": [
		    {
			"D01F07": "28349567768726"
		    },
		    {
			"D09F00": "1"
		    },
		    {
			"I1": "computerName2"
		    },
		    {
			"I14": "586755749630"
		    },
		    {
			"I78": "D01D02"
		    }
		]
	    },
	    {
		"AccountId": 876543,
		"Flags": null,
		"PartnerId": 456789,
		"Settings": [
		    {
			"D09F00": "5"
		    },
		    {
			"I1": "computerName3"
		    },
		    {
			"I14": "23630480"
		    },
		    {
			"I78": "D19D20D05"
		    }
		]
	    }
	],
	"totalStatistics": null
    },
    "visa": "{{visa}}"
}