Unlock a world of possibilities! Login now and discover the exclusive benefits awaiting you.
Qlik Cloud tenants are the highest level of logical isolation provided to our customers. The subscriptions and associated entitlements (also known as licenses) that customers purchase from Qlik are not fixed to these tenants. When needed, a customer can update the entitlement used by their tenant. This article covers how to do this, as well as all considerations before moving.
You should not attempt to update your tenant entitlement unless directed to do so by Qlik, or you are an OEM customer who is managing multiple entitlements for their estate.
Content:
There are three scenarios where you might need to update your entitlement:
If you are an OEM or Enterprise customer leveraging multiple tenants in Qlik Cloud, please also consider reviewing the Platform Operations series on qlik.dev to learn more about managing these estates prior to changing your entitlements.
Before you begin migrating your subscription or entitlement, consider:
Updating the entitlement requires four steps:
Your SLK is available through:
{ "licenseNumber" : "1234 5678 1234 5678" , "licenseKey" : "eyJhbGciOiJSUzUxMiIsImtpZCI6ImEzMzdhZDE3LTk1ODctNG...." , "valid" : "./2023-10-08" , "status" : "Ok" ,... } |
When you migrate between entitlements, any user assignments will be reset. You will need to export any current assignments if you wish to reassign them.
There are three ways of doing this:
curl - L - X GET 'https://<hostname>.<region>.qlikcloud.com/api/v1/licenses/assignments' \ - H 'Authorization: Bearer ey....' \ - H 'Content-type: application/json' \ - H 'Accept: application/json' |
If you have many users, both option a and b will require you to paginate to get all results.
Results will look like:
{ "data" : [
{ "subject" : "QLIKBOT\\f0e92f326ac77427df155940fec39e6a" , "type" : "professional" , "excess" : false, "created" : "2022-10-20T13:46:29.474Z" }, { "subject" : "auth0|a08d000001f0wjria3" , "type" : "professional" , "excess" : false, "created" : "2022-10-06T09:21:13.265Z" }, { "subject" : "QLIKBOT\\52b7313d6705e2873eaadb9be23d8c06" , "type" : "professional" , "excess" : false, "created" : "2022-10-05T12:46:01.716Z" } ], "links" : { "next" : { "href" : "" }, "prev" : { "href" : "" } } } |
If required, reassign entitlements which were exported in step 2. You can do this in two ways:
curl -L -X POST 'https://<hostname>.<region>.qlikcloud.com/api/v1/licenses/assignments/actions/add' \
-H 'Authorization: Bearer ey...' \
-H 'Content-type: application/json' \
-H 'Accept: application/json' \
--data-raw '{
"add": [
{
"subject": "1ef2caed0dbe0a66a24ccadf61546099",
"type": "professional"
}
]
}'
The information in this article is provided as-is and to be used at own discretion. Depending on tool(s) used, customization(s), and/or other factors ongoing support on the solution below may not be provided by Qlik Support.