Gateways - Add Datasource User

Služba:

Power BI REST APIs

Verze rozhraní API:

v1.0

Udělí nebo aktualizuje oprávnění požadovaná k použití zadaného zdroje dat pro zadaného uživatele.

Dovolení

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

Požadovaný obor

Dataset.ReadWrite.All

Omezení

Brány virtuální sítě se nepodporují. Přidávání skupin prostřednictvím rozhraní API se nepodporuje.

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

Text požadavku

Name	Vyžadováno	Typ	Description
datasourceAccessRight	True	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.

Odpovědi

Name	Typ	Description
200 OK		OK

Příklady

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Example

Assign the ReadOverrideEffectiveIdentity user access right to a service principal example

Ukázkový požadavek

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

Text požadavku

{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Ukázková odpověď

Stavový kód:

200

Example

Ukázkový požadavek

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

Text požadavku

{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Ukázková odpověď

Stavový kód:

200

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

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