Capacities - Get Capacities

Service:

Power BI REST APIs

API Version:

v1.0

Возвращает список емкостей, к которым у пользователя есть доступ.

Разрешения

Этот вызов API может вызываться профилем субъекта-службы. Дополнительные сведения см. в разделе "Профили субъектов-служб" в Power BI Embedded. Создатель профиля должен иметь разрешения на емкость.

Требуемая область

Capacity.Read.All или Capacity.ReadWrite.All

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

Ответы

Имя	Тип	Описание
200 OK	Capacities	ОК

Примеры

Example

Sample Request

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

Sample Response

Status code:

200

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

Определения

Имя	Описание
Capacities	Оболочка ответа OData для списка емкости Power BI
Capacity	Емкость Power BI
CapacityState	Состояние емкости
capacityUserAccessRight	Право доступа, которое пользователь имеет в емкости
TenantKey	Сведения о ключе шифрования

Capacities

Оболочка ответа OData для списка емкости Power BI

Имя	Тип	Описание
odata.context	string
value	Capacity[]	Список емкостей

Capacity

Емкость Power BI

Имя	Тип	Описание
admins	string[]	Массив администраторов емкости
capacityUserAccessRight	capacityUserAccessRight	Право доступа, которое пользователь имеет на емкости
displayName	string	Отображаемое имя емкости
id	string	Идентификатор емкости
region	string	Регион Azure, в котором подготовлена емкость.
sku	string	Номер SKU емкости
state	CapacityState	Состояние емкости
tenantKey	TenantKey	Сведения о ключе шифрования (применяется только к маршрутам администратора)
tenantKeyId	string	Идентификатор ключа шифрования (применимо только к маршруту администратора)

CapacityState

Состояние емкости

Имя	Тип	Описание
Active	string	Емкость готова к использованию.
Deleted	string	Емкость была удалена и недоступна
Deleting	string	Выполняется удаление емкости
Invalid	string	Не удается использовать емкость
NotActivated	string	Не поддерживается
PreSuspended	string	Не поддерживается
ProvisionFailed	string	Сбой подготовки емкости
Provisioning	string	Выполняется активация емкости
Suspended	string	Использование емкости приостановлено
UpdatingSku	string	Выполняется изменение номера SKU емкости

capacityUserAccessRight

Право доступа, которое пользователь имеет в емкости

Имя	Тип	Описание
Admin	string	У пользователя есть права администратора на емкость
Assign	string	Пользователь имеет права участника и может назначать рабочие области емкости
None	string	У пользователя нет доступа к емкости

TenantKey

Сведения о ключе шифрования

Имя	Тип	Описание
createdAt	string	Дата и время создания ключа шифрования
id	string	Идентификатор ключа шифрования
isDefault	boolean	Указывает, является ли ключ шифрования ключом по умолчанию для всего клиента. Любая только что созданная емкость наследует ключ по умолчанию.
keyVaultKeyIdentifier	string	Универсальный код ресурса (URI), однозначно указывающий ключ шифрования в Azure Key Vault
name	string	Имя ключа шифрования
updatedAt	string	Дата и время последнего обновления ключа шифрования