If you’re evaluating Microsoft Material and don’t presently personal a Premium Capability, likelihood is you’re utilizing Microsoft Material Trial Capacities. All Energy BI customers inside an organisation or particular safety teams given the rights can decide into Material Trial Capacities. Due to this fact, chances are you’ll have already got a number of Trial Material Capacities in your tenant. Your Material Directors can particularly management who can decide into the Material Trial capacities throughout the Material Admin Portal, on the Assist and help settings part, and enabling the Customers can attempt Microsoft Material paid options setting as proven within the following picture:

The authorised customers can then decide into Material Trial by following this course of:

1. Click on the Account Supervisor on the highest proper nook of the web page
2. Click on the Begin trial button
3. Click on the Begin trial button once more
4. Present the required particulars
5. Click on the Prolong my free trial button

The next picture reveals the previous steps:

As you see, opting into Material Trial is easy, until it isn’t!

There are instances the place authorised customers can’t begin their Material Trial as a result of their tenant has already exceeded the restrict of obtainable trial capacities. In that case, the customers get the next message:

Unable to join the Microsoft Material trial
We can’t assign you a free Microsoft Material trial capability as a result of your Microsoft tenant has reached the utmost variety of accessible free trial capacities.

If we do some digging, we discover out that the restricted variety of accessible trial capacities is documented within the official Micrsoft Study’s web site. To sum up the documentation, the customers who face this challenge have a few choices being:

• Buy a Material capability
• Ask one other trial capability consumer to provide you with entry to a workspace assigned to their trial capability
• Ask your Material administrator(s) to create a Microsoft help ticket to extend your tenant’s capability limits

These options are all easy. However chances are you’ll face some surprising roadblocks. In some instances, many individuals throughout the organisation need to study Microsoft Material. Nevertheless, the organisation’s governance insurance policies don’t enable the creation of workspaces on the manufacturing tenant for self-learning functions. As a substitute, the customers should use their Private Workspace for studying functions.

This weblog submit focuses on taking a look at our choices to beat this problem.

We’ve got two choices requiring the Material Admin position as follows:

• Reassign private workspaces from the Material Admin Portal
• Use Energy BI REST APIs to assign workspaces to a Material trial capability

Reassign Private Workspaces from the Material Admin Portal

Observe these steps to Reassign private workspaces in case you are a Material administrator:

1. Throughout the Admin Portal click on the Workspaces tab
2. Choose a private workspace
3. Click on the Reassign Workspace from the ribbon
4. Choose the Trial choice
5. Click on the Save button

As we see, the non-public workspace is now assigned to a trial capability.

It appears to be like prefer it did the trick, however there’s a caveat. This methodology works nice if we’ve got just one Material trial capability within the tenant. As we noticed earlier, we’ve got but to be given the choice to pick a particular Material capability. As a substitute, we simply chosen the Trial license mode. In my exams on a tenant with a number of trial capacities, the above course of at all times assigned the workspace to the newer capability (the capability that was created final). However what if you wish to assign the non-public workspaces to a particular capability and to not each capability? Energy BI APIs to the rescue!

Use Energy BI REST APIs to assign workspaces to a Material trial capability

As talked about earlier than, we have to be a Material Admin to implement this methodology efficiently. The required API is the Admin – Capacities AssignWorkspacesToCapacity. This API’s methodology is POST, so we have to cross the record of workspace IDs and the capability ID to the API’s Physique. The Physique for this API should observe this construction:

{
  "capacityMigrationAssignments": [
    {
      "targetCapacityObjectId": "CAPACITY_ID",
      "workspacesToAssign": [
        "WORKSPACE_ID1"
        , "WORKSPACE_ID2"
        , ...
      ]
    }
  ]
}

We’ve got a few choices to get the capability ID and workspace IDs, equivalent to utilizing Microsoft Material’s Person Interface (UI), Discover the Characteristic Utilization and Adoption semantic mannequin underneath the Admin Monitoring workspace of the Microsoft Purview hub, and working Admin REST APIs. The only manner for the aim of this blogpost is to make use of Microsoft Material’s internet UI. To maintain this weblog quick and easy, we use the net UI to seize the capability and workspace IDs. I’ll write a separate weblog to elucidate the Microsoft Purview hub setup and utilization, so keep tuned!

Get Capability ID in Microsoft Material

Login to your Microsoft Material account and navigate to the Admin Portal. Observe these steps to get the specified capability ID:

1. Click on the Capability settings tab
2. Click on the specified capability kind; in our case, we’re after a Material Trial capability, so we click on the Trial tab
3. Click on the Settings for the specified capability underneath the Actions column
4. The Capability ID seems on the backside of the capability Settings web page

The next picture reveals these steps:

Get Workspace ID in Microsoft Material

On Microsoft Material, navigate to the Admin Portal, then observe these steps:

1. Choose the Workspaces tab
2. Hover over the specified Private Workspace and click on the Actions ellipsis button
3. Choose the Particulars choice
4. The workspace ID reveals up

The next picture reveals these steps:

Run Admin/Capacities/AssignWorkspaces REST API

Now that we’ve got the capability ID and workspace ID useful, we are able to go forward and run the POST https://api.powerbi.com/v1.0/myorg/admin/capacities/AssignWorkspaces REST API.

I’m a giant fan of the Strive It functionality within the Energy BI REST API pages that allows us to actually run the APIs with out writing a single line of code, which is ideal for working one-off actions. Observe these steps to run the API instantly from the API documentation webpage:

1. Go to Microsoft Study documentation for the admin/capacities/assignworkspaces API
2. Click on the Strive It button

Tip

If that is the primary time you employ this characteristic, that you must agree with and provides the required consent.

3. On the Affirm your account click on the Proceed with Account button

4. Copy/paste the Physique half as proven right here

Be aware

Keep in mind to exchange the CAPACITY_ID and WORKSPACE_ID with the IDs captured from the Microsoft Material UI.

5. Click on the Run button

We’ll get Response Code: 200 if the API efficiently runs, as proven within the following picture:

If we examine the Workspaces on the Admin Portal, we see that the non-public workspace is now assigned to the specified capability.

Whereas Microsoft generously presents a free Material trial capability to empower organisations to study this know-how, sure limitations could current roadblocks for customers exploring Microsoft Material. This weblog has tackled these challenges, specializing in efficient options like assigning Private Workspaces to present Material Trial capabilities, making certain a smoother studying expertise for the customers. Understanding and overcoming these limitations is essential for directors navigating governance insurance policies of their organisations.

As at all times, I invite you to share your ideas within the feedback under. Observe me on X (Twitter) and LinkedIn to get notified of my new posts.