Manage license containers
In 10Duke Scale, license containers hold the licenses that have been issued to customers.
License containers are customer-specific, and they are used to control license consumers’ access to licenses.
Each customer has one default license container. Licenses issued using the UI console are always stored in the default container. If no container is specified when issuing licenses through the API, they are also stored in the default container.
See also how to move licenses to another license container.
Limitations
License containers are not visible in the UI console, and you cannot manually create and manage them from there.
Some UI operations affect license containers though: creating a customer automatically creates a default container for them, and deleting a customer also deletes their containers and all the licenses in them.
Manage license containers through the API
Use the following License Management API operations:
Operation | URL (relative, prepend the environment base URL) |
---|---|
Retrieve the license containers of a customer | GET /licensees/{licenseeId}/license-containers |
Retrieve a license container of a customer | GET /licensees/{licenseeId}/license-containers/{licenseContainerId} |
Create a new license container for a customer | POST /licensees/{licenseeId}/license-containers |
Edit a license container of a customer | PUT /licensees/{licenseeId}/license-containers/{licenseContainerId} |
Delete a license container from a customer and all the licenses it contains | DELETE /licensees/{licenseeId}/license-containers/{licenseContainerId} |
Note: Make sure a customer always has one license container set as default.
Next steps
Grant license consumers access to the license containers and the licenses in them.
We recommend that your client application uses a regular heartbeat to make sure that license consumers cannot continue consuming licenses that have been deleted together with a license container. Even though license consumers’ license leases are deleted, from your client application’s point of view a lease remains valid until the next heartbeat.