Udostępnij za pośrednictwem


Admin - Dataflows GetDataflowsInGroupAsAdmin

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

Uprawnienia

  • Użytkownik musi mieć uprawnienia administratora (takie jak administrator globalny Office 365 lub administrator usługi Power BI) lub uwierzytelnić się przy użyciu jednostki usługi.
  • Uprawnienia delegowane są obsługiwane.

W przypadku uruchamiania w ramach uwierzytelniania podstawowego usługi aplikacja nie może mieć żadnych premii wymaganych przez administratora dla usługi Power BI ustawionych w Azure Portal.

Zakres wymagany

Tenant.Read.All lub Tenant.ReadWrite.All

Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.

Ograniczenia

Maksymalna liczba żądań na godzinę wynosi 200.

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

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
groupId
path True

string

uuid

Identyfikator obszaru roboczego

$filter
query

string

Filtruje wyniki na podstawie warunku logicznego

$skip
query

integer

int32

Pomija pierwsze n wyników

$top
query

integer

int32

Zwraca tylko pierwsze n wyników

Odpowiedzi

Nazwa Typ Opis
200 OK

Dataflows

OK

Przykłady

Example

Sample Request

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

Sample Response

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

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 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 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[]

(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 Pobierz użytkowników przepływu danych jako Administracja lub wywołania interfejsu API PostWorkspaceInfo z parametrem 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

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

Read

string

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

ReadReshare

string

Przyznaje dostęp do odczytu i udostępniania dalej zawartości w przepływie danych

ReadWrite

string

Przyznaje dostęp do odczytu i zapisu do 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