Move your embedded app to production

Important

This article only applies to embed for your customers/app owns data applications. Customers using the embed for your organization scenario don't need to purchase a capacity.

After you've completed developing your application, to move to production you'll need to back your workspace with a capacity. Note that all workspaces (the ones containing the reports or dashboards, and the ones containing the datasets) must be assigned to a capacity.

Create a capacity

By creating a capacity, you can take advantage of having a resource for your customers. There are two types of capacities you can choose from:

  • Power BI Premium - A tenant-level Microsoft 356 subscription available in two SKU families, EM and P. When embedding Power BI content, this solution is referred to as Power BI embedding. For more information regarding this subscription, see What is Power BI Premium?

  • Azure Power BI Embedded - You can purchase a capacity from the Microsoft Azure portal. This subscription uses the A SKUs. For details on how to create a Power BI Embedded capacity, see Create Power BI Embedded capacity in the Azure portal.

    Note

    With A SKUs, you can't access Power BI content with a FREE Power BI license.

Capacity specifications

The table below describes the resources and limits of each SKU. To determine which capacity best fits your needs, see the which SKU should I purchase for my scenario table.

Capacity Nodes Total v-cores Backend v-cores RAM (GB) Frontend v-cores DirectQuery/Live Connection (per sec) Model Refresh Parallelism
EM1/A1 1 0.5 2.5 0.5 3.75 1
EM2/A2 2 1 5 1 7.5 2
EM3/A3 4 2 10 2 15 3
P1/A4 8 4 25 4 30 6
P2/A5 16 8 50 8 60 12
P3/A6 32 16 100 16 120 24

Development testing

For development testing, you can use embed trial tokens with a Pro license. To embed in a production environment, use a capacity.

The number of embed trial tokens a Power BI service principal or master user (master account) can generate, is limited. Use the Available Features API to check the percentage of your current embedded usage. The usage amount is displayed per service principal or master account.

If you run out of embed tokens while testing, you need to purchase a Power BI Embedded or Premium capacity. There's no limit to the number of embed tokens you can generate with a capacity.

Assign a workspace to a capacity

Once you create a capacity, you can assign your workspace to that capacity.

Each workspace that contains a Power BI item related to the embedded content (including datasets, reports, and dashboards), must be assigned to capacities. For example, if an embedded report and the dataset bound to it reside in different workspaces, both workspaces must be assigned to capacities.

Assign a workspace to a capacity using a service principal

To assign a workspace to a capacity using a service principal, use the Power BI REST API. When you're using the Power BI REST APIs, make sure to use the service principal object ID.

Assign a workspace to a capacity using a master user

You can also assign a workspace to a capacity from the settings of that workspace using a master user. The master user must have admin permissions to that workspace, and also capacity assignment permissions to that capacity.

  1. Within the Power BI service, expand workspaces and select the ellipsis for the workspace you're using for embedding your content. Then select Workspace settings.

    A screenshot showing the workspace settings menu in Power B I service portal.

  2. Select the Premium tab, and do the following:

    • Enable Capacity.

    • Select the capacity you created.

    • Select Save.

    A screenshot showing the workspace premium settings tab in Power B I service portal.

    After assigning your workspace to a capacity, a diamond appears next to it

    A screenshot showing the diamond next to a workspace with a premium capacity in Power B I service portal.

Next steps