Gateways - Add Datasource User

Service:

Power BI REST APIs

API Version:

v1.0

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

Oprávnění

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ě (VNet) 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. Pokud používáte cluster bran, ID brány odkazuje 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áva (úroveň oprávnění), která má uživatel ke zdroji dat
displayName		string	Zobrazovaný název objektu zabezpečení
emailAddress		string	E-mailová adresa uživatele
identifier		string	ID objektu zabezpečení
principalType		PrincipalType	Typ objektu zabezpečení
profile		ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

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

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Example

Sample Request

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

Request Body

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

Sample Response

Status code:

200

Definice

Name	Description
DatasourceUser	Uživatel Power BI s přístupem ke zdroji dat
DatasourceUserAccessRight	Přístupová práva (úroveň oprávnění), která má uživatel ke zdroji dat
PrincipalType	Typ objektu zabezpečení
ServicePrincipalProfile	Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

DatasourceUser

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

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

DatasourceUserAccessRight

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

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

PrincipalType

Typ objektu zabezpečení

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

ServicePrincipalProfile

Profil objektu zabezpečení služba Power BI. Relevantní pouze pro Power BI Embedded řešení s více tenanty.

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