License Utility API
You can use the License Utility API to connect with the BMC TrueSight Capacity Optimization server and return the license information in the XML and JSON formats. The XML generated is same as that returned by License Tracking utility.
To access the API, ensure that your user role has the following activities assigned to it:
- Enable access to Data API activity - (API_DATA)
- Administration section - View activity - (WEB_ADMIN)
For more information about managing roles and activities, see Adding-and-managing-roles.
Retrieving the licenses in XML fomat
Method | GET |
URI pattern | /dh-services/data/license |
Description | Retrieve the licenses in XML format |
Request parameters | NA |
Sample response | Click here to show/hide the sample response file...<?xml version="1.0" encoding="UTF-8"?><bmc_license_xml_report xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="LicenseDataXMLSimplifiedSample.xsd"> <entry> <field_value> <name>AuditCount</name> <value>1</value> </field_value> <field_value> <name>Host</name> <value>vl-pun-bco-qa34.bmc.com</value> </field_value> <field_value> <name>LicenseChecksum</name> <value>486767383</value> </field_value> <field_value> <name>LicenseDescription</name> <value>Overall number of managed systems</value> </field_value> <field_value> <name>LicenseRequestedFrom</name> <value>1484677800000</value> </field_value> <field_value> <name>LicenseRequestedTo</name> <value>1484764200000</value> </field_value> <field_value> <name>LicenseType</name> <value>20</value> </field_value> <field_value> <name>ProductName</name> <value>BMC TrueSight Capacity Optimizer for Servers</value> </field_value> <field_value> <name>ReportDate</name> <value>1484806077261</value> </field_value> <field_value> <name>SuiteName</name> <value>BMC TrueSight Capacity Optimization</value> </field_value> </entry> <entry> <field_value> <name>AuditCount</name> <value>1</value> </field_value> <field_value> <name>Host</name> <value>vl-pun-bco-qa34.bmc.com</value> </field_value> <field_value> <name>LicenseChecksum</name> <value>1677676054</value> </field_value> <field_value> <name>LicenseDescription</name> <value>Overall number of managed systems - distinct by name</value> </field_value> <field_value> <name>LicenseRequestedFrom</name> <value>1484677800000</value> </field_value> <field_value> <name>LicenseRequestedTo</name> <value>1484764200000</value> </field_value> <field_value> <name>LicenseType</name> <value>20</value> </field_value> <field_value> <name>ProductName</name> <value>BMC TrueSight Capacity Optimizer for Servers - distinct by name</value> </field_value> <field_value> <name>ReportDate</name> <value>1484806077261</value> </field_value> <field_value> <name>SuiteName</name> <value>BMC TrueSight Capacity Optimization</value> </field_value> </entry> <entry> <field_value> <name>AuditCount</name> <value>0</value> </field_value> <field_value> <name>Host</name> <value>vl-pun-bco-qa34.bmc.com</value> </field_value> <field_value> <name>LicenseChecksum</name> <value>289352045</value> </field_value> <field_value> <name>LicenseDescription</name> <value>Number of managed systems imported from Capacity Agents</value> </field_value> <field_value> <name>LicenseRequestedFrom</name> <value>1484677800000</value> </field_value> <field_value> <name>LicenseRequestedTo</name> <value>1484764200000</value> </field_value> <field_value> <name>LicenseType</name> <value>20</value> </field_value> <field_value> <name>ProductName</name> <value>BMC TrueSight Capacity Optimizer for Servers [Capacity Agents]</value> </field_value> <field_value> <name>ReportDate</name> <value>1484806077261</value> </field_value> <field_value> <name>SuiteName</name> <value>BMC TrueSight Capacity Optimization</value> </field_value> </entry> <entry> <field_value> <name>AuditCount</name> <value>0</value> </field_value> <field_value> <name>Host</name> <value>vl-pun-bco-qa34.bmc.com</value> </field_value> <field_value> <name>LicenseChecksum</name> <value>2037891146</value> </field_value> <field_value> <name>LicenseDescription</name> <value>Number of managed systems imported from Capacity Agents - distinct by name</value> </field_value> <field_value> <name>LicenseRequestedFrom</name> <value>1484677800000</value> </field_value> <field_value> <name>LicenseRequestedTo</name> <value>1484764200000</value> </field_value> <field_value> <name>LicenseType</name> <value>20</value> </field_value> <field_value> <name>ProductName</name> <value>BMC TrueSight Capacity Optimizer for Servers [Capacity Agents] - distinct by name</value> </field_value> <field_value> <name>ReportDate</name> <value>1484806077261</value> </field_value> <field_value> <name>SuiteName</name> <value>BMC TrueSight Capacity Optimization</value> </field_value> </entry> <entry> <field_value> <name>AuditCount</name> <value>0</value> </field_value> <field_value> <name>Host</name> <value>vl-pun-bco-qa34.bmc.com</value> </field_value> <field_value> <name>LicenseChecksum</name> <value>1548499269</value> </field_value> <field_value> <name>LicenseDescription</name> <value>Overall number of managed network devices</value> </field_value> <field_value> <name>LicenseRequestedFrom</name> <value>1484677800000</value> </field_value> <field_value> <name>LicenseRequestedTo</name> <value>1484764200000</value> </field_value> <field_value> <name>LicenseType</name> <value>20</value> </field_value> <field_value> <name>ProductName</name> <value>BMC TrueSight Capacity Optimizer for Network</value> </field_value> <field_value> <name>ReportDate</name> <value>1484806077261</value> </field_value> <field_value> <name>SuiteName</name> <value>BMC TrueSight Capacity Optimization</value> </field_value> </entry> <entry> <field_value> <name>AuditCount</name> <value>0</value> </field_value> <field_value> <name>Host</name> <value>vl-pun-bco-qa34.bmc.com</value> </field_value> <field_value> <name>LicenseChecksum</name> <value>811262598</value> </field_value> <field_value> <name>LicenseDescription</name> <value>Overall number of managed ports</value> </field_value> <field_value> <name>LicenseRequestedFrom</name> <value>1484677800000</value> </field_value> <field_value> <name>LicenseRequestedTo</name> <value>1484764200000</value> </field_value> <field_value> <name>LicenseType</name> <value>20</value> </field_value> <field_value> <name>ProductName</name> <value>BMC TrueSight Capacity Optimizer for Storage</value> </field_value> <field_value> <name>ReportDate</name> <value>1484806077261</value> </field_value> <field_value> <name>SuiteName</name> <value>BMC TrueSight Capacity Optimization</value> </field_value> </entry> </bmc_license_xml_report> |
Retrieving the licenses in JSON format
Method | GET |
URI pattern | /dh-services/data/v2/license |
Description | Retrieve the licenses in JSON format |
Request parameters | NA |
Request header | Accept: application/json |
Sample response | Click here to show/hide the sample response file...{ "co": { "AUDIT_COUNT": "24789", "HOST": "optcore", "LICENSE_DESCRIPTION": "Overall number of managed systems", "LICENSE_REQUESTED_FROM": "1582848000000", "LICENSE_REQUESTED_TO": "1584057600000", "LICENSE_TYPE": "20", "PRODUCT_NAME": "TrueSight Capacity Optimizer for Servers", "PRODUCT_VERSION": "20.02", "REPORT_DATE": "1584119036388", "SUITE_NAME": "TrueSight Capacity Optimization" }, "co-distinct-name": { "AUDIT_COUNT": "24789", "HOST": "optcore", "LICENSE_DESCRIPTION": "Overall number of managed systems - distinct by name", "LICENSE_REQUESTED_FROM": "1582848000000", "LICENSE_REQUESTED_TO": "1584057600000", "LICENSE_TYPE": "20", "PRODUCT_NAME": "TrueSight Capacity Optimizer for Servers", "PRODUCT_VERSION": "20.02", "REPORT_DATE": "1584119036388", "SUITE_NAME": "TrueSight Capacity Optimization" }, "coee": { "AUDIT_COUNT": "24786", "HOST": "optcore", "LICENSE_DESCRIPTION": "Number of managed systems imported from Capacity Agents", "LICENSE_REQUESTED_FROM": "1582848000000", "LICENSE_REQUESTED_TO": "1584057600000", "LICENSE_TYPE": "20", "PRODUCT_NAME": "TrueSight Capacity Optimizer for Servers [Capacity Agents]", "PRODUCT_VERSION": "20.02", "REPORT_DATE": "1584119036388", "SUITE_NAME": "TrueSight Capacity Optimization" }, "coee-distinct-name": { "AUDIT_COUNT": "24786", "HOST": "optcore", "LICENSE_DESCRIPTION": "Number of managed systems imported from Capacity Agents - distinct by name", "LICENSE_REQUESTED_FROM": "1582848000000", "LICENSE_REQUESTED_TO": "1584057600000", "LICENSE_TYPE": "20", "PRODUCT_NAME": "TrueSight Capacity Optimizer for Servers [Capacity Agents]", "PRODUCT_VERSION": "20.02", "REPORT_DATE": "1584119036388", "SUITE_NAME": "TrueSight Capacity Optimization" }, "network": { "AUDIT_COUNT": "0", "HOST": "optcore", "LICENSE_DESCRIPTION": "Overall number of managed network devices", "LICENSE_REQUESTED_FROM": "1582848000000", "LICENSE_REQUESTED_TO": "1584057600000", "LICENSE_TYPE": "20", "PRODUCT_NAME": "TrueSight Capacity Optimizer for Network", "PRODUCT_VERSION": "20.02", "REPORT_DATE": "1584119036388", "SUITE_NAME": "TrueSight Capacity Optimization" }, "storage": { "AUDIT_COUNT": "0", "HOST": "optcore", "LICENSE_DESCRIPTION": "Overall number of managed ports", "LICENSE_REQUESTED_FROM": "1582848000000", "LICENSE_REQUESTED_TO": "1584057600000", "LICENSE_TYPE": "20", "PRODUCT_NAME": "TrueSight Capacity Optimizer for Storage", "PRODUCT_VERSION": "20.02", "REPORT_DATE": "1584119036388", "SUITE_NAME": "TrueSight Capacity Optimization" } } |
Related topic