topic Re: CUCM - AXL API : Getting License Info in Management

CUCM - AXL API : Getting License Info

Jayaprakash Subramaniam — Tue, 11 Aug 2015 14:37:34 GMT

Hi All,

Looking AXL API capability matrix, I can see that using AXL api, we could perform the following options in CUCM.

listLicenseCapabilities
updateLicenseCapabilities
getLicenseUnitReport
getLicensedUsers

Could some one please help with right documentation to know about the wsdl urls and how do we use this API in terms of request and responses - A developer guide.

The actual objective is pull the license data from CUCM into a my internal monitoring tool as there is no SNMP / option available to get the data from CUCM

It would be great If somebody can guide me a sample of this method using SOAP UI

Thanks in advance

- JP

Re: CUCM - AXL API : Getting License Info

dstaudt — Tue, 11 Aug 2015 21:03:46 GMT

Note that as of CUCM 9.0, licensing is managed by the Enterprise Licensing Manager/Cisco Prime component, and so most license details will not be present in the CUCM database for retrieval via AXL. Note that ELM/Prime does not have any supported APIs itself - it may not be possible to programmatically retrieve all licensing details.

From 9.x-10.0, I believe that the requests listed above may be accepted, but may return invalid/empty results. For these releases essentially no licensing info can be retrieved.

For 10.5, a 'getLicensedUser' operations was added, see an example below, which gets some basic license info per individual.

For 11.0, 'listLicensedUser' was added for searching/bulk info of users, along with 'doUpdateLicenseUsage', which (I think) causes CUCM to sync license info with ELM/Prime for updated data. Note the operations-by-release page does not seem to reflect these two APIs currently (will fix.)

See this page for obtaining the AXL WSDL from the CUCM server:

https://developer.cisco.com/site/axl/learn/how-to/get-wsdl.gsp

getLicensedUser request/response:

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns="http://www.cisco.com/AXL/API/10.5">

<soapenv:Header/>

<soapenv:Body>

<ns:getLicensedUser>

<name>dstaudt</name>

</ns:getLicensedUser>

</soapenv:Body>

</soapenv:Envelope>

---------------------------

<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">

<soapenv:Body>

<ns:getLicensedUserResponse xmlns:ns="http://www.cisco.com/AXL/API/10.5">

<userId>dstaudt</userId>

<firstName>David</firstName>

<lastName>Staudt</lastName>

<licenseType>HCS_Standard</licenseType>

</licensedUser>

</return>

</ns:getLicensedUserResponse>

</soapenv:Body>

</soapenv:Envelope>

Re: CUCM - AXL API : Getting License Info

Jayaprakash Subramaniam — Thu, 13 Aug 2015 07:21:22 GMT

Hi,

Thank you for the response.

I am in the need of mainly pulling license information of CUCM Version 9.x-10.0. Is there any option that I can think of in getting it ?

Will there be an option to query the ELM database to pull this data externally ? Any inputs.

Regards,

Re: CUCM - AXL API : Getting License Info

dstaudt — Thu, 13 Aug 2015 15:49:01 GMT

Unfortunately I don't think there is a solution for now.

This FAQ notes a place where you can provide feedback on enhancements (e.g. an API) on ELM/Prime programmability:

Cisco AXL

Re: CUCM - AXL API : Getting License Info

istibekesi — Fri, 19 Aug 2016 09:21:58 GMT

Any update about this so far?