Dataflows - Get Dataflows

Service:

Power BI REST APIs

API Version:

v1.0

Zwraca listę wszystkich przepływów danych z określonego obszaru roboczego.

Uprawnienia

To wywołanie interfejsu API może być wywoływane przez profil jednostki usługi. Aby uzyskać więcej informacji, zobacz: Profile jednostki usługi w Power BI Embedded.

Wymagany zakres

Dataflow.ReadWrite.All lub Dataflow.Read.All

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

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
groupId	path	True	string uuid	Identyfikator obszaru roboczego

Odpowiedzi

Nazwa	Typ	Opis
200 OK	Dataflows	OK

Przykłady

Example

Sample Request

GET https://api.powerbi.com/v1.0/myorg/groups/a2f89923-421a-464e-bf4c-25eab39bb09f/dataflows

Sample Response

Status code:

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

Definicje

Nazwa	Opis
Dataflow	Metadane przepływu danych. Poniżej znajduje się lista właściwości, które mogą być zwracane dla przepływu danych. W zależności od wywoływanego interfejsu API zostanie zwrócony tylko podzbiór właściwości, uprawnienia obiektu wywołującego i dostępność danych w bazie danych usługi Power BI.
Dataflows	Otoka odpowiedzi OData dla listy metadanych przepływu danych
DataflowUser	Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych
DataflowUserAccessRight	Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień)
PrincipalType	Typ podmiotu zabezpieczeń
ServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

Dataflow

Metadane przepływu danych. Poniżej znajduje się lista właściwości, które mogą być zwracane dla przepływu danych. W zależności od wywoływanego interfejsu API zostanie zwrócony tylko podzbiór właściwości, uprawnienia obiektu wywołującego i dostępność danych w bazie danych usługi Power BI.

Nazwa	Typ	Opis
configuredBy	string	Właściciel przepływu danych
description	string	Opis przepływu danych
modelUrl	string	Adres URL pliku definicji przepływu danych (model.json)
modifiedBy	string	Użytkownik, który zmodyfikował przepływ danych
modifiedDateTime	string	Data i godzina ostatniej modyfikacji przepływu danych
name	string	Nazwa przepływu danych
objectId	string	Identyfikator przepływu danych
users	DataflowUser[]	(Wartość pusta) Szczegóły dostępu użytkownika przepływu danych. Ta właściwość zostanie usunięta z odpowiedzi ładunku w nadchodzącej wersji. Informacje o użytkowniku w przepływie danych usługi Power BI można pobrać przy użyciu wywołania interfejsu API Pobierania przepływów danych jako wywołania interfejsu API Administracja lub wywołania interfejsu API PostWorkspaceInfo za pomocą parametru getArtifactUser .

Dataflows

Otoka odpowiedzi OData dla listy metadanych przepływu danych

Nazwa	Typ	Opis
odata.context	string
value	Dataflow[]	Lista metadanych przepływu danych

DataflowUser

Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych

Nazwa	Typ	Opis
DataflowUserAccessRight	DataflowUserAccessRight	Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień)
displayName	string	Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress	string	Adres e-mail użytkownika
graphId	string	Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratora.
identifier	string	Identyfikator podmiotu zabezpieczeń
principalType	PrincipalType	Typ podmiotu zabezpieczeń
profile	ServicePrincipalProfile	Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.
userType	string	Typ użytkownika.

DataflowUserAccessRight

Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień)

Nazwa	Typ	Opis
None	string	Usuwa uprawnienia do zawartości w przepływie danych
Owner	string	Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w przepływie danych
Read	string	Udziela dostępu do odczytu zawartości w przepływie danych
ReadReshare	string	Udziela dostępu do odczytu i udostępniania dalej zawartości w przepływie danych
ReadWrite	string	Udziela dostępu do odczytu i zapisu zawartości w przepływie danych

PrincipalType

Typ podmiotu zabezpieczeń

Nazwa	Typ	Opis
App	string	Typ jednostki usługi
Group	string	Typ podmiotu zabezpieczeń grupy
None	string	Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User	string	Typ podmiotu zabezpieczeń użytkownika

ServicePrincipalProfile

Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

Nazwa	Typ	Opis
displayName	string	Nazwa profilu jednostki usługi
id	string	Identyfikator profilu jednostki usługi