Capacities - Get Capacities

Returns a list of capacities the user has access to.

Required scope: Capacity.Read.All or Capacity.ReadWrite.All
To set the permissions scope, see Register an app.

GET https://api.powerbi.com/v1.0/myorg/capacities

Responses

Name Type Description
200 OK

OK

Examples

example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/capacities

Sample Response

{
  "value": [
    {
      "id": "0f084df7-c13d-451b-af5f-ed0c466403b2",
      "displayName": "MyCapacity",
      "admins": [
        "john@contoso.com"
      ],
      "sku": "A1",
      "state": "Active",
      "region": "West Central US",
      "capacityUserAccessRight": "Admin"
    }
  ]
}

Definitions

Capacities

Odata response wrapper for a Power BI capacity list

Capacity

A Power BI capacity

CapacityState

The capacity state

capacityUserAccessRight

Access right user has on the capacity

TenantKey

Encryption key information

Capacities

Odata response wrapper for a Power BI capacity list

Name Type Description
odata.context
  • string
value

The Capacity List

Capacity

A Power BI capacity

Name Type Description
admins
  • string[]

An array of capacity admins.

capacityUserAccessRight

Access right user has on the capacity

displayName
  • string

The capacity display name

id
  • string

The capacity id

region
  • string

The Azure region where the capacity is provisioned

sku
  • string

The capacity SKU.

state

The capacity state

tenantKey

Encryption key information (Only applicable for admin route)

tenantKeyId
  • string

The id of the encryption key (Only applicable for admin route)

CapacityState

The capacity state

Name Type Description
Active
  • string

Capacity ready for use

Deleted
  • string

Capacity has been deleted and is not available

Deleting
  • string

Capacity in process of being deleted

Invalid
  • string

Capacity can not be used

NotActivated
  • string

Not Supported

PreSuspended
  • string

Not Supported

ProvisionFailed
  • string

Capacity failed to provisioned

Provisioning
  • string

Capacity in activation process

Suspended
  • string

Capacity suspended for use

UpdatingSku
  • string

Capacity Sku change is in progress

capacityUserAccessRight

Access right user has on the capacity

Name Type Description
Admin
  • string

User has administrator rights on the capacity

Assign
  • string

User can assign workspaces to the capacity

None
  • string

User doesn't have access to the capacity

TenantKey

Encryption key information

Name Type Description
createdAt
  • string

Encryption key creation time

id
  • string

The id of the encryption key

isDefault
  • boolean

Indicates that this key is set as default for the entire tenant. Any new capacity creation will inherit this key upon creation

keyVaultKeyIdentifier
  • string

Uri to the version of the Azure Key Vault key

name
  • string

The name of the encryption key

updatedAt
  • string

Encryption key last update time