Child pages
  • Manage2 API Functions - Extend One-Time Licenses

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Description


Excerpt

This function extends one-time licenses for one year.


Panel
bgColor#F2F2F2
borderStylenone

Examples 


Panel
bgColor#FFFFFF
borderStylenone


Expand
titleBrowser-based Calls


Code Block
languagetext
titleXML
https://manage2.cpanel.net/XMLonetimeext.cgi?ip=127.0.0.1


Code Block
languagetext
titleJSON
https://manage2.cpanel.net/XMLonetimeext.cgi?output=json&ip=127.0.0.1


Code Block
languagetext
titleYAML
https://manage2.cpanel.net/XMLonetimeext.cgi?output=yaml&ip=127.0.0.1



Expand
titlecPanel Licensing PHP Class


Code Block
languagephp
<?php
include("cpl.inc.php");
$cpl = new cPanelLicensing("barney@example.com","12345luggage");
$lisc = $cpl->extendOnetime(array( "ip" => "127.0.0.11" ) );
?>



Expand
titlecPanel Licensing Perl Module


Code Block
languageperl
linenumberstrue
use cPanelLicensing;
my $licenseManager = new cPanelLicensing(user => 'barney\@example.com', pass => '12345luggage'); 
$licenseManager->extend_onetime_updates (
	'ip' => '127.0.0.1'
);



Expand
titleOutput (JSON)


Code Block
languagetext
linenumberstrue
{
  "version": 0.1,
  "status": 0,
  "reason": "Dispatched notification Updates have been extended for the license on 
ip: 127.0.0.11. The old updates experiation time was: Mon Jul 11 
03:27:02 2011 GMT. The new updates expiration time is: Tue Jul 10 
03:27:02 2012 GMT. If your updates have already expired, you should run 
/usr/local/cpanel/cpkeyclt to reenable updates."
}



Expand
titleOutput (XML)


Code Block
languagexml
linenumberstrue
<XMLonetimeext reason="
 Dispatched notification Updates have been extended for the license on 
ip: 127.0.0.11. The old updates experiation time was: Mon Jul 11 
03:27:02 2011 GMT. The new updates expiration time is: Tue Jul 10 
03:27:02 2012 GMT. If your updates have already expired, you should run 
/usr/local/cpanel/cpkeyclt to reenable updates. " status="1" version="0.1"/>



Expand
titleOutput (YAML)


Code Block
languagetext
linenumberstrue
--- 
reason: Dispatched notification Updates have been extended for the license on 
ip: 127.0.0.11. The old updates experiation time was: Mon Jul 11 
03:27:02 2011 GMT. The new updates expiration time is: Tue Jul 10 
03:27:02 2012 GMT. If your updates have already expired, you should run 
/usr/local/cpanel/cpkeyclt to reenable updates.
status: 0
version: 0.1




Parameters

ParameterTypeDescriptionPossible valuesExample
ipstring

Required

The license account's IP address.

A valid IP address on the server.

The List License Information function returns a list of possible values.

127.0.0.11

Returns

ReturnTypeDescriptionPossible valuesExample
reasonstringThe function's result.A string value.


Expand
titleClick to view...

Dispatched notification Updates have been extended for the license on

ip: 127.0.0.11. The old updates experiation time was: Mon Jul 11

03:27:02 2011 GMT. The new updates expiration time is: Tue Jul 10

03:27:02 2012 GMT. If your updates have already expired, you should run

/usr/local/cpanel/cpkeyclt to reenable updates.


statusBooleanWhether the function succeeded.
  • 1 — Success

  • 0 — Failure.
1
versionnumericInternal information that the Manage2 API uses.A numeric value.0.1