Gateways - Add Datasource User

Service:

Power BI REST APIs

API Version:

v1.0

Przyznaje lub aktualizuje uprawnienia wymagane do używania określonego źródła danych dla określonego użytkownika.

Uprawnienia

Użytkownik musi mieć uprawnienia administratora bramy.

Zakres wymagany

Dataset.ReadWrite.All

Ograniczenia

Bramy sieci wirtualnej nie są obsługiwane. Dodawanie grup za pośrednictwem interfejsu API nie jest obsługiwane.

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

Treść żądania

Nazwa	Wymagane	Typ	Opis
datasourceAccessRight	True	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.

Odpowiedzi

Nazwa	Typ	Opis
200 OK		OK

Przykłady

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

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

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