3.9. newlicense

Description

This method is used to install a new SoftNAS license key.

POST

newlicense

Request

See Standard Request Structure

Example

Response

The following parameters are returned in addition to the Standard Response Structure

Property	Description	Note/Data Type
actual-storage-GB	Actual storage in use, measured in gigabytes.	string
actual-expiration	Expiration date of license including grace period.	Date string
capabilities	Internal use only.	string
capacityGB	Licensed maximum capacity in gigabytes.	string
currentkey	License key.	string
Msg	Message appropriate to the method in the request, based on success or failure.	string
expiration	Expiration date of the license.	Date string
gracedays	Number of grace days following license expiration that product continues to operate.	Integer string
graceperiod	In the event you are running SoftNAS In a production environment and your license expires, it will enter the grace period. “1” means grace period is in effect.	Boolean string
graceremaining	Amount of days remaining in the grace period, before the grace period expires and SoftNAS functionality is impacted.
hardware_id	The hardware ID used for license activation. On AWS, the instance ID; otherwise, IP address of admin interface.	string
ipmode	IP address mode, how the default IP address used for licensing was assigned “STATIC” or “DHCP”	string
is_activated	Reports if the license is active or not. True or False.	Boolean string
is_perpetual	Reports if the license is a perpetual license or not. True or false.	Boolean string
is_subscription	Reports of the license type is subscription-based (monthly or annual).	Boolean string
istrial	Reports if the product is currently running in trial mode.	Boolean string
license-version	Licensed software version of SoftNAS.	string
licensetype	Reports the license type: monthly, annual, subscription, trial etc.	string
maint_expiration	Reports the date at which the maintenance package expires.	Date string
maint_expired	Reports if the status of the maintenance package is expired. True or False.	Boolean string
model	The license model: “key” (licensed by key) or “utility”. (Licensed by the hour).	string
platform	Platform on which SoftNAS is running. Eg. Amazon, VMWare, Microsoft HyperV	string
product-id	SoftNAS product id	string
producttype	SoftNAS product type.	string
regname	Registered name – customer name associated with an activated license key.	string
sig	internal use only.
status	Reports of the current license is valid. Possible values: valid license or an error message	string
storage-capacity-GB	Reports total storage capacity applicable to the current license in gigabytes.	string
today	Reports today's date.	Date string
totalstorageGB	Total storage consumed currently by storage pools.	string
valid	True if the license is valid.	Boolean string

Example

{

"result": {

"data": {

"actual-storage-GB": 29.8,

"actual_expiration": "01/26/2014",

"capabilities": "1:1:2048:01/26/2014:2:1",

"capacityGB": "2,048 GB",

"currentkey": "CEAASA-BESNJA-8MEED6-AHAZZN-XHWB8X-A2NUK3",

"errMsg": "Valid License",

"expiration": "01/28/2014",

"gracedays": "2",

"graceperiod": "0",

"graceremaining": "2",

"hardware_id": "i-0b06fe44",

"hwlock": "",

"is_activated": true,

"is_perpetual": false,

"is_subscription": true,

"istrial": "1",

"license-version": "1",

"licensetype": "TRIAL",

"maint_expiration": "01/28/2014",

"maint_expired": false,

"model": "key",

"product-id": "1",

"producttype": "SoftNAS™ Professional Edition",

"regname": "RBLLC",

"sig": "1F842C0F",

"status": "Valid License",

"storage-capacity-GB": "2048",

"today": "01/12/2014",

"totalStorageGB": "30 GB",

"valid": true

},

"msg": "",

"success": true,

"total": 30

},

"session_id": 11255,

"success": true

}

3.9. newlicense

Made with help of Dr.Explain