Reactivate expired licenses — XMLlicenseReActivate.cgi
This Manage2 function allows you to reactivate an expired license.
- liscid (integer) — The ID of the license you wish to reactivate.
- force (boolean) — Reactivates the license even if it will extend an existing termed license or if the license was deactivated within 48 hours of billing. This variable is optional.
- Note: A billing adjustment will be made to your account if the license was deactivated within 48 hours prior to your last billing date.
1 — Results in a forced license reactivation.
0 — The new license will not be reactivated forcefully.
- Note: It is no longer necessary to use the force, billme, and reactivateok options together to force an activation. The only variable required is force. The reactivateok and billme functions are deprecated.
- dryrun (boolean) — Shows error messages and price information without reactivating the license.
1 — Show the error messages and price information, without reactivating the license.
0 — Activates the license. If
force is required, the license will not activate.
- licenseid (integer) — The ID of the license that has been reactivated.
- price (string) — The price billed immediately after reactivating. The price shown could be for yearly licenses, or if the license was deactivated within 48 hours of billing.
- monthly_price (string) — The price that will be added to the customer's monthly bill for this license.
- reason (string) — Describes, in English, the result of the request.
Reactivated TRAININGSEMINAR-INTERNAL license on 184.108.40.206 in the 'foo' group.
- status (boolean) — Indicates the status of the license reactivation.
1 — The license has been successfully reactivated.
0 — The license has not been reactivated.
Using HTTP (direct API call)
Calling =http://manage2.cpanel.net/XMLlicenseReActivate.cgi?liscid=12354 in a web browser will produce XML output similar to the following:
<XMLlicenseReActivate licenseid="12354" monthly_price="0.00"
price="0.00" reason="Reactivated TRAININGSEMINAR-INTERNAL license on
220.127.116.11 in the 'foo' group." status="1"/>
Calling the function using the URL above will return XML data by default. To change the output format that will be returned, use either of the following URLs:
- JSON —
- YAML —
For more information about each of these output types, visit our Choosing an Output Type
Using a Perl module
The following is an example of a Perl module that will call
. You can use this module to pass input variables to a Manage2 API function. You will need to edit the example below to suit your needs.
my $cpl = cPanelLicensing->new(user => $user, pass => $pass);
my $licenseid = $cpl->reactivateLicense(liscid => $liscid);
In this example,
is meant to stand for the ID of the license you wish to reactivate.
Learn more about using a Perl module to call API functions
Using a PHP class
The following is an example showing how to call the cPanelLicensing PHP class. You can use this class to pass input variables to the Manage2 API using a few short calls.
$cpl = new cPanelLicensing($user, $pass);
$license = $cpl->reactivateLicense(array("liscd" => $liscid));
In the example above,
is meant to stand for the license ID of the license you wish to reactivate.
represent the username and password for your Manage2 account.
Learn more about using a PHP class to call API functions
Topic revision: r25 - 21 Feb 2013 - 20:00:45 - Main.ColinShannon
ManageTwo.XMLReactivateLicense moved from Sandbox.XMLReactivateLicense on 21 Jul 2009 - 19:13 by Main.JustinSchaefer
- put it back