Admin - Dataflows GetDataflowUsersAsAdmin
Zwraca listę użytkowników, którzy mają dostęp do określonego przepływu danych.
Permissions
- Użytkownik musi być administratorem sieci szkieletowej lub uwierzytelniać 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 witrynie Azure Portal.
Wymagany zakres
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/dataflows/{dataflowId}/users
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
dataflow
|
path | True |
string (uuid) |
Identyfikator przepływu danych |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
OK |
Przykłady
Example
Przykładowe żądanie
GET https://api.powerbi.com/v1.0/myorg/admin/dataflows/{dataflowId}/users
Przykładowa odpowiedź
{
"value": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"dataflowUserAccessRight": "ReadWrite",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
}
]
}
Definicje
| Nazwa | Opis |
|---|---|
|
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ń) |
|
Dataflow |
Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do przepływu danych |
|
Principal |
Typ podmiotu zabezpieczeń |
|
Service |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded. |
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 administratorów. |
| identifier |
string |
Identyfikator podmiotu zabezpieczeń |
| principalType |
Typ podmiotu zabezpieczeń |
|
| profile |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded. |
|
| userType |
string |
Typ użytkownika. |
DataflowUserAccessRight
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 |
DataflowUsers
Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do przepływu danych
| Nazwa | Typ | Opis |
|---|---|---|
| @odata.context |
string |
|
| value |
Lista użytkowników z dostępem do przepływu danych |
PrincipalType
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
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania z wieloma dzierżawami usługi Power BI Embedded.
| Nazwa | Typ | Opis |
|---|---|---|
| displayName |
string |
Nazwa profilu jednostki usługi |
| id |
string (uuid) |
Identyfikator profilu jednostki usługi |