License¶
The license resource allows you to view and update your Vidispine license. It is also the entry point to use if the system is being used as a licensing provider.
Version and license¶
Retrieve version and license information¶
-
GET
/version
¶ Display your license allowance and current system usage.
The
systemInfo
element in the response shows the MAC addresses discovered on the local system. The MAC-address(es) in the license key must match that/those of your system.Produces: - application/xml, application/json – VersionDocument
- text/plain – The version details in a informational text format.
Slave management and monitoring¶
Deprecated since version 5.0: A license file should be used instead.
Install a slave license on a master node¶
Deprecated since version 5.0.
-
PUT
/license/slave
¶ Installs the slave license file with the given path.
Query Parameters: - path (string) – Required. The name of the slave license file.
Produces: - application/xml, application/json – SlaveLicenseDocument
Install a slave license on a master node¶
Deprecated since version 5.0.
-
POST
/license/slave
¶ Installs a slave license.
Accepts: - text/plain – The content of the slave license file.
Produces: - application/xml, application/json – SlaveLicenseDocument
List all slaves¶
-
GET
/license/slave
¶ Returns a list of all the slave nodes connected to this master. Slaves that have not been seen for more than 180 minutes will not be available.
Produces: - application/xml, application/json – SlaveListDocument
List slave license status¶
-
GET
/license/slave/
(id)¶ Returns information about the slave with the given id.
Produces: - application/xml, application/json – VersionDocument
Retrieve a slave license file¶
-
GET
/license/slave/
(id)/license
¶ Returns the slave license for a specific slave.
Produces: - application/xml, application/json – SlaveLicenseDocument
Delete a slave instance¶
Deprecated since version 5.0.
-
DELETE
/license/slave/
(id)¶ Removes the slave with the given id.
List all installed slave licenses¶
Deprecated since version 5.0.
-
GET
/license/slave/license
¶ Returns the
id
andSlaveIdentifier
of all installed slave license on a masterQuery Parameters: - slaveId (string) – Find the slave license with this slave id.
Produces: - application/xml, application/json – SlaveLicenseListDocument
List installed slave licenses by id¶
Deprecated since version 5.0.
-
GET
/license/slave/license/
(id)¶ Returns the detail of an installed slave license with the given id
Produces: - application/xml, application/json – SlaveLicenseDocument
- text/plain – The slave license file.
Install or update slave connection string¶
-
PUT
/APInoauth/license/auth-info
¶ Accepts: - application/xml, application/json – SlaveAuthInfoDocument
Example¶
PUT /APInoauth/license/auth-info
Content-Type: application/xml
<SlaveAuthInfoDocument xmlns="http://xml.vidispine.com/schema/vidispine">
<masterHost>http://192.168.0.1:8080/</masterHost>
<masterHost>http://my.other.server:8080/</masterHost>
<slaveId>your-slave-id</slaveId>
</SlaveAuthInfoDocument>
License validity and status can be seen from GET /version
.