Admin - Get Capacities As Admin

Returns a list of capacities for the organization.
Note: The user must have administrator rights (such as Office 365 Global Administrator or Power BI Service Administrator) to call this API or authenticate via service principal.

Required scope: Tenant.Read.All or Tenant.ReadWrite.All.
Delegated permissions are supported.
To set the permissions scope, see Register an app.

GET https://api.powerbi.com/v1.0/myorg/admin/capacities
GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}

URI Parameters

Name In Required Type Description
$expand
query
  • string

Expands related entities inline

Responses

Name Type Description
200 OK

OK

Examples

Example
Example with expand on tenant key

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/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",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7"
    }
  ]
}

Example with expand on tenant key

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey

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",
      "tenantKeyId": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
      "tenantKey": {
        "id": "82d9a37a-2b45-4221-b012-cb109b8e30c7",
        "name": "Contoso Sales",
        "keyVaultKeyIdentifier": "https://contoso-vault2.vault.azure.net/keys/ContosoKeyVault/b2ab4ba1c7b341eea5ecaaa2wb54c4d2",
        "isDefault": true,
        "createdAt": "2019-04-30T21:35:15.867-07:00",
        "updatedAt": "2019-04-30T21:35:15.867-07:00"
      }
    }
  ]
}

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