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 find all licenses that have an expiration date that is earlier than the date specified in this function.

This function requires a 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 2015-05-26, 2015-09-10, and 2015-12-02, and you specify an expiration date of 2015-09-10 in this function, the first two licenses will be returned.

Return values

The response is of the type Soap_Response_List_License, with result_array of type ArrayOfSoap_License.

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: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

<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>
  • No labels