Page History

The information on this page refers to SOAP version 1. This function has been replaced in SOAP version 2 with the function FindLicenseByExpirationDateBetween.

The FindLicenseByExpirationDate function is used to to find all licenses that have an expiration date that is earlier than the date specified in this function.

This function requires a LAC administrator login token, which is obtained using the Login function, . This function also uses an offset and an expiration date in the format YYYY-MM-DD. For example, if you have three licenses that expire on 20112015-05-26, 20112015-09-10, and 20122015-12-02, and you specify an expiration date of 20112015-09-10 in this function, the first two licenses will be returned.

In addition, this function uses an offset. Licenses are packed into arrays of 100 elements. You can use an offset greater than 0 to get additional licenses. For example, if you have 321 licenses, you would run this method 4 times using the offsets 0, 100, 200, 300. The first 3 responses will have 100 licenses each, and the last response will have 21 licenses.

Return values

The response is of the type ArrayOfSoapSoap_Response_List_Licensewhich is an , with result_array of Soaptype ArrayOfSoap_Licenseobjects.

Example request

No Format


<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:FindLicenseByExpirationDate soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
         <token xsi:type="xsd:string">292c1bb77d6faf51049dc99e3c3e10d624791052</token>
         <expirationDate xsi:type="xsd:string">2021-12-07</expirationDate>
         <offset xsi:type="xsd:int">0</offset>
      </ns:FindLicenseByExpirationDate>
   </soapenv:Body>
</soapenv:Envelope>

Example response

No Format


<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:SOAP-ENC="http://schemas.xmlsoap.org/soap/encoding/" 
xmlns:xsd="http://www.w3.org/2001/XMLSchema" 
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
   <SOAP-ENV:Body>
      <ns1:FindLicenseByExpirationDateResponse>
         <return xsi:type="ns1:Soap_Response_List_License">
            <result_array SOAP-ENC:arrayType="ns1:Soap_License[1]" xsi:type="ns1:ArrayOfSoap_License">
               <item xsi:type="ns1:Soap_License">
                  <id xsi:type="xsd:int">8</id>
                  <activation_key xsi:type="xsd:string">58ARD-JETMQ-7Z4NQ-WMOEL</activation_key>
                  <license_text xsi:type="xsd:string">
# This license is generated using X-Formation License Activation Center
# Generation Time: 2011-11-23 05:42:04 GMT
# Activation Key: 58ARD-JETMQ-7Z4NQ-WMOEL

FEATURE f1
{
VENDOR = XFORMATION
VERSION = 2.51
END = 2011-12-08
KEY = lixSdQyvYqNHqXrV2EeJC[zfUKD1RCI6jvMmqSKDuFWnnpqV34Aonef0TbnuxzdbD5jc5h \
n72aJG2MOOCeApu1UFX1tNlTJZRa8bkoHCwKUQ3z[QbwBKuMHavXQD0n6BEssNRBRyJXRR \
RJct752lmOx[JbRq5S7FD1Qoba2XyE1cNsjkJ9HtLZn[CYy]NfASgKRkdrm2JVnnrM8IUM \
t8PWH9P]0PeYZatGsjdfhkjsdhfkljsdhfjksdhfjsds9r6rcQEYbK1IshBrBrdehp7OZ[maRgAh2 \
8RgvWxc069mfXaDeoxbeJ2up0VYeRHsbop5il1X8bm3wce[LE[P892T5Qr[GWhdWsgoA[9 \
C5zSLUDRF9L6JItz0o7pix8hHN[zoHxnLoJQlLr[96]MEXkgWOh0qBwEDG3I6aIKbvstXR \
NlGzeQb0s]deqME]kdqE2e8NY6FMpkITjcZzFQ80Z316tyQEqe7ejMcJ
}</license_text>
                  <activation_time xsi:type="xsd:string">2011-11-23 07:42:04</activation_time>
                  <expiration_date xsi:type="xsd:string">2011-12-08</expiration_date>
                  <HostidValues SOAP-ENC:arrayType="ns1:Soap_HostidValue[1]" xsi:type="ns1:ArrayOfSoap_HostidValue">
                     <item xsi:type="ns1:Soap_HostidValue">
                        <name xsi:type="xsd:string">Not Locked</name>
                        <value xsi:type="xsd:string"/>
                     </item>
                  </HostidValues>
               </item>
            </result_array>
            <result_code xsi:type="xsd:int">0</result_code>
            <result_string xsi:nil="true"/>
         </return>
      </ns1:FindLicenseByExpirationDateResponse>
   </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Page tree

Versions Compared

Old Version 4

New Version Current

Key