Admin - Datasets GetDatasetsInGroupAsAdmin
Возвращает список наборов данных из указанной рабочей области.
Разрешения
- Пользователь должен быть администратором Fabric или пройти проверку подлинности с помощью субъекта-службы.
- Поддерживаются делегированные разрешения.
При выполнении в рамках проверки подлинности службы приложения не должны иметь необходимые разрешения администратора для Power BI, заданные на портале Azure.
Требуемая область
Tenant.Read.All или Tenant.ReadWrite.All
Важно только при проверке подлинности через стандартный делегированный маркер доступа администратора. Не должно присутствовать при использовании проверки подлинности через субъект-службу.
Ограничения
Максимум 200 запросов в час.
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/datasets
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/datasets?$filter={$filter}&$top={$top}&$skip={$skip}&$expand={$expand}
Параметры URI
Имя | В | Обязательно | Тип | Описание |
---|---|---|---|---|
group
|
path | True |
string (uuid) |
Идентификатор рабочей области |
$expand
|
query |
string |
Расширяет встроенные связанные сущности |
|
$filter
|
query |
string |
Возвращает подмножество результатов на основе условия параметра запроса Odata Odata фильтра. |
|
$skip
|
query |
integer (int32) |
Пропускает первые результаты n |
|
$top
|
query |
integer (int32) |
Возвращает только первые результаты n |
Ответы
Имя | Тип | Описание |
---|---|---|
200 OK |
ХОРОШО |
Примеры
Example |
Example with expand on encryption |
Example
Образец запроса
GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets
Пример ответа
{
"value": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"addRowsAPIEnabled": false,
"configuredBy": "john@contoso.com",
"isRefreshable": true,
"isEffectiveIdentityRequired": false,
"isEffectiveIdentityRolesRequired": false,
"isOnPremGatewayRequired": false,
"isInPlaceSharingEnabled": false
}
]
}
Example with expand on encryption
Образец запроса
GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets?$expand=encryption
Пример ответа
{
"value": [
{
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"name": "SalesMarketing",
"addRowsAPIEnabled": false,
"configuredBy": "john@contoso.com",
"isRefreshable": true,
"isEffectiveIdentityRequired": false,
"isEffectiveIdentityRolesRequired": false,
"isOnPremGatewayRequired": false,
"isInPlaceSharingEnabled": false,
"encryption": {
"id": "cfafbeb1-8037-4d0c-896e-a46fb27ff229",
"encryptionStatus": "InSyncWithWorkspace"
}
}
]
}
Определения
Имя | Описание |
---|---|
Admin |
Набор данных Power BI, возвращенный API-интерфейсами администратора. API возвращает подмножество из следующего списка свойств набора данных. Подмножество зависит от вызываемого API, разрешений вызываемого абонента и доступности данных в базе данных Power BI. |
Admin |
Оболочка списка odata набора данных |
Dataset |
Параметры масштабирования запросов набора данных |
Dataset |
Запись права доступа пользователя Power BI для набора данных |
Dataset |
Право доступа, которое пользователь имеет для набора данных (уровень разрешений) |
Dependent |
Зависимый поток данных Power BI |
Encryption |
Сведения о шифровании для набора данных |
Encryption |
Состояние шифрования набора данных |
Principal |
Тип субъекта |
Service |
Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами. |
AdminDataset
Набор данных Power BI, возвращенный API-интерфейсами администратора. API возвращает подмножество из следующего списка свойств набора данных. Подмножество зависит от вызываемого API, разрешений вызываемого абонента и доступности данных в базе данных Power BI.
Имя | Тип | Описание |
---|---|---|
ContentProviderType |
string |
Нерекомендуемое свойство, которое следует игнорировать. |
Encryption |
Сведения о шифровании набора данных. Применимо только при указании |
|
IsEffectiveIdentityRequired |
boolean |
Требуется ли для набора данных эффективное удостоверение, которое необходимо отправить в вызов API GenerateTo ken. |
IsEffectiveIdentityRolesRequired |
boolean |
Определяется ли безопасность на уровне строк внутри PBIX-файла Power BI. В этом случае необходимо указать роль. |
IsInPlaceSharingEnabled |
boolean |
Может ли набор данных использоваться внешними пользователями в собственном клиенте. |
IsOnPremGatewayRequired |
boolean |
Требуется ли для набора данных локальный шлюз данных |
IsRefreshable |
boolean |
Это поле возвращает |
addRowsAPIEnabled |
boolean |
Позволяет ли набор данных добавлять новые строки |
configuredBy |
string |
Владелец набора данных |
createReportEmbedURL |
string |
URL-адрес внедрения отчета в набор данных |
createdDate |
string (date-time) |
Дата и время создания набора данных |
description |
string |
Описание набора данных |
id |
string |
Идентификатор набора данных |
name |
string |
Имя набора данных |
qnaEmbedURL |
string |
Url-адрес внедрения набора данных Q&A |
queryScaleOutSettings |
Параметры масштабирования запросов набора данных |
|
targetStorageMode |
string |
Режим хранения набора данных |
upstreamDataflows |
Список всех потоков данных этого элемента зависит от |
|
users |
(Пустое значение) Сведения о доступе пользователя к набору данных. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о пользователе в элементе Power BI (например, отчете или панели мониторинга) с помощью API Получения пользователей набора данных в качестве администратора или API PostWorkspaceInfo с параметром |
|
webUrl |
string |
URL-адрес веб-набора данных |
workspaceId |
string (uuid) |
Идентификатор рабочей области набора данных. Это свойство будет возвращено только в GetDatasetsAsAdmin. |
AdminDatasets
Оболочка списка odata набора данных
Имя | Тип | Описание |
---|---|---|
@odata.context |
string |
Контекст OData |
value |
Наборы данных |
DatasetQueryScaleOutSettings
Параметры масштабирования запросов набора данных
Имя | Тип | Описание |
---|---|---|
autoSyncReadOnlyReplicas |
boolean |
Автоматически ли набор данных синхронизирует реплики только для чтения |
maxReadOnlyReplicas |
integer minimum: -1maximum: 64 |
Максимальное количество реплик только для чтения для набора данных (0–64, -1 для автоматического числа реплик) |
DatasetUser
Запись права доступа пользователя Power BI для набора данных
Имя | Тип | Описание |
---|---|---|
datasetUserAccessRight |
Право доступа, которое пользователь имеет для набора данных (уровень разрешений) |
|
displayName |
string |
Отображаемое имя субъекта |
emailAddress |
string |
Адрес электронной почты пользователя |
graphId |
string |
Идентификатор субъекта в Microsoft Graph. Доступно только для API администрирования. |
identifier |
string |
Идентификатор субъекта |
principalType |
Тип субъекта |
|
profile |
Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами. |
|
userType |
string |
Тип пользователя. |
DatasetUserAccessRight
Право доступа, которое пользователь имеет для набора данных (уровень разрешений)
Значение | Описание |
---|---|
None |
Удаляет разрешение на содержимое в наборе данных |
Read |
Предоставляет доступ на чтение к содержимому в наборе данных |
ReadExplore |
Предоставляет доступ на чтение и изучение содержимого в наборе данных |
ReadReshare |
Предоставляет доступ на чтение и повторное предоставление доступа к содержимому в наборе данных |
ReadReshareExplore |
Предоставляет доступ к содержимому в наборе данных для чтения, повторного доступа и просмотра |
ReadWrite |
Предоставляет доступ на чтение и запись к содержимому в наборе данных |
ReadWriteExplore |
Предоставляет доступ на чтение, запись и изучение содержимого в наборе данных |
ReadWriteReshare |
Предоставляет доступ для чтения, записи и повторного доступа к содержимому в наборе данных |
ReadWriteReshareExplore |
Предоставляет доступ для чтения, записи, повторного доступа к содержимому в наборе данных |
DependentDataflow
Зависимый поток данных Power BI
Имя | Тип | Описание |
---|---|---|
groupId |
string |
Идентификатор целевой группы |
targetDataflowId |
string |
Идентификатор целевого потока данных |
Encryption
Сведения о шифровании для набора данных
Имя | Тип | Описание |
---|---|---|
EncryptionStatus |
Состояние шифрования набора данных |
EncryptionStatus
Состояние шифрования набора данных
Значение | Описание |
---|---|
InSyncWithWorkspace |
Шифрование поддерживается и синхронизируется с параметрами шифрования. |
NotInSyncWithWorkspace |
Шифрование поддерживается, но не синхронизируется с параметрами шифрования. |
NotSupported |
Шифрование не поддерживается для этого набора данных |
Unknown |
Состояние шифрования неизвестно из-за повреждения набора данных |
PrincipalType
Тип субъекта
Значение | Описание |
---|---|
App |
Тип субъекта-службы |
Group |
Тип субъекта-группы |
None |
Нет типа субъекта. Используется для доступа на уровне всей организации. |
User |
Тип субъекта-пользователя |
ServicePrincipalProfile
Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами.
Имя | Тип | Описание |
---|---|---|
displayName |
string |
Имя профиля субъекта-службы |
id |
string (uuid) |
Идентификатор профиля субъекта-службы |