GetLicense (v1,v2)
This API can be used to collect the license and usage information of your AhsayCBS server.
The settings can be found on the AhsayCBS web console at:
- System Settings > License > Backup
v1 GetLicense.do
URL
https://CBS.EXAMPLE.COM/cbs/api/json/GetLicense.do
Available Since Version: 8.3
v2 GetLicense.do
Since AhsayCBS version 8.3, the following add-on modules are combined into one add-on module, to make these modules that were previously separated, interchangeable:
- Hyper-V and VMware (per Guest VM)
- Hyper-V and VMware (per Socket)
- NAS - Synology and NAS - QNAP
- AhsayOBM and AhsayACB Microsoft 365
To facilitate such changes, a new version of the GetLicense.do API (v2 GetLicense.do) was introduced with the following parameters:
Key | Type | Description |
---|---|---|
VMQuota | String | Hyper-V or VMware Guest VM quota |
UsedVMQuota | String | Used Hyper-V or VMware Guest VM quota |
RemainVMQuota | String | Available Hyper-V or VMware Guest VM quota |
HypervisorSocketQuota | String | Hyper-V or VMware Socket quota |
UsedHypervisorSocketQuota | String | Used Hyper-V or VMware Socket quota |
RemainHypervisorSocketQuota | String | Available Hyper-V or VMware Socket quota |
NasQuota | String | Synology or QNAP NAS client quota |
UsedNasQuota | String | Used Synology or QNAP NAS client quota |
RemainNasQuota | String | Available Synology or QNAP NAS client quota |
Office365Quota | String | AhsayOBM or AhsayACB Microsoft 365 quota |
UsedOffice365Quota | String | Used AhsayOBM or AhsayACB Microsoft 365 quota |
RemainOffice365Quota | String | Available AhsayOBM or AhsayACB Microsoft 365 quota |
For AhsayCBS pre-8.3, you should use the v1 API instead. For all other new versions, use the v2 API to get accurate licensing details.
URL
https://CBS.EXAMPLE.COM/obs/api/json/2/GetLicense.do
Available Since Version: 9.1
Parameters
Key | Type | Description |
---|---|---|
SysUser | String | Username of an AhsayCBS System User with Admin, API or Read-Only API role. |
SysPwd | String | Password matching SysUser. |
Return Values
Key | Type | Description |
---|---|---|
Status | String | "OK" or "Error" |
Data | ConfigData | Contains the particulars of a user's license. |
Message | String | Error message, it only appears if status displays "Error". |
ExptType | String | The type of exception, will only be displayed if the status is "Error". |
JSON Objects
Licensing Data
Key | Type | Description |
---|---|---|
Key | String | Product key |
Licensee | String | Licensee name |
ProductName | String | Name of the product, e.g. "Offsite Backup Software, OEM Edition". |
Version | String | Version of the AhsayCBS. |
UseProxy | Boolean | Enable / disable the use of proxy defined in the AhsayCBS to connect to the internet. |
LicTypeName | String | Name of license type. |
MaxObmUsers | String | Maximu number of AhsayOBM user CALs. |
UsedObmQuota | String | Used AhsayOBM user CALs. |
RemainObmQuota | String | Remaining AhsayOBM user CALs. |
ExpiryDate | String | Expiry date of the license key. |
SupExpDate | String | Expiry date of the software support. |
MaxQuota | String | Maximum backup quota of a user. |
Ip | String | The IP address of AhsayCBS registered. |
Port | String | The connection port of AhsayCBS registered. |
Mac | String | The MAC address of the network card that AhsayCBS registered. |
MaxUsers | String | Maximum number of users allowed. |
AcbClientEnabled | Boolean | Enable / disable the use of the AhsayACB client module. |
DagUseObm | String | Used AhsayOBM CALs due to DAG usage. |
AcbUseObm | String | Used AhsayOBM CALs due to no AhsayACB CALs. |
EnableReplication | Boolean | Enable / disable the use of the replication module. |
EnableMSExchangeMailbox | Boolean | Enable / disable the use of the Exchange Mailbox module. |
ExchangeMailboxQuota | String | Exchange Mailbox quota. |
UsedExchangeMailboxQuota | String | Used Exchange Mailbox quota. |
RemainExchangeMailboxQuota | String | Remaining Exchange Mailbox quota. |
VMQuota | String | Hyper-V / VMware (Per Guest VM) quota. |
UsedVMQuota | String | Used Hyper-V / VMware (Per Guest VM) quota. |
RemainVMQuota | String | Remaining Hyper-V / VMware (Per Guest VM) quota. |
HypervisorSocketQuota | String | Hyper-V / VMware (Per Socket) quota. |
Used HypervisorSocketQuota | String | Used Hyper-V / VMware (Per Socket) quota. |
RemainHypervisorSocketQuota | String | Remaining Hyper-V / VMware (Per Socket) quota. |
EnableMobile | Boolean | Enable / disable the use of Ahsay Mobile. |
MobileQuota | String | AhsayMOB quota. |
UsedMobileQuota | String | Used AhsayMOB quota. |
RemainMobileQuota | String | Remaining AhsayMOB quota. |
Office365Quota | String | AhsayACB / AhsayOBM Microsoft 365 quota. |
UsedOffice365Quota | String | Used AhsayACB / AhsayOBM Microsoft 365 quota. |
RemainOffice365Quota | String | Remaining AhsayACB / AhsayOBM Microsoft 365 quota. |
OpenDirectQuota | String | Granular Restore / OpenDirect quota. Only works on pre-v9.13 AhsayCBS. |
UsedOpenDirectQuota | String | Used Granular Restore / OpenDirect quota. Only works on pre-v9.13 AhsayCBS. |
RemainOpenDirectQuota | String | Remaining Granular Restore / OpenDirect quota. Only works on pre-v9.13 AhsayCBS. |
NasQuota | String | Synology / QNAP - NAS client quota. |
UsedNasQuota | String | Used Synology / QNAP - NAS client quota. |
RemainNasQuota | String | Remaining Synology / QNAP - NAS clien quota. |
Deactivated | Boolean | Disable / enable license key. |
EnableNasServer | Boolean | Enable / disable the NAS server module. |
EnableUbs | Boolean | Enable / disable the AhsayUBS module. |
EnableHa | Boolean | Enable / disable the HA module. |
MobileQuotaV2 | String | Ahsay Mobile backup quota. |
UsedMobileV2Quota | String | Used Ahsay Mobile backup quota. |
RemainMobileV2Quota | String | Remaining Ahsay Mobile backup quota. |
Example
INPUT
{
"SysUser":"api_user",
"SysPwd":"qWeRtY123456!@#$%"
}
OUTPUT
{
"Status":"OK",
"Data":{
"MobileQuota":"2000",
"HypervisorSocketQuota":"4000",
"ExpiryDate":"12/31/2024",
"RemainMobileV2Quota":"32980",
"ProductName":"Ahsay Cloud Backup Suite",
"MaxUsers":"7100",
"Port":"8081",
"RemainVMQuota":"22000",
"LicenseFile":"",
"RemainObmQuota":"5099",
"Version":"9.5.4.0",
"NasQuota":"2010",
"EnableCbs":true,
"UsedNasQuota":"2",
"Licensee":"EvaluationOnly",
"RemainMobileQuota":"2000",
"RemainOffice365Quota":"4000",
"UsedObmQuota":"1",
"UsedAcbRepQuota":0,
"RemainAcbRepQuota":2000,
"MaxObmUsers":"5100",
"RemainOpenDirectQuota":"2000",
"EnableUbs":true,
"Mac":"08-00-27-72-37-A8",
"RemainAcbQuota":"1999",
"AcbRepQuota":2000,
"UsedMobileQuota":"0",
"RemainNasQuota":"2008",
"UsedMobileV2Quota":"20",
"RemainExchangeMailboxQuota":"2000",
"RemainHypervisorSocketQuota":"4000",
"Key":"62pMG-YPD6I-3ggaG-b5MCT-XX",
"EnableHa":false,
"ObmRepQuota":5100,
"Description":"",
"Ip":"127.0.0.1",
"MaxAcbUsers":"2000",
"UsedHypervisorSocketQuota":"0",
"DagUseObm":"0",
"UsedVMQuota":"0",
"MobileQuotaV2":"33000",
"AcbUseObm":"0",
"UsedExchangeMailboxQuota":"0",
"RemainObmRepQuota":5100,
"UsedAcbQuota":"1",
"OpenDirectQuota":"2000",
"LicType":4,
"UseProxy":false,
"SupExpDate":"12/31/2024",
"LicTypeName":"OEM License",
"VMQuota":"22000",
"Office365Quota":"4000",
"AcbUseObmRep":0,
"BrandedProductName":"",
"UsedOffice365Quota":"0",
"ExchangeMailboxQuota":"2000",
"DateFormat":"MM/dd/yyyy",
"MaxQuota":"UNLIMITED",
"UsedOpenDirectQuota":"0",
"UsedObmRepQuota":0
}
}