...
Parameter | Required | Type | Description | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
${featureId} | Yes | integer | Specifies feature-specific parameters. | ||||||||||
${returnType} | Yes | string | Specifies the format in which license usage data will be returned. The format can be one of the following: json, csv, xls, xlsx or pdf. | ||||||||||
sd | Yes | string | Specifies the start date for which the report will be generated in YYYY-MM-DD format; for example, 2017-01-20. | ||||||||||
ed | Yes | string | Specifies the end date for which the report will be generated in YYYY-MM-DD format; for example, 2017-01-27. | ||||||||||
grat | Yes | integer | Specifies granularity of the returned data, which can be one of the following:
| ||||||||||
agrt | No | integer | Specifies aggregation type of the returned data, which can be one of the following:
By default data is aggregated by username and hostname | ||||||||||
rn | No | string | Specifies the name of the report that will be displayed once the report has been exported to PDF or XLS. For CSV and JSON formats this parameter will be ignored. | ||||||||||
filter | No | json/string | Applies filtering license usage data on all fields. To filter by string column, use the following format:
To filter by numeric column, use the following format:
| ||||||||||
fieldsVisibility | No | json/string | Specifies field visibility settings, like this:
where "1" indicates that a specific field is visible and ''0" indicates that it is not. Note that the order of the settings you make is important – when exported, the fields will be visible in exactly the same order you specify here. | ||||||||||
limit | No | integer | Determines the maximum number of data records that can be returned. The value must be greater than zero. | ||||||||||
offset | No | integer | Specifies the offset of the first row to return. | ||||||||||
orderBy | No | string | Specifies the field by which you want to order your data records. The field name can be one of the following: ludfud | un | luminhn | lualsn | lumaxfns | lbminfv | lbmaxftype | ldtcmusage | hu | mu | hb | ftmb | ||||||||||
orderDirection | No | string | Determines whether the sorting results will be displayed in ascending (ASC) or descending (DESC) order. |
...
Code Block | ||
---|---|---|
| ||
{ "success": ${success}, "msg": ${message}, "data": [ { "fid": ${featureId}, "ludlsid": ${datelicenseServerId}, "luminuid": ${minUseduserId}, "luauil": ${averageUseduserIsLdap}, "lumaxfud": ${maxUseddate}, "lbminun": ${minBorrowedusername}, "lbmaxhn": ${maxBorrowedhostname}, "ldtclsn": ${denialslicenseServerName}, "hufns": ${hoursUsedfeatureName}, "ftfv": ${totalfeatureVersion}, "ftype": ${featureType}, ], "codemusage": ${codemaxUsage}, "totalCounthu": ${hoursUsed}, "mu": ${maxUsed}, "hb": ${hoursBorrowed}, "mb": ${maxBorrowed} } ], "code": ${code}, "totalCount": ${count} } |
where the response fields can be explained as follows:
Field | Type | Description |
---|---|---|
success | boolean | Indicates that your API request was successfully processed. |
msg | string | Error message returned on failure. |
fid |
integer | Feature ID. | |
lsid | integer | License server ID. |
uid | integer | User ID. |
uil | boolean | Information if user is managed by LDAP. |
fud | string | Indicates period of time for which usage information is generated, i.e. date and time for hourly usage and dates for the remaining granularity options. |
un | string | Username. |
hn | string | Hostname. |
lsn | string | License server name. |
fns | string | Feature name. |
fv | string | Feature version. |
ftype | string | Feature type. |
musage | float | Maximum usage of licenses in relation to total license number, expressed in percentages. |
hu | float | Hours used. |
mu | integer | Maximum licenses used count for given date. |
hb |
float |
Hours borrowed. |
mb | integer | Maximum licenses borrowed count for given date |
ldtc
. | ||
code | integer | Error code if success equals false, null otherwise. |
totalCount | integer | Total number of rows returned. |
Obtaining information about usage history comparison for features
...