Gateways - Get Datasource Users

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Vrátí seznam uživatelů, kteří mají přístup k zadanému zdroji dat.

Dovolení

Uživatel musí mít oprávnění správce brány.

Požadovaný obor

Dataset.ReadWrite.All nebo Dataset.Read.All

Omezení

Brány virtuální sítě se nepodporují.

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

Parametry identifikátoru URI

Name	V	Vyžadováno	Typ	Description
datasourceId	path	True	string (uuid)	ID zdroje dat
gatewayId	path	True	string (uuid)	ID brány. Při použití clusteru brány odkazuje ID brány na primární (první) bránu v clusteru. V takových případech se ID brány podobá ID clusteru brány.

Odpovědi

Name	Typ	Description
200 OK	DatasourceUsers	OK

Příklady

Example

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:

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"
    }
  ]
}

Definice

Name	Description
DatasourceUser	Uživatel Power BI s přístupem ke zdroji dat
DatasourceUserAccessRight	Přístupové právo (úroveň oprávnění), které má uživatel ve zdroji dat
DatasourceUsers	Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem ke zdroji dat
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.

DatasourceUser

Objekt

Uživatel Power BI s přístupem ke zdroji dat

Name	Typ	Description
datasourceAccessRight	DatasourceUserAccessRight	Přístupové právo (úroveň oprávnění), které má uživatel ve zdroji dat
displayName	string	Zobrazovaný název objektu zabezpečení
emailAddress	string	E-mailová adresa uživatele
identifier	string	ID objektu objektu zabezpečení
principalType	PrincipalType	Typ objektu zabezpečení
profile	ServicePrincipalProfile	Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.

DatasourceUserAccessRight

Výčet

Přístupové právo (úroveň oprávnění), které má uživatel ve zdroji dat

Hodnota	Description
None	Žádné oprávnění pro přístup ke zdroji dat. Platí jenom při aktualizaci uživatelských oprávnění.
Read	Datové sady vlastněné uživatelem mají ke zdroji dat přístup pro čtení.
ReadOverrideEffectiveIdentity	Uživatel může přepsat efektivní identitu pro Power BI Embedded. Platí jenom pro místní zdroje dat Analysis Services.

DatasourceUsers

Objekt

Obálka odpovědi OData pro seznam uživatelů Power BI s přístupem ke zdroji dat

Name	Typ	Description
@odata.context	string
value	DatasourceUser[]	Seznam uživatelů s přístupem ke zdroji dat

PrincipalType

Výčet

Typ objektu zabezpečení

Hodnota	Description
None	Žádný typ objektu zabezpečení. Používá se pro přístup na úrovni celé organizace.
User	Typ objektu zabezpečení uživatele
Group	Typ objektu zabezpečení skupiny
App	Typ instančního objektu

ServicePrincipalProfile

Objekt

Profil instančního objektu Power BI. Relevantní pouze pro víceklientské řešení Power BI Embedded.

Name	Typ	Description
displayName	string	Název instančního profilu
id	string (uuid)	ID profilu instančního objektu