Udostępnij przez

Dataflows - Get Dataflows

Usługa:
Power BI REST APIs
Wersja interfejsu API:
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 usłudze 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

Przykładowe żądanie

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

Przykładowa odpowiedź

Kod stanu:
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 jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

Dataflow

Objekt

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)
name

string

Nazwa przepływu danych
objectId

string (uuid)

Identyfikator przepływu danych
users

DataflowUser[]

(Pusta wartość) 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 administratora Pobierz użytkowników przepływu danych lub wywołania interfejsu API PostWorkspaceInfo z parametrem .

Dataflows

Objekt

Otoka odpowiedzi OData dla listy metadanych przepływu danych

Nazwa Typ Opis
@odata.context

string

value

Dataflow[]

Lista metadanych przepływu danych

DataflowUser

Objekt

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 administratorów.
identifier

string

Identyfikator podmiotu zabezpieczeń
principalType

PrincipalType

Typ podmiotu zabezpieczeń
profile

ServicePrincipalProfile

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.
userType

string

Typ użytkownika.

DataflowUserAccessRight

Wyliczanie

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

Wartość Opis
None

Usuwa uprawnienia do zawartości w przepływie danych
Read

Przyznaje dostęp do odczytu do zawartości w przepływie danych
ReadWrite

Przyznaje dostęp do odczytu i zapisu do zawartości w przepływie danych
ReadReshare

Udziela dostępu do odczytu i udostępniania dalej zawartości w przepływie danych
Owner

Udziela dostępu do odczytu, zapisu i udostępniania dalej do zawartości w przepływie danych

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń

Wartość Opis
None

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User

Typ podmiotu zabezpieczeń użytkownika
Group

Typ podmiotu zabezpieczeń grupy
App

Typ jednostki usługi

ServicePrincipalProfile

Objekt

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi
id

string (uuid)

Identyfikator profilu jednostki usługi