Getting information about available/used licenses

Format

Method	GET
URL	/managerinfo
Request content	Empty
Successful answer	ManagerInfo Object
Non-successful answer	ErrorMessage Object
Unexpected error	HTTP 500

ManagerInfo Object

Schema

version	ManagerVersionInfo	Version of the software run by this manager
manager_id	String	Universal id of the manager.
licenses	Array of LicenseInfo	Information of licenses installed in this Manager. This information is shown only to authenticated users

JSON example

{
	"version": {
		"major":"3",
		"minor":"0",
		"release":"1"
	},
	"manager_id":"1bd1fad1-2390-4bcf-bf8b-0435fee1aa5b",
	"licenses":[{
		"version":1,
		"signature":"TG9uZ0xvbmdMb25nTG9uZ0xvbmdMb25nTG9uZ0xvbmdMb25nTG9uZ0xvbmdMb25nTG9uZ0xvbmdMb25nTG9uZ0Jhc2U2NA==",
		"license_id":"13cc3b6a-1a83-4681-9432-43ac178a41f2",
		"manager_id":"1bd1fad1-2390-4bcf-bf8b-0435fee1aa5b",
		"valid_since":17480,
		"valid_until":17980,
		"type":"concurrent",
		"max_sessions":1000,
		"usage":{
			"in_use":6,
			"licensed_guests":[
				"fedora25",
				"w7",
				"guest1",
				"guest2",
				"guest3",
				"fedora26_template"
			]
		}
	}]
}

ManagerVersionInfo Object

Schema

major	String	Major number of flexVDI Manager version
minor	String	Minor number of flexVDI Manager version
release	String	Release number of flexVDI Manager version

JSON example

"version": {
		"major":"3",
		"minor":"0",
		"release":"1"
	}

LicenseInfo

Schema

version	Integer	Version of the license
signature	String	Cryptographic signature of the license. Used to validate it
license_id	String	License identifier
license_code	String	Human-readable license code
manager_id	String	Manager identifier
valid_since	Integer	First day of license validity. Expressed as number of days since Unix epoch.
valid_until	Integer	Last day of license validity. Expressed as number of days since Unix epoch.
type	String	Type of license.
max_sessions	Integer	Maximum number of sessions granted by the license.
usage	LicenseUsageInfo	Information about session currently using this license

JSON example

{
	"version":1,
	"signature":"TG9uZ0xvbmdMb25nTG9uZ0xvbmdMb25nTG9uZ0xvbmdMb25nTG9uZ0xvbmdMb25nTG9uZ0xvbmdMb25nTG9uZ0Jhc2U2NA==",
	"license_id":"13cc3b6a-1a83-4681-9432-43ac178a41f2",
	"manager_id":"1bd1fad1-2390-4bcf-bf8b-0435fee1aa5b",
	"valid_since":17480,
	"valid_until":17980,
	"type":"concurrent",
	"max_sessions":1000,
	"usage":{
		"in_use":6,
		"licensed_guests":[
			"fedora25",
			"w7",
			"guest1",
			"guest2",
			"guest3",
			"fedora26_template"
		]
	}
}

LicenseUsageInfo

Schema

in_use	Integer	Number of licensed versions currently in use
licensed_guests	String Array	Array of ids of the guests that are currently using the licenses

JSON example

{
	"in_use":6,
	"licensed_guests":[
		"fedora25",
		"w7",
		"guest1",
		"guest2",
		"guest3",
		"fedora26_template"
	]
}