Admin - Dataflows GetDataflowsAsAdmin

Ссылка

Служба:: Power BI REST APIs

Версия API:: v1.0

Возвращает список потоков данных для организации.

Разрешения

Пользователь должен быть администратором Fabric или пройти проверку подлинности с помощью субъекта-службы.
Поддерживаются делегированные разрешения.

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

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

Tenant.Read.All или Tenant.ReadWrite.All

Важно только при проверке подлинности через стандартный делегированный маркер доступа администратора. Не должно присутствовать при использовании проверки подлинности через субъект-службу.

Ограничения

Максимум 200 запросов в час.

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

С использованием необязательных параметров:

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows?$filter={$filter}&$top={$top}&$skip={$skip}

Параметры URI

Имя	В	Тип	Описание
$filter	query	string	Возвращает подмножество результатов на основе условия параметра запроса Odata Odata фильтра.
$skip	query	integer int32	Пропускает первые результаты n
$top	query	integer int32	Возвращает только первые результаты n

Ответы

Имя	Тип	Описание
200 OK	AdminDataflows	ХОРОШО

Примеры

Example

Образец запроса

GET https://api.powerbi.com/v1.0/myorg/admin/dataflows

Пример ответа

Код состояния:: 200

{
  "value": [
    {
      "objectId": "bd32e5c0-363f-430b-a03b-5535a4804b9b",
      "name": "AdventureWorks",
      "description": "Our Adventure Works",
      "modelUrl": "https://MyDataflowStorageAccount.dfs.core.windows.net/powerbi/contoso/AdventureWorks/model.json",
      "configuredBy": "john@contoso.com",
      "workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
    }
  ]
}

Определения

Имя	Описание
AdminDataflow	Метаданные потока данных, возвращаемые API администрирования. Ниже приведен список свойств, которые могут быть возвращены для потока данных. Только подмножество свойств будет возвращено в зависимости от вызываемого API, разрешений вызывающего объекта и доступности данных в базе данных Power BI.
AdminDataflows	Оболочка ответа OData для коллекции потоков данных администратора Power BI
DataflowUser	Запись права доступа пользователя Power BI для потока данных
DataflowUserAccessRight	Право доступа, которое пользователь имеет для потока данных (уровень разрешений)
PrincipalType	Тип субъекта
ServicePrincipalProfile	Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами.

AdminDataflow

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

Имя	Тип	Описание
configuredBy	string	Владелец потока данных
description	string	Описание потока данных
modelUrl	string	URL-адрес файла определения потока данных (model.json)
modifiedBy	string	Пользователь, изменив поток данных
modifiedDateTime	string	Дата и время последнего изменения потока данных
name	string	Имя потока данных
objectId	string	Идентификатор потока данных
users	DataflowUser[]	(Пустое значение) Сведения о доступе пользователей потока данных. Это свойство будет удалено из ответа полезных данных в предстоящем выпуске. Вы можете получить сведения о потоке данных Power BI с помощью вызова API Получения пользователей потока данных в качестве администратора или вызова API PostWorkspaceInfo с параметром `getArtifactUser`.
workspaceId	string	Идентификатор рабочей области потока данных.

AdminDataflows

Оболочка ответа OData для коллекции потоков данных администратора Power BI

Имя	Тип	Описание
odata.context	string	Контекст OData
value	AdminDataflow[]	Коллекция отчетов

DataflowUser

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

Имя	Тип	Описание
DataflowUserAccessRight	DataflowUserAccessRight	Право доступа, которое пользователь имеет для потока данных (уровень разрешений)
displayName	string	Отображаемое имя субъекта
emailAddress	string	Адрес электронной почты пользователя
graphId	string	Идентификатор субъекта в Microsoft Graph. Доступно только для API администрирования.
identifier	string	Идентификатор субъекта
principalType	PrincipalType	Тип субъекта
profile	ServicePrincipalProfile	Профиль субъекта-службы Power BI. Применимо только для решения Power BI Embedded с несколькими арендами.
userType	string	Тип пользователя.

DataflowUserAccessRight

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

Имя	Тип	Описание
None	string	Удаляет разрешение на содержимое в потоке данных
Owner	string	Предоставляет доступ для чтения, записи и повторного доступа к содержимому в потоке данных
Read	string	Предоставляет доступ на чтение к содержимому в потоке данных
ReadReshare	string	Предоставляет доступ для чтения и повторного доступа к содержимому в потоке данных
ReadWrite	string	Предоставляет доступ на чтение и запись к содержимому в потоке данных

PrincipalType

Тип субъекта

Имя	Тип	Описание
App	string	Тип субъекта-службы
Group	string	Тип субъекта-группы
None	string	Нет типа субъекта. Используется для доступа на уровне всей организации.
User	string	Тип субъекта-пользователя

ServicePrincipalProfile

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

Имя	Тип	Описание
displayName	string	Имя профиля субъекта-службы
id	string	Идентификатор профиля субъекта-службы

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