Dataflows - Get Dataflows

Служба:

Power BI REST APIs

Версия API:

v1.0

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

Разрешения

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

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

Dataflow.ReadWrite.All или Dataflow.Read.All

GET https://api.powerbi.com/v1.0/myorg/groups/{groupId}/dataflows

Параметры URI

Имя	В	Обязательно	Тип	Описание
groupId	path	True	string (uuid)	Идентификатор рабочей области

Ответы

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

Примеры

Example

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

GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/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"
    }
  ]
}

Определения

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

Dataflow

Object

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

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

Dataflows

Object

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

Имя	Тип	Описание
@odata.context	string
value	Dataflow[]	Список метаданных потока данных

DataflowUser

Object

Запись права доступа пользователя 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	Удаляет разрешение на содержимое в потоке данных
Read	Предоставляет доступ на чтение к содержимому в потоке данных
ReadWrite	Предоставляет доступ на чтение и запись к содержимому в потоке данных
ReadReshare	Предоставляет доступ для чтения и повторного доступа к содержимому в потоке данных
Owner	Предоставляет доступ для чтения, записи и повторного доступа к содержимому в потоке данных

PrincipalType

Перечисление

Тип субъекта

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

ServicePrincipalProfile

Object

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

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