Create a Monthly License Usage report in GravityZone
This section explains how to create a Monthly License Usage report in the GravityZone console and also by using APIs.
In GravityZone Control Center
To create a Monthly License Usage report:
Log in to GravityZone Control Center.
Go to Reports.
Click Add in the action toolbar.
Under Details, select Monthly License Usage and enter a specific report name, if needed.
Under Settings, configure when the report to be generated, the interval, product type, and delivery by mail, according to your needs.
Optionally, select the report to show only endpoint details and only direct companies.
Under Select Target, select the companies you are interested in.
Click Generate.
To obtain the CSV file:
Generate a Monthly License Usage report.
In the report page, click Export CSV.
Choose Export details in csv.
Select to open or to save the file when prompted by the web browser and confirm.
By using GravityZone APIs
You can obtain the Monthly License Usage report and its CSV file by calling certain API methods:
Make a request for
createReport
.Parameters:
"type": 13
(Monthly License Usage report)"targetIds": [string]
(your own company ID or other companies)
Options:
"reportingInterval": 4
(for the last month)"skipSummary": true
. The report will contain only the details. To include the summary, choosefalse
.
The response will return a result containing a string.
Make a request for
getDownloadLinks
using the string asreportId
parameter.The response will contain the downloading link for the report.
Examples
Request createReport:
{ "params": { "name": "reportName", "type": 13, "targetIds": [ "5a8d349fb1a43d4d19f7ccc9" ], "options": { "reportingInterval": 4, "skipSummary": true } }, "jsonrpc": "2.0", "method": "createReport", "id": "e249c22c-0ada-4772-a9f1-ee1cbb322588" }
Response createReport:
{ "id": "e249c22c-0ada-4772-a9f1-ee1cbb322588", "jsonrpc": "2.0", "result": "5aa246f4b1a43db6152b95af" }
Request getDownloadLinks:
{ "params": { "reportId": "5aa246f4b1a43db6152b95af" }, "jsonrpc": "2.0", "method": "getDownloadLinks", "id": "e249c22c-0ada-4772-a9f1-ee1cbb322588" }
Response getDownloadLinks:
{ "id": "e249c22c-0ada-4772-a9f1-ee1cbb322588", "jsonrpc": "2.0", "result": { "readyForDownload": true, "lastInstanceUrl": "http://192.168.33.20:8221/api/v1.0/http/downloadReportZip?reportId=5aa246f4b1a43db6152b95af&allInstances=0" }
For details regarding the API methods regarding the license usage in GravityZone Cloud, refer to the GravityZone API Guide for Partners, specifically to these methods:
Companies –
createCompany
Licensing –
getLicenseInfo
Licensing –
setMonthlySubscription
Licensing -
getMonthlyUsage
Reports –
createReport
To learn how to calculate the monthly license usage, refer to Calculate the endpoint usage with the Monthly License Usage report.