Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

ParameterRequiredTypeDescription
fieldsVisibilityNojson/string 

rn

Nostring 
filterNojson/string

Applies filtering license usage data on all fields.

To filter by string column, use the following format:

Code Block
languagejs
[
	{ 
		"type": "string",
		"field": "ucd",
		"value": "${value}"
	}
]
To filter by numeric column, use the following format: 

 

Code Block
[
    {
        "type": "numeric",
        "comparison": "${gt | lt | eq}",
        "field": "${uct | ucdy | ucde | ucch}",
        "value": "${value}"
    }
]
limitNointegerDetermines the maximum number of data records that can be returned. The value must be greater than zero.
offsetNointegerSpecifies the offset of the first row to return.
orderByNostringSpecifies the field by which you want to order your data records. The field name can be one of the following: ucd, uct, ucdy, ucde, ucch.
orderDirectionNostringDetermines whether the sorting results will be displayed in ascending (ASC) or descending (DESC) order.

If your request is successful, you should see a response similar to the following:

Code Block
{
    success: ${success},
    msg: ${message},
    data: [{
        "ucd": ${date},
        "uct": ${totalUsers},
        "ucdy": ${dailyUsers},
        "ucde": ${deniedUsers},
        "ucch": ${consurrentHosts}
    }],
    "code": ${errorCode},
    "totalCount": ${totalNumberOfRecords}
}

where the response fields can be explained as follows:

FieldTypeDescription
ucd
stringDate in YYYY-MM-DD format.
uct
integerTotal Users.
ucdy
integerDaily Users.
ucde
integerDenied Users.
ucch
integerConcurrent Hosts.
msg
stringError message returned on failure.
success
booleanIndicates if the API request was successfully processed. 
codeintegerError code if success == false.
totalCountintegerTotal number of records.