Udostępnij przez

Gateways - Get Datasource Users

Usługa:
Power BI REST APIs
Wersja interfejsu API:
v1.0

Zwraca listę użytkowników, którzy mają dostęp do określonego źródła danych.

Permissions

Użytkownik musi mieć uprawnienia administratora bramy.

Wymagany zakres

Dataset.ReadWrite.All lub Dataset.Read.All

Ograniczenia

Bramy sieci wirtualnej nie są obsługiwane. 

GET https://api.powerbi.com/v1.0/myorg/gateways/{gatewayId}/datasources/{datasourceId}/users

Parametry identyfikatora URI

Nazwa W Wymagane Typ Opis
datasourceId
 path True

string (uuid)

Identyfikator źródła danych
gatewayId
 path True

string (uuid)

Identyfikator bramy. W przypadku korzystania z klastra bramy identyfikator bramy odwołuje się do bramy podstawowej (pierwszej) w klastrze. W takich przypadkach identyfikator bramy jest podobny do identyfikatora klastra bramy.

Odpowiedzi

Nazwa Typ Opis
200 OK

DatasourceUsers

OK

Przykłady

Example

Przykładowe żądanie

GET https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users

Przykładowa odpowiedź

Kod stanu:
200 
{
  "value": [
    {
      "datasourceAccessRight": "Read",
      "displayName": "John Nick",
      "emailAddress": "john@contoso.com",
      "identifier": "john@contoso.com",
      "principalType": "User"
    },
    {
      "datasourceAccessRight": "ReadOverrideEffectiveIdentity",
      "displayName": "ContosoTestApp",
      "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
      "principalType": "App"
    }
  ]
}

Definicje

Nazwa Opis
DatasourceUser

Użytkownik usługi Power BI z dostępem do źródła danych
DatasourceUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w źródle danych
DatasourceUsers

Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do źródła 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.

DatasourceUser

Objekt

Użytkownik usługi Power BI z dostępem do źródła danych

Nazwa Typ Opis
datasourceAccessRight

DatasourceUserAccessRight

Prawo dostępu (poziom uprawnień), które użytkownik ma w źródle danych
displayName

string

Nazwa wyświetlana podmiotu zabezpieczeń
emailAddress

string

Adres e-mail użytkownika
identifier

string

Identyfikator obiektu 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.

DatasourceUserAccessRight

Wyliczanie

Prawo dostępu (poziom uprawnień), które użytkownik ma w źródle danych

Wartość Opis
None

Brak uprawnień dostępu do źródła danych. Ma zastosowanie tylko podczas aktualizowania uprawnień użytkownika.
Read

Zestawy danych należące do użytkownika mają dostęp do odczytu do źródła danych
ReadOverrideEffectiveIdentity

Użytkownik może zastąpić obowiązującą tożsamość usługi Power BI Embedded. Dotyczy tylko lokalnych źródeł danych usług Analysis Services.

DatasourceUsers

Objekt

Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do źródła danych

Nazwa Typ Opis
@odata.context

string

value

DatasourceUser[]

Lista użytkowników z dostępem do źródła 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 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