Capacities - Get Workloads

Returns the current state of the specified capacity workloads. If a workload is enabled, the percentage of maximum memory that the workload can consume is also returned.

Workload APIs aren't relevant for Gen2 capacities.

Required Scope

Capacity.Read.All or Capacity.ReadWrite.All

GET https://api.powerbi.com/v1.0/myorg/capacities/{capacityId}/Workloads

URI Parameters

Name In Required Type Description
capacityId
path True

string

uuid

The capacity ID

Responses

Name Type Description
200 OK

Workloads

OK

Examples

Example

Sample request

GET https://api.powerbi.com/v1.0/myorg/capacities/0f084df7-c13d-451b-af5f-ed0c466403b2/Workloads

Sample response

{
  "value": [
    {
      "state": "Enabled",
      "name": "Dataflows",
      "maxMemoryPercentageSetByUser": "66"
    },
    {
      "state": "Disabled",
      "name": "PaginatedReports"
    }
  ]
}

Definitions

Name Description
Workload

A capacity workload setting

Workloads

OData response wrapper for capacity workload settings list

WorkloadState

The capacity workload state

Workload

A capacity workload setting

Name Type Description
maxMemoryPercentageSetByUser

integer

The percentage of the maximum memory that a workload can consume (set by the user)

name

string

The workload name

state

WorkloadState

The capacity workload state

Workloads

OData response wrapper for capacity workload settings list

Name Type Description
odata.context

string

value

Workload[]

The list of capacity workload settings

WorkloadState

The capacity workload state

Name Type Description
Disabled

string

The workload is disabled

Enabled

string

The workload is enabled

Unsupported

string

The workload is unsupported by the current capacity SKU and can't be enabled. This value can't be set by the user in a Patch Workload API call.