Admin - Groups GetGroupUsersAsAdmin
Zwraca listę użytkowników, którzy mają dostęp do określonego obszaru roboczego.
Uprawnienia
- Użytkownik musi być administratorem sieci szkieletowej lub uwierzytelniać się przy użyciu jednostki usługi.
- Uprawnienia delegowane są obsługiwane.
W przypadku uruchamiania w ramach uwierzytelniania podstawowego usługi aplikacji nie może mieć żadnych premii wymaganych przez administratora dla usługi Power BI ustawionych w witrynie Azure Portal.
Wymagany zakres
Tenant.Read.All lub Tenant.ReadWrite.All
Istotne tylko w przypadku uwierzytelniania za pośrednictwem standardowego delegowanego tokenu dostępu administratora. Nie może być obecny, gdy jest używane uwierzytelnianie za pośrednictwem jednostki usługi.
Ograniczenia
Maksymalna liczba żądań na godzinę wynosi 200.
GET https://api.powerbi.com/v1.0/myorg/admin/groups/{groupId}/users
Parametry identyfikatora URI
| Nazwa | W | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
group
|
path | True |
string (uuid) |
Identyfikator obszaru roboczego |
Odpowiedzi
| Nazwa | Typ | Opis |
|---|---|---|
| 200 OK |
OK |
Przykłady
Example
Przykładowe żądanie
GET https://api.powerbi.com/v1.0/myorg/admin/groups/f089354e-8366-4e18-aea3-4cb4a3a50b48/users
Przykładowa odpowiedź
{
"value": [
{
"displayName": "John Nick",
"emailAddress": "john@contoso.com",
"groupUserAccessRight": "Admin",
"identifier": "john@contoso.com",
"graphId": "3fadb6e4-130c-4a8f-aeac-416e38b66756",
"principalType": "User"
},
{
"displayName": "Adam Wood",
"emailAddress": "Adam@contoso.com",
"groupUserAccessRight": "Member",
"identifier": "Adam@contoso.com",
"graphId": "785e192c-0f1f-41ca-ae7a-a85da28e565a",
"principalType": "User"
},
{
"displayName": "ContosoTestApp",
"groupUserAccessRight": "Admin",
"identifier": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"graphId": "3d9b93c6-7b6d-4801-a491-1738910904fd",
"principalType": "App"
}
]
}
Definicje
| Nazwa | Opis |
|---|---|
|
Group |
Użytkownik usługi Power BI z dostępem do obszaru roboczego |
|
Group |
Prawo dostępu (poziom uprawnień), który użytkownik ma w obszarze roboczym |
|
Group |
Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do obszaru roboczego |
|
Principal |
Typ podmiotu zabezpieczeń |
|
Service |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
GroupUser
Użytkownik usługi Power BI z dostępem do obszaru roboczego
| Nazwa | Typ | Opis |
|---|---|---|
| displayName |
string |
Nazwa wyświetlana podmiotu zabezpieczeń |
| emailAddress |
string |
Adres e-mail użytkownika |
| graphId |
string |
Identyfikator podmiotu zabezpieczeń w programie Microsoft Graph. Dostępne tylko dla interfejsów API administratorów. |
| groupUserAccessRight |
Prawo dostępu (poziom uprawnień), który użytkownik ma w obszarze roboczym |
|
| identifier |
string |
Identyfikator podmiotu zabezpieczeń |
| principalType |
Typ podmiotu zabezpieczeń |
|
| profile |
Profil jednostki usługi Power BI. Dotyczy tylko rozwiązania wielodostępu usługi Power BI Embedded. |
|
| userType |
string |
Typ użytkownika. |
GroupUserAccessRight
Prawo dostępu (poziom uprawnień), który użytkownik ma w obszarze roboczym
| Wartość | Opis |
|---|---|
| None |
Brak dostępu do zawartości obszaru roboczego |
| Member |
Odczyt, ponowne udostępnianie i eksplorowanie (ReadReshareExplore) praw dostępu do zawartości obszaru roboczego |
| Admin |
Uprawnienia administratora do zawartości obszaru roboczego |
| Contributor |
Odczyt i eksplorowanie (ReadExplore) dostęp do zawartości obszaru roboczego |
| Viewer |
Dostęp tylko do odczytu (odczyt) do zawartości obszaru roboczego |
GroupUsers
Otoka odpowiedzi OData dla listy użytkowników usługi Power BI z dostępem do obszaru roboczego
| Nazwa | Typ | Opis |
|---|---|---|
| @odata.context |
string |
|
| value |
Lista użytkowników z dostępem do obszaru roboczego |
PrincipalType
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
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 |