Admin - Dataflows GetDataflowsAsAdmin
Zwraca listę przepływów danych dla organizacji.
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.
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}
Parametry identyfikatora URI
Nazwa | W | Wymagane | Typ | Opis |
---|---|---|---|---|
$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 |
OK |
Przykłady
Example
Sample Request
GET https://api.powerbi.com/v1.0/myorg/admin/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",
"workspaceId": "6369a442-4bc4-425c-916d-460c42be746b"
}
]
}
Definicje
Nazwa | Opis |
---|---|
Admin |
Metadane przepływu danych zwracane przez interfejsy API Administracja. 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. |
Admin |
Otoka odpowiedzi OData dla kolekcji przepływów danych usługi Power BI Administracja |
Dataflow |
Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych |
Dataflow |
Prawo dostępu, które użytkownik ma dla przepływu danych (poziom uprawnień) |
Principal |
Typ podmiotu zabezpieczeń |
Service |
Profil główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami. |
AdminDataflow
Metadane przepływu danych zwracane przez interfejsy API Administracja. 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 |
(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 |
|
workspaceId |
string |
Identyfikator obszaru roboczego przepływu danych. |
AdminDataflows
Otoka odpowiedzi OData dla kolekcji przepływów danych usługi Power BI Administracja
Nazwa | Typ | Opis |
---|---|---|
odata.context |
string |
Kontekst OData |
value |
Kolekcja raportów |
DataflowUser
Wpis prawa dostępu użytkownika usługi Power BI dla przepływu danych
Nazwa | Typ | Opis |
---|---|---|
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 |
Typ podmiotu zabezpieczeń |
|
profile |
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 |