Gateways - Get Datasource Users

Service:

Power BI REST APIs

API Version:

v1.0

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

Uprawnienia

Użytkownik musi mieć uprawnienia administratora bramy.

Zakres wymagany

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

Sample Request

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

Sample Response

Status code:

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 główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

DatasourceUser

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 główny usługa Power BI. Dotyczy tylko Power BI Embedded rozwiązania z wieloma dzierżawami.

DatasourceUserAccessRight

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

Nazwa	Typ	Opis
None	string	Brak uprawnień dostępu do źródła danych. Ma zastosowanie tylko podczas aktualizowania uprawnień użytkownika.
Read	string	Zestawy danych należące do użytkownika mają dostęp do odczytu do źródła danych
ReadOverrideEffectiveIdentity	string	Użytkownik może zastąpić obowiązującą tożsamość dla Power BI Embedded. Dotyczy tylko lokalnych źródeł danych usług Analysis Services.

DatasourceUsers

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

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