Udostępnij przez


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
dataflowId
path True

string (uuid)

Identyfikator przepływu danych

Odpowiedzi

Nazwa Typ Opis
200 OK

DataflowUsers

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

DataflowUsers

Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do przepływu danych

PrincipalType

Typ podmiotu zabezpieczeń

ServicePrincipalProfile

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

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

DataflowUser[]

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