Admin - Get Capacities As Admin
Возвращает список емкостей для организации.
Разрешения
- Пользователь должен быть администратором Fabric или пройти проверку подлинности с помощью субъекта-службы.
- Поддерживаются делегированные разрешения.
При выполнении в рамках проверки подлинности службы приложения не должны иметь необходимые разрешения администратора для Power BI, заданные на портале Azure.
Требуемая область
Tenant.Read.All или Tenant.ReadWrite.All
Важно только при проверке подлинности через стандартный делегированный маркер доступа администратора. Не должно присутствовать при использовании проверки подлинности через субъект-службу.
Ограничения
Максимум 200 запросов в час.
GET https://api.powerbi.com/v1.0/myorg/admin/capacities
GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand={$expand}
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
$expand
|
query |
string |
Расширяет встроенные связанные сущности |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ХОРОШО |
Примеры
Example |
Example with expand on tenant key |
Example
Образец запроса
GET https://api.powerbi.com/v1.0/myorg/admin/capacities
Пример ответа
{
"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
Образец запроса
GET https://api.powerbi.com/v1.0/myorg/admin/capacities?$expand=tenantKey
Пример ответа
{
"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"
}
}
]
}
Определения
Имя | Описание |
---|---|
Capacities |
Оболочка ответа OData для списка емкости Power BI |
Capacity |
Емкость Power BI |
Capacity |
Состояние емкости |
capacity |
Право доступа, которое пользователь имеет в емкости |
Tenant |
Сведения о ключе шифрования |
Capacities
Оболочка ответа OData для списка емкости Power BI
Имя | Тип | Описание |
---|---|---|
odata.context |
string |
|
value |
Capacity[] |
Список емкости |
Capacity
Емкость Power BI
Имя | Тип | Описание |
---|---|---|
admins |
string[] |
Массив администраторов емкости |
capacityUserAccessRight |
Право доступа, которое пользователь имеет в емкости |
|
displayName |
string |
Отображаемое имя емкости |
id |
string |
Идентификатор емкости |
region |
string |
Регион Azure, в котором была подготовлена емкость |
sku |
string |
Номер SKU емкости |
state |
Состояние емкости |
|
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 |
Дата последнего обновления и время ключа шифрования |