Udostępnij przez

Gateways - Add Datasource User

Usługa:
Power BI REST APIs
Wersja interfejsu API:
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.

Wymagany zakres

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 jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

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

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Treść żądania
{
  "identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
  "datasourceAccessRight": "ReadOverrideEffectiveIdentity"
}

Przykładowa odpowiedź

Kod stanu:
200

Example

Przykładowe żądanie

POST https://api.powerbi.com/v1.0/myorg/gateways/1f69e798-5852-4fdd-ab01-33bb14b6e934/datasources/252b9de8-d915-4788-aaeb-ec8c2395f970/users
Treść żądania
{
  "emailAddress": "john@contoso.com",
  "datasourceAccessRight": "Read"
}

Przykładowa odpowiedź

Kod stanu:
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 jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

DatasourceUser

Objekt

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 jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

DatasourceUserAccessRight

Wyliczanie

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

Wartość Opis
None

Brak uprawnień dostępu do źródła danych. Ma zastosowanie tylko podczas aktualizowania uprawnień użytkownika.
Read

Zestawy danych należące do użytkownika mają dostęp do odczytu do źródła danych
ReadOverrideEffectiveIdentity

Użytkownik może zastąpić obowiązującą tożsamość usługi Power BI Embedded. Dotyczy tylko lokalnych źródeł danych usług Analysis Services.

PrincipalType

Wyliczanie

Typ podmiotu zabezpieczeń

Wartość Opis
None

Brak typu podmiotu zabezpieczeń. Służy do uzyskiwania dostępu na poziomie całej organizacji.
User

Typ podmiotu zabezpieczeń użytkownika
Group

Typ podmiotu zabezpieczeń grupy
App

Typ jednostki usługi

ServicePrincipalProfile

Objekt

Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded.

Nazwa Typ Opis
displayName

string

Nazwa profilu jednostki usługi
id

string (uuid)

Identyfikator profilu jednostki usługi