Поделиться через


Admin - Datasets GetDatasetsInGroupAsAdmin

Возвращает список наборов данных из указанной рабочей области.

Разрешения

  • Пользователь должен иметь права администратора (например, Office 365 глобального администратора или администратора службы Power BI) или пройти проверку подлинности с помощью субъекта-службы.
  • Поддерживаются делегированные разрешения.

При выполнении в режиме предварительной проверки подлинности службы в портал Azure приложение не должно иметь необходимых предустановок согласия администратора для Power BI.

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

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

Имя В Обязательно Тип Описание
groupId
path True

string

uuid

идентификатор рабочей области;

$expand
query

string

Развертывает встроенные связанные сущности

$filter
query

string

Фильтрует результаты на основе логического условия

$skip
query

integer

int32

Пропускает первые n результатов

$top
query

integer

int32

Возвращает только первые n результатов

Ответы

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

AdminDatasets

ОК

Примеры

Example
Example with expand on encryption

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets

Sample Response

{
  "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

Sample Request

GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/datasets?$expand=encryption

Sample Response

{
  "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"
      }
    }
  ]
}

Определения

Имя Описание
AdminDataset

Набор данных Power BI, возвращаемый api Администратор. API возвращает подмножество из следующего списка свойств набора данных. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.

AdminDatasets

Оболочка списка odata набора данных

DatasetQueryScaleOutSettings

Параметры масштабирования запроса для набора данных

DatasetUser

Запись права доступа пользователя Power BI для набора данных

DatasetUserAccessRight

Право доступа, которое пользователь имеет для набора данных (уровень разрешений)

DependentDataflow

Поток данных, зависящий от Power BI

Encryption

Сведения о шифровании для набора данных

EncryptionStatus

Состояние шифрования набора данных

PrincipalType

Тип субъекта

ServicePrincipalProfile

Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.

AdminDataset

Набор данных Power BI, возвращаемый api Администратор. API возвращает подмножество из следующего списка свойств набора данных. Подмножество зависит от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.

Имя Тип Описание
ContentProviderType

string

Тип поставщика контента для набора данных

CreateReportEmbedURL

string

URL-адрес внедрения отчета создания набора данных

CreatedDate

string

Дата и время создания набора данных

Encryption

Encryption

Сведения о шифровании набора данных. Применимо, только если $expand указан параметр .

IsEffectiveIdentityRequired

boolean

Требуется ли набору данных действующее удостоверение, которое необходимо отправить в вызове API GenerateToken .

IsEffectiveIdentityRolesRequired

boolean

Определяется ли безопасность на уровне строк в PBIX-файле Power BI. Если да, необходимо указать роль.

IsInPlaceSharingEnabled

boolean

Можно ли предоставить доступ к набору данных внешним пользователям для использования в их собственном клиенте

IsOnPremGatewayRequired

boolean

Требуется ли набору данных локальный шлюз данных

IsRefreshable

boolean

Является ли набор данных обновляемым или нет. Обновляемый набор данных Power BI — это набор данных, который обновлялся по крайней мере один раз или для которого существует допустимое расписание обновления.

QnaEmbedURL

string

URL-адрес внедрения набора данных Q&A

addRowsAPIEnabled

boolean

Позволяет ли набор данных добавлять новые строки

configuredBy

string

Владелец набора данных

description

string

Описание набора данных

id

string

Идентификатор набора данных

name

string

Имя набора данных

queryScaleOutSettings

DatasetQueryScaleOutSettings

Параметры масштабирования запроса для набора данных

targetStorageMode

string

Режим хранения набора данных

upstreamDataflows

DependentDataflow[]

Список всех потоков данных, от которые зависит этот элемент

users

DatasetUser[]

(Пустое значение) Сведения о доступе пользователя к набору данных. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Сведения о пользователях элемента Power BI (например, отчет или панель мониторинга) можно получить с помощью API получения набора данных в качестве Администратор API или API PostWorkspaceInfo с параметром getArtifactUsers .

webUrl

string

URL-адрес набора данных

workspaceId

string

Идентификатор рабочей области набора данных. Это свойство будет возвращено только в GetDatasetsAsAdmin.

AdminDatasets

Оболочка списка odata набора данных

Имя Тип Описание
odata.context

string

Контекст OData

value

AdminDataset[]

Наборы данных

DatasetQueryScaleOutSettings

Параметры масштабирования запроса для набора данных

Имя Тип Описание
autoSyncReadOnlyReplicas

boolean

Автоматически ли набор данных синхронизирует реплики только для чтения

maxReadOnlyReplicas

integer

Максимальное число реплик только для чтения для набора данных (0–64, –1 для автоматического числа реплик)

DatasetUser

Запись права доступа пользователя Power BI для набора данных

Имя Тип Описание
datasetUserAccessRight

DatasetUserAccessRight

Право доступа, которое пользователь имеет для набора данных (уровень разрешений)

displayName

string

Отображаемое имя субъекта

emailAddress

string

Адрес электронной почты пользователя

graphId

string

Идентификатор субъекта в Microsoft Graph. Доступно только для api-интерфейсов администратора.

identifier

string

Идентификатор субъекта

principalType

PrincipalType

Тип субъекта

profile

ServicePrincipalProfile

Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.

userType

string

Тип пользователя.

DatasetUserAccessRight

Право доступа, которое пользователь имеет для набора данных (уровень разрешений)

Имя Тип Описание
None

string

Удаляет разрешение на содержимое в наборе данных.

Read

string

Предоставляет доступ на чтение к содержимому в наборе данных.

ReadExplore

string

Предоставляет доступ на чтение и просмотр к содержимому в наборе данных

ReadReshare

string

Предоставляет доступ для чтения и повторного доступа к содержимому в наборе данных.

ReadReshareExplore

string

Предоставляет доступ для чтения, повторного доступа и просмотра к содержимому в наборе данных.

ReadWrite

string

Предоставляет доступ на чтение и запись к содержимому в наборе данных.

ReadWriteExplore

string

Предоставляет доступ для чтения, записи и просмотра к содержимому в наборе данных.

ReadWriteReshare

string

Предоставляет доступ для чтения, записи и повторного доступа к содержимому в наборе данных.

ReadWriteReshareExplore

string

Предоставляет доступ для чтения, записи, повторного доступа и просмотра к содержимому в наборе данных.

DependentDataflow

Поток данных, зависящий от Power BI

Имя Тип Описание
groupId

string

Идентификатор целевой группы

targetDataflowId

string

Идентификатор целевого потока данных

Encryption

Сведения о шифровании для набора данных

Имя Тип Описание
EncryptionStatus

EncryptionStatus

Состояние шифрования набора данных

EncryptionStatus

Состояние шифрования набора данных

Имя Тип Описание
InSyncWithWorkspace

string

Шифрование поддерживается и синхронизируется с параметрами шифрования.

NotInSyncWithWorkspace

string

Шифрование поддерживается, но не синхронизируется с параметрами шифрования

NotSupported

string

Шифрование не поддерживается для этого набора данных

Unknown

string

Состояние шифрования неизвестно из-за повреждения набора данных

PrincipalType

Тип субъекта

Имя Тип Описание
App

string

Тип субъекта-службы

Group

string

Тип субъекта-группы

None

string

Нет основного типа. Используйте для доступа на уровне всей организации.

User

string

Тип субъекта-пользователя

ServicePrincipalProfile

Профиль субъекта служба Power BI. Применимо только для Power BI Embedded мультитенантного решения.

Имя Тип Описание
displayName

string

Имя профиля субъекта-службы

id

string

Идентификатор профиля субъекта-службы