Getting Started with License Provisioning

In this article:

• Overview
• Recommended steps
• Recommended testing strategies

Overview

The License Provisioning endpoint allows you to add new product licenses to users in Pluralsight without replacing or removing any existing licenses. This page walks you through the complete setup of the License Provisioning API, including detailed documentation on its functionality, step-by-step instructions for setting up your HTTP request, and recommended testing strategies. Troubleshooting tips are also provided to help resolve any issues during the process.

Recommended steps

1. Familiarize yourself with the authentication requirements on the Authentication page.
2. Follow the setup instructions:
   • General setup: Navigate to the License provision setup page. This page will explain step by step about how to set up your HTTP request with license provisioning.
3. Test your setup
   • Follow the recommended testing strategy below to verify that your setup is functioning correctly.
4. Review results and troubleshoot errors:
   • General review: Check the results on the License provision results page and refer to the troubleshooting section there for any issues encountered.

Recommended testing strategries for license provisioning

Follow these phased steps to ensure a smooth testing process:

1. Run initial provision job with dry run

   • Set the dryRun URL parameter to true to simulate the provision without applying changes.
   • Optional: Use strict mode to halt the process if any errors occur. Refer to the Strict mode (ExitOnError) section of License provisioning setup page.

2. Review results

   • Check the Provision Results page for any errors or warnings.
   • Review the list of operations generated by the dry run.
   • Ask yourself:
     • Is the total number of users who were provisioned with licenses close to your estimated range?

3. Troubleshoot if necessary

   • If the number of operations generated isn’t as expected:
     • Click the gray "View All" button on the results page to review detailed in-depth results.
     • Use these insights to diagnose and fix any issues.

4. Proceed after review

   • Once satisfied with the dry run results, move on to the next steps.

5. Final provision run

   • Set the dryRun URL parameter to false to apply the provision process.
   • Send the entire data set for provisioning.
   • Review the final results for successful operations.

6. Automate to production

   • Determine the frequency of automated provisioning based on your use case needs.