| The information on this page refers to SOAP version 1. For SOAP version 2, refer to link. |
|---|
The GetActivationCounters function is used to get the LAC activation counters, which includes information such as the number of remaining subscription and one-time activations, applicable counter reset dates, etc.
This function also requires a login token, which is obtained using the Login function.
Return values
The response is of the type Soap_Response_ActivationCounters with result_object of type Soap_ActivationCounters.
This function can be used only by LAC users who have an "Administrator" role. If a user without administrator privileges attempts to use this function, the user will get the response "Access denied."
Example request
<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns="https://license.x-formation.com/soap/type/vendor/version/1">
<soapenv:Header/>
<soapenv:Body>
<ns:GetActivationCounters soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<token xsi:type="xsd:string">ddd93521ad574393d8d6a491917d01c26d80ba89</token>
</ns:GetActivationCounters>
</soapenv:Body>
</soapenv:Envelope>
Example response
<SOAP-ENV:Envelope SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ns1="https://license.x-formation.com/soap/type/vendor/version/1"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Body>
<ns1:GetActivationCountersResponse>
<return xsi:type="ns1:Soap_Response_ActivationCounters">
<result_object xsi:type="ns1:Soap_ActivationCounters">
<free_activations_left_count xsi:type="xsd:int">0</free_activations_left_count>
<free_activations_default_count xsi:type="xsd:int">0</free_activations_default_count>
<ActivationSubscriptions SOAP-ENC:arrayType="ns1:Soap_ActivationSubscription[2]" xsi:type="ns1:ArrayOfSoap_ActivationSubscription">
<item xsi:type="ns1:Soap_ActivationSubscription">
<start_date xsi:type="xsd:string">2011-12-12</start_date>
<expiration_date xsi:type="xsd:string">2012-06-12</expiration_date>
<next_reset_date xsi:type="xsd:string">2012-01-12</next_reset_date>
<activations_left_count xsi:type="xsd:int">200</activations_left_count>
<default_count xsi:type="xsd:int">200</default_count>
</item>
<item xsi:type="ns1:Soap_ActivationSubscription">
<start_date xsi:type="xsd:string">2011-12-12</start_date>
<expiration_date xsi:type="xsd:string">2012-12-12</expiration_date>
<next_reset_date xsi:type="xsd:string">2012-01-12</next_reset_date>
<activations_left_count xsi:type="xsd:int">150</activations_left_count>
<default_count xsi:type="xsd:int">150</default_count>
</item>
</ActivationSubscriptions>
<one_time_activations_left_count xsi:type="xsd:int">100</one_time_activations_left_count>
<one_time_activations_expiration_date xsi:type="xsd:string">2012-12-12</one_time_activations_expiration_date>
</result_object>
<result_code xsi:type="xsd:int">0</result_code>
<result_string xsi:nil="true"/>
</return>
</ns1:GetActivationCountersResponse>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>